diff options
author | Clement Ho <clemmakesapps@gmail.com> | 2018-03-20 23:15:24 +0000 |
---|---|---|
committer | Clement Ho <clemmakesapps@gmail.com> | 2018-03-20 23:15:24 +0000 |
commit | 7887835561c9b5b74921fa1842336adafad07c20 (patch) | |
tree | 61e132b4ce62ad9dabb1465c975e56082fee3d41 | |
parent | 38632aa5fb393e60a1c33f74df1513c4c403a47d (diff) | |
parent | 9eb30418c6dc3e7cfde438dc3b5a7213d5ab8292 (diff) | |
download | gitlab-ce-7887835561c9b5b74921fa1842336adafad07c20.tar.gz |
Merge branch 'docs-fe-monitoring' into 'master'
Add performance monitoring docs for the new FE guide
See merge request gitlab-org/gitlab-ce!17809
-rw-r--r-- | doc/development/new_fe_guide/development/performance.md | 15 |
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..244dfb3756f 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 in 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. + +These pages can be found inside a text file in the gitlab-build-images [repository](https://gitlab.com/gitlab-org/gitlab-build-images) called [gitlab.txt](https://gitlab.com/gitlab-org/gitlab-build-images/blob/master/scripts/gitlab.txt) +Any frontend engineer can contribute to this dashboard. They can contribute by adding or removing urls of pages from this text file. Please have a [frontend monitoring expert](https://about.gitlab.com/team) review your changes 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%](https://sites.google.com/a/webpagetest.org/docs/using-webpagetest/metrics/speed-index) + +For these metrics, lower numbers are better as it means that the website is more performant. |