Red Hat Ansible Inside レポートガイド

Ansible Inside は、自動化ジョブに関する使用状況概要データを保存します。Red Hat はこのデータを使用して、製品の改善と新機能のどこに注力すべきかを特定します。

自動化ジョブが完了すると、メトリクスが収集され、ジョブに関する次の情報が保存されます。

次のアーキテクチャー図は、Red Hat に送信できるように、Python アプリケーションの外部にある永続データストレージにデータを保存する方法を示しています。

メトリクスデータは、tarball ファイルにバンドルされています。ジョブごとに個別のファイルが生成されます。ファイルは暗号化されておらず、ファイルの内容は表示できます。

各 tarball ファイルには、次のような暗号化なしの CSV ファイルが含まれています。

Ansible SDK をインストールすると、デフォルトのメトリクスの保存場所が ~/.ansible/metrics ディレクトリーに設定されます。

自動化ジョブが完了すると、メトリクスがディレクトリー内の tarball に書き込まれます。ディレクトリーが存在しない場合、Ansible SDK はディレクトリーを作成します。

Playbook を実行する Python ファイルに、メトリクスファイルの保存ディレクトリーへのパスを指定できます。

Python 自動化ジョブファイルごとに異なるディレクトリーパスを設定することも、複数のジョブの tarball を 1 つのディレクトリーに格納することもできます。Python ファイルでパスを設定しない場合、実行するジョブの tarball はデフォルトディレクトリー (~/.ansible/metrics) に保存されます。

自動化ジョブが完了したら、データを保存するために指定したディレクトリーに移動し、ファイルを一覧表示します。

新しく完了したジョブのデータは、名前が自動化ジョブの実行日時で始まる tarball ファイルに含まれています。たとえば、次のファイルは、2023 年 3 月 8 日の午前 2 時 30 分に実行された自動化ジョブのデータを記録します。

ls

$ ls

2023_03_08_02_30_24__aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa_job_data.tar.gz

tarball 内のファイルを表示するには、tar xvf を実行します。

tar xvf 2023_03_08_02_30_24__aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa_job_data.tar.gz

$ tar xvf 2023_03_08_02_30_24__aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa_job_data.tar.gz

x jobs.csv
x modules.csv
x collections.csv
x roles.csv
x playbook_on_stats.csv

次の例は jobs.csv ファイルを示しています。

cat jobs.csv

job_id,job_type,started,finished,job_state,hosts_ok,hosts_changed,hosts_skipped,hosts_failed,hosts_unreachable,task_count,task_duration
84896567-a586-4215-a914-7503010ef281,local,2023-03-08 02:30:22.440045,2023-03-08 02:30:24.316458,,5,0,0,0,0,2,0:00:01.876413

$ cat jobs.csv

job_id,job_type,started,finished,job_state,hosts_ok,hosts_changed,hosts_skipped,hosts_failed,hosts_unreachable,task_count,task_duration
84896567-a586-4215-a914-7503010ef281,local,2023-03-08 02:30:22.440045,2023-03-08 02:30:24.316458,,5,0,0,0,0,2,0:00:01.876413

パラメーターの値が使用できない場合、CSV ファイルの対応するエントリーが空になります。上記の jobs.csv ファイルでは、job_state 値は使用できません。