﻿---
title: Наблюдаемость
description: "Наблюдаемость и мониторинг: метрики, логи, трассировка, ошибки, синтетические проверки, RUM и OpenTelemetry."
---

## Мониторинг и наблюдаемость

**Мониторинг** собирает и проверяет заранее выбранные показатели: доступен ли сайт, сколько ошибок возникает, не закончилась ли память. **Наблюдаемость (observability)** — способность системы давать достаточно данных, чтобы ответить на новый вопрос о её поведении, включая непредвиденный сбой.

Мониторинг сообщает, что что-то идёт не так. Наблюдаемость помогает понять, почему: какой запрос, сервис, релиз, зависимость или участок кода связан с деградацией. Для этого приложение и инфраструктура должны быть правильно инструментированы.

## Основные сигналы

| Сигнал | На какой вопрос отвечает | Ограничение |
|---|---|---|
| **Метрики** | Как меняется числовое состояние во времени? | Агрегация скрывает отдельные события |
| **Логи** | Что произошло в конкретный момент? | Без контекста сложно восстановить цепочку запроса |
| **Трассы** | Как один запрос прошёл через операции и сервисы? | Требуют propagation и продуманного sampling |
| **Исключения** | Где код завершился ошибкой и как часто? | Не заменяют бизнес-метрики и логи зависимостей |
| **Синтетические проверки** | Работает ли сценарий из контролируемой точки? | Не показывают разнообразие реальных пользователей |
| **RUM** | Что испытывают реальные пользователи? | Требует контроля приватности и учёта разных устройств |

Сигналы наиболее полезны в связке. Например, метрика показывает рост p95, трассировка — медленную зависимость, лог — детали вызова, а release в error tracking связывает проблему с изменением.

## Контекст и корреляция

Для перехода между сигналами нужны общие идентификаторы и атрибуты: trace/span ID, service name, environment, release, request ID. Пользовательские идентификаторы добавляются только после оценки приватности.

Типовой маршрут диагностики:

```text
SLO/alert → затронутый сценарий и период → метрика → trace/log/error
         → связанный deployment → восстановление → postmortem
```

Контекст должен распространяться через вызовы. Если каждый сервис пишет несвязанные события, сбор всего в одном хранилище сам по себе корреляцию не создаст.

## OpenTelemetry

**OpenTelemetry** предоставляет API, SDK, протокол OTLP и Collector для формирования, получения, обработки и экспорта телеметрии. Он помогает отделить instrumentation от конкретного backend: приложение формирует сигналы единообразно, а систему хранения и анализа можно сменить без полной переделки кода.

OpenTelemetry не является хранилищем или дашбордом. Для анализа нужен совместимый backend или собственный стек.

## Минимальный набор для веб-проекта

1. Внешний [uptime check](https://wpcraft.ru/kb/infrastructure/observability/uptime-monitoring.md) ключевого URL и проверка TLS.
2. Метрики инфраструктуры и приложения с разумным набором labels.
3. Централизованные структурированные логи с request ID.
4. Error tracking с release и окружением.
5. Оповещение ответственного с runbook.
6. Трассировка и RUM — когда распределённые вызовы и пользовательский опыт требуют более глубокой диагностики.

## Страницы направления

- [Uptime monitoring](https://wpcraft.ru/kb/infrastructure/observability/uptime-monitoring.md) — внешняя доступность и сценарные проверки.
- [Infrastructure monitoring](https://wpcraft.ru/kb/infrastructure/observability/infrastructure-monitoring.md) — ресурсы, сервисы и time series.
- [Log management](https://wpcraft.ru/kb/infrastructure/observability/log-management.md) — сбор, поиск, хранение и защита событий.
- [Tracing](https://wpcraft.ru/kb/infrastructure/observability/tracing.md) — путь запроса и задержка операций.
- [Error tracking](https://wpcraft.ru/kb/infrastructure/observability/error-tracking.md) — исключения, grouping и releases.
- [Real User Monitoring](https://wpcraft.ru/kb/infrastructure/observability/real-user-monitoring.md) — Web Vitals, события и сессии.
- [Alerting](https://wpcraft.ru/kb/infrastructure/observability/alerting.md) — actionable оповещения и борьба с шумом.

## Связанные инструменты

- [OpenTelemetry](https://wpcraft.ru/kb/infrastructure/tools/open-telemetry.md) — сбор и передача телеметрии.
- [Prometheus](https://wpcraft.ru/kb/infrastructure/tools/prometheus.md) — метрики и оповещения.
- [Grafana](https://wpcraft.ru/kb/infrastructure/tools/grafana.md) — дашборды и исследование сигналов.
- [Better Stack](https://wpcraft.ru/kb/infrastructure/tools/better-stack.md) — интегрированная платформа наблюдаемости.

## Связанные материалы

- [SRE](https://wpcraft.ru/kb/infrastructure/sre.md) — пользовательские цели надёжности.
- [AI-наблюдаемость](https://wpcraft.ru/kb/ai/agents/observability.md) — специфика агентов и LLM.
- [Управление инцидентами](https://wpcraft.ru/kb/infrastructure/incidents.md) — действия после получения сигнала.

## Материалы и источники

- [OpenTelemetry: Observability primer](https://opentelemetry.io/docs/concepts/observability-primer/) — сигналы, instrumentation и надёжность.
- [OpenTelemetry: Signals](https://opentelemetry.io/docs/concepts/signals/) — traces, metrics, logs и baggage.
- [Google SRE: Monitoring Distributed Systems](https://sre.google/sre-book/monitoring-distributed-systems/) — мониторинг, симптомы и причины.