Метрика сводит числовые наблюдения, запись журнала сохраняет событие с контекстом. Агрегат без исходных записей не восстанавливает последовательность конкретного запроса.
Метрика
Определение
Метрика — числовое наблюдение или сводка с определёнными ресурсом, единицей, временем и способом расчёта. Счётчик и текущее значение читают по-разному: интенсивность даёт прирост счётчика, а текущее значение может и снижаться.
Также ищут: metric · monitoring metric · числовая метрика · временной ряд метрик
Зачем это знать
Одинаковая подпись процента не делает показатели сопоставимыми. Для счётчика нужны разность и время, для общего процента — исходные числители и знаменатели, для текущего значения — его собственная семантика.
Карта понятия
Что подтверждено
OpenTelemetry описывает метрики как числовые измерения и сводные показатели, собранные за определённый период.
Граница применимости: Метрики OpenTelemetry; подробности отдельных событий могут потребовать журналов или трассировок.
Название, единица измерения, тип инструмента и атрибуты определяют смысл метрики; одного числового значения недостаточно.
Граница применимости: Модель метрик и семантические соглашения OpenTelemetry; часть системных соглашений ещё может развиваться.
Накопительный счётчик операций вырос со 100 до 160 за 30 секунд без сброса и потерь измерения. За интервал учтено 60 операций, средняя интенсивность — две операции в секунду. Само значение 160 не является интенсивностью.
Граница применимости: Расчёт для явно заданного накопительного счётчика одного ресурса. Не применяется к текущим значениям и не устанавливает распределение событий внутри интервала.
Текущее число занятых мест снизилось с 80 до 30. Для такого показателя уменьшение допустимо и не означает минус 50 произошедших событий. Формулу интенсивности накопительного счётчика нельзя применить только из-за числового вида показателя.
Граница применимости: Редакторское применение различия текущего значения и счётчика. Изменение занятости само по себе не раскрывает отдельные поступления и завершения за интервал.
В одинаково определённых непересекающихся группах успешны 90 из 100 и 999 из 1000 операций. Вместе это 1089 из 1100, то есть 99%. Обычное среднее 90% и 99,9% даёт 94,95% и не является общей долей этих операций.
Граница применимости: Редакторская арифметика для одного окна и одинаковых правил подсчёта. Дубликатов и неизвестных исходов нет; каждая операция входит в общий знаменатель один раз.
Не путать
Метрика становится показателем услуги при явной связи с пользовательской операцией и правилами измерения. Одного имени счётчика или графика для SLI недостаточно.
Что проверить
- Установите ресурс, единицу и тип показателя.
- Отделите счётчик от текущего значения.
- Проверьте сбросы и полноту интервала.
- Для интенсивности сохраните разность и длительность.
- Для объединения долей используйте исходные количества.
- Исключите повторный учёт одной операции.
- Проверьте границу связи метрики с пользовательским результатом.
Первоисточники
- Semantic Conventions for System Metrics
Задаёт system CPU, memory, disk и network metric names, units, attributes и utilization calculation.
Утверждения: 02
- Metric Types
Определяет counter, gauge, histogram и summary, включая resets и cumulative behavior.
- Implementing SLOs
Описывает построение SLI/SLO от пользовательской цели, measurement window и error-budget policy.
Утверждения: 05
- OpenTelemetry Logs Data Model
Определяет Timestamp, severity, body, resource, attributes, TraceId и SpanId LogRecord.
- Service Level Objectives
Определяет SLI, SLO и SLA и объясняет user-centric latency, error rate, throughput и percentiles.