Datadog におけるパイプラインの可視化

Docs > Continuous Integration Visibility > Datadog におけるパイプラインの可視化

概要

Pipelines ページは、パイプラインからの重要なメトリクスと結果を表示することで、CI 状態のパイプラインファーストビューを提供します。パイプラインを保守しているのではなく、関連するコードを保守しているため、最も気になるパフォーマンス問題やテストの失敗を調査するのに役立ちます。

セットアップ

Datadog で Pipeline Visibility を設定するための CI プロバイダーを選択します。

Azure

CI プロバイダーが対応していない場合は、公開 API エンドポイントから Pipeline Visibility を設定してみてください。

パイプラインの確認

パイプラインを確認するには、CI > Pipelines に移動します。

パイプラインの健全性の概要

Pipelines ページには、選択した時間枠での各パイプラインのデフォルトブランチの集計統計と、最新のパイプライン実行のステータスが表示されます。このページを使用して、すべてのパイプラインを確認し、その健全性をすばやく確認します。Pipelines ページには、通常は main や prod などの名前が付けられた_デフォルト_ブランチのメトリクスが表示されます。

表示されるメトリクスには、ビルド頻度、失敗率、平均期間、95 パーセンタイル期間が含まれます。この情報は、どのパイプラインが使用率が高く、潜在的にリソースの消費量が多いかを明らかにします。最後のビルド結果、期間、最後の実行時間は、最後のコミットの効果を示します。

パイプライン名でページをフィルタリングして、最も関心のあるパイプラインを確認できます。遅延または障害が発生しているパイプラインをクリックすると、パフォーマンスの低下やビルドエラーを引き起こした可能性のあるコミットが表示されます。

パイプラインの詳細とブランチ

特定のパイプラインをクリックすると、Pipeline Details ページが表示されます。このページには、指定した時間枠で選択したパイプラインのデータのビューが表示され、デフォルト以外のブランチを表示できます。

時間の経過に伴う実行の合計と失敗、ビルド期間のパーセンタイル、ステージごとの内訳に費やされた合計時間など、選択したパイプラインに関する情報を取得します。ステージとジョブの要約テーブルもあるため、期間、全体的な実行時間の割合、または失敗率の観点からそれらをすばやく並べ替えることができます。

パイプラインの_デフォルト_ブランチを表示すると、ページ上の各ステージとジョブのサマリーテーブルに、ステージとジョブの期間の絶対的および相対的な変化を視覚化する Duration Change グラフと、Errored Executions のグラフが表示されます。

パイプラインのフィーチャーブランチを表示する際、Errored Executions のグラフが 2 つ表示されます。1 つはこのフィーチャーブランチでの実行に失敗したもの、もう 1 つはこのブランチの失敗を他の失敗と比較するものです。Other Branches と Specific Branch を切り替えるオプションがあります。Other Branches を選択すると、このフィーチャーブランチの実行失敗を他のすべてのブランチの失敗と集計して比較し、導入された (ローカル) 実行失敗と継承された (グローバル) 実行失敗を区別することができます。Specific Branch に追跡すると、このフィーチャーブランチの実行失敗と選択した別のブランチの実行失敗を直接比較し、パイプラインのパフォーマンスの変化を具体的に追跡するのに役立ちます。

オプションで、このフィーチャーブランチでの実行失敗と、選択した別のブランチでの実行失敗を直接比較することも可能です。

下部のパイプライン実行リストには、選択したブランチについて、選択した時間枠内にパイプライン (またはそのステージまたはジョブ) が実行されたすべての時間が表示されます。左側のファセットを使用して、表示するパイプライン、ステージ、またはジョブにリストを正確にフィルタリングします。

サービス、リソース、ネットワークイベントへの接続を確認する

実行の 1 つをクリックしてパイプライン実行ビューを開き、パイプラインとそのステージのフレームグラフまたはスパンリストを表示します。左側の Executions (n) リストを使用すると、同じコミットでパイプラインを再試行するたびにデータにすばやくアクセスできます。

CI プロバイダーリンク (次の画像の gitlab-ci gitlab.pipeline > documentation) をクリックして、パイプライン、ステージ、またはジョブの Resource、Service、または Analytics ページを具体的に調べます。また、完全なタグ情報と、ネットワーク監視イベントへのリンクもあります。

ログへの接続を確認する

CI プロバイダーでジョブログ収集がサポートされ、有効になっている場合、関連するログイベントはパイプライン実行ビューの Logs タブで確認できます。

注: ジョブログの収集は、限られたプロバイダーのみでサポートされています。

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

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

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