第9章 集中ロギング
ロギングについて考えるとき、ほとんどの人の頭にまず浮かぶのは、特定の問題をトラブルシューティングする能力です。テクノロジーが進化し続け、多くのアプリケーションが膨大な量のデータをキャプチャーするに伴い、ログはデータをキャプチャーするだけでなく、運用インテリジェンスメソッドの適用を可能にする上で重要なロールを果たします。
Ansible Automation Platform は、詳細なログを数種類のサードパーティー製外部ログ集約サービスに送信できるロギング機能を提供します。このデータフィードに接続されたサービスは、自動化コントローラーの使用や技術の傾向に関する洞察を得るための有用な手段として機能します。このデータを使用して、インフラストラクチャー内のイベントを分析し、異常をモニタリングし、あるサービスのイベントを別のサービスのイベントと関連付けることができます。
自動化コントローラーに最も役立つデータのタイプは、ジョブファクトデータ、ジョブイベント/ジョブ実行、アクティビティーストリームデータ、およびログメッセージです。データは、カスタムハンドラーで、またはインポートされたライブラリーを介して設計された最小限のサービス固有の調整を使用して、HTTP 接続を介して JSON 形式で送信されます。
現在、Ansible Automation Platform のログ機能は、Splunk、Logstash、Loggly、Sumologic と簡単に連携できるように設定されており、別のサードパーティーの外部ログ集約サービスを使用する場合は他の オプションを提供します。
このリファレンス環境の目的上、Splunk Enterprise 8.2.2 を使用して、両方の Ansible Automation Platform サイトに集中ログを設定することに重点を置いています。
Splunk Enterprise のインストールは、このリファレンスアーキテクチャーの範囲外です。詳細は、How to install Splunk Enterprise を参照してください。
9.1. Splunk HTTP イベントコレクター (HEC) の設定 リンクのコピーリンクがクリップボードにコピーされました!
HTTP イベントコレクターは、開発者がトークンベースの認証モデルを使用して、HTTP または HTTPS を介してアプリケーションイベントを Splunk プラットフォームに直接送信できるようにするエンドポイントです。
HEC を使用するための最初の手順は、Splunk デプロイメント内で HEC を有効にすることです。
Splunk 管理者として、以下を実行します。
- Splunk ダッシュボードにログインします。
-
Settings
Data Inputs HTTP Event Collector をクリックします。 - 右上隅にある Global Settings をクリックします。
- All Tokens トグルオプションで Enabled (デフォルト) を選択します。
-
すべての HEC トークンの Default Source Type を選択します (例:
_json)。 - Splunk デプロイメントで HTTPS を使用している場合は、Enable SSL をにチェックマークを付けます。
- HTTP Port Number を介して HTTP 入力専用のポートを設定します。デフォルトは 8088 です。
- Save をクリックします。
図9.1 グローバル設定
Splunk デプロイメントでポート 8088 (または割り当てられたポート) が開いていることを確認します。
Splunk デプロイメントで HEC を有効にして、Splunk での自動化コントローラー認証に使用される HEC トークンを生成します。
HTTP 経由でデータを受信するためにトークンを設定する方法は多くありますが、このリファレンス環境では以下の設定が使用されます。
HEC の詳細は、HTTP Event Collector を参照してください。
-
Settings
Add Data をクリックします。 - ページ下部で Monitor を選択します。
- HTTP Event Collector をクリックします。
- Name フィールドにトークン名を入力します (例: AAP)。
- Source Type を Select に変更し、ドロップダウンに _json と入力します。
- Index 内で、ansible というラベルの付いたインデックスを作成します。
新しく作成したインデックスを選択したアイテムボックスに追加します。
右上隅にある Review をクリックします。
- Submit をクリックします。
作成されたトークン値は、Ansible Automation Platform で Splunk の認証に使用されるため保存します。
緑色の Start Search ボタンをクリックし、提供されたサンプルクエリーをコピーして後で使用できるようにします。
source="http:AAP" (index="ansible") sourcetype="_json"
source="http:AAP" (index="ansible") sourcetype="_json"Copy to Clipboard Copied! Toggle word wrap Toggle overflow