Визуализация данных с помощью панелей мониторинга Azure Data Explorer

Статья
03/08/2024

Обозреватель данных Azure — это быстрая и высокомасштабируемая служба для изучения данных журналов и телеметрии. Изучите данные в веб-приложении Azure Data Explorer, начиная с приема данных, выполнения запросов и, в конечном счете, создания панелей мониторинга.

Панель мониторинга — это коллекция плиток, при необходимости упорядоченная в виде страниц, где каждая плитка имеет базовый запрос и визуальное представление. С помощью пользовательского веб-интерфейса можно экспортировать запросы язык запросов Kusto (KQL) на панель мониторинга в качестве визуальных элементов, а затем при необходимости изменять их базовые запросы и форматирование визуальных элементов. Помимо простоты просмотра данных, этот полностью интегрированный интерфейс панели мониторинга Azure Data Explorer обеспечивает улучшенную производительность запросов и визуализации.

Важно!

Ваши данные защищены. Панели мониторинга и метаданные, связанные с панелями мониторинга, о пользователях шифруются при хранении с помощью ключей, управляемых Корпорацией Майкрософт.

На следующем рисунке показан пример панели мониторинга Azure Data Explorer:

Сведения об интерактивном изучении примеров панелей мониторинга см. в статье Краткое руководство. Визуализация примеров панелей мониторинга данных.

Предварительные требования

Учетная запись Майкрософт или удостоверение пользователя Microsoft Entra. Подписка Azure не обязательна.
Создайте кластер и базу данных Azure Data Explorer.
Войдите в пользовательский веб-интерфейс Azure Data Explorer и добавьте подключение к кластеру.

Создание панели мониторинга

На панели навигации выберите Панели мониторинга>Новая панель мониторинга.
Введите имя панели мониторинга и выберите Создать.

Добавление источника данных

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

Выберите меню Дополнительно [...] >Источники данных
В области Источники данных выберите + Новый источник данных.
В области Создание нового источника данных:
1. Введите значение в поле Имя источника данных.
2. Введите регион для URI кластера и выберите команду Подключиться.
3. Выберите из раскрывающегося списка базу данных для восстановления.
4. Укажите значение для параметра Максимальный возраст кэша результатов запроса, чтобы включить кэш результатов запроса для всех запросов этого источника данных. Максимальный возраст можно указать в секундах, часах или днях.
5. Нажмите кнопку создания.

Добавить плитку

Плитки панели мониторинга используют язык запросов Kusto фрагменты для получения данных и визуализации визуальных элементов. Каждый запрос или плитка поддерживает один визуальный элемент.

Выберите команду Добавить плитку на холсте панели мониторинга или в верхней строке меню.
В области Запрос:
1. Выберите источник данных в раскрывающемся меню.
2. Введите запрос и выберите команду Выполнить. Дополнительные сведения о создании запросов, использующих параметры, см. в разделе Использование параметров в запросе.
3. Выберите Визуальный элемент.
На вкладке визуальный элемент выберите Тип визуального элемента, чтобы выбрать тип визуального элемента.
Выберите команду Применить изменения, чтобы закрепить визуальный элемент на панели мониторинга.
Вы можете изменить размер визуального элемента и нажать значок Сохранить .

Закрепление плитки из запроса

Запрос также можно закрепить на вкладке запроса в пользовательском веб-интерфейсе.

Закрепление запроса:

Создайте и выполните запрос, выходные данные которого необходимо визуализировать на панели мониторинга.
Выберите Общий доступ>Закрепить на панели мониторинга.
В области Закрепить на панели мониторинга:
1. Укажите имя плитки.
2. Имя источника данных автоматически заполняется из источника данных запроса.
3. Выберите Использовать существующий источник данных, если это возможно.
4. Выберите Создать.
5. Введите имя панели мониторинга.
6. Установите флажок View dashboard after creation (Просмотреть панель мониторинга после создания), если это новая панель мониторинга.
7. Выберите Закрепить.

Использование параметров

Параметры значительно улучшают производительность отображения панели мониторинга и позволяют использовать значения фильтров как можно раньше в запросе. Фильтрация включается, если параметр включен в запрос, связанный с плитками. Дополнительные сведения о настройке и использовании различных типов параметров см. в статье Использование параметров на панелях мониторинга Azure Data Explorer.

Просмотр запроса

Запрос можно просмотреть в режиме редактирования или просмотра. Редактирование базового запроса плитки возможно только в режиме редактирования. В режиме просмотра запрос можно изменить на новой вкладке запроса, не изменяя базовый запрос плитки панели мониторинга.

Перейдите к панели мониторинга.
На плитке, которую вы хотите изучить, выберите меню Дополнительно [...]>Просмотр запроса.

Откроется панель с таблицей запросов и результатов.
Выберите вкладку Новый запрос. Перейдите к изменению запроса в области запроса пользовательского веб-интерфейса Azure Data Explorer.

Снимок экрана: область просмотра запроса с запросом в верхней половине экрана и результатом в нижней половине.

Примечание

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

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

Важно!

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

ссылка на панель мониторинга;
разрешения для панели мониторинга;
доступ к базовой базе данных в кластере Azure Data Explorer.

Управление разрешениями

Выберите пункт меню Общий доступ на панели мониторинга вверху.
Выберите элемент Управление разрешениями в раскрывающемся списке.

Предоставить разрешения

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

Введите Microsoft Entra пользователя или группу Microsoft Entra в разделе Добавление новых участников.
На уровне Разрешение выберите одно из следующих значений: Просмотр или Изменение.
Выберите Добавить.

Управление разрешениями панели мониторинга.

Изменение уровня разрешений пользователя

Чтобы изменить уровень разрешений пользователя, на панели Разрешения панели мониторинга:

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

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

щелкните Общий доступ, а затем Копировать ссылку;
в окне Разрешения панели мониторинга щелкните элемент Копировать ссылку.

Экспорт панелей мониторинга

Используйте меню файлов для экспорта панели мониторинга в формате JSON. Экспорт панели мониторинга может быть полезен в следующих сценариях:

Управление версиями. Файл можно использовать для восстановления панели мониторинга до предыдущей версии.
Шаблон панели мониторинга. Файл можно использовать в качестве шаблона для создания новых панелей мониторинга.
Редактирование вручную. Файл можно изменить, чтобы исправить или улучшить панель мониторинга. Файл можно импортировать обратно в панель мониторинга.

Чтобы экспортировать панель мониторинга, выберите на панели мониторинга действие Файл, Экспорт в файл.

Снимок экрана: панель мониторинга, на которой показан параметр

Файл содержит данные о панели мониторинга в формате JSON, структура которых представлена в следующем фрагменте кода.

{
  "id": "{GUID}",
  "eTag": "{TAG}",
  "title": "Dashboard title",
  "tiles": [
    {
      "id": "{GUID}",
      "title": "Tile title",
      "query": "{QUERY}",
      "layout": { "x": 0, "y": 7, "width": 6, "height": 5 },
      "pageId": "{GUID}",
      "visualType": "line",
      "dataSourceId": "{GUID}",
      "visualOptions": {
        "xColumn": { "type": "infer" },
        "yColumns": { "type": "infer" },
        "yAxisMinimumValue": { "type": "infer" },
        "yAxisMaximumValue": { "type": "infer" },
        "seriesColumns": { "type": "infer" },
        "hideLegend": false,
        "xColumnTitle": "",
        "yColumnTitle": "",
        "horizontalLine": "",
        "verticalLine": "",
        "xAxisScale": "linear",
        "yAxisScale": "linear",
        "crossFilterDisabled": false,
        "crossFilter": { "dimensionId": "dragX-timeRange", "parameterId": "{GUID}" },
        "multipleYAxes": {
          "base": { "id": "-1", "columns": [], "label": "", "yAxisMinimumValue": null, "yAxisMaximumValue": null, "yAxisScale": "linear", "horizontalLines": [] },
          "additional": []
        },
        "hideTileTitle": false
      },
      "usedParamVariables": [ "{PARAM}" ]
    }
  ],
  "dataSources": [ {} ],
  "$schema": "https://dataexplorer.azure.com/static/d/schema/20/dashboard.json",
  "autoRefresh": { "enabled": true, "defaultInterval": "15m", "minInterval": "5m" },
  "parameters": [ {} ],
  "pages": [ { "name": "Primary", "id": "{GUID}" } ],
  "schema_version": "20"
}

Создание новой панели мониторинга из файла

Файл панели мониторинга можно использовать для создания новой панели мониторинга, как описано ниже.

На главной странице панели мониторинга выберите действие Создать панель мониторинга, Импорт из файла.
Выберите файл для импорта.
Введите имя панели мониторинга и щелкните Создать.

Обновление или восстановление существующей панели мониторинга из файла

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

На панели мониторинга выберите Файл, Заменить на файл.
Выберите файл, чтобы обновить панель мониторинга.
Щелкните Save changes (Сохранить изменения).

Страница "Добавить"

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

На левой панели Страницы выберите + Добавить страницу.
Чтобы присвоить странице имя, выберите вертикальное меню Дополнительно [...]>Страница переименования.
Добавьте плитки на страницу.

Включение автообновления

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

Частоту автоматического обновления по умолчанию может задать редактор базы данных. Редакторы и зрители могут изменять фактическую частоту автоматического обновления при просмотре панели мониторинга.

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

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

Выберите меню Дополнительно [...]>Автоматическое обновление.
Установите переключатель в положение Включено, чтобы включить автоматическое обновление.
Выберите значения для параметров Минимальный интервал времени и Частота обновления по умолчанию.
Выберите элементы Применить и Сохранить, чтобы сохранить панель мониторинга.