summaryrefslogtreecommitdiff
path: root/doc/user/admin_area/analytics/instance_statistics.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/user/admin_area/analytics/instance_statistics.md')
-rw-r--r--doc/user/admin_area/analytics/instance_statistics.md46
1 files changed, 44 insertions, 2 deletions
diff --git a/doc/user/admin_area/analytics/instance_statistics.md b/doc/user/admin_area/analytics/instance_statistics.md
index bac0e845d2c..0d62d30435d 100644
--- a/doc/user/admin_area/analytics/instance_statistics.md
+++ b/doc/user/admin_area/analytics/instance_statistics.md
@@ -1,9 +1,23 @@
-# Instance Statistics
+---
+stage: Manage
+group: Value Stream Management
+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/#designated-technical-writers
+---
-> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/235754) in GitLab 13.4.
+# Instance Statistics **(CORE)**
+
+> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/235754) in GitLab 13.5 behind a feature flag, disabled by default.
+> - [Became enabled by default](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/46962) in GitLab 13.6.
+> - It's enabled on GitLab.com.
+> - It's recommended for production use.
+
+CAUTION: **Warning:**
+This feature might not be available to you. Check the **version history** note above for details.
Instance Statistics gives you an overview of how much data your instance contains, and how quickly this volume is changing over time.
+To see Instance Statistics, go to **Admin Area > Analytics > Instance Statistics**.
+
## Total counts
At the top of the page, Instance Statistics shows total counts for:
@@ -16,3 +30,31 @@ At the top of the page, Instance Statistics shows total counts for:
- Pipelines
These figures can be useful for understanding how much data your instance contains in total.
+
+## Past year trend charts
+
+Instance Statistics also displays line charts that show total counts per month, over the past 12 months,
+in the categories shown in [Total counts](#total-counts).
+
+These charts help you visualize how rapidly these records are being created on your instance.
+
+![Instance Activity Pipelines chart](img/instance_activity_pipelines_chart_v13_6.png)
+
+### Enable or disable Instance Statistics
+
+In GitLab version 13.5 only, Instance Statistics was under development and not ready for production use.
+It was deployed behind a feature flag that was **disabled by default**.
+[GitLab administrators with access to the GitLab Rails console](../../../administration/feature_flags.md)
+can opt to enable it.
+
+To enable it:
+
+```ruby
+Feature.enable(:instance_statistics)
+```
+
+To disable it:
+
+```ruby
+Feature.disable(:instance_statistics)
+```