Duoワークフロー

このデータソースは、プロジェクトまたはグループ全体で実行されたGitLab Duo Agent Platformフロー（Duoワークフローとも呼ばれます）に関する集計されたメトリクス（使用したクレジット数を含む）を提供します。

許可されるモード

• analytics

許可されるスコープ

複数のグループまたはプロジェクトにわたってGitLab Duoワークフローを集計するには、in演算子を使用したリストを使用します。詳細については、複数のグループとプロジェクトを参照してください。

クエリフィルター

結果をフィルタリングするには、queryパラメータでこれらのフィールドを使用します。

アクティブな日数

説明: ユーザーが選択した期間内にフローを作成した個別の日数でフローをフィルタリングします。activeDays = 1は、ちょうど1日だけアクティブだったユーザーに一致します。

許可される値の型: Number

ノート:

• このカウントは、ユーザーごとの選択された期間全体を対象とします。
• 範囲を指定するために2つの範囲演算子を組み合わせることができます。例: activeDays >= 2 and activeDays <= 5。ただし、同じフィールドに対して=を別の比較と組み合わせることはできません。

作成日

説明: フローを作成日でフィルタリングします。複数のcreated条件を使用して、指定した期間を定義します。

指定可能な値の型:

• AbsoluteDate（形式はYYYY-MM-DD）
• RelativeDate（形式は<sign><digit><unit>で、signは+、-、または省略、digitは整数、unitはd（日）、w（週）、m（月）、またはy（年）のいずれか）

ノート:

• =演算子の場合、GLQLはユーザーのタイムゾーンでの00:00から23:59までの時間範囲を考慮します。

フロータイプ

説明: フローをそのタイプでフィルタリングします。例: software_development、code_review/v1。

指定可能な値の型:

• String
• List（複数の値にはinまたはnot in演算子を使用）

使用されたフロータイプ

説明: ユーザーが選択した期間内に実行した個別のフロータイプの数でフローをフィルタリングします。flowTypesUsed >= 2は、2つ以上のフロータイプを使用したユーザーに一致します。

許可される値の型: Number

ノート:

• このカウントは、ユーザーごとの選択された期間全体を対象とします。
• 同じ組み合わせルールが適用されます: 範囲を指定するために2つの範囲演算子を使用しますが、同じフィールドに対して=を別の比較と組み合わせることはできません。

ステータス

説明: フローをそのライフサイクルステータスでフィルタリングします。

指定可能な値の型:

• Enum、created、running、paused、finished、failed、stopped、input_required、plan_approval_required、またはtool_call_approval_requiredのいずれか1つ
• List（複数の値にはinまたはnot in演算子を使用）

ノート:

• 3つの*_requiredステータスは、ユーザーの対応待ちのフローであり、pausedとは異なります。
• ステータスは大文字と小文字を区別せずに照合されます。completedやabortedなどの他のつづりは受け付けられません。

ユーザー

説明: フローを実行したユーザーでフィルタリングします。

指定可能な値の型:

• Number（ユーザーID）
• List（複数のユーザーIDにはinまたはnot in演算子を使用）

ディメンション

メトリクス

ノート:

• returningUsersCount、joinedUsersCount、churnedUsersCount、およびpreviousPeriodUsersCountメトリクスは、各createdバケットを直前のものと比較するため、createdディメンションも選択されている場合にのみ有効です。createdフィルターだけでは不十分です。
• mergedMrCount、closedMrCount、およびopenMrCountメトリクスは、フローが作成し、後にマージされた、マージせずにクローズされた、またはまだオープンであるマージリクエストをカウントします。これらはそれらのマージリクエストの現在の状態に遅れることがあるため、最近マージされたマージリクエストがオープンとしてカウントされ続けることがあります。

ソートフィールド

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

例

• 過去30日間のフロータイプ別のフロー:

  yaml

  ```glql
  title: "Duo workflows by flow type (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  dimensions: flowType as "Flow"
  metrics: totalCount as "Flows", usersCount as "Users", creditsUsedSum as "Credits"
  sort: totalCount desc
  ```

• 月次クレジット使用量の推移:

  yaml

  ```glql
  title: "Monthly Duo workflow credit usage trend"
  display: columnChart
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -90d
  dimensions: created(monthly) as "Month"
  metrics: creditsUsedSum as "Credits used"
  sort: created asc
  ```

• チャットフローを除く月次クレジット使用量:

  yaml

  ```glql
  title: "Monthly Duo workflow credits, excluding chat"
  display: columnChart
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -90d and flowType not in ("chat", "agentic_chat/v1")
  dimensions: created(monthly) as "Month", flowType as "Flow"
  metrics: creditsUsedSum as "Credits used"
  sort: created asc
  ```

• 過去30日間のモデル別クレジット:

  yaml

  ```glql
  title: "Duo workflow credits by model (last 30 days)"
  display: barChart
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  dimensions: model as "Model"
  metrics: creditsUsedSum as "Credits used"
  sort: creditsUsedSum desc
  ```

• 過去30日間のクレジット別トップユーザー:

  yaml

  ```glql
  title: "Top users by Duo workflow credits (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  dimensions: user as "User"
  metrics: totalCount as "Flows", creditsUsedSum as "Credits", creditsUsedMean as "Avg credits per flow"
  sort: creditsUsedSum desc
  limit: 10
  ```

• 過去30日間のステータス別フロー:

  yaml

  ```glql
  title: "Duo workflows by status (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  dimensions: status as "Status"
  metrics: totalCount as "Flows", createdMrCountSum as "MRs created", mergedMrCountSum as "MRs merged", openMrCountSum as "MRs open"
  sort: status asc
  ```

• 週次ユーザー維持率:

  yaml

  ```glql
  title: "Weekly Duo workflow user retention"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -90d
  dimensions: created(weekly) as "Week"
  metrics: usersCount as "Users", returningUsersCount as "Returning", joinedUsersCount as "Joined", churnedUsersCount as "Churned"
  sort: created desc
  ```

• 過去30日間のアクティビティ階層およびフロータイプ別ユーザー:

  yaml

  ```glql
  title: "Duo workflow users by activity tier (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  dimensions: userTier(thresholds=[4, 25, 100]) as "Tier", flowType as "Flow"
  metrics: totalCount as "Flows", usersCount as "Users"
  sort: userTier asc
  ```

• 過去30日間のステータス別フロー数の比較:

  yaml

  ```glql
  title: "Duo workflows by outcome (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  metrics: totalCount as "All", totalCount(status="finished") as "Completed", totalCount(status=["paused", "input_required"]) as "Waiting", totalCount(status="failed") as "Failed"
  ```

• 過去30日間のグループ比較:

  yaml

  ```glql
  title: "Duo workflow usage by subgroup (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  dimensions: group(depth=2) as "Group"
  metrics: usersCount as "Users", creditsUsedSum as "Credits"
  sort: usersCount desc
  ```

• グループ化なしの全体使用状況:

  yaml

  ```glql
  title: "Duo workflow usage overview (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  metrics: totalCount as "Flows", usersCount as "Users", projectsCount as "Projects", creditsUsedQuantile(0.5) as "Median credits"
  ```