Корпоративные поля наблюдаемости¶
Ненормативный материал. Таблица сводит действующие требования и не вводит новых обязательств.
Нормативные источники: OBS-LOG-003, OBS-LOG-004, OBS-TRACE-003,
OBS-MET-002, OBS-ERR-004, OBS-ERR-005, OBS-ERR-006, OBS-AUD-002,
OBS-AUD-003, FE-OBS-001, FE-OBS-003, FE-OBS-005, FE-OBS-006,
FE-ERR-005, FE-ERR-006, MOB-BUILD-002, MOB-OBS-003, MOB-OBS-004 и
INT-EVT-001.
| Поле | Тип | Сигналы | Назначение |
|---|---|---|---|
timestamp |
RFC 3339 string | лог, аудит, интеграционное событие | Время события в UTC с долями секунды |
telemetry.type |
string | аудит | Значение audit для отдельной маршрутизации |
severity_text |
enum | лог | TRACE, DEBUG, INFO, WARN, ERROR или FATAL |
severity_number |
integer | лог | Числовой уровень по модели OpenTelemetry |
message |
string | лог, backend-ошибка | Краткое понятное человеку описание |
service.name |
string | лог, трасса, метрика, ошибка, аудит | Стабильное имя сервиса |
service.version |
string | лог, трасса, метрика, ошибка, аудит | Версия выпуска; для mobile — публичная версия в паре с app.build_number |
deployment.environment.name |
string | лог, трасса, метрика, ошибка, аудит | Окружение выполнения |
os.name |
string | mobile-телеметрия, mobile-ошибка | Платформа мобильной ОС |
os.version |
string | mobile-телеметрия, mobile-ошибка | Версия мобильной ОС |
app.build_number |
string | mobile-телеметрия, mobile-ошибка | Монотонный номер store-сборки, уточняющий service.version |
event.id |
string | аудит, интеграционное событие | Уникальный идентификатор события |
event.name |
string | лог, ошибка, аудит, интеграционное событие | Стабильный тип события |
event.schema_version |
positive integer | аудит, интеграционное событие | Версия схемы события |
producer.id |
string | интеграционное событие | Стабильный идентификатор producer |
error.type |
string | ошибка | Стабильный класс ошибки |
trace_id |
32 lowercase hex | лог, трасса, ошибка, аудит | Идентификатор распределённой трассы |
span_id |
16 lowercase hex | лог, трасса, ошибка, аудит | Идентификатор операции внутри трассы |
request_id |
string | лог, ошибка, аудит | Идентификатор одного запроса или сообщения |
correlation_id |
string | лог, ошибка, аудит | Идентификатор связанной бизнес-операции |
actor.type |
string | аудит | Тип субъекта либо anonymous |
actor.id |
string | аудит | Устойчивый разрешённый идентификатор субъекта |
action |
string | аудит | Выполненное действие |
object.type |
string | аудит | Тип целевого объекта |
object.id |
string | аудит | Разрешённый идентификатор целевого объекта |
result |
enum | аудит | success или failure |
failure.reason |
string | аудит | Нормализованная причина неуспешного результата |
source.address |
string | аудит | Разрешённое политикой представление источника |
session.id |
string | RUM, ошибка (browser), трасса (browser) | Псевдонимный идентификатор сессии |
view.name |
string | RUM, трасса (browser) | Шаблон маршрута или экрана приложения |
Обязательность поля зависит от сигнала и контекста. Она определяется требованием с соответствующим ID, а не этой таблицей.