Metric Dashboard Terminology

A recent slack discussion wanted to standardize how we define a component in a dashboard. Is it a chart? Or is it a panel?

This issue is meant to continue that discussion and have a place to standardize our terminology. As an outcome of this issue, we should update our documentation to include the standard terms and/or update the handbook.

Definitions and Documentation

@mikolaj_wawrzyniak summed it up like this:

panel contain single displayable unit (most of a times it is a chart) https://docs.gitlab.com/ee/user/project/integrations/prometheus.html#panel-panels-properties

panels are included into some group (panel_groups) https://docs.gitlab.com/ee/user/project/integrations/prometheus.html#panel-group-panel_groups-properties

Visuals

This is a Panel:

Screenshot_2020-06-10_at_17.02.19

This is a Panel Group:

Screenshot_2020-06-10_at_17.03.01

Diagram

To show some of the different terms we use, here is a diagram with how components are related:

Edited by Matt Nohr