summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/development/new_fe_guide/development/performance.md15
1 files changed, 14 insertions, 1 deletions
diff --git a/doc/development/new_fe_guide/development/performance.md b/doc/development/new_fe_guide/development/performance.md
index 26b07874f0f..f18c0ef99bb 100644
--- a/doc/development/new_fe_guide/development/performance.md
+++ b/doc/development/new_fe_guide/development/performance.md
@@ -1,3 +1,16 @@
# Performance
-> TODO: Add content
+## Monitoring
+
+We have a performance dashboard available on one of our [grafana instances](https://performance.gprd.gitlab.com/dashboard/db/sitespeed-page-summary?orgId=1). This dashboard automatically aggregates metric data from [sitespeed.io](https://sitespeed.io) every 6 hours. These changes are displayed after a set number of pages are aggregated.
+
+The aforementioned pages can be found inside a text file on the gitlab-build-images [repository](https://gitlab.com/gitlab-org/gitlab-build-images) inside the `scripts` folder under the name `gitlab.txt`
+Any frontend team member can contribute to this, by adding or removing any pages from this text file, just please ping a [frontend monitoring expert](https://about.gitlab.com/team) for review before assigning to a maintainer of the `gitlab-build-images` project. The changes will go live on the next scheduled run after the changes are merged into `master`.
+
+There are 3 recommended high impact metrics to review on each page
+
+* [First visual change](https://developers.google.com/web/tools/lighthouse/audits/first-meaningful-paint)
+* [Speed Index](https://sites.google.com/a/webpagetest.org/docs/using-webpagetest/metrics/speed-index)
+* Visual Complete 95%
+
+For these metrics, lower numbers are better as it means that the website is more performant.