debian-mirror-gitlab/doc/user/analytics/ci_cd_analytics.md

94 lines
5.2 KiB
Markdown
Raw Normal View History

2021-03-08 18:12:59 +05:30
---
stage: Release
group: Release
info: 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
---
2021-09-04 01:27:46 +05:30
# CI/CD Analytics **(FREE)**
2021-03-08 18:12:59 +05:30
2021-09-04 01:27:46 +05:30
## Pipeline success and duration charts
2021-03-08 18:12:59 +05:30
2021-09-04 01:27:46 +05:30
> [Renamed](https://gitlab.com/gitlab-org/gitlab/-/issues/38318) to CI/CD Analytics in GitLab 12.8.
2021-03-08 18:12:59 +05:30
GitLab tracks the history of your pipeline successes and failures, as well as how long each pipeline
ran. To view this information, go to **Analytics > CI/CD Analytics**.
View successful pipelines:
![Successful pipelines](img/pipelines_success_chart.png)
View pipeline duration history:
![Pipeline duration](img/pipelines_duration_chart.png)
2021-12-11 22:18:48 +05:30
Pipeline statistics are gathered by collecting all available pipelines for the
project regardless of status. The data available for each individual day is based
on when the pipeline was created. The total pipeline calculation includes child
pipelines and pipelines that failed with invalid YAML. If you are interested in
filtering pipelines based on other attributes, consider using the [Pipelines API](../../api/pipelines.md#list-project-pipelines).
2021-04-29 21:17:54 +05:30
## DevOps Research and Assessment (DORA) key metrics **(ULTIMATE)**
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/275991) in GitLab 13.7.
2021-11-18 22:05:49 +05:30
> - [Added support](https://gitlab.com/gitlab-org/gitlab/-/issues/291746) for lead time for changes in GitLab 13.10.
2021-03-11 19:13:27 +05:30
Customer experience is a key metric. Users want to measure platform stability and other
post-deployment performance KPIs, and set targets for customer behavior, experience, and financial
impact. Tracking and measuring these indicators solves an important pain point. Similarly, creating
views that manage products, not projects or repositories, provides users with a more relevant data set.
Since GitLab is a tool for the entire DevOps life-cycle, information from different workflows is
integrated and can be used to measure the success of the teams.
The DevOps Research and Assessment ([DORA](https://cloud.google.com/blog/products/devops-sre/the-2019-accelerate-state-of-devops-elite-performance-productivity-and-scaling))
team developed four key metrics that the industry has widely adopted. You can use these metrics as
performance indicators for software development teams:
- Deployment frequency: How often an organization successfully releases to production.
- Lead time for changes: The amount of time it takes for code to reach production.
- Change failure rate: The percentage of deployments that cause a failure in production.
- Time to restore service: How long it takes an organization to recover from a failure in
production.
2021-04-29 21:17:54 +05:30
### Supported metrics in GitLab
The following table shows the supported metrics, at which level they are supported, and which GitLab version (API and UI) they were introduced:
2021-09-04 01:27:46 +05:30
| Metric | Level | API version | Chart (UI) version | Comments |
|---------------------------|---------------------|--------------------------------------|---------------------------------------|-----------|
| `deployment_frequency` | Project-level | [13.7+](../../api/dora/metrics.md) | [13.8+](#deployment-frequency-charts) | The [old API endpoint](../../api/dora4_project_analytics.md) was [deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/323713) in 13.10. |
2021-09-30 23:02:18 +05:30
| `deployment_frequency` | Group-level | [13.10+](../../api/dora/metrics.md) | [13.12+](#deployment-frequency-charts) | |
2021-09-04 01:27:46 +05:30
| `lead_time_for_changes` | Project-level | [13.10+](../../api/dora/metrics.md) | [13.11+](#lead-time-charts) | Unit in seconds. Aggregation method is median. |
2021-09-30 23:02:18 +05:30
| `lead_time_for_changes` | Group-level | [13.10+](../../api/dora/metrics.md) | [14.0+](#lead-time-charts) | Unit in seconds. Aggregation method is median. |
2021-09-04 01:27:46 +05:30
| `change_failure_rate` | Project/Group-level | To be supported | To be supported | |
| `time_to_restore_service` | Project/Group-level | To be supported | To be supported | |
2021-03-11 19:13:27 +05:30
2021-11-18 22:05:49 +05:30
### Deployment frequency charts
2021-03-08 18:12:59 +05:30
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/275991) in GitLab 13.8.
2021-06-08 01:23:25 +05:30
The **Analytics > CI/CD Analytics** page shows information about the deployment
frequency to the `production` environment. The environment must be part of the
[production deployment tier](../../ci/environments/index.md#deployment-tier-of-environments)
for its deployment information to appear on the graphs.
2021-03-08 18:12:59 +05:30
2021-06-08 01:23:25 +05:30
![Deployment frequency](img/deployment_frequency_charts_v13_12.png)
These charts are available for both groups and projects.
2021-04-29 21:17:54 +05:30
2021-11-18 22:05:49 +05:30
### Lead time charts
2021-04-29 21:17:54 +05:30
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/250329) in GitLab 13.11.
The charts in the **Lead Time** tab show information about how long it takes
merge requests to be deployed to a production environment.
![Lead time](img/lead_time_chart_v13_11.png)
Smaller values are better. Small lead times indicate fast, efficient deployment
processes.
For time periods in which no merge requests were deployed, the charts render a
red, dashed line.
2021-06-08 01:23:25 +05:30
2021-09-04 01:27:46 +05:30
These charts are available for both groups and projects.