Создание дашбордов

Дашборды и панели позволяют отображать данные в наглядной форме. Каждой панели нужен как минимум один запрос, чтобы отобразить визуализацию.

Перед началом:

• Убедитесь, что у вас есть соответствующие разрешения. Подробнее о разрешениях см. в разделе О пользователях и разрешениях.
• Разберитесь в языке запросов целевого источника данных.

Создание дашборда

Чтобы создать дашборд, выполните следующие шаги:

1. В главном меню нажмите Dashboards.

2. Нажмите New и выберите New Dashboard.

3. Нажмите значок Add new element (синий знак «плюс») и щёлкните панель или перетащите её на дашборд.

4. На новой панели выберите один из следующих вариантов:

   • Configure visualization: открывает режим редактирования панели с предварительно выбранным источником данных по умолчанию для вашего экземпляра. Настройте запрос и задайте параметры панели и визуализации.

   • Use saved query: открывает панель Saved queries. Выберите запрос, и Grafana добавит панель с применённой предлагаемой визуализацией.

     Затем перейдите к шагу 12.

   • Use library panel: открывает панель со списком библиотечных панелей. Выберите библиотечную панель, и Grafana добавит её.

     Затем перейдите к шагу 12.

Note

Сохранённые запросы доступны только в Grafana Enterprise и Grafana Cloud.

5. Если вы хотите изменить источник данных панели, на вкладке Queries нажмите раскрывающийся список Data source и выполните одно из следующих действий:

   • Выберите один из существующих источников данных.
   • Нажмите Open advanced data source picker, чтобы выбрать один из встроенных специальных источников данных Grafana или настроить новый источник данных (только для администраторов).

   Дополнительные сведения об источниках данных см. в разделе Источники данных с конкретными рекомендациями.

6. Чтобы создать запрос, выполните одно из следующих действий:

   • Напишите или составьте запрос на языке запросов вашего источника данных.
   • Откройте раскрывающееся меню Saved queries и нажмите Replace query, чтобы повторно использовать сохранённый запрос.

7. (Необязательно) Чтобы сохранить запрос для повторного использования, откройте раскрывающееся меню Saved queries и выберите Save query.

8. Нажмите Refresh, чтобы выполнить запрос к источнику данных.

9. Выберите предлагаемую визуализацию или нажмите All visualizations и выберите одну из полного списка.

   Grafana отображает предварительный просмотр результатов запроса с применённой визуализацией.

   Дополнительные сведения о настройке отдельных визуализаций см. в разделе Параметры визуализаций.

10. (Необязательно) Если панель это поддерживает, выберите вариант в разделе Panel styles на боковой панели редактора панели. Каждый стиль показывает живой предпросмотр того, как он меняет визуализацию. Нажатие на стиль применяет его к панели.

    Подробнее о стилях панелей см. в документации редактора панелей.

11. См. следующую документацию о способах настройки параметров панели.

    Хотя это и не обязательно, большинству визуализаций требуется некоторая настройка, прежде чем они корректно отобразят нужную вам информацию.

    • Настройка стандартных параметров
    • Параметры конкретных визуализаций
    • Настройка сопоставлений значений
    • Настройка пороговых значений
    • Переопределение значений полей

12. Введите название и описание панели или позвольте Grafana создать их с помощью возможностей генеративного ИИ.

13. Нажмите Save.

14. Введите название и описание дашборда или позвольте Grafana создать их с помощью возможностей генеративного ИИ.

15. Выберите папку, если это применимо.

16. Нажмите Save

17. Нажмите Back.

18. Нажмите Exit edit.

Редактирование дашборда

Теперь, когда базовый дашборд создан, его можно расширить дополнительными возможностями, описанными в следующих разделах:

• Боковая панель и панель инструментов: узнайте о редактировании, не покидая дашборд.
• Навигация с помощью структуры содержимого: узнайте, как быстро перейти к любому элементу дашборда с помощью структуры содержимого.
• Редактирование дашборда: узнайте, как редактировать дашборд.

Боковая панель и панель инструментов

Боковая панель позволяет вносить изменения, не покидая дашборд, отображая параметры, связанные с элементом дашборда, находящимся в фокусе.

Панель инструментов расположена рядом с боковой панелью и содержит параметры, которые удобно иметь под рукой постоянно.

На следующем изображении показаны части боковой панели и панели инструментов. Наведите курсор на номера, чтобы отобразить описания параметров панели инструментов (описания также приведены после изображения):

Панель инструментов отображается как в режиме редактирования, так и в режиме просмотра, но значки Dashboard options и Feedback недоступны в режиме просмотра.

Доступные параметры настройки на боковой панели различаются в зависимости от выбранного элемента дашборда:

• Dashboards: основные параметры находятся на боковой панели, а дополнительные параметры настройки — на странице Settings.
• Groupings (rows and tabs): все параметры настройки доступны на боковой панели.
• Panels: основные параметры находятся на боковой панели, а дополнительные параметры настройки — в представлении Edit panel.

Закреплённая и откреплённая боковая панель

Вы можете использовать боковую панель закреплённой или откреплённой, нажав значок Dock/Undock на боковой панели. Когда боковая панель закреплена, содержимое дашборда изменяет размер, чтобы вместить её. Когда она откреплена, боковая панель плавает поверх содержимого дашборда. В режиме редактирования боковая панель по умолчанию закреплена, а в режиме просмотра — откреплена.

В следующей таблице описано поведение боковой панели в режиме редактирования при закреплении или откреплении:

Expand table

Закреплена	Откреплена
После открытия боковая панель остаётся открытой независимо от того, куда вы нажмёте.	Боковая панель закрывается, если вы не выберете элемент дашборда.
Боковая панель отображает параметры дашборда при нажатии на его рабочую область.	Боковая панель отображает параметры дашборда только при нажатии значка Dashboard options.

Когда вы закрепляете или открепляете боковую панель, ваш выбор сохраняется для всех дашбордов этого экземпляра Grafana между сессиями через локальное хранилище браузера. Вы можете сбросить этот выбор, очистив следующие ключи в локальном хранилище:

• Для режима просмотра: grafana.ui.sidebar.dashboard-view.docked
• Для режима редактирования: grafana.ui.sidebar.dashboard.docked

Также можно изменять размер как боковой панели, так и панели инструментов. Размер панели инструментов можно изменять только когда боковая панель закрыта и не закреплена, но это доступно и в режиме просмотра, и в режиме редактирования. Изменения размера сохраняются, пока вы их не измените.

Навигация с помощью структуры содержимого

Content outline предоставляет древовидную структуру, показывающую все части дашборда и их взаимосвязи, включая панели, строки, вкладки и переменные. Структура также позволяет быстро перемещаться по дашборду и доступна как в режиме просмотра, так и в режиме редактирования (обратите внимание, что переменные включены только в режим редактирования).

Чтобы перемещаться по дашборду с помощью структуры, выполните следующие шаги:

1. Перейдите к дашборду, который хотите просмотреть или изменить.

2. На правой панели инструментов нажмите значок Content outline, чтобы открыть её.

3. Выполните одно из следующих действий:

   • Разверните структуру, чтобы найти нужную часть дашборда для просмотра или изменения.
   • Введите имя элемента в строке поиска структуры.

4. Нажмите на элемент дерева, чтобы перейти к этой части дашборда.

Редактирование дашборда

Чтобы отредактировать дашборд, выполните следующие шаги:

1. Перейдите к дашборду, который хотите изменить.

2. Нажмите Edit.

3. Выполните одно из следующих действий:

   Expand table

   Что изменить	Действие
   Изменить существующие элементы	Нажмите на элемент, чтобы открыть боковую панель с соответствующими параметрами. Нажмите значок Dashboard options, чтобы открыть настройки дашборда. Если дашборд большой, откройте Content outline и используйте её для перехода к нужной части дашборда.
   Добавить панели	Нажмите значок Add new element и выберите Panel. Также можно навести курсор на дашборд, чтобы отобразить кнопку Add panel. Это удобно, если нужно гарантированно добавить новую панель внутри группы.
   Сгруппировать панели	Нажмите Add new element и выберите Add row/Group into rows или Add tab/Group into tabs. Или наведите курсор на дашборд, чтобы отобразить Group panels, и выберите вариант группировки либо выберите конкретный набор панелей и сгруппируйте их в строки или вкладки. Подробнее о группировках см. в разделе Группировки панелей.
   Добавить элементы управления дашбордом	Нажмите Add new element и выберите один из следующих пунктов: Filter and Group by Variable Annotation query Links
   Изменить макеты	Нажмите на строку, вкладку или значок Dashboard options, чтобы открыть боковую панель и получить доступ к параметрам макета. Подробнее см. в разделе параметры макета панелей.

4. Закончив вносить изменения, нажмите Save.

5. (Необязательно) Введите описание внесённых изменений.

6. Нажмите Save.

7. При необходимости нажмите Back.

8. Нажмите Exit edit

Макеты панелей

Макеты панелей управляют размером и расположением панелей на дашборде. Есть два варианта макета панелей:

• Custom: панели можно размещать и задавать им размер по отдельности. Это выбор по умолчанию для нового дашборда. Правила показа/скрытия не поддерживаются.
• Auto grid: панели автоматически изменяют размер и подстраиваются, создавая однородную сетку. Ручные изменения в этом макете невозможны. Правила показа/скрытия поддерживаются.

При первом создании дашборда вы выбираете макет, и этот выбор становится значением по умолчанию для строк и вкладок, которые вы добавляете в дашборд. Однако это значение по умолчанию можно изменить в настройках дашборда.

Макет Auto grid

В макете auto grid панели автоматически получают размер и позицию по мере добавления. Есть параметры по умолчанию, ограничивающие макет, и их можно изменить, чтобы лучше контролировать отображение:

• Min column width: выберите Standard, Narrow, Wide или Custom, для последнего можно ввести минимальную ширину в пикселях.
• Max columns: задайте число до 10.
• Row height: выберите Standard, Short, Tall или Custom, для последнего можно ввести высоту строки в пикселях.
• Fill screen: включите переключатель, чтобы панель занимала всю высоту экрана. Если панель находится в строке, переключатель Fill screen для строки также должен быть включён (см. параметры настройки группировок.

При попытке изменить размер панели в макете auto grid открывается диалоговое окно со следующими параметрами:

• Edit auto layout: отрегулируйте конфигурацию макета.
• Switch to custom layout: изменяйте размер и положение панелей вручную.

Если вы работаете на вкладке, индикатор типа макета отображается автоматически. Чтобы увидеть, какой тип макета активен для строки, наведите курсор на эту строку, чтобы отобразить индикатор.

Для повторяющихся панелей это взаимодействие доступно на последней панели группы.

Обновление макета панелей

Чтобы обновить макет панелей, выполните следующие шаги:

1. Перейдите к дашборду, который хотите изменить.
2. Нажмите Edit.
3. Нажмите на дашборд или группировку, содержащую макет панелей, который нужно изменить.
4. При необходимости нажмите значок Dashboard options, чтобы открыть боковую панель.
5. В разделе Layout выберите Custom или Auto grid.
6. Нажмите Save.
7. (Необязательно) Введите описание внесённых изменений.
8. Нажмите Save.
9. Нажмите Exit edit

Настройка параметров повторения

Вы можете настроить Grafana так, чтобы панели, строки или вкладки динамически добавлялись в дашборд на основе значения переменной. Переменные динамически изменяют ваши запросы на всех панелях, строках или вкладках дашборда.

Это применимо только к запросам, которые содержат переменную с несколькими значениями.

Чтобы настроить повторения, выполните следующие шаги:

1. Перейдите к дашборду, который хотите изменить.

2. Нажмите Edit.

3. Нажмите на панель, строку или вкладку, которую нужно изменить, чтобы открыть боковую панель, или нажмите значок Dashboard options, чтобы открыть её.

   Если дашборд большой, откройте Content outline и используйте её для перехода к нужной части дашборда.

4. Разверните раздел Repeat options.

5. Выберите Repeat by variable.

6. Для панелей в пользовательском макете задайте следующие параметры:

7. В разделе Repeat direction выберите одно из следующих значений:
   • Horizontal — расположить панели рядом друг с другом. Grafana корректирует ширину повторяющейся панели. Нельзя размещать другие панели в одной строке с повторяющейся панелью.
   • Vertical — расположить панели в столбец. Ширина повторяющихся панелей такая же, как у исходной повторяющейся панели.
8. Если вы выбрали Horizontal, выберите значение в раскрывающемся списке Max per row, чтобы ограничить максимальное число панелей в строке.

9. (Необязательно) Чтобы дать контекст пользователям дашборда, добавьте имя переменной в название панели, строки или вкладки.

10. Закончив настройку повторения, нажмите Save.

11. (Необязательно) Введите описание внесённых изменений.

12. Нажмите Save.

13. Нажмите Exit edit.

Повторяющиеся строки и вкладки и специальный источник данных Dashboard

Если строка содержит панели, использующие специальный источник данных Dashboard—источник данных, использующий набор результатов другой панели того же дашборда—то соответствующие панели в повторяющихся строках будут ссылаться на панель в исходной строке, а не в повторяющихся. То же поведение применимо и к вкладкам.

Например, в дашборде:

• Row 1 содержит Panel 1A и Panel 1B
• Panel 1B использует результаты Panel 1A через источник данных -- Dashboard --
• Повторяющаяся строка Row 2 содержит Panel 2A и Panel 2B
• Panel 2B ссылается на Panel 1A, а не на Panel 2A

Правила показа/скрытия

Вы можете настроить показ или скрытие панелей, строк и вкладок на основе правил. Например, можно настроить скрытие панели, если запрос не возвращает данных, или показ вкладки только при наличии определённого значения переменной.

Есть три типа правил показа/скрытия:

• Результат запроса
• Переменная шаблона
• Диапазон времени меньше

Шаги по созданию правил показа/скрытия см. в разделе Настройка правил показа/скрытия.

Правило результата запроса

Показывать или скрывать панель в зависимости от того, возвращает ли запрос результаты. Правило предоставляет варианты Has data и No data, позволяя показывать или скрывать панель в зависимости от наличия или отсутствия данных.

Например, если у вас есть дашборд с несколькими панелями и вы хотите, чтобы отображались только панели, возвращающие данные, задайте правило следующим образом:

• Panel visibility > Show
• Query result > Has data

Кроме того, может понадобиться разобраться с дашбордом с несколькими панелями, чтобы понять, на каких из них сломанные запросы, не возвращающие результатов. В этом случае правило задаётся следующим образом:

• Panel visibility > Show
• Query result > No data

Правило переменной шаблона

Динамически показывать или скрывать панель, строку или вкладку в зависимости от значения переменной. Вы можете выбрать любую переменную, настроенную для дашборда, и воспользоваться следующими операторами для максимальной гибкости:

• Equals
• Not equals
• Matches (значения регулярного выражения)
• Not matches (значения регулярного выражения)

При необходимости вы можете добавить другие переменные, не покидая дашборд.

Правило диапазона времени меньше

Показывать или скрывать панель, строку или вкладку, если диапазон времени дашборда короче выбранного диапазона. Это гарантирует, что при изменении диапазона времени дашборда вы видите только данные, относящиеся к этому периоду.

Например, дашборд отслеживает внедрение функции со временем и имеет следующую настройку:

• Диапазон времени дашборда — Last 7 days
• Одна панель отслеживает недельную статистику
• Одна панель отслеживает дневную статистику

Для панели с недельной статистикой настроено правило скрывать её, если диапазон времени дашборда меньше 7 дней. Для панели с дневной статистикой настроено правило скрывать её, если диапазон времени дашборда меньше 24 часов. Такая конфигурация гарантирует, что эти панели, зависящие от времени, отображаются только тогда, когда прошло достаточно времени, чтобы они стали актуальными.

Для этого типа правил можно выбирать диапазоны времени от 5 minutes до 5 years.

Настройка правил показа/скрытия

Чтобы настроить правила показа/скрытия, выполните следующие шаги:

1. Перейдите к дашборду, который хотите изменить.

2. Нажмите Edit.

3. Нажмите на панель, строку или вкладку, которую нужно изменить, чтобы открыть боковую панель, или нажмите значок Dashboard options, чтобы открыть её.

   Если дашборд большой, откройте Content outline и используйте её для перехода к нужной части дашборда.

4. Разверните раздел Show / hide rules.

5. Выберите Show или Hide, чтобы задать, показывать или скрывать панель, строку или вкладку по результату правил.

6. Нажмите + Add rule.

7. Выберите тип правила:

   • Query result: показывать или скрывать панель в зависимости от результатов запроса. Выберите Has data или No data.
   • Template variable: динамически показывать или скрывать панель, строку или вкладку в зависимости от значения переменной. Выберите переменную и оператор и введите значение.
   • Time range less than: показывать или скрывать панель, строку или вкладку, если диапазон времени дашборда короче выбранного диапазона. Выберите диапазон времени от 5 minutes до 5 years.

8. Если вы настроили более одного правила, в разделе Match rules выберите одно из следующих значений:

   • Match all: панель, строка или вкладка показывается или скрывается, только если совпадают все правила.
   • Match any: панель, строка или вкладка показывается или скрывается, если совпадает любое из правил.

   Этот параметр отображается только при добавлении нескольких правил.

9. Закончив настройку правил, нажмите Save.

10. (Необязательно) Введите описание внесённых изменений.

11. Нажмите Save.

12. Нажмите Exit edit

Скрытые панели, строки или вкладки не видны, когда дашборд находится в режиме просмотра. В режиме редактирования скрытые элементы дашборда отображаются со значком или наложением, указывающим на это.

Перемещение панели

Чтобы переместить панель, выполните следующие шаги:

1. Перейдите к дашборду, который хотите изменить.

2. Нажмите Edit.

3. Перейдите к панели, которую хотите переместить.

   Если дашборд большой, откройте Content outline и используйте её для перехода к панели.

4. Нажмите на заголовок панели и перетащите панель в другую строку или вкладку либо на новое место дашборда.

   Если в дашборде есть группировки, панель можно переместить только в другую группировку.

5. Когда новое положение подсветится сплошной синей линией, отпустите панель.

6. Нажмите Save.

7. (Необязательно) Введите описание внесённых изменений.

8. Нажмите Save.

9. Нажмите Exit edit

Изменение размера панели

Если у вашего дашборда или группировки макет Custom, вы можете вручную изменять размер панели.

Чтобы изменить размер панели, выполните следующие шаги:

1. Перейдите к дашборду, который хотите изменить.

2. Нажмите Edit.

3. Перейдите к панели, размер которой хотите изменить.

   Если дашборд большой, откройте Content outline и используйте её для перехода к панели.

4. Нажмите и перетащите правый нижний угол панели, чтобы изменить её размер.

5. Нажмите Save.

6. (Необязательно) Введите описание внесённых изменений.

7. Нажмите Save.

8. Нажмите Exit edit.

Копирование, дублирование и удаление элементов дашборда

Вы можете копировать и вставлять, дублировать или удалять любые элементы дашборда с помощью боковой панели:

Чтобы управлять элементами дашборда, выполните следующие шаги:

1. Перейдите к дашборду, который хотите изменить.

2. Нажмите Edit.

3. Выполните одно из следующих действий:

   • Для панелей, строк или вкладок нажмите на элемент, который нужно изменить, чтобы открыть боковую панель. Если дашборд большой, откройте Content outline и используйте её для перехода к нужной части дашборда.
   • Для элементов управления дашборда—фильтров, переменных, аннотаций или ссылок—нажмите на элемент управления в верхней части дашборда, чтобы отобразить параметры редактирования и удаления, а затем нажмите значок редактирования этого элемента. Откроется боковая панель.

4. В верхней части боковой панели выполните одно из следующих действий:

   • Нажмите Copy.
   • Нажмите Duplicate. Дублированный элемент добавляется рядом с исходным. Перейдите к шагу 6.
   • Нажмите Delete и подтвердите удаление элемента управления. Перейдите к шагу 7.

5. Если вы выбрали Copy, перейдите к той части дашборда, куда нужно добавить скопированный элемент, и нажмите Paste panel, Paste row или Paste tab.

6. При необходимости обновите скопированный или дублированный элемент.

7. Нажмите Save.

8. (Необязательно) Введите описание внесённых изменений.

9. Нажмите Save.

10. Нажмите Exit edit

Копирование дашборда

Чтобы сделать копию дашборда, выполните следующие шаги:

1. Перейдите к дашборду, который хотите изменить.

2. Нажмите Edit.

3. Нажмите раскрывающийся список Save и выберите Save as copy.

4. (Необязательно) Укажите имя, папку, описание копии дашборда и то, копировать ли теги исходного дашборда.

   По умолчанию скопированный дашборд имеет то же имя, что и исходный, с добавленным словом “Copy”, и находится в той же папке.

5. Нажмите Save.

Теперь вы находитесь в скопированном дашборде.

Часто задаваемые вопросы