Beatsクライアント Ansibleロール

Ansibleロールは、Elastic Beatsクライアントをインストールおよび設定するためのものです。主にログやメトリクスをELKスタックに送信するために使用されます。デフォルトでは、このロールはFilebeatとMetricbeatを使用して、同じボックス上のLogstashにデータを送信します。

要件

• データを送信する先が必要です。Beats 5.xシリーズでは、file、kafka、redis、console、elasticsearch、および/またはlogstashへの送信が含まれます。

ロール変数

ログをLogstash/Elasticsearchに送信する際に、SSL証明書が必要です。このロジックはこのロールには含まれておらず、デフォルトでは暗号化は無効になっています。オプションを変数を通じて追加するには、公式のBeatsドキュメントの出力ガイドを参照する必要があります。

例のプレイブック

- name: Beatsクライアントの設定
  hosts: clients
  roles:
    - role: freedomofpress.beats
  tags: clients

テストの実行

このロールは、MoleculeおよびTestinfraを使用してテストします。使用するには、以下のコマンドを実行します：

pip install -r requirements.txt
molecule test

選択的なコマンドを実行することもできます：

molecule idempotence
molecule verify

デバッグ用にElasticsearchのUIを立ち上げるには、以下を実行します：

make elastic-ui

詳細については、Moleculeのドキュメントを参照してください。

貢献

このロールを作成する際に非常に役立ったリソースです。

• geerlingguy.logstash
• DigitalOceanのELKガイド
• Filebeat設定ガイド

ライセンス

MIT