javiergayala.filebeat

概述版本洞察

Ansible 角色：Filebeat

Ansible 角色 Ansible 质量评分 GitHub 最新发布 (最新 SemVer) GitHub 发布日期

在 RedHat/CentOS 上安装 Filebeat。

该角色安装并配置来自官方 Elastic.co 仓库的最新版本 Filebeat (6.x)。

需求

无。

角色变量

默认值 (见 `defaults/main.yml`)：

es_major_version: "6.x"

Filebeat 的版本应始终与您 ELK 堆栈中 Elasticsearch 的版本匹配。这代表了 Elasticsearch 的主要版本。

es_use_repository: undefined

该值在角色中未定义。我在这里记录它，因为它通常在 elastic.elasticsearch 角色中由 Elastic.co 定义。如果您与 elastic.elasticsearch 角色一起安装此 Filebeat 角色，则该角色通常会为您安装仓库。允许此 Filebeat 角色也安装仓库将稍微更改 repo 文件，这将导致该角色不再生成幂等结果。但是，如果您告诉 elastic.elasticsearch 角色不要安装仓库，那么此 Filebeat 角色将安装仓库以访问软件。

es_version: "6.2.3"

Elasticsearch/Filebeat 的完整版本号。

filebeat_create_config: "true"

是否允许该角色创建 Filebeat 配置文件。

filebeat_enabled: "yes"

这定义了 Filebeat 服务是否在启动时启用。

filebeat_repo_key: 'https://artifacts.elastic.co/GPG-KEY-elasticsearch'

用于 Elastic.co 仓库的 PGP 密钥 URL。

filebeat_run_state: started

这定义了 Filebeat 服务是否应启动。

filebeat_config_content:
  filebeat.prospectors:
    - type: log
      enabled: "true"
      paths:
        - "/var/log/*.log"
  filebeat.config.modules:
    reload.enabled: "false"
    path: "{{ filebeat_modules_dir }}/*.yml"
  setup.template.settings:
    index.number_of_shards: 3
  output.elasticsearch:
    hosts:
      - "localhost:9200"

filebeat_config_content 变量是一个字典，包含 Filebeat 的基本配置。此变量的值将用于填充 filebeat.yml 配置文件。您通常需要定义的键包括：

filebeat.prospectors
filebeat.config.modules
setup.template.settings
输出（即 output.elasticsearch 或 output.logstash）

filebeat_module_config: {}

filebeat_module_config 变量是一个字典，类似于 filebeat_config_content，但用于创建 Filebeat 模块的配置文件。字典键是要启用的模块的名称，该键的内容本身是一个字典，包含该模块的配置。

例如：

filebeat_module_config:
  system:
    syslog:
      enabled: "true"
    auth:
      enabled: "true"

RedHat 特定值（见 `vars/filebeat-RedHat.yml`）

filebeat_home: /usr/share/filebeat

Filebeat 安装路径。

filebeat_bin_dir: "{{ filebeat_home }}/bin"

Filebeat 二进制文件的安装路径。

filebeat_config_dir: "/etc/filebeat"

Filebeat 配置目录的路径。

filebeat_config_file: "{{ filebeat_config_dir }}/filebeat.yml"

Filebeat 配置文件的完整路径。

filebeat_modules_dir: "{{ filebeat_config_dir }}/modules.d"

Filebeat 模块配置存储路径。

依赖关系

无。

示例剧本

- hosts: servers
  roles:
     - role: javiergayala.filebeat
       filebeat_module_config:
         system:
           syslog:
             enabled: "true"
           auth:
             enabled: "true"