debian-mirror-gitlab/doc/api/dora4_group_analytics.md

stage	group	info	type
Release	Release	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments	reference, api

DORA4 Analytics Group API (ULTIMATE ONLY)

• Introduced in GitLab 13.9.
• It's deployed behind a feature flag, disabled by default.
• It's disabled on GitLab.com.
• It's not recommended for production use.
• To use it in GitLab self-managed instances, ask a GitLab administrator to enable it. (ULTIMATE ONLY)

WARNING: This feature might not be available to you. Check the version history note above for details.

All methods require reporter authorization.

List group deployment frequencies

Get a list of all group deployment frequencies:

GET /groups/:id/analytics/deployment_frequency?environment=:environment&from=:from&to=:to&interval=:interval

Attributes:

Attribute	Type	Required	Description
id	string	yes	The ID of the group.

Parameters:

Parameter	Type	Required	Description
environment	string	yes	The name of the environment to filter by.
from	string	yes	Datetime range to start from. Inclusive, ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
to	string	no	Datetime range to end at. Exclusive, ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
interval	string	no	The bucketing interval (all, monthly, daily).

Example request:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/analytics/deployment_frequency?environment=:environment&from=:from&to=:to&interval=:interval"

Example response:

[
  {
    "from": "2017-01-01",
    "to": "2017-01-02",
    "value": 106
  },
  {
    "from": "2017-01-02",
    "to": "2017-01-03",
    "value": 55
  }
]

Enable or disable DORA4 Analytics Group API (ULTIMATE ONLY)

DORA4 Analytics Group API is under development and not ready for production use. It is deployed behind a feature flag that is disabled by default. GitLab administrators with access to the GitLab Rails console can enable it.

To enable it:

Feature.enable(:dora4_group_deployment_frequency_api)

To disable it:

Feature.disable(:dora4_group_deployment_frequency_api)