Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

第8章 ルールブックアクティベーションのトラブルシューティング

さまざまな理由により、ルールブックのアクティベーションが失敗する場合があります。多くの問題は基本的なチェックで解決できますが、分散システム全体の障害を診断するには、堅牢なロギングが必要です。

Event-Driven Ansible の強化されたログ記録ストラテジーには、すべての出力にトラッキングの一意識別子が追加され、トラブルシューティングが大幅に改善されます。

本章では、アクティベーション失敗の原因となり得る問題の一覧と、それぞれの推奨される解決方法を説明します。新しい識別子を使用した詳細なログフィルタリングは、Event-Driven Ansible ログフィルタリング を参照してください。

8.1. Event-Driven Ansible ログフィルタリング
リンクのコピー

Event-Driven Ansible は、すべてのログ出力にトラッキングの識別子を含めることで、トラブルシューティングを大幅に改善します。これらの識別子は、複数のサービスとログファイルにわたるユーザーアクションとアクティベーションプロセスを追跡するのに役立ちます。

Expand
表8.1 Event-Driven Ansible ログトラッキング ID
識別子省略形目的場所

X-REQUEST-ID

rid

Event-Driven Ansible リクエストのライフサイクル全体を通じて、プラットフォームゲートウェイからの HTTP リクエストを追跡します。これを使用して、UI アクションまたは API 呼び出しをバックエンド処理と関連付けます。

HTTP 応答ヘッダーと Event-Driven Ansible ログエントリーに含まれます。

Log Tracking ID

tid

アクティベーションのライフサイクル を作成から完了まで追跡し、再起動後も複数のログファイルにわたって保持します。

すべてのアクティベーション関連ログエントリーに含まれます。UI のアクティベーション History タブから取得できます。

Activation Instance ID

aiid

ルールブックのアクティベーションに含まれる 1 つの実行インスタンスに固有のログを特定し、その実行の ansible-rulebook 出力を表示できるようにします。

アクティベーションログに含まれます。

注記

すべてのプロセスがユーザーまたは外部クライアントから発生するわけではありません。Event-Driven Ansible オーケストレーターが内部的にプロセス (例: モニター要求) をトリガーすると、そのプロセスのライフサイクルを追跡するために rid UUID が内部的に生成され、プラットフォームゲートウェイログには表示されません。

拡張ログ形式では、これらの識別子がメッセージの先頭に配置されるため、フィルタリングが容易になります。

[rid: <UUID>] [tid: <UUID>] [aiid: <ID>] aap_eda.tasks.orchestrator Processing request…​

8.1.1. トラブルシューティングにログフィルタリングを使用する
リンクのコピー

トラッキングの一意識別子を活用して、すべてのシステムログを効率的に検索およびフィルタリングする方法を学習します。このプロセスでは、特定のルールブックのアクティベーションまたは API リクエストの正確なタイムラインと失敗の原因を特定します。

手順

  1. 識別子を収集します。

    1. 問題が発生した場合は、UI の History タブ で、失敗したアクティベーションインスタンスのログから Log Tracking ID (tid) を取得します。
    2. 問題がユーザーアクション (アクティベーションの再開など) によって発生した場合は、HTTP 応答ヘッダーから X-REQUEST-ID (rid) を取得します。

  2. システムログを検索します。

    1. 収集された UUID を使用して、バックエンドログ (ワーカー、スケジューラー、API など) を検索します。これにより不要なノイズが除外され、すべてのサービスにわたって、特定のリクエストやアクティベーションの全体的なタイムラインを把握しやすくなります。

  3. タイムラインを関連付けます。

    1. 共通の tid を使用して、さまざまなログファイルとサービスにわたるアクティベーションの進行状況 (または失敗) を追跡します。

  4. サポートツールを使用します。

    1. 必要に応じて、sosreport または mustgather ツールを使用して、/var/log/ansible-automation-platform/eda/ から関連するすべての Event-Driven Ansible ログを自動的に収集します。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat