| 1 | # Playbook: Grafana (v1) |
| 2 | |
| 3 | > **Scope:** типовые задачи админа Grafana — дашборды, источники данных, алерты. Без привязки к конкретным инстансам и паролям. Глубокий справочник: `kb-grafana-reference-v1.md`. |
| 4 | |
| 5 | --- |
| 6 | |
| 7 | ## Ключевые понятия |
| 8 | |
| 9 | - **Дашборд:** набор панелей и визуализаций; данные из одного или нескольких data source. |
| 10 | - **Data source:** подключение к хранилищу (Prometheus, InfluxDB, MySQL, Zabbix через плагин и т.д.). Редактор запросов свой у каждого типа. |
| 11 | - **Алерт:** правило по запросу и условию; при срабатывании — уведомление через контактные точки (contact points). Маршрутизация — по политикам уведомлений (notification policies) и меткам (labels). |
| 12 | |
| 13 | --- |
| 14 | |
| 15 | ## Где что в UI |
| 16 | |
| 17 | - **Шестерёнка (⚙️)** → Administration: Data Sources, Users, Teams, Plugins, Provisioning. |
| 18 | - **Data Sources** — добавление/правка источников (только Organization Admin). |
| 19 | - **Дашборд:** Settings — переменные, аннотации, теги; Edit — панели и запросы. |
| 20 | - **Alerting** — правила алертов, контактные точки, политики уведомлений, тишины (silences). |
| 21 | |
| 22 | --- |
| 23 | |
| 24 | ## Типовые задачи |
| 25 | |
| 26 | - **Добавить источник:** Configuration → Data Sources → Add; тип (Prometheus, Loki, Tempo, InfluxDB, MySQL и т.д.), URL, при необходимости auth; Save & Test. Только Organization Admin может добавлять/редактировать data sources. |
| 27 | - **Нет данных на панели:** проверить data source (Test), запрос (синтаксис, временной диапазон), права доступа к хранилищу; проверить переменные дашборда (могут подставлять пустое значение). |
| 28 | - **Настроить алерт:** Alerting → Alert rules → New; запрос(ы), условие (expression), контактные точки; при необходимости — labels для маршрутизации по политикам (notification policies). Provisioned политики при file-based provisioning не редактируются в UI. |
| 29 | - **Временное отключение уведомлений:** Alerting → Silences → New silence; задать matchers (по labels) и срок. |
| 30 | - **Provisioning:** дашборды и источники — YAML/JSON в каталогах provisioning; алертинг — через конфиг или API (ограничение редактирования в UI при file provisioning). |
| 31 | |
| 32 | --- |
| 33 | |
| 34 | ## Анти-паттерны |
| 35 | |
| 36 | - Хранить пароли и токены в репозитории; использовать секреты и переменные окружения (GF_* в Docker). |
| 37 | - Менять provisioned дашборды только через файлы — изменения из UI в provisioned не сохраняются обратно в файлы. |
| 38 | - Игнорировать роль пользователя (Organization Admin нужен для управления data sources). |
| 39 | |
| 40 | --- |
| 41 | |
| 42 | ## Диагностика |
| 43 | |
| 44 | Сводка: [`troubleshooting/playbook-ops-observability-network-troubleshooting-v1.md`](troubleshooting/playbook-ops-observability-network-troubleshooting-v1.md) § Grafana. |
| 45 | |
| 46 | --- |
| 47 | |
| 48 | *Подробности: установка, конфиг, переменные, аннотации, плагины, LDAP/OAuth — в `kb-grafana-reference-v1.md`.* |
| 49 | |
| 50 | |