Skip to content

Metrics Catalog

The Metrics-Catalog is a declarative approach to monitoring GitLab using Service-Level Monitoring.

At present, the documentation on the Metrics-Catalog requires some work, but there are several conference talks on the approach we use:

  • Service-Level Monitoring - notes on the Service-Level Monitoring implementation, including minimum sample size thresholds.
  • Monitoring Overrides - the monitoring stanza of a service definition, and the per-SLI alert overrides available under it.
  • Traffic Cessation Alerts - how we alert on an SLI that stops receiving traffic.
  • Cost Attribution - the costAttribution stanza of a service definition, and the usage recording rule it generates for the cost warehouse.

The metrics-catalog source can be found in the following locations in this project:

  1. metrics-catalog - the GitLab.com Metrics-Catalog.
  2. reference-architectures/get-hybrid - A Reference Architecture Metrics-Catalog for a GitLab Environment Toolkit Hybrid (VM+Kubernetes) GitLab deployment
  3. libsonnet - common source-code, written in Jsonnet, for generating the configuration.