From 48b522e7f347dc346884e0be055bf4f9a024c8d6 Mon Sep 17 00:00:00 2001 From: Tigran Najaryan <4194920+tigrannajaryan@users.noreply.github.com> Date: Mon, 13 Jun 2022 14:33:49 -0400 Subject: [PATCH] Clarify when "count" is used instead of pluralization (#2613) --- specification/metrics/semantic_conventions/README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/specification/metrics/semantic_conventions/README.md b/specification/metrics/semantic_conventions/README.md index 941a354bf..ca4aba539 100644 --- a/specification/metrics/semantic_conventions/README.md +++ b/specification/metrics/semantic_conventions/README.md @@ -10,6 +10,7 @@ * [Name Reuse Prohibition](#name-reuse-prohibition) * [Units](#units) * [Pluralization](#pluralization) + + [Use `count` Instead of Pluralization](#use-count-instead-of-pluralization) - [General Metric Semantic Conventions](#general-metric-semantic-conventions) * [Instrument Naming](#instrument-naming) * [Instrument Units](#instrument-units) @@ -105,6 +106,17 @@ should not be pluralized, even if many data points are recorded. * `system.paging.faults`, `system.disk.operations`, and `system.network.packets` should be pluralized, even if only a single data point is recorded. +#### Use `count` Instead of Pluralization + +If the value being recorded represents the count of concepts signified +by the namespace then the metric should be named `count` (within its namespace). +The pluralization rule does not apply in this case. + +For example if we have a namespace `system.processes` which contains all metrics related +to the processes then to represent the count of the processes we can have a metric named +`system.processes.count`. The suffix `count` here indicates that it is the count of +`system.processes`. + ## General Metric Semantic Conventions The following semantic conventions aim to keep naming consistent. They