Skip to content

[Feature] Интеграция логов бэкенда в дашборды Grafana #7

@soorq

Description

@soorq

Контекст

Для обеспечения полноценной наблюдаемости (observability) необходимо объединить метрики производительности и логи приложения в едином интерфейсе Grafana. Это позволит инженерам выполнять корреляцию событий (например, сопоставлять всплески 5xx ошибок с конкретными записями в логах) без переключения между инструментами, что значительно сокращает MTTR (Mean Time To Resolution).


Технические требования

  • Локация логики: infrastructure/grafana/dashboards, deploy/grafana-provisioning
  • Инструменты: Grafana, Loki Data Source, LogQL.
  • Логика работы:
    1. Настроить или обновить существующий Data Source для Loki в Grafana.
    2. Создать новый раздел (Row) "Application Logs" в основном дашборде бэкенда.
    3. Добавить панель типа Logs, использующую переменную $service или $container для фильтрации.
    4. Настроить Derived Fields в настройках Data Source для создания кликабельных ссылок между Trace ID (из логов) и данными в Tempo/Jaeger.

Цель и критерии приемки (Definition of Done)

  • База: Проверена доступность Loki как источника данных в Grafana.
  • Функционал: На дашборде отображается поток логов с возможностью фильтрации по уровню (INFO, WARN, ERROR).
  • Лимиты/SLA: Время рендеринга панели логов при выборке за последние 15 минут не должно превышать 2 секунд.
  • Интеграция: Обновлен JSON-дескриптор дашборда в репозитории (код-базе) для автоматического развертывания через CI/CD.

Важные указания

  • Производительность: Использовать ограничение max lines в настройках панели (рекомендуется 1000), чтобы избежать перегрузки браузера при просмотре "тяжелых" логов.
  • Ошибки: При отсутствии данных в Loki панель должна отображать корректное состояние "No data", а не ошибку парсинга.
  • Безопасность: Убедиться, что права доступа к дашборду с логами соответствуют ролевой модели (RBAC) Grafana, исключая доступ для неавторизованных пользователей.

Metadata

Metadata

Assignees

Labels

devopsЗадачи, связанные с автоматизацией жизненного цикла ПОdocumentationImprovements or additions to documentationenhancementNew feature or requestinfrastructureЗадачи по управлению железом или виртуальными ресурсамиmonitoringЗадачи по настройке инструментов сбора данных и оповещенияobservabilityЗадачи по обеспечению глубокой видимости систем

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions