SYSTEM ATLASЗагрузка материала

Экземпляры наблюдений в метриках

Exemplars

Exemplar связывает агрегированную метрику с конкретным наблюдением, например trace id запроса, который попал в histogram bucket.

Простыми словами

Например, на p99 latency видна точка exemplar; по ней открывается trace медленного checkout-запроса. Поэтому заранее определяют границы ожидания и поведение при отказе - иначе один медленный компонент начинает удерживать ресурсы и распространять проблему дальше.

Пример от @Vibeclakr

Пример при разработке

На p99 latency видна точка exemplar; по ней открывается trace медленного checkout-запроса.

Это редакционный пример применения, а не часть определения или доказательство концепции.

Формальное определение

Exemplar связывает агрегированную метрику с конкретным наблюдением, например trace id запроса, который попал в histogram bucket.

Механизм действия

При записи измерения система сохраняет ограниченное число репрезентативных значений и контекст, не превращая каждую точку в label.

Пример в работе

Нерабочий подход

Внедрить «Экземпляры наблюдений в метриках» как формальную настройку, не проверив сценарий отказа и ограничение: Выбор exemplars является выборкой; чувствительные данные нельзя помещать в attributes.

Системный подход

Применять «Экземпляры наблюдений в метриках» только для заявленной цели, проверять поведение на реальном контуре и сохранять наблюдаемый критерий результата.

Ограничения

Выбор exemplars является выборкой; чувствительные данные нельзя помещать в attributes.

Источник

OpenTelemetry Project, “OpenTelemetry Metrics Data Model: Exemplars”, 2026.

Первоисточник