CI パイプラインの検索と管理

Docs > Continuous Integration Visibility > CI パイプラインの検索と管理

概要

自分のサービスのビルドパイプラインを常に把握しておきたい開発者にとって、Pipelines ページは便利です。

このページで確認できることは、次のとおりです。

特にデフォルトブランチで、あなたのサービスのパイプラインは十分に高速で信頼できていますか？
そうでない場合、根本原因は何ですか？

また、次のような高レベルの集計やトレンドも確認できます。

パイプライン実行やブランチの集計統計に基づき、ビルドシステム全体の健全性を俯瞰できます。
本番向けパイプラインの破損など、すぐに対応が必要な問題を素早く見つけて修正するための入口になります。
各パイプラインが時間の経過とともにどのように実行され、どんな結果・傾向が出ているかを確認できます。
各ビルドステージでどこに時間が費やされているかの内訳を時系列で把握できるため、最も効果の大きい箇所に改善を集中できます。

パイプラインを検索する

パイプラインを表示するには、Software Delivery > CI Visibility > CI Pipeline List に移動します。

Pipelines ページでは、選択した期間における各パイプラインのデフォルトブランチの集計統計に加え、最新のパイプライン実行のステータスも確認できます。このページを使うと、すべてのパイプラインを一覧し、健全性を手早く把握できます。このページに表示されるのは、デフォルトブランチ (通常は main または prod) に関連付けられた Git 情報を持つパイプラインと、Git 情報が一切ないパイプラインのみです。

表示されるメトリクスには、ビルド頻度、失敗率、所要時間の中央値、所要時間の中央値の変化 (絶対値と相対値) も含まれます。これにより、利用頻度が高くリソース消費が大きい可能性のあるパイプラインや、性能が悪化しているパイプラインを見分けられます。直近のビルド結果・所要時間・最終実行時刻から、最後のコミットの影響も把握できます。

パイプライン名でページをフィルタリングし、特に注視したいパイプラインだけを表示できます。遅い、または失敗しているパイプラインをクリックすると、どのコミットが性能劣化やビルドエラーを持ち込んだ可能性があるか、といった詳細を掘り下げられます。Datadog Teams を使用している場合は、チームのハンドルに一致するカスタムタグを使って、チームに紐づく特定のパイプラインだけに絞り込めます。

パイプラインの詳細と実行履歴

特定のパイプラインをクリックすると、指定した期間における選択パイプラインのデータをさまざまな角度から確認できる Pipeline Details ページが表示されます。

選択したパイプラインについて、実行総数と失敗実行数の推移、ビルド所要時間のパーセンタイル、エラー率、ステージ別の総所要時間の内訳などを把握できます。ステージとジョブのサマリーテーブルも用意されており、所要時間、全体実行時間に占める割合、失敗率といった観点で素早く並べ替えられます。

パイプライン実行リストには、選択したブランチについて、選択期間内にそのパイプライン (またはステージやジョブ) が実行されたすべての履歴が表示されます。左側のファセットを使って、見たいパイプライン、ステージ、ジョブだけにリストを絞り込んでください。

クリティカルパスをハイライト表示する

トレース上でクリティカルパスをハイライト表示するには、パイプライン実行ページで Critical path チェックボックスをクリックします。

クリティカルパスは、パイプライン全体の実行時間を短縮したいときに、優先して高速化すべきスパンを強調表示します。ある CI ジョブがクリティカルパス上にある場合、そのジョブは実行時間の観点でトレース内の最長経路の一部であることを意味します。クリティカルパス上の CI ジョブを高速化しない限り、CI パイプラインそのものは短縮できません。

CI パイプライン全体の所要時間を短縮するために、どのジョブを優先すべきかを判断するには、このガイドを参照してクリティカルパス上の CI ジョブを特定してください。

サービス、リソース、ネットワークイベントとの関連を確認する

いずれかの実行をクリックすると、パイプライン実行ビューが開き、パイプラインと各ステージのフレームグラフまたはスパンリストを確認できます。左側の Executions (n) リストから、同一コミットに対するパイプラインの再試行ごとのデータに素早くアクセスできます。

CI プロバイダのリンク (以下の画像の gitlab-ci gitlab.pipeline > documentation) をクリックすると、対象のパイプライン、ステージ、ジョブに対応する Resource、Service、Analytics ページを詳しく確認できます。タグの詳細情報や、ネットワーク監視イベントへのリンクも見つけられます。