GitHub Actions のワークフローにトレースを設定する

互換性

サポートされている GitHub バージョン:

• GitHub.com (SaaS)

GitHub Enterprise Server はサポートされていません。

Datadog インテグレーションの構成

GitHub アプリの構成

GitHub Actions のインテグレーションは、プライベートな GitHub アプリを使用してワークフロー情報を収集します。すでにアプリをお持ちの場合は、次のセクションに進んでください。

1. GitHub アプリインテグレーションタイルに移動します。
2. Link GitHub Account をクリックします。
3. 指示に従って、個人または組織のアカウントにインテグレーションを構成します。
4. Edit Permissions で、Actions: Read アクセスを許可します。
5. Create App in GitHub をクリックすると、アプリの作成プロセス GitHub が完了します。
6. アプリの名前は、例えば Datadog CI Visibility とします。
7. Install GitHub App をクリックし、GitHub の指示に従ってください。

GitHub Actions のトレースを構成する

GitHub アプリを作成し、インストールしたら、視覚化したいアカウントやリポジトリで CI Visibility を有効にします。

1. Getting Started ページに移動し、GitHub をクリックします。
2. 有効にしたいアカウントの Enable Account をクリックします。
3. Enable CI Visibility をクリックして、アカウント全体の CI Visibility を有効にします。
4. また、リポジトリリストをスクロールして、Enable CI Visibility トグルをクリックすると、個々のリポジトリを有効にすることができます。

パイプラインは、アカウントやリポジトリに対して CI Visibility を有効にすると、すぐに表示されます。

ログ収集の有効化

GitHub Actions CI Visibility のインテグレーションでは、ワークフロージョブのログを Logs Product に自動転送することもできます。 ログを有効にするには、以下の手順で行います。

1. CI Visibility settings ページに移動します。
2. 有効になっている、またはリポジトリを有効にしているアカウントをクリックします。
3. アカウント全体のログを有効にするには、Enable Job Logs Collection をクリックします。
4. また、リポジトリリストをスクロールして、Enable Job Logs Collection トグルをクリックすると、個々のリポジトリを有効にすることができます。

ログ収集の切り替え直後は、ワークフロージョブのログが Datadog Logs に転送されます。なお、ログは CI Visibility とは別課金となります。ログの保持、除外、インデックスは、Logs Settings で構成されます。

Datadog でパイプラインデータを視覚化する

パイプラインが終了した後、Pipelines ページと Pipeline Executions ページにデータが入力されます。

注: Pipelines ページには、各リポジトリのデフォルトブランチのデータのみが表示されます。

GitHub Actions のトレースを無効にする

CI Visibility GitHub Actions のインテグレーションを無効にするには、GitHub アプリがワークフロージョブおよびワークフロー実行イベントのサブスクリプションを終了していることを確認します。イベントを削除するには

1. GitHub Apps のページに移動します。
2. 該当する Datadog GitHub アプリの Edit > Permission & events をクリックします (複数のアプリがある場合は、それぞれのアプリでこのプロセスを繰り返す必要があります)。
3. Subscribe to events セクションまでスクロールし、Workflow job および Workflow run が選択されていないことを確認します。

その他の参考資料

お役に立つドキュメント、リンクや記事:

パイプラインの実行結果とパフォーマンスを確認するドキュメント トラブルシューティング CIドキュメント カスタムタグとメトリクスを追加してパイプラインの可視性を拡張するドキュメント