イベント駆動型の Ansible 統合セットアップ

最終更新日: 04 年 2024 月 XNUMX 日

LogicMonitor を Event-Driven Ansible と統合して、アラートの修復手順を実行できます。 たとえば、Web サーバーがダウンしている場合、LogicMonitor からアラートを受信すると、Ansible イベントによって Web サーバーが再起動されます。

イベント駆動型 Ansible に対する LogicMonitor のアラート統合のセットアップには、次の手順が含まれます。

  1. LogicMonitor ポータルからのイベント駆動型 Ansible の構成
  2. Ansible トークンの生成
  3. イベント駆動型 Ansible 用の LogicMonitor プラグインのインストールと構成

LogicMonitor ポータルからのイベント駆動型 Ansible の構成

  1. LogicMonitorで、次の場所に移動します 設定 > 統合。
  2. 選択 統合の追加.
  3. ノーザンダイバー社の 統合の追加 ペイン、下 自動化の統合選択 Ansible.
    Ansible統合ページを追加する
  4. イベント駆動型の Ansible 統合の名前と説明を入力します。
  5. Webhook イベント ソースがホストされる URL を入力します。
  6.  アラートデータ、キーと値のペアまたはトークンを選択して、アラート メッセージをカスタマイズします。
    • 選択 キー/値 ペア選択 レコードを追加、キーを提供します お名前 と 、次に選択 申し込む.
    • 選択 Raw選択 トークンの挿入、アラート メッセージに必要なトークンを含めます。 次のトークンが利用可能です。
      • ## ADMIN ##
      • ##管理者の電話番号##
      • ##管理者のメール##
      • ##管理者ページャー##
      • ## ALERTTYPE ##
      • ##アラートステータス##
      • ##メッセージ##
      • ## ALERTID ##
      • ## EXTERNALTICKETID ##
        詳細については、を参照してください。 LogicModuleアラートメッセージで使用可能なトークン.
        注意:
        • アラート メッセージは JSON 形式でのみ送信されます。
        • デフォルトでは、例として、いくつかのトークンがアラート データ メッセージ セクションに含まれています。 このセクションを編集するには、 トークンを挿入 
  7. 選択 Save.

Ansible トークンの生成

Ansible トークンを生成するには、構成した統合を再度開く必要があります。 詳細については、「LogicMonitor ポータルからのイベント駆動型 Ansible の構成」を参照してください。

  1. MFAデバイスに移動する  設定 > 統合、次に選択 管理  構成した Ansible 統合に関連付けられています。
  2. 選択 Ansible トークンの生成 Ansible トークンを生成します。
    アンシブルトークン
  3. 生成されたトークンをコピーします。 トークンを検証できるように、トークンをコピーして Ansible ホストに保存する必要があります。

推奨事項: Ansible トークンを安全に保存し、LogicMonitor ポータルからイベント駆動型 Ansible プラグイン インスタンスに転送するようにしてください。 メッセージを閉じると、生成された Ansible トークンにアクセスできなくなります。

イベント駆動型 Ansible を使用した LogicMonitor プラグインのインストールと構成

Event-Driven Ansible を使用して LogicMonitor プラグインをインストールして構成するには、次の手順を実行します。

  • LogicMonitor ポータルからイベント駆動型 Ansible を構成した後、Ansible トークンを生成する必要があります。 詳細については、「Ansible トークンの生成」を参照してください。
  • システムに Ansible Rulebook をインストールする必要があります。 詳細については、「」を参照してください。 Ansible ルールブックのインストール.

次のコマンドを使用して、Event-Driven Ansible で LogicMonitor プラグインをインストールして構成します。

1.Logicmonitor Ansibleプラグインをインストールします。

ansible-galaxy collection install logicmonitor.integration

2. ファイル secure_vars.yml を作成します。 LogicMonitor ポータルから Event-Driven Ansible を構成した後、生成した Ansible トークンを追加する必要があります。 詳細については、「Ansible トークンの生成」を参照してください。

---
ansible_token: [copied token]

3. Ansible vault を使用してファイルを暗号化します。

ansible-vault encrypt secure_vars.yml
New Vault password:
Confirm New Vault password:

注意: 暗号化に使用したパスワードを覚えておく必要があります。

4. ルールブックを作成するか、提供されたルールブックのいずれかを使用します。

---
- name: webhook alert Events
  hosts: localhost
  sources:
    - logicmonitor.integration.webhook:
        hosts: 127.0.0.1
        port: 5000
        vault_pass: '{{vault_pass}}'
        vault_path: '{{vault_path}}'
  rules:
    - name: start collector
      condition: event.payload.type == "agentDownAlert"
      action:
        run_playbook:
          name: logicmonitor.integration.start_lm-collector

5. 必要な引数を渡します。

    引数はルールブックで直接渡すことも、ファイルまたは環境から変数として渡すこともできます。 詳細については、「」を参照してください。 使用法 Ansible ドキュメントに記載されています。

6. 次のコマンドを使用してプラグインを実行します。

  • オプション [“–env-vars vault_pass”] を使用して環境変数の変数を使用した Ansible ルールブックのサンプル コマンド:
    ansible-rulebook --rulebook rulebooks/AgentDownMitigation.yml -i rulebooks/inventory.yml --verbose --env-vars vault_pass
  • 環境変数を渡さない Ansible ルールブックのサンプル コマンド:
    ansible-rulebook --rulebook rulebooks/AgentDownMitigation.yml -i rulebooks/inventory.yml

プラグインを構成すると、Ansible イベント ソースのアラートを受け取るようになります。

記事上で