正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

CI/CDの分析

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

CI/CD分析を使用して、パイプラインのパフォーマンスメトリクスと成功率に関するインサイトを得ることができます。

CI/CD分析ページでは、重要なCI/CDパイプラインのメトリクスの視覚化がGitLab UIで直接提供されます。これらの視覚化は、開発チームがソフトウェア開発プロセスの健全性と効率性を迅速に理解するのに役立ちます。

CI/CD分析を表示する

CI/CD分析を表示するには:

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 分析 > CI/CD分析を選択します。

パイプラインメトリクス

パイプラインの成功と失敗の履歴、および各パイプラインの実行時間を確認できます。パイプラインの統計は、ステータスに関係なく、プロジェクトで利用可能なすべてのパイプラインを収集することによって収集されます。個々の日ごとに利用可能なデータは、パイプラインがいつ開始されたかに基づいています。

CI/CD分析には、パイプラインに関する主要なメトリクスが表示されます:

  • 総パイプライン実行数: 選択した期間に実行されたパイプラインの合計数。パイプラインの合計計算には、子パイプラインと無効なYAMLで失敗したパイプラインが含まれます。他の属性に基づいてパイプラインをフィルタリングするには、Pipelines APIを使用します。
  • 期間の中央値: パイプラインが完了するまでにかかる時間の中央値。
  • 失敗率: 失敗したパイプラインの割合。
  • 成功率: 正常に完了したパイプラインの割合。
  • Other rate: スキップまたはキャンセルされたパイプラインの割合。

結果を絞り込む

分析データをフィルタリングして、特定の領域に焦点を当てることができます:

  • ソース: パイプライントリガーソースでフィルタリングします。
  • ブランチ: パイプラインが実行されたブランチでフィルタリングします。
  • 日付範囲: 分析する期間を選択します(たとえば、先週)。

フィルタリングを使用すると、特定のワークフローコンポーネントのパフォーマンスを分析したり、異なるブランチを比較したりできます。

パイプライン実行時間チャート

パイプライン実行時間チャートは、パイプラインの実行時間が時間の経過とともにどのように変化したかを示しています。チャートには以下が表示されます:

  • 中央(50パーセンタイル): 一般的なパイプラインのパイプライン実行時間チャート。
  • 95パーセンタイル: 95%のパイプラインは、この時間内に完了するか、それよりも短時間で完了し、5%だけがより長くかかります。

この視覚化は、パイプライン実行時間チャートの傾向を特定するのに役立ち、時間の経過とともにCI/CDプロセスの効率性を判断するのに役立ちます。

パイプラインステータスチャート

パイプラインステータスチャートは、時間の経過に伴うパイプラインステータスの分布を示しています:

  • 成功: エラーなしで完了したパイプライン。
  • 失敗: エラーが原因で正常に完了しなかったパイプライン。
  • その他: 他のステータス(キャンセル、スキップ)のパイプライン。

この視覚化は、パイプラインの安定性を追跡し、失敗率が高い期間を特定するのに役立ちます。

CI/CDジョブパフォーマンスメトリクス

  • プラン: Premium、Ultimate
  • 提供形態: GitLab.com
  • ステータス: 利用制限

GitLab Self-ManagedまたはGitLab Dedicatedでは、デフォルトでは利用できません。GitLab Self-ManagedおよびGitLab DedicatedインスタンスでCI/CDジョブのパフォーマンスメトリクスを表示するには、ClickHouseを設定する必要があります。

CI/CDジョブのパフォーマンスの傾向により、デベロッパーは非効率または問題のあるCI/CDジョブを迅速に特定できます。これらの機能をGitLab UIに直接含めることで、デベロッパーはCI/CDのパフォーマンスの問題を特定して修正するためのコンテキストを得ることができます。

ジョブのパフォーマンスメトリクスを使用すると、ボトルネックを特定し、ジョブの信頼性を監視し、全体的なパイプライン実行時間チャートに最も影響を与えるジョブに最適化の取り組みを集中させることができます。

ジョブのパフォーマンスセクションには、選択した期間のパイプライン内の各ジョブのメトリクスが表示されます:

  • ジョブ名: CI/CDジョブの名前。
  • P50 duration: このジョブの一般的な実行時間。ジョブの実行の半分はより速く完了し、半分はより長く時間がかかります。
  • P95実行時間: ジョブの実行の95%がこの時間内に完了します。このメトリクスを使用して、外れ値と最悪のシナリオを特定します。
  • 失敗率: 失敗したジョブ実行の割合。レートが高いほど、信頼性の問題を示し、調査が必要です。

デフォルトでは、テーブルは平均時間(最も長く実行されているジョブが最初)でソートされます。テーブルには、ページネーションコントロールを使用して、ページあたり10個のジョブが表示されます。任意の列ヘッダーを選択して、そのメトリクスでソートするか、検索バーを使用して名前で特定のジョブを検索できます。