group_contributions
Gets or lists a group_contributions resource.
Overview​
| Name | group_contributions |
| Type | Resource |
| Id | gitlab.analytics.group_contributions |
Fields​
The following fields are returned by SELECT queries:
- list
GraphQL response envelope
| Name | Datatype | Description |
|---|---|---|
issues_closed | integer | Number of issues closed by the user. |
issues_created | integer | Number of issues created by the user. |
merge_requests_approved | integer | Number of merge requests approved by the user. |
merge_requests_closed | integer | Number of merge requests closed by the user. |
merge_requests_created | integer | Number of merge requests created by the user. |
merge_requests_merged | integer | Number of merge requests merged by the user. |
repo_pushed | integer | Number of repository pushes the user made. |
total_events | integer | Total number of events contributed by the user. |
user | object | UserCore identity (id, username, name) |
Methods​
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list | select | full_path, from_, to_, host | Provides the aggregated contributions by users within the group and its subgroups Generated from the GitLab GraphQL schema field Group.contributions (connection of ContributionAnalyticsContribution nodes). |
Parameters​
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
from_ | string | Start date of the reporting time range. |
full_path | string | Full path of the group, for example gitlab-org |
host | string | GitLab host, with an optional port (default gitlab.com). Resolved from the GITLAB_HOST environment variable when it is set (x-stackQL-envVar); a WHERE host value always takes precedence. Self-managed instances: the provider is generated from the gitlab.com schema, so older instances may reject fields they do not serve. (default: gitlab.com, x-stackQL-envVar: GITLAB_HOST) |
to_ | string | End date of the reporting time range. The end date must be within 93 days after the start date. |
SELECT examples​
- list
Provides the aggregated contributions by users within the group and its subgroups Generated from the GitLab GraphQL schema field Group.contributions (connection of ContributionAnalyticsContribution nodes).
SELECT
issues_closed,
issues_created,
merge_requests_approved,
merge_requests_closed,
merge_requests_created,
merge_requests_merged,
repo_pushed,
total_events,
user
FROM gitlab.analytics.group_contributions
WHERE full_path = '{{ full_path }}' -- required
AND from_ = '{{ from_ }}' -- required
AND to_ = '{{ to_ }}' -- required
AND host = '{{ host }}' -- required (defaults to gitlab.com; or set GITLAB_HOST)
;