Continuous Integration Visibility Explorer

This product is not supported for your selected Datadog site. ().

概要

CI Visibility Explorer では、任意のタグを使用して、パイプライン実行を複数のレベルで検索とフィルター、視覚化、エクスポートすることができます。

Pipeline、Stage、Job、Step、Command のレベルの CI パイプラインの実行結果を確認するには、Software Delivery > CI Visibility > Executions に移動します。

デフォルトの CI ファセット

左側の CI パネルには、パイプライン実行の検索に使用できるデフォルトのファセットが表示されます。

ファセット説明
CI StatusCI 実行のステータス: Success、Failure、または Canceled
CI InstanceCI プロバイダーのインスタンス名。
Durationパイプラインが実行される時間。
Pipeline IDパイプラインの ID。
CI ProviderCI プロバイダーの名前。
Node Labelsノードのラベル。
Node Nameノードの名前。
Partial Pipeline再試行、手動承認、またはその他の不完全なシーケンスを含む CI パイプライン実行を指します。
Partial RetryCI 実行が以前の実行の再試行であったかどうかを示します。
Manually TriggeredCI 実行が手動でトリガーされたかどうかを示します。
パラメーターパイプラインまたはジョブがトリガーされた際のユーザー定義パラメーター。
Pipeline Numberパイプラインの番号。
Pipeline URLパイプラインの URL。
Queue TimeCI キューでジョブまたはタスクが実行前に待機していた合計時間。
デプロイCI パイプラインとともにデプロイされた GitLab 環境。
Deployment ActionGitLab のデプロイされた環境内で実行されたアクション。
Command NameCI パイプライン内の特定のコマンドに対するユーザー定義の識別子。
コマンドカスタムパイプラインスパンを生成するために実行されたコマンドライン。
Downstream Pipelineこのパイプラインが別のパイプラインの下流にあるかどうかを示します。
Upstream Pipeline ID現在のパイプラインの前に実行され、それをトリガーするパイプライン実行の識別子。
Step NameCI パイプライン内の特定のステップに割り当てられた名前。
エラードメインCI 実行時のエラーの種類 (プロバイダー、ユーザー、不明など)
Run timeCI パイプラインの実行に費やされた合計時間。
Wait timeCI 実行において手動承認を待つのに費やされた合計時間。
Is Deploymentパイプライン内のジョブがデプロイを開始したかどうかを示します。
Contains Deploymentパイプラインにデプロイをトリガーするジョブが含まれているかどうかを示します。
On Critical Pathジョブが CI パイプラインの実行のクリティカル パス上にあるかどうかを示します。

CI Visibility Explorer で検索クエリの一部として使用できる一般的なファセットについては、パイプライン実行ファセットを参照してください。

パイプライン実行の詳細とトレース

選択した時間枠でのパイプラインの実行に関する集計データを確認できます。検索フィールドとファセットを使用して、調査したい実行までリストをスコープします。上部のボタンを使用して、リストを変更してパイプライン、ステージ、またはジョブを表示します。

以下は、最もアクティブなパイプラインの継続時間、失敗したパイプラインの継続時間、パイプラインの実行時間を可視化する 3 つのグラフで、それぞれ継続時間の累積に切り替えるオプションがあります。これらのグラフは左上で選択したレベル (Pipeline、Stage、Job など) にスコープされます。

エクスプローラービューのトレンドグラフ: Duration、Errored、Executions

各パイプラインの実行は、ステージとジョブの情報を含むトレースとして報告されます。リスト内の実行をクリックして、個々のパイプライン、ステージ、ジョブ実行トレースにアクセスします (Pipeline Details ビューからパイプラインの実行をクリックするのと同様)。

CI パイプラインデータはダッシュボードとノートブックで利用できるため、ビルドエンジニアリングチームは、優先度の高い作業と CI の傾向に関するコミュニケーションを長期にわたってカスタマイズできます。

検索とフィルター

左側のファセットをクリックするか、検索バーに独自のカスタムクエリを記述することで、パイプライン実行のサブセットに焦点を絞ったり、広げたり、シフトしたりできます。ファセットを選択または選択解除すると、検索バーに変更が自動的に反映されます。同様に、検索バーのクエリを変更するか、検索バーにクエリをゼロから記述して、左側のファセットを選択または選択解除できます。

  • パイプラインの検索方法については、検索と管理を参照してください。
  • クエリの作成方法については、検索構文を参照してください。

分析

情報を導出または統合するために、クエリされたパイプライン実行を、フィールド、パターン、トランザクションなどの上位エンティティにグループ化します。属性を検索するために作成する必要のない ファセットを使用すると、以下のアクションを実行できます。

  • CI/CD パイプラインで実行されているテストの進捗を検索し、追跡します。
  • すべての CI/CD ジョブの実行を調査して、失敗したテスト実行を特定してトラブルシューティングします。

視覚化

視覚化の種類を選択して、フィルターや集計の結果を視覚化し、パイプラインの実行をよりよく理解できます。例えば、パイプライン実行をリストで表示してパイプラインデータを列ごとに整理したり、時系列グラフで表示してパイプラインデータの経時変化を測定したりできます。

エクスポート

CI Visibility Explorer のビューをエクスポートすると、後で別のコンテキストで再利用できます。

参考資料

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

ビルドの問題を解決するためにパイプラインデータを調査するドキュメント more more Datadog CI モニターによるパイプラインアラートの構成ブログ more more