- 重要な情報
- はじめに
- 用語集
- ガイド
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- Service Management
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
Pipelines ページは、パイプラインからの重要なメトリクスと結果を表示することで、CI 状態のパイプラインファーストビューを提供します。パイプラインを保守しているのではなく、関連するコードを保守しているため、最も気になるパフォーマンス問題やテストの失敗を調査するのに役立ちます。
Datadog で Pipeline Visibility を設定するための CI プロバイダーを選択します。
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
など) にスコープされます。
各パイプラインの実行は、ステージとジョブの情報を含むトレースとして報告されます。リスト内の実行をクリックして、個々のパイプライン、ステージ、ジョブ実行トレースにアクセスします (Pipeline Details ページからパイプラインの実行をクリックするのと同様)。
または、Analytics ボタンをクリックして、パイプライン実行データをインタラクティブにフィルタリング、グループ化すれば、質問への回答やダッシュボードでの共有に使用することができます。
ダッシュボードまたはノートブックを作成する際、検索クエリで CI パイプラインデータを使用すると、視覚化ウィジェットのオプションが更新されます。詳細については、ダッシュボードとノートブックのドキュメントを参照してください。
Export ボタンをクリックすると、Pipelines Executions ページまたは Test Runs ページの CI Pipeline モニターに検索クエリをエクスポートできます。
お役に立つドキュメント、リンクや記事: