第9章 ロギングおよびアグリゲーション

このセクションでは、さまざまな Automation Controller コンポーネントによって生成されるログメッセージの共通スキーマについて説明します。ログメッセージスキーマを理解すると、システムを効果的に監視およびトラブルシューティングするのに役立ちます。

全ロガーに対する共通のスキーマ

Automation Controller には、ジョブテンプレート、インベントリー、認証情報など、システム内のオブジェクトの変更を記録する activity_stream ロガーが組み込まれています。

これは、ログメッセージスキーマ にリストされているすべてのロガーに共通するフィールドを使用します。

次の追加フィールドがあります。

このロガーは、ジョブイベントに保存されているデータを反映します。ただし、ロガーの予期される標準フィールドと競合する場合を除きます (この場合、フィールドはネストされます)。job_event モデルのフィールド host は、event_host として指定されることに注意してください。ペイロード内にはサブディクショナリーフィールド event_data もあります。このフィールドには、Ansible イベントの詳細に応じて異なるフィールドが含まれます。

このロガーには ログメッセージスキーマ の共通フィールドも含まれています。

このセクションでは、Automation Controller のスキャン/ファクト/システム追跡ロガーによって生成されるログメッセージのスキーマについて説明します。

これらには、サービス、パッケージまたはファイルの詳細なディクショナリータイプのフィールドが含まれます。

このロガーには、ログメッセージスキーマ の共通フィールドも含まれます。

ジョブステータス変更ロガーは、ジョブのステータス変更が発生した際にそれをキャプチャーします。

この情報ソースは、ジョブイベントと比較してジョブ状態の変化に関する情報は少量とし、ジョブテンプレートをベースとするジョブ以外で、統合されたジョブタイプに対する変更を取得します。

このロガーには、ログメッセージスキーマ の共通フィールドと、ジョブモデルに存在するフィールドも含まれます。

Automation Controller は標準の Python ロギングモジュールを使用して、システムのさまざまな部分からのメッセージをログに記録します。

このロガーには、ログメッセージスキーマ の共通フィールドも含まれます。

さらに、ログメッセージを含む msg フィールドが含まれます。エラーには別の traceback フィールドが含まれます。ナビゲーションパネルから、Settings Automation Execution Logging を選択します。Logging Settings ページで Edit をクリックし、ENABLE EXTERNAL LOGGING オプションを使用して、ロギングコンポーネントを有効または無効にします。

ロギングアグリゲーターサービスは、以下の監視またはデータ分析システムと連携します。

https://<yourcontrollerfqdn>/api/v2/settings/logging

{
    "LOG_AGGREGATOR_HOST": "https://<yoursplunk>:8088/services/collector/event",
    "LOG_AGGREGATOR_PORT": null,
    "LOG_AGGREGATOR_TYPE": "splunk",
    "LOG_AGGREGATOR_USERNAME": "",
    "LOG_AGGREGATOR_PASSWORD": "$encrypted$",
    "LOG_AGGREGATOR_LOGGERS": [
        "awx",
        "activity_stream",
        "job_events",
        "system_tracking"
    ],
    "LOG_AGGREGATOR_INDIVIDUAL_FACTS": false,
    "LOG_AGGREGATOR_ENABLED": true,
    "LOG_AGGREGATOR_CONTROLLER_UUID": ""
}

https://<yourcontrollerfqdn>/api/v2/settings/logging

{
    "LOG_AGGREGATOR_HOST": "https://<yoursplunk>:8088/services/collector/event",
    "LOG_AGGREGATOR_PORT": null,
    "LOG_AGGREGATOR_TYPE": "splunk",
    "LOG_AGGREGATOR_USERNAME": "",
    "LOG_AGGREGATOR_PASSWORD": "$encrypted$",
    "LOG_AGGREGATOR_LOGGERS": [
        "awx",
        "activity_stream",
        "job_events",
        "system_tracking"
    ],
    "LOG_AGGREGATOR_INDIVIDUAL_FACTS": false,
    "LOG_AGGREGATOR_ENABLED": true,
    "LOG_AGGREGATOR_CONTROLLER_UUID": ""
}

filter {
  json {
    source => "message"
  }
}

filter {
  json {
    source => "message"
  }
}