コントリビュート
- プラン: Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
コントリビュートは、プロジェクトまたはグループ全体のコントリビュートアクティビティ(コミット、イシュー、マージリクエストなど)に関する集計メトリクスを提供するデータソースです。
許可されるモード
許可されるスコープ
| スコープ | 説明 |
|---|---|
project | 特定のプロジェクトにおけるコントリビュートをクエリする。 |
group | サブグループを含むグループ内のすべてのプロジェクトにおけるコントリビュートをクエリする。 |
クエリフィールド
作成日
説明: コントリビュートが作成された日付でコントリビュートをフィルタリングします。
指定可能な値の型:
AbsoluteDate(YYYY-MM-DDの形式)RelativeDate(<sign><digit><unit>の形式。+、-、または省略された記号で、桁は整数であり、unitはd(日)、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" ```