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

パイプラインアナリティクス

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

アナリティクスモードは、完了したパイプラインの集計メトリクスを返します。データは通常10分以内に利用可能です。

個々のパイプラインレコードをクエリするには、パイプラインを使用します。

許可されたスコープ

スコープ説明
project特定のプロジェクトで完了したパイプラインをクエリする。
groupグループ内のすべてのプロジェクト(サブグループを含む)で完了したパイプラインをクエリする。

クエリフィールド

フィールド名前演算子
完了日時finished=><>=<=
Refref=in
ソースsource=in
開始日時started=><>=<=
ステータスstatus=in

完了日時

説明: パイプラインを完了日でフィルタリングします。

指定可能な値の型:

  • AbsoluteDateYYYY-MM-DDの形式)
  • RelativeDate<sign><digit><unit>の形式で、signは+-、または省略され、digitは整数、unitd(日)、w(週)、m(月)、y(年)のいずれか)

ノート:

  • =演算子の場合、時間範囲はユーザーのタイムゾーンで00:00から23:59までと見なされます。
  • >=および<=演算子は、クエリ対象の日付を含みますが、>および<は含みません。

Ref

説明: パイプラインを、実行されたGitブランチまたはタグ名でフィルタリングします。

指定可能な値の型:

  • String
  • List(複数の値にはin演算子を使用)

ソース

説明: パイプラインをトリガーイベントでフィルタリングします。

指定可能な値の型:

  • String
  • List(複数の値にはin演算子を使用)

開始日時

説明: パイプラインを開始日でフィルタリングします。

指定可能な値の型:

  • AbsoluteDateYYYY-MM-DDの形式)
  • RelativeDate<sign><digit><unit>の形式で、signは+-、または省略され、digitは整数、unitd(日)、w(週)、m(月)、y(年)のいずれか)

ノート:

  • =演算子の場合、時間範囲はユーザーのタイムゾーンで00:00から23:59までと見なされます。
  • >=および<=演算子は、クエリ対象の日付を含みますが、>および<は含みません。

ステータス

説明: パイプラインをそのCI/CDのステータスでフィルタリングします。

指定可能な値の型:

  • Enum。次のいずれか: canceledfailedskipped、またはsuccess
  • List(複数の値にはin演算子を使用)

ディメンション

ディメンション名前説明
完了日時finished完了日でグループ化します(週単位)。
プロジェクトprojectプロジェクトでグループ化します。
RefrefGitブランチまたはタグでグループ化します。
ソースsourceパイプラインをトリガーしたものでグループ化します。
開始日時started開始日でグループ化します(週単位)。
ステータスstatusパイプラインのステータスでグループ化します。

メトリクス

メトリック名前説明
キャンセル率canceledRateキャンセルされたパイプラインの、全パイプラインに対する比率。
期間クォンタイルdurationQuantileパイプライン期間の95パーセンタイル値(秒単位)。
失敗率failureRate失敗したパイプラインの、全パイプラインに対する比率。
スキップ率skippedRateスキップされたパイプラインの、全パイプラインに対する比率。
成功率successRate成功したパイプラインの、全パイプラインに対する比率。
合計数totalCount完了したパイプラインの総数。

日付ディメンションは固定のweekly粒度を使用し、durationQuantileは固定の0.95クォンタイルを使用します。設定可能な粒度とクォンタイルに関するサポートは、GLQLイシュー130で提案されています。

ソートフィールド

選択したディメンションまたはメトリクスに含まれる任意のフィールドでソートします。詳細については、アナリティクスモードのソートを参照してください。

  • 過去30日間のRefごとのパイプラインの成功率と失敗率:

    ```glql
    title: "Pipeline success and failure rates by branch (last 30 days)"
    display: table
    mode: analytics
    query: type = Pipeline and project = "gitlab-org/gitlab" and finished >= -30d
    dimensions: ref as "Ref"
    metrics: totalCount as "Total", successRate as "Success rate", failureRate as "Failure rate"
    sort: totalCount desc
    ```
  • 特定のRefに関する週ごとのパイプライン期間トレンド:

    ```glql
    title: "Weekly pipeline duration trend for master"
    display: table
    mode: analytics
    query: type = Pipeline and project = "gitlab-org/gitlab" and ref = "master" and finished >= -90d
    dimensions: finished as "Week"
    metrics: totalCount as "Total", durationQuantile as "p95 duration (s)"
    sort: finished desc
    ```
  • グループの全体的なパイプラインメトリクス(グループ化なし):

    ```glql
    title: "Overall pipeline metrics for gitlab-org"
    display: table
    mode: analytics
    query: type = Pipeline and group = "gitlab-org" and finished >= -7d
    metrics: totalCount as "Total", successRate as "Success rate", failureRate as "Failure rate", canceledRate as "Canceled rate"
    ```
  • ソースとステータスでグループ化され、日付範囲でフィルタリングされたパイプライン:

    ```glql
    title: "Pipelines by source and status (Q1 2026)"
    display: table
    mode: analytics
    query: type = Pipeline and project = "gitlab-org/gitlab" and finished >= "2026-01-01" and finished <= "2026-03-31"
    dimensions: source as "Source", status as "Status"
    metrics: totalCount as "Total"
    sort: totalCount desc
    ```
  • グループ全体の特定のrefsとステータスにフィルタリング:

    ```glql
    title: "Default branch pipeline outcomes across gitlab-org"
    display: table
    mode: analytics
    query: type = Pipeline and group = "gitlab-org" and finished >= -14d and ref in ("master", "main") and status in ("success", "failed")
    dimensions: project as "Project", status as "Status"
    metrics: totalCount as "Total", successRate as "Success rate"
    sort: totalCount desc
    limit: 20
    ```