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

Настройки дашборда (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. Здесь достаточно знать, что они существуют и настраиваются не внутри панели, а на уровне всего дашборда.


Ссылки между дашбордами. Например: на дашборде «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