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

エージェントプラットフォームセッション

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

このデータソースは、プロジェクトまたはグループ全体でのGitLab Duo Agent Platformセッション使用状況に関する集計メトリクスを提供します。

許可されるモード

許可されたスコープ

スコープ説明
project特定のプロジェクトでGitLab Duo Agent Platformセッションをクエリします。
groupグループ内のすべてのプロジェクト(サブグループを含む)でGitLab Duo Agent Platformセッションをクエリします。

詳細については、スコープを参照してください。

クエリフィールド

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

フィールド名前(およびエイリアス)演算子
作成済みcreated(opened、openedAt、createdAt)=、>、<、>=、<=
フロータイプflowType=、in
ユーザーuser=、in

作成済み

説明: セッションが作成された日時でフィルタリングします。範囲演算子を使用して時間枠を定義します。

指定可能な値の型:

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

ノート:

  • =演算子の場合、時間範囲はユーザーのタイムゾーンで00:00から23:59までとみなされます。

フロータイプ

説明: セッションのフロータイプでフィルタリングします。例: chat、code_review/v1。

指定可能な値の型:

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

ユーザー

説明: セッションを所有するユーザーでフィルタリングします。

指定可能な値の型:

  • Number(ユーザーID)
  • List(複数のユーザーIDにはin演算子を使用)

ユーザー名によるフィルタリングのサポートは、イシュー599750で追跡されています。

ディメンション

ディメンション名前説明
作成済みcreated日付でグループ化します。granularityパラメータにはweeklyまたはmonthlyを指定できます(デフォルト: weekly)。例: created(monthly)。
フロータイプflowTypeセッションのフロータイプでグループ化します。
プロジェクトprojectプロジェクトでグループ化します。プロジェクトにスコープされていないセッションは、プロジェクトなしで単一の行にグループ化されます。
ユーザーuserユーザーでグループ化します(アバター、名前、ユーザー名を表示)。

メトリクス

メトリック名前説明
完了率completionRate完了したセッションの割合(0から1の値)。
最大期間durationMax完了したセッションの最長期間(秒単位)。
平均期間durationMean完了したセッションの平均期間(秒単位)。
最小期間durationMin完了したセッションの最短期間(秒単位)。
期間分位durationQuantile指定された分位における完了したセッションの期間(秒単位)。quantileパラメータには0.01から0.99の値を指定できます(デフォルト: 0.5)。例: durationQuantile(0.95)。
期間合計durationSum完了したセッションの総期間(秒単位)。
完了数finishedCount完了したセッションの数。
合計数totalCountセッションの総数。
ユーザー数usersCountユニークユーザーの数。

ソートフィールド

任意のディメンション、または以下のメトリクスでソートします:

  • totalCount
  • finishedCount
  • usersCount
  • completionRate
  • durationQuantile。

これらのメトリクスはソートできません:

  • durationMean
  • durationMin
  • durationMax
  • durationSum

詳細については、アナリティクスモードのソートを参照してください。

例

  • 過去30日間のフロータイプ別セッション:

    yaml
    ```glql
    title: "Agent Platform sessions by flow (last 30 days)"
    display: table
    mode: analytics
    query: type = AgentPlatformSession and group = "gitlab-org" and created > -30d
    dimensions: flowType as "Flow"
    metrics: totalCount as "Total", finishedCount as "Finished", completionRate as "Completion rate"
    sort: totalCount desc
    ```
  • 週次セッショントレンド:

    yaml
    ```glql
    title: "Weekly Agent Platform session trend"
    display: columnChart
    mode: analytics
    query: type = AgentPlatformSession and group = "gitlab-org" and created > -90d
    dimensions: created(weekly) as "Week"
    metrics: totalCount as "Total", usersCount as "Users"
    sort: created desc
    ```
  • ユーザーごとのセッション、平均期間を含む:

    yaml
    ```glql
    title: "Agent Platform sessions by user"
    display: table
    mode: analytics
    query: type = AgentPlatformSession and group = "gitlab-org" and created > -30d
    dimensions: user as "User"
    metrics: totalCount as "Total", durationMean as "Avg duration"
    sort: totalCount desc
    limit: 10
    ```
  • グループ化なしの全体的な完了率と中央値期間:

    yaml
    ```glql
    title: "Agent Platform session completion (last 30 days)"
    display: table
    mode: analytics
    query: type = AgentPlatformSession and group = "gitlab-org" and created > -30d
    metrics: totalCount as "Total", completionRate as "Completion rate", durationQuantile(0.5) as "Median duration"
    ```