Grafana Notebooks (появилось в 13.3.0)¶
В ходе расследования инцидента вы открываете дашборды, строите Explore-запросы, общаетесь с Grafana Assistant. К концу у вас в голове — полная картина, но поделиться ей можно только устно или длинным сообщением в чате.
Notebooks — это новый тип артефакта в Grafana. Документ, в который можно вставлять панели из дашбордов, результаты Explore-запросов, выводы Grafana Assistant, свой текст с рассуждениями — и делиться ссылкой с командой.
Что можно вставить в Notebook¶
- Dashboard panels — живые панели из любого дашборда. Не скриншот, а интерактивный график, который показывает данные на момент открытия Notebook.
- Explore queries — результат запроса в Explore: график, таблица или логи. Полезно, когда вы нашли аномалию в Explore и хотите сохранить её вместе с контекстом.
- Grafana Assistant findings — выводы AI-ассистента. Если Assistant помог найти причину аномалии, этот вывод можно вставить в Notebook как доказательство.
- Текст с Markdown — ваши рассуждения, гипотезы, ссылки на runbook, тикеты. Markdown-форматирование: заголовки, списки, код, ссылки.
Типичный сценарий: postmortem¶
- Во время инцидента вы строите Explore-запрос, который показывает аномальный latency у
/api/payment. Сохраняете его в Notebook. - Добавляете панель «Error Rate» из production-дашборда, на которой виден всплеск в момент инцидента.
- Пишете текстом гипотезу: «Проблема в deadlock PostgreSQL, см. тикет ENG-4821».
- Добавляете вывод Grafana Assistant, который проанализировал трейсы и подтвердил deadlock.
- Сохраняете Notebook. Делитесь ссылкой с командой в Slack.
Результат: не разрозненные скриншоты в чате, а единый документ с живыми данными, текстом и AI-выводами. Через неделю на postmortem-встрече открываете тот же Notebook — все панели всё ещё показывают данные на момент инцидента (тайм-диапазон зафиксирован).
Notebook vs дашборд vs Explore¶
| Возможность | Dashboard | Explore | Notebook |
|---|---|---|---|
| Сохранение запросов | Да (панели) | Нет (сессия живёт пока открыта) | Да |
| Текст и рассуждения | Да (Text panel) | Нет | Да |
| Живые данные | Да | Да | Да (на момент открытия) |
| Совместное использование | Ссылка на дашборд | Копирование URL | Ссылка на Notebook |
| Вставка из Explore | Нет | — | Да |
| Вставка AI-выводов | Нет | Нет | Да |
| Версионирование | Да (версии дашборда) | Нет | Базовое (сохранение) |
Notebook не заменяет дашборд. Дашборд — для постоянного мониторинга. Notebook — для документирования конкретного события или расследования.
Где найти¶
Dashboards → Notebooks — новый пункт в боковом меню. Открывается список ваших Notebooks. Можно создать новый или открыть существующий.
Права на Notebooks наследуются от прав на дашборды: Viewer может читать, Editor — создавать и редактировать. Notebooks хранятся в организации и видны всем, у кого есть доступ.
Подводные камни¶
- Не для постоянного мониторинга. Notebook фиксирует временной диапазон. Через неделю панель в Notebook покажет данные за ту неделю, когда был инцидент, а не «сейчас». Для постоянного мониторинга — дашборд.
- Не заменяет runbook. Runbook говорит «что делать». Notebook говорит «что случилось». Это разные документы. Ссылку на runbook можно вставить в Notebook, но не наоборот.
- Превью, не production-скриншот. Панели в Notebook интерактивные, но ограничены временным диапазоном. Не используйте Notebook как замену production-дашборду для алертов.
Далее: Grafana Drilldown