FileBeatのためのAnsibleロール

Red Hat/CentOSまたはDebian/UbuntuにFileBeatをインストールするためのAnsibleロールです。

テスト済み環境

• EL / CentOS (6 / 7)
• Debian (Wheezy / Jessie)
• Ubuntu (Trusty / Xenial)
• Solaris

ロール変数

利用可能な変数は以下に示されており、defaults/main.ymlで定義されたデフォルト値が記載されています。

FileBeatユーザーとグループを設定します。root以外のユーザーでFileBeatを実行する場合、ログがFileBeatユーザーによって読み取り可能であることを確認してください。FileBeatユーザーを特権グループに追加し、ログへのアクセスを許可します。

Ubuntuでは、ユーザーをadmグループに追加します。CentOSでは、setfaclコマンドで権限を調整できます。例: sudo setfacl -m g:filebeat:r <path>。

filebeat_user: root
filebeat_group: root

filebeat ユーザーとグループを作成します。

filebeat_create_user: true

使用するFileBeatのバージョンです。

filebeat_version: 6.3.0

FileBeatのaptリポジトリを利用します。

特定のバージョンをインストールするには、filebeat_use_repoの値をfalseに変更し、（オプションで）filebeat_package_baseurlの値を調整します（デフォルト値が設定されています）。

filebeat_use_repo: true

filebeat_use_repo: false の場合のパッケージダウンロード用のFileBeatベースURLです。

filebeat_deb_baseurl: "https://artifacts.elastic.co/downloads/beats/filebeat"

ブート時にFileBeatを起動します。

filebeat_start_at_boot: true

FileBeatのバージョンアップグレード。このオプションはパッケージのアップグレードを許可します。

filebeat_upgrade: false

FileBeatの設定ファイルです。

filebeat_config_file: /etc/filebeat/filebeat.yml

FileBeatのレジストリファイルです。

filebeat_config_registry_file: /var/lib/filebeat/registry

FileBeatの設定は、filebeat_config変数に基づいて構築されます。内容を管理しやすくするために、filebeat_config変数は複数の他の変数で構成されています：

• filebeat_config_prospectors
• filebeat_config_output
• filebeat_config_shipper
• filebeat_config_logging

filebeat_config_prospectors: |
  filebeat:
    prospectors:
      -
        input_type: log
        paths:
          - /var/log/*.log
        registry_file: "{{filebeat_config_registry_file}}"
filebeat_config_output: |
  output:
    elasticsearch:
      hosts: [ 'localhost:9200' ]
filebeat_config_shipper: |
  shipper:
filebeat_config_logging: |
  logging:
    files:
      rotateeverybytes: 10485760 # = 10MB
filebeat_config: |
  {{filebeat_config_prospectors}}
  {{filebeat_config_output}}
  {{filebeat_config_shipper}}
  {{filebeat_config_logging}}

FileBeatのテンプレート（インストールするテンプレートのリスト）です。これらのテンプレートは/etc/filebeatディレクトリにコピーされ、例えばElasticsearch出力で使用できます。

https://www.elastic.co/guide/en/beats/filebeat/current/elasticsearch-output.html#_template

filebeat_templates: []

使用例

    - hosts: logging
      roles:
        - { role: torian.filebeat }

ライセンス

ライセンスを参照してください。

作者情報

このロールは2016年にEmiliano Castagnariによって作成されました。