Перейти к содержанию

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

  1. Во время инцидента вы строите Explore-запрос, который показывает аномальный latency у /api/payment. Сохраняете его в Notebook.
  2. Добавляете панель «Error Rate» из production-дашборда, на которой виден всплеск в момент инцидента.
  3. Пишете текстом гипотезу: «Проблема в deadlock PostgreSQL, см. тикет ENG-4821».
  4. Добавляете вывод Grafana Assistant, который проанализировал трейсы и подтвердил deadlock.
  5. Сохраняете 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