OTEL Resource
Ресурсы — это набор атрибутов, которые описывают сущность, создающую телеметрию, в контексте API OpenTelemetry. Они предоставляют контекст для данных телеметрии, таких как метрики, логи и трейсы, и помогают идентифицировать источник этих данных.
Атрибуты — это пары ключ-значение, которые описывают характеристики ресурса в OpenTelemetry, такие как имя хоста, версия программного обеспечения или среда выполнения, и предоставляют дополнительный контекст для данных телеметрии.
Атрибуты определяются на уровне SDK и являются одним из компонентов всех трёх сущностей провайдеров.
Semantic Conventions
Проект OpenTelemetry представляет стандартные названия для большого количества типовых атрибутов. Следует использовать их, а не изобретать свои.
Ресурсы сервиса
Существует набор ресурсов которые должны быть определены так как не могут быть получены другими методами. Они представляют собой по сути набор атрибутов описывающих сам сервис, что важно многим (почти всем) инструментам хранения и анализа.
- service.name - логическое имя сервиса. Должно быть единым на всех инстансах если сервис горизонтально масштабирован.
- service.namespace - Имя сервиса не всегда уникально и их можно группировать с неймспейсы.
- service.instance.id - уникальный идентификатор сервиса. Должно быть уникально при горизонтальном мастшабировани у каждого экземпляра сервиса.
- service.version - версия та же что в системе контроля версий.
Детекторы ресурсов
Большинство SDK для конкретных языков предоставляют набор детекторов ресурсов, которые можно использовать для автоматического обнаружения информации о ресурсах из окружения