Datadog の CI Pipeline Visibility
This product is not supported for your selected
Datadog site. (
).
概要
Pipeline Visibility は、CI の健全性をパイプライン中心で表示し、パイプラインからの重要なメトリクスと結果を提供します。これにより、パイプラインの障害をトラブルシュートし、パフォーマンスのボトルネックに対処し、CI のパフォーマンスと信頼性を長期的に追跡するのに役立ちます。
セットアップ
Datadog で Pipeline Visibility を設定するための CI プロバイダーを選択します。
用語
CI パイプラインの概念はプロバイダーによって異なる場合がありますが、Datadog Pipeline Visibility での CI パイプラインの定義とそれらの概念がどのように対応しているかを確認してください。
| Datadog | GitHub Actions |
|---|
| パイプライン | ワークフロー |
| ジョブ | ジョブ |
| 手順 | 手順 |
| Datadog | GitLab |
|---|
| パイプライン | パイプライン |
| ステージ | ステージ |
| ジョブ | ジョブ |
| Datadog では利用不可 | スクリプト |
| Datadog | Jenkins |
|---|
| パイプライン | パイプライン |
| ステージ | ステージ |
| ジョブ | 手順 |
| Datadog | CircleCI |
|---|
| パイプライン | ワークフロー |
| ジョブ | ジョブ |
| Datadog では利用不可 | 手順 |
| Datadog | Buildkite |
|---|
| パイプライン | パイプライン |
| ジョブ | ジョブ |
| Datadog では利用不可 | 手順 |
| Datadog | TeamCity |
|---|
| パイプライン | ビルドチェーン |
| ジョブ | ビルド |
| Datadog では利用不可 | 手順 |
| Datadog | Azure Pipelines |
|---|
| パイプライン | パイプライン |
| ステージ | ステージ |
| ジョブ | ジョブ |
| Datadog では利用不可 | 手順 |
| Datadog | AWS CodePipeline |
|---|
| パイプライン | パイプライン |
| ステージ | ステージ |
| ジョブ | アクション |
| Datadog | その他の CI プロバイダー |
|---|
| パイプライン | パイプライン |
| ステージ | ステージ |
| ジョブ | ジョブ |
| 手順 | 手順 |
CI プロバイダーが対応していない場合は、公開 API エンドポイントから Pipeline Visibility を設定してみてください。
サポートされる機能
| Jenkins | GitLab | CircleCI | Buildkite | GitHub Actions | Azure Pipelines | Codefresh | TeamCity | AWS CodePipeline | その他の CI プロバイダー |
|---|
パイプライントレースの可視化
パイプライン実行と関連するトレースの可視化。 | | | | | | | | | | |
実行中のパイプライン
稼働中のパイプライン実行の識別と関連するトレース。 | | | | | | | | | | |
部分再試行
部分再試行の識別 (例えば、ジョブの一部のみが再試行された場合)。 | | | | | | | | | | |
ステップスパン
ステップレベルのスパンは、より詳細な可視性を得るために利用できます。 |
(ただし、ジョブスパンとして表示されます) | | | | | | | | | |
手動ステップ
パイプライン全体に手動承認フェーズがあるジョブの識別。 | | | | | | | | | | |
承認待ち時間
パイプラインまたはジョブが手動承認を待っている時間。 | | | | | | | | | | |
キュー時間
パイプラインまたはジョブが実行前にキューにあった時間。 | | | | | | | | | | |
実行時間
パイプラインがジョブをアクティブに稼働した時間。 | | | | | | | | | | |
ログの相関付け
CI プロバイダーからのパイプラインまたはジョブのログの取得。ログは、パイプライン実行ビューの Logs タブに表示されます。 | | | | | | | | | | |
インフラストラクチャーメトリクスの相関付け
Datadog Agent、CI パイプライン、またはジョブランナーのホストレベルの情報を CI パイプラインの実行データと相関付け。 | | | | | | | | | | |
datadog-ci を使用したトレースコマンドのカスタムスパン
パイプラインのフレームグラフによる視覚化に組み込むために、コマンドレベルイベントの CI Visibility への送信をサポート。その後、これらのイベントのクエリと分析が可能になります。 | | | | | | | | | | |
カスタム事前定義タグ
CI プロバイダーで、実行間で変化しない静的なパイプラインタグの設定をサポート。 | | | | | | | | | | |
カスタムタグとランタイムの測定値
CI Visibility で、テキストと数字で構成されたユーザー定義タグのパイプラインおよびジョブへの追加をサポート。 | | | | | | | | | | |
パラメーター
ユーザーが設定したカスタムパイプラインパラメーター (例: DYNAMICS_IS_CHILD:true) の追加をサポート。その後、CI Visibility Explorer でこれらのパラメーターを使って検索を行い、特定のパラメーターを持つすべてのイベントを見つけることができます。 | | | | | | | | | | |
パイプラインの失敗理由
パイプラインやジョブの失敗の背後にある具体的な理由の特定。 | | | | | | | | | | |
CI パイプラインデータの使用
ダッシュボードまたはノートブックを作成する際、検索クエリで CI パイプラインデータを使用すると、視覚化ウィジェットのオプションが更新されます。詳細については、ダッシュボードとノートブックのドキュメントを参照してください。
パイプラインデータのアラート
Export ボタンをクリックすると、Executions ページまたは Test Runs ページの CI Pipeline モニターに検索クエリをエクスポートできます。
参考資料