diff options
Diffstat (limited to 'doc/operations/metrics')
-rw-r--r-- | doc/operations/metrics/alerts.md | 6 | ||||
-rw-r--r-- | doc/operations/metrics/dashboards/default.md | 2 | ||||
-rw-r--r-- | doc/operations/metrics/dashboards/panel_types.md | 2 | ||||
-rw-r--r-- | doc/operations/metrics/dashboards/variables.md | 6 | ||||
-rw-r--r-- | doc/operations/metrics/dashboards/yaml.md | 14 | ||||
-rw-r--r-- | doc/operations/metrics/embed.md | 10 | ||||
-rw-r--r-- | doc/operations/metrics/embed_grafana.md | 2 | ||||
-rw-r--r-- | doc/operations/metrics/index.md | 2 |
8 files changed, 22 insertions, 22 deletions
diff --git a/doc/operations/metrics/alerts.md b/doc/operations/metrics/alerts.md index a3d741b78ea..44999ad7cd6 100644 --- a/doc/operations/metrics/alerts.md +++ b/doc/operations/metrics/alerts.md @@ -61,7 +61,7 @@ Prometheus server to use the ## Trigger actions from alerts **(ULTIMATE)** -> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/4925) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 11.11. +> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/4925) in GitLab 11.11. Alerts can be used to trigger actions, like opening an issue automatically (disabled by default since `13.1`). To configure the actions: @@ -83,7 +83,7 @@ values extracted from the [`alerts` field in webhook payload](https://prometheus - `full_query`: Alert query extracted from the payload's `generatorURL` field - Optional list of attached annotations extracted from `annotations/*` - Alert [GFM](../../user/markdown.md): GitLab Flavored Markdown from the payload's `annotations/gitlab_incident_markdown` field. -- Alert Severity (introduced in GitLab version [13.9](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/50871): +- Alert Severity ([Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/50871) in GitLab version 13.9): Extracted from the alert payload field `labels/severity`. Maps case-insensitive value to [Alert's severity](../incident_management/alerts.md#alert-severity): - **Critical**: `critical`, `s1`, `p1`, `emergency`, `fatal`, or any value not in this list @@ -107,7 +107,7 @@ of the project. ### Recovery alerts -> - [From GitLab Ultimate 12.5](https://gitlab.com/gitlab-org/gitlab/-/issues/13401), when GitLab receives a recovery alert, it automatically closes the associated issue. +> [From GitLab 12.5](https://gitlab.com/gitlab-org/gitlab/-/issues/13401), when GitLab receives a recovery alert, it automatically closes the associated issue. The alert in GitLab will be automatically resolved when Prometheus sends a payload with the field `status` set to `resolved`. diff --git a/doc/operations/metrics/dashboards/default.md b/doc/operations/metrics/dashboards/default.md index 2ba7a4e0d87..2be26e843c4 100644 --- a/doc/operations/metrics/dashboards/default.md +++ b/doc/operations/metrics/dashboards/default.md @@ -30,7 +30,7 @@ This dashboard requires Kubernetes v1.14 or higher, due to the in Kubernetes 1.14. This dashboard displays CPU, memory, network and disk metrics for the pods in your -[connected K8s cluster](../../../user/project/clusters/index.md). It provides a +[connected Kubernetes cluster](../../../user/infrastructure/clusters/index.md). It provides a [variable selector](templating_variables.md#metric_label_values-variable-type) at the top of the dashboard to select which pod's metrics to display. diff --git a/doc/operations/metrics/dashboards/panel_types.md b/doc/operations/metrics/dashboards/panel_types.md index dc96e2556ac..140e18b5b13 100644 --- a/doc/operations/metrics/dashboards/panel_types.md +++ b/doc/operations/metrics/dashboards/panel_types.md @@ -62,12 +62,10 @@ panel_groups: query_range: 'http_requests_total' label: '# of Requests' unit: 'count' - metrics: - id: anomaly_requests_upper_limit query_range: 10000 label: 'Max # of requests' unit: 'count' - metrics: - id: anomaly_requests_lower_limit query_range: 2000 label: 'Min # of requests' diff --git a/doc/operations/metrics/dashboards/variables.md b/doc/operations/metrics/dashboards/variables.md index 4b083284819..fa79524883d 100644 --- a/doc/operations/metrics/dashboards/variables.md +++ b/doc/operations/metrics/dashboards/variables.md @@ -8,7 +8,9 @@ info: To determine the technical writer assigned to the Stage/Group associated w ## Query variables -Variables can be specified using double curly braces, such as `"{{ci_environment_slug}}"` ([added](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/20793) in GitLab 12.7). +> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/20793) in GitLab 12.7. + +Variables can be specified using double curly braces, such as `"{{ci_environment_slug}}"`. Support for the `"%{ci_environment_slug}"` format was [removed](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/31581) in GitLab 13.0. @@ -66,5 +68,5 @@ avg(sum(container_memory_usage_bytes{container_name!="{{pod}}"}) by (job)) witho The URL for this query would be: ```plaintext -http://gitlab.com/<user>/<project>/-/environments/<environment_id>/metrics?dashboard=.gitlab%2Fdashboards%2Fcustom.yml&pod=POD +https://gitlab.com/<user>/<project>/-/environments/<environment_id>/metrics?dashboard=.gitlab%2Fdashboards%2Fcustom.yml&pod=POD ``` diff --git a/doc/operations/metrics/dashboards/yaml.md b/doc/operations/metrics/dashboards/yaml.md index 45803598a40..8068a66d5c4 100644 --- a/doc/operations/metrics/dashboards/yaml.md +++ b/doc/operations/metrics/dashboards/yaml.md @@ -14,7 +14,7 @@ Dashboards have several components: The following tables outline the details of expected properties. -## **Dashboard (top-level) properties** +## Dashboard (top-level) properties | Property | Type | Required | Description | | ------ | ------ | ------ | ------ | @@ -23,7 +23,7 @@ The following tables outline the details of expected properties. | `templating` | hash | no | Top level key under which templating related options can be added. | | `links` | array | no | Add links to display on the dashboard. | -## **Templating (`templating`) properties** +## Templating (`templating`) properties | Property | Type | Required | Description | | -------- | ---- | -------- | ----------- | @@ -31,7 +31,7 @@ The following tables outline the details of expected properties. Read the documentation on [templating](templating_variables.md). -## **Links (`links`) properties** +## Links (`links`) properties | Property | Type | Required | Description | | -------- | ---- | -------- | ----------- | @@ -41,7 +41,7 @@ Read the documentation on [templating](templating_variables.md). Read the documentation on [links](index.md#add-related-links-to-custom-dashboards). -## **Panel group (`panel_groups`) properties** +## Panel group (`panel_groups`) properties Dashboards display panel groups in the order they are listed in the dashboard YAML file. @@ -55,7 +55,7 @@ is no longer used. Panels in a panel group are laid out in rows consisting of two panels per row. An exception to this rule are single panels on a row: these panels take the full width of their containing row. -## **Panel (`panels`) properties** +## Panel (`panels`) properties Dashboards display panels in the order they are listed in the dashboard YAML file. @@ -72,7 +72,7 @@ is no longer used. | `metrics` | array | yes | The metrics which should be displayed in the panel. Any number of metrics can be displayed when `type` is `area-chart` or `line-chart`, whereas only 3 can be displayed when `type` is `anomaly-chart`. | | `links` | array | no | Add links to display on the chart's [context menu](index.md#chart-context-menu). | -## **Axis (`panels[].y_axis`) properties** +## Axis (`panels[].y_axis`) properties | Property | Type | Required | Description | | ----------- | ------ | ----------------------------- | -------------------------------------------------------------------- | @@ -80,7 +80,7 @@ is no longer used. | `format` | string | no, defaults to `engineering` | Unit format used. See the [full list of units](yaml_number_format.md). | | `precision` | number | no, defaults to `2` | Number of decimal places to display in the number. | | -## **Metrics (`metrics`) properties** +## Metrics (`metrics`) properties | Property | Type | Required | Description | | ------ | ------ | ------ | ------ | diff --git a/doc/operations/metrics/embed.md b/doc/operations/metrics/embed.md index d773d04f1cc..e84c190e08d 100644 --- a/doc/operations/metrics/embed.md +++ b/doc/operations/metrics/embed.md @@ -96,17 +96,17 @@ a chart corresponding to the query can be included if these requirements are met ## Embedding cluster health charts -> - [Introduced](<https://gitlab.com/gitlab-org/gitlab/-/issues/40997>) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 12.9. -> - [Moved](<https://gitlab.com/gitlab-org/gitlab/-/issues/208224>) to GitLab core in 13.2. +> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/40997) in GitLab 12.9. +> - [Moved](https://gitlab.com/gitlab-org/gitlab/-/issues/208224) from GitLab Ultimate to GitLab Free in 13.2. -[Cluster Health Metrics](../../user/project/clusters/index.md#visualizing-cluster-health) +[Cluster Health Metrics](../../user/infrastructure/clusters/manage/clusters_health.md) can also be embedded in [GitLab-flavored Markdown](../../user/markdown.md). To embed a metric chart, include a link to that chart in the form `https://<root_url>/<project>/-/cluster/<cluster_id>?<query_params>` anywhere that GitLab-flavored Markdown is supported. To generate and copy a link to the chart, follow the instructions in the -[Cluster Health Metric documentation](../../user/project/clusters/index.md#visualizing-cluster-health). +[Cluster Health Metric documentation](../../user/infrastructure/clusters/manage/clusters_health.md). The following requirements must be met for the metric to unfurl: @@ -114,7 +114,7 @@ The following requirements must be met for the metric to unfurl: - Prometheus must be monitoring the cluster. - The user must be allowed access to the project cluster metrics. - The dashboards must be reporting data on the - [Cluster Health Page](../../user/project/clusters/index.md#visualizing-cluster-health) + [Cluster Health Page](../../user/infrastructure/clusters/manage/clusters_health.md) If the above requirements are met, then the metric unfurls as seen below. diff --git a/doc/operations/metrics/embed_grafana.md b/doc/operations/metrics/embed_grafana.md index 473b335d4c5..81b1f8a3bc6 100644 --- a/doc/operations/metrics/embed_grafana.md +++ b/doc/operations/metrics/embed_grafana.md @@ -51,7 +51,7 @@ To set up the Grafana API in Grafana: section. 1. To enable the integration, check the **Active** checkbox. 1. For **Grafana URL**, enter the base URL of the Grafana instance. -1. For **API Token**, enter the Admin API token you just generated. +1. For **API Token**, enter the Administrator API token you just generated. 1. Click **Save Changes**. ### Generate a link to a panel diff --git a/doc/operations/metrics/index.md b/doc/operations/metrics/index.md index 07e71fe79ef..f09b9f35d88 100644 --- a/doc/operations/metrics/index.md +++ b/doc/operations/metrics/index.md @@ -111,7 +111,7 @@ dashboard is visible to authenticated and non-authenticated users. ## Adding custom metrics -> - [Moved](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/28527) to GitLab Free in 12.10. +> - [Moved](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/28527) from GitLab Premium to GitLab Free in 12.10. Custom metrics can be monitored by adding them on the monitoring dashboard page. After saving them, they display on the environment metrics dashboard provided that either: |