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

コントリビュート

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

コントリビュートは、プロジェクトまたはグループ全体のコントリビュートアクティビティ(コミット、イシュー、マージリクエストなど)に関する集計メトリクスを提供するデータソースです。

許可されるモード

許可されるスコープ

スコープ説明
project特定のプロジェクトにおけるコントリビュートをクエリする。
groupサブグループを含むグループ内のすべてのプロジェクトにおけるコントリビュートをクエリする。

クエリフィールド

フィールド名前演算子
作成日created=><>=<=
ユーザーuser=in

作成日

説明: コントリビュートが作成された日付でコントリビュートをフィルタリングします。

指定可能な値の型:

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

ノート:

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

ユーザー

説明: コントリビュートを行ったユーザーでフィルタリングします。

指定可能な値の型:

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

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

ディメンション

ディメンション名前説明
作成日createdコントリビュートの作成日で月ごとのバケットにグループ化します。

メトリクス

メトリック名前説明
合計数totalCountコントリビュートの合計数。
ユーザー数usersCountユニークコントリビューターの数。

ソートフィールド

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

  • プロジェクトの月ごとのコントリビュートトレンド:

    ```glql
    title: "Monthly contributions"
    display: table
    mode: analytics
    query: type = Contribution and project = "gitlab-org/gitlab"
    dimensions: created as "Month"
    metrics: totalCount as "Total", usersCount as "Contributors"
    sort: created desc
    ```
  • 一連のユーザーのコントリビュートトレンド:

    ```glql
    title: "Contributions from a set of users"
    display: table
    mode: analytics
    query: type = Contribution and project = "gitlab-org/gitlab" and user in (1234567, 2345678) and created >= -90d
    dimensions: created as "Month"
    metrics: totalCount as "Total"
    sort: created desc
    ```
  • 過去1年間の特定ユーザーの月ごとのコントリビュート:

    ```glql
    title: "User contribution history"
    display: table
    mode: analytics
    query: type = Contribution and group = "gitlab-org" and user = 1234567 and created >= -365d
    dimensions: created as "Month"
    metrics: totalCount as "Total"
    sort: created asc
    ```
  • グループ全体のコントリビュートメトリクス(グループ化なし):

    ```glql
    title: "Overall contribution metrics"
    display: table
    mode: analytics
    query: type = Contribution and group = "gitlab-org" and created >= -90d
    metrics: totalCount as "Total", usersCount as "Contributors"
    ```