1 files changed, 33 insertions, 0 deletions
diff --git a/doc/user/analytics/ci_cd_analytics.md b/doc/user/analytics/ci_cd_analytics.md
new file mode 100644
index 00000000000..beb2cbfdc58
--- /dev/null
+++ b/doc/user/analytics/ci_cd_analytics.md
@@ -0,0 +1,33 @@
+---
+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
+---
+
+# CI/CD Analytics
+
+## Pipeline success and duration charts **(CORE)**
+
+> - Introduced in GitLab 3.1.1 as Commit Stats, and later renamed to Pipeline Charts.
+> - [Renamed](https://gitlab.com/gitlab-org/gitlab/-/issues/38318) to CI/CD Analytics in GitLab 12.8.
+
+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)
+
+## Deployment frequency charts **(ULTIMATE)**
+
+> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/275991) in GitLab 13.8.
+
+The **Analytics > CI/CD Analytics** page shows information about the deployment frequency to the
+`production` environment. The environment **must** be named `production` for its deployment
+information to appear on the graphs.
+
+![Deployment frequency](img/deployment_frequency_chart_v13_8.png)