Skip to content

Commit 62bf3d7

Browse files
committed
Manually apply suggested edits from @SuperQ
Signed-off-by: Conall O'Brien <conall@conall.net>
1 parent 1cb09cd commit 62bf3d7

1 file changed

Lines changed: 8 additions & 9 deletions

File tree

docs/practices/labels.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -15,23 +15,22 @@ Prometheus labels can come from both the target and from
1515

1616
By default Prometheus configures two primary discovery target labels.
1717

18-
* `job`
19-
* The `job` label is one of the few ubiquitious labels, set at scrape time, and is
20-
used to identify metrics scraped from the same target/exporter.
21-
* If not specified in PromQL expressions, they will match unrelated metrics with the same name. This is especially true in a multi system or multi tenant installation
18+
- `job`
19+
- The `job` label is one of the few ubiquitious labels, set at scrape time, and is
20+
used to identify metrics scraped from the same target/exporter.
21+
- If not specified in PromQL expressions, they will match unrelated metrics with the same name. This is especially true in a multi system or multi tenant installation
2222

2323
WARNING: When using `without`, be careful not to strip out the `job` label accidentally.
2424

25-
* `instance`
26-
* The `instance` label will include the `ip:port` what was scraped, providing a
27-
crucial breadcrumb for debugging scrape time issues
25+
- `instance`
26+
- The `instance` label will include the `ip:port` what was scraped
2827

2928
### General Labelling Advice
3029

3130
Use labels to differentiate the characteristics of the thing that is being measured:
3231

33-
* `api_http_requests_total` - differentiate request types: `operation="create|update|delete"`
34-
* `api_request_duration_seconds` - differentiate request stages: `stage="extract|transform|load"`
32+
- `api_http_requests_total` - differentiate request types: `operation="create|update|delete"`
33+
- `api_request_duration_seconds` - differentiate request stages: `stage="extract|transform|load"`
3534

3635
Do not put the label names in the metric name, as this introduces redundancy
3736
and will cause confusion if the respective labels are aggregated away.

0 commit comments

Comments
 (0)