Настройки дашборда (Dashboard Settings)¶
Представьте, что вы собираете чемодан. Открываете его, а там — множество отделений: для одежды, для документов, для мелочей. Settings дашборда — это такой же чемодан. В нём примерно дюжина вкладок, каждая для своего. Разбираем по порядку, слева направо сверху вниз.
General¶
Это первое, что видит пользователь, создавая дашборд. Три поля:
-
Name — название. Пишите по-человечески: не
mysql-db01-v2-final-new, аСерверы БД — Production. Длинное название само скажет, что на дашборде. Не экономьте на пробелах и дефисах — они повышают читаемость. -
Description — описание. Поле, которое заполняют в 5% случаев, а зря. Когда через полгода вы откроете дашборд и спросите себя «а зачем я это создавал и кто отвечает за данные?», описание спасёт ситуацию. Пишите кратко: цель дашборда, контакты ответственного, примечания по данным.
-
Tags — метки классификации. Производственные (
production,staging), технологические (database,cache,queue), региональные (eu,us,ru), и так далее. Теги работают в паре с поиском: нажать на тег в списке дашбордов — и отфильтровать всё по этому тегу. -
Folder — папка. Папки нужны не только для организации, но и для наследования прав доступа. При создании дашборда вы выбираете папку, и дашборд наследует все права, назначенные на эту папку. Подробнее — в главе про Permissions.
Time Options¶
Timezone (Часовой пояс)¶
Каждый дашборд может иметь собственный часовой пояс. Варианты:
| Значение | Когда использовать |
|---|---|
| Default (берётся из конфига Grafana) | Если админ настроил правильно — то и хорошо. Чаще всего это UTC. |
| Browser | Автоматически подстраивается под часовой пояс пользователя. Идеально для дашбордов, на которые смотрят международные команды. |
| UTC | Стандартный выбор для серверной инфраструктуры. Логи, метрики, трейсы — всё пишется в UTC. Не надо ничего пересчитывать. |
| Конкретный город (Europe/Moscow и т.п.) | Когда дашборд висит в офисе, где все сидят в одном часовом поясе. |
Почему это важно: если ваша команда сидит в Москве, а дашборд показывает время в UTC, в январе вы будете видеть «сегодняшние» метки времени на 3 часа раньше реальности. Неудобно, но терпимо. А вот летом — на 3 часа, и это уже путаница.
Auto-Refresh (Автообновление)¶
Интервал, с которым Grafana перезапрашивает данные из источника и обновляет отображение. Возможные значения:
| Интервал | Для чего подходит |
|---|---|
| Off (выключено) | Аналитические дашборды, которыми вы пользуетесь сидя за компьютером. Нажал F5 когда понадобилось. |
| 5s | Дашборды в оперативном центре (NOC, командный центр), где требуется реакция за секунды. Осторожно: грузит источник данных запросами каждые 5 секунд. |
| 10s | Оперативный мониторинг, но не такой агрессивный. |
| 30s | Стандартный оперативный дашборд. За 30 секунд человек успевает осмыслить данные. |
| 1m | Самый популярный выбор для дашбордов на большом экране (телевизор, информационная панель). |
| 5m | Дашборды с трендами за несколько дней. Графики просто не успевают измениться быстрее 5 минут. |
| 15m | Дашборды с агрегированными данными за недели. Частота обновления раз в день тоже подойдёт, но зачем? |
| 30m, 1h, 2h, 1d | Почти никогда не нужны в интерфейсе Grafana. Лучше используйте внешний инструмент, который снимает скриншот раз в день. |
Общее правило: если дашборд висит постоянно на телевизоре и на него смотрят люди — ставьте 1 минуту. Если дашборд открывают, смотрят 5 минут и закрывают — ставьте Off. Пользователь сам обновит когда нужно.
Annotations (уровня дашборда)¶
Подробно аннотации разберём в Части III. Здесь важно понять разницу: аннотации бывают двух уровней — дашборда (настраиваются в Settings) и панели (настраиваются в конкретной панели). Аннотации дашборда — это события, которые показываются на всех графиках внутри этого дашборда. Аннотации уровня панели — только на конкретном графике.
Variables (беглый взгляд)¶
Вкладка, где живут переменные дашборда. Переменные — это динамические фильтры: выпадающие списки вверху дашборда, через которые выбирается источник данных, сервер, регион. Подробный разбор — в Части IV. Здесь достаточно знать, что они существуют и настраиваются не внутри панели, а на уровне всего дашборда.
Links (беглый взгляд)¶
Ссылки между дашбордами. Например: на дашборде «PostgreSQL — Обзор» вы можете добавить ссылку «Логи того же сервера» → дашборд в Loki, где логи уже отфильтрованы по тому же серверу. Подробно — в Части IV.
Metadata и история изменений (Versions)¶
Grafana хранит историю всех сохранений дашборда. Вкладка Versions показывает вам список версий: дата, автор, сообщение (если автор оставил). Вы можете посмотреть любую версию и восстановить её одним кликом. Это работает как git log для дашборда. Очень выручает, когда коллега случайно удалил половину панелей и сохранил.
Экспорт, импорт, копирование¶
Набор операций над дашбордом как целым:
- Save As — копия дашборда с новым названием и новым
uid. Исходный дашборд не трогается. - Export — сохранить JSON дашборда локально.
- Import — загрузить JSON из файла или вставить текст. Можно перезаписать существующий дашборд или создать новый.
- Copy — дубликат внутри того же экземпляра Grafana. Быстрее, чем экспорт-импорт.
- Delete — удаляет дашборд навсегда. Спросит подтверждение.
JSON Model¶
Уже обсуждали в предыдущей главе. Здесь в интерфейсе вы видите живой JSON дашборда, можете его скопировать целиком или поменять что-то вручную и нажать Save. Будьте осторожны: вкладка даёт полный доступ к редактированию — сломать дашборд неправильным JSON проще простого. Но и починить можно тем же способом: скопировать исправленный JSON и сохранить.
Далее: Rows и Tabs