Поделиться через

Временные параметры книги

  • Статья

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

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

  1. Начните с пустой книги в режиме редактирования.

  2. Выберите Добавить параметры>Добавить параметр.

  3. В открывшейся области параметров введите:

    • Имя параметра: TimeRange
    • Тип параметра: Time range picker
    • Требуется: checked
    • Доступные диапазоны времени: Last hour, Last 12 hours, Last 24 hours, Last 48 hours, Last 3 days, Last 7 daysи Allow custom time range selection.

  4. Нажмите кнопку Сохранить, чтобы создать параметр.

    Снимок экрана: параметр диапазона времени в режиме чтения.

Так выглядит книга в режиме чтения.

Ссылка на временной параметр

На временные параметры можно ссылаться с помощью привязок, KQL или текста.

Ссылка на временной параметр с помощью привязок

  1. Выберите Добавить запрос, чтобы добавить элемент управления запросом, а затем выберите ресурс Application Insights.

  2. Большинство элементов управления книги поддерживают средство выбора области Диапазон времени. Откройте раскрывающийся список Диапазон времени и выберите {TimeRange} в группе Параметры интервала времени внизу.

    • При этом элемент управления диапазона времени привязывается к диапазону времени диаграммы.
    • Область времени в примере запроса теперь представляет собой Последние 24 часа.

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

    Снимок экрана: параметр диапазона времени, на который сделана ссылка с помощью привязок.

Ссылка на временной параметр с помощью KQL

  1. Выберите Добавить запрос, чтобы добавить элемент управления запросом, а затем выберите ресурс Application Insights.

  2. Откройте раскрывающийся список диапазонов времени и выберите Set in query группу "Диапазон времени". В KQL введите фильтр области времени с помощью параметра | where timestamp {TimeRange}:

    • При этом время оценки запроса увеличится до | where timestamp > ago(1d).
    • Это является значением диапазона времени для параметра.

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

    Снимок экрана: диапазон времени, на который сделана ссылка с помощью KQL.

Ссылка на временной параметр в тексте

  1. Добавьте текстовый элемент управления в книгу.
  2. В Markdown введите The chosen time range is {TimeRange:label}.
  3. Нажмите Done Editing (Завершить правку).
  4. В текстовом элементе управления отображается текст: Выбранный диапазон времени — "Последние 24 часа".

Опции параметров времени

Параметр Описание Пример
{TimeRange} Метка диапазона времени Последние 24 часа
{TimeRange:label} Метка диапазона времени Последние 24 часа
{TimeRange:value} Значение диапазона времени > назад (1 день)
{TimeRange:query} Запрос в диапазоне времени > назад (1 день)
{TimeRange:start} Время запуска диапазона времени 20.03.2019 16:18
{TimeRange:end} Время окончания диапазона времени 21.03.2019 16:18
{TimeRange:grain} Интервал диапазона времени 30 мин

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

requests
| make-series Requests = count() default = 0 on timestamp from {TimeRange:start} to {TimeRange:end} step {TimeRange:grain}

Следующие шаги

Начало работы с Книгами Azure