Добавление переменной на дашборд: различия между версиями

Материал из Документация Ключ-АСТРОМ
Нет описания правки
 
Строка 3: Строка 3:
Используйте переменные для фильтрации ваших дашбордов, в качестве значений переменных в плитках кода и в качестве заполнителей в заголовках плиток и тексте плиток Markdown.
Используйте переменные для фильтрации ваших дашбордов, в качестве значений переменных в плитках кода и в качестве заполнителей в заголовках плиток и тексте плиток Markdown.


'''Устарело: поля dt.entity.*'''
'''Устарело: поля dt.entity.*''' Если вы видите следующее сообщение:


Если вы видите следующее сообщение:
> Поля dt.entity.* устарели. Пожалуйста, используйте поля dt.smartscape.* вместо них.


''Поля dt.entity.* устарели. Пожалуйста, используйте поля dt.smartscape.* вместо них.''
мы рекомендуем использовать эквивалентное поле dt.smartscape.*. Устаревшие поля dt.entity.* в конечном итоге будут удалены.
 
мы рекомендуем использовать эквивалентное поле <code>dt.smartscape.*</code>.
 
Устаревшие поля <code>dt.entity.*</code> в конечном итоге будут удалены.


== Добавление переменной ==
== Добавление переменной ==
'''Чтобы добавить переменную на дашборд'''
Чтобы добавить переменную на дашборд:


# В заголовке дашборда откройте меню '''Добавить''' и выберите '''Переменные'''.
# В заголовке дашборда откройте меню '''Добавить''' и выберите '''Переменные'''. Сочетание клавиш: <code>Shift+V</code>. Отображается панель '''Переменная'''.
#* Сочетание клавиш: '''Shift+V'''
# Отображается панель '''Переменная'''.
# Определите переменную.
# Определите переменную.
#* '''Имя''': имя переменной. Оно отображается на дашборде и может содержать любые символы.
#* '''Имя''': имя переменной. Оно отображается на дашборде и может содержать любые символы.
#** Ключ-АСТРОМ выводит ключ из имени, заменяя любой символ, не являющийся буквой или цифрой, на _. Добавьте префикс $ к ключу, чтобы ссылаться на переменную в запросах, коде и заголовках.
#* '''Ключ-АСТРОМ''' выводит ключ из имени, заменяя любой символ, не являющийся буквой или цифрой, на <code>_</code>. Добавьте префикс <code>$</code> к ключу, чтобы ссылаться на переменную в коде и заголовках. Ключ не может начинаться с зарезервированного префикса <code>dt_</code>. Чтобы найти ключ переменной, откройте её меню или проверьте выноску, отображаемую, пока переменная ещё не используется.
#** Ключ не может начинаться с зарезервированного префикса <code>dt_</code>.
#** Чтобы найти ключ переменной, откройте её меню или проверьте выноску, отображаемую, пока переменная ещё не используется.
#* '''Тип''': может быть одним из следующих:
#* '''Тип''': может быть одним из следующих:
#** '''DQL''': значение возвращается из запроса, который вы вводите при определении переменной.
#*** Выберите '''Запустить''', чтобы протестировать ваш запрос.
#** '''Код''': значение возвращается из кода, который вы вводите при определении переменной.
#** '''Код''': значение возвращается из кода, который вы вводите при определении переменной.
#** '''Список''': список значений с разделителями-запятыми (CSV).
#** '''Список''': список значений с разделителями-запятыми (CSV). Чтобы определить возможные значения, введите их (через запятую) в поле под '''Данными'''. Чтобы определить значение по умолчанию, выберите одно из списка '''Значение по умолчанию'''. Чтобы разрешить выбор нескольких значений одновременно, включите '''Множественный выбор'''.
#*** Чтобы определить возможные значения, введите их (через запятую) в поле под '''Данными'''.
#*** Чтобы определить значение по умолчанию, выберите одно из списка '''Значение по умолчанию'''.
#*** Чтобы разрешить выбор нескольких значений одновременно, включите '''Множественный выбор'''.
#** '''Свободный текст''': произвольный текст. Вы можете ввести '''Значение по умолчанию'''. Ваши изменения сохраняются автоматически.
#** '''Свободный текст''': произвольный текст. Вы можете ввести '''Значение по умолчанию'''. Ваши изменения сохраняются автоматически.
# Настройте '''Параметры отображения'''.
# Настройте '''Параметры отображения''':
#* Если раскрывающийся список переменной должен отображаться на дашборде, включите '''Отображать как фильтр на дашборде'''.
#* Если раскрывающийся список переменной должен отображаться на дашборде, включите '''Отображать как фильтр на дашборде'''. Отключите его, когда хотите скрыть его, например, когда переменная используется как статическое значение across плиток, но не должна отображаться пользователю дашборда.
#* Отключите его, когда хотите скрыть его, например, когда переменная используется как статическое значение across плиток, но не должна отображаться пользователю дашборда.
#* Если пользователи вашего дашборда должны иметь возможность выбирать несколько значений одновременно в раскрывающемся списке переменной, включите '''Множественный выбор'''. Отключите его, когда хотите использовать только отдельные значения раскрывающегося списка переменной.
#* Если пользователи вашего дашборда должны иметь возможность выбирать несколько значений одновременно в раскрывающемся списке переменной, включите '''Множественный выбор'''.
#* Отключите его, когда хотите использовать только отдельные значения раскрывающегося списка переменной.
#* Выберите '''Значение по умолчанию''' для раскрывающегося списка переменной. Если вы ничего не введёте в это поле, будет выбрано первое доступное значение.
#* Выберите '''Значение по умолчанию''' для раскрывающегося списка переменной. Если вы ничего не введёте в это поле, будет выбрано первое доступное значение.
# Когда закончите, выберите '''< Переменная''' в верхней части, чтобы перейти на панель '''Переменные''', или выберите соответствующую кнопку, чтобы закрыть панель '''Переменные'''.
# Когда закончите, выберите '''< Переменная''' в верхней части, чтобы перейти на панель '''Переменные''', или выберите соответствующую кнопку, чтобы закрыть панель '''Переменные'''.


Переменные в дашбордах могут быть определены как зависимые от других переменных.
Переменные в дашбордах могут быть определены как зависимые от других переменных. Значение переменной пересчитывается, если её определение ссылается на другую переменную и значение другой переменной изменяется. Например, если значение переменной A изменяется, значение любой переменной, определение которой ссылается на переменную A, пересчитывается. Циклы не допускаются. Например, если значение переменной A зависит от значения переменной B, значение переменной B не может зависеть от значения переменной A.
 
Значение переменной пересчитывается, если её определение ссылается на другую переменную и значение другой переменной изменяется.
 
Например, если значение переменной A изменяется, значение любой переменной, определение которой ссылается на переменную A, пересчитывается.
 
Циклы не допускаются.
 
Например, если значение переменной A зависит от значения переменной B, значение переменной B не может зависеть от значения переменной A.
 
То, как вы редактируете переменную, зависит от '''Типа'''. Подробности и примеры см. в разделах:
 
* '''DQL-переменная'''
* '''Переменная-список'''
* '''Переменная-код'''
* '''Переменная свободного текста'''


== Использование переменной ==
== Использование переменной ==
После создания переменной вы готовы использовать её в запросе.
После создания переменной вы готовы использовать её. Всегда помните о необходимости добавлять префикс <code>$</code> к ключу переменной. Ключ-АСТРОМ выводит ключ из имени переменной, заменяя любой символ, не являющийся буквой или цифрой, на <code>_</code>. Например, переменная с именем <code>My Total</code> получает ключ <code>My_Total</code>, поэтому вы ссылаетесь на неё как <code>$My_Total</code>.
 
Всегда помните о необходимости добавлять префикс $ к ключу переменной в ваших запросах.
 
Ключ-АСТРОМ выводит ключ из имени переменной, заменяя любой символ, не являющийся буквой или цифрой, на _. Например, переменная с именем <code>My Total</code> получает ключ <code>My_Total</code>, поэтому вы ссылаетесь на неё как <code>$My_Total</code> в вашем запросе.


Чтобы найти ключ переменной, откройте её меню или проверьте выноску, отображаемую, пока переменная ещё не используется.
Чтобы найти ключ переменной, откройте её меню или проверьте выноску, отображаемую, пока переменная ещё не используется.
'''Например:'''
# Откройте меню и выберите '''Переменные''', чтобы добавить переменную на ваш дашборд.
# Определите следующую переменную:
#* '''Имя''': <code>Host</code>
#* '''Тип''': <code>DQL</code>
#* '''Запрос''':
<pre>
fetch dt.entity.host
| fields entity.name
</pre>
# Включите '''Множественный выбор''', чтобы вы могли выбрать более одного значения за раз для отображения в ваших визуализациях.
# Ваши изменения сохраняются автоматически.
# Выберите соответствующую кнопку, чтобы закрыть панель '''Переменная'''.
=== Использование с плиткой DQL ===
# Откройте меню и выберите '''DQL'''.
# Скопируйте и вставьте следующий запрос в поле '''DQL''' и выберите '''Запустить'''.
<pre>
fetch logs, scanLimitGBytes: 20
| filter in(host.name, array($Host))
| makeTimeseries count(), by:{ host.name }
</pre>
# Обратите внимание, что запрос ссылается на нашу новую переменную <code>Host</code> как <code>$Host</code>, где знак доллара указывает, что это ключ переменной.
Или, если вы не используете переменную с множественным выбором, вы можете ссылаться на неё так:<pre>
fetch logs, scanLimitGBytes: 20
| filter host.name == $Host
| makeTimeseries count(), by:{ host.name }
</pre>Поскольку вы добавили переменную с множественным выбором, вы можете использовать селектор значений, чтобы определить, какие значения отображаются в ваших визуализациях.
Вы, конечно, можете использовать вашу переменную в нескольких запросах.


=== Использование с плиткой Explore ===
=== Использование с плиткой Explore ===
'''Чтобы использовать переменную в плитке данных Explore'''
Чтобы использовать переменную в плитке данных Explore:


# Откройте меню и выберите '''Логи'''.
# Откройте меню и выберите '''Логи'''.
Строка 110: Строка 40:
# В добавленном поле фильтра введите <code>$</code>, чтобы получить предложения для всех доступных переменных, затем выберите <code>$Host</code>.
# В добавленном поле фильтра введите <code>$</code>, чтобы получить предложения для всех доступных переменных, затем выберите <code>$Host</code>.


'''Примечание''': добавление переменных в плитки '''Explore''' работает только для переменных с одиночным выбором в сочетании с оператором <code>=</code>.
'''Примечание:''' добавление переменных в плитки Explore работает только для переменных с одиночным выбором в сочетании с оператором <code>=</code>.


== Список переменных ==
== Список переменных ==
'''Чтобы перечислить все переменные, выполните одно из следующих действий:'''
Чтобы перечислить все переменные, выполните одно из следующих действий:
 
* Откройте меню и выберите '''Все переменные'''.
* Обратите внимание, что это меню доступно только после добавления хотя бы одной переменной на дашборд.
 
В этом примере для дашборда определены четыре переменные — <code>LogLevels</code>, <code>MyFreeTextVariable</code>, <code>Variable1</code> и <code>Variable2</code>, и мы можем видеть их текущие значения под их именами.
 
Выберите значок настроек в правом верхнем углу дашборда, затем выберите '''Переменные'''.
 
'''Пример:'''


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


* Для дашборда определены четыре переменные — <code>LogLevels</code>, <code>MyFreeTextVariable</code>, <code>Variable1</code> и <code>Variable2</code>.
В этом примере для дашборда определены четыре переменные — <code>LogLevels</code>, <code>MyFreeTextVariable</code>, <code>Variable1</code> и <code>Variable2</code>, и мы можем видеть их текущие значения под их именами. Две из переменных — <code>Variable1</code> и <code>Variable2</code> — отображают значок предупреждения. Подробности см. в разделе «Устранение неполадок переменных».
* Две из переменных — <code>Variable1</code> и <code>Variable2</code> — отображают значок предупреждения. Подробности см. в разделе «Устранение неполадок переменных».


Отсюда у вас есть следующие параметры, специфичные для переменных:
Отсюда у вас есть следующие параметры, специфичные для переменных:
Строка 135: Строка 56:
* Чтобы скрыть или отобразить переменную, выберите соответствующий значок.
* Чтобы скрыть или отобразить переменную, выберите соответствующий значок.
** Скрытая переменная с одиночным или множественным выбором автоматически определяет своё значение из доступных параметров; она не использует сохранённое значение по умолчанию.
** Скрытая переменная с одиночным или множественным выбором автоматически определяет своё значение из доступных параметров; она не использует сохранённое значение по умолчанию.
** Скрытые переменные с множественным выбором определяются как * (все параметры).
** Скрытые переменные с множественным выбором определяются как <code>*</code> (все параметры).
** Скрытые переменные с одиночным выбором определяются как первый доступный параметр.
** Скрытые переменные с одиночным выбором определяются как первый доступный параметр.
** Сохранённое значение по умолчанию сохраняется и восстанавливается, если вы снова сделаете переменную видимой. Чтобы закрепить скрытую переменную за конкретным значением, используйте вместо этого переменную свободного текста.
** Сохранённое значение по умолчанию сохраняется и восстанавливается, если вы снова сделаете переменную видимой. Чтобы закрепить скрытую переменную за конкретным значением, используйте вместо этого переменную свободного текста.
Строка 142: Строка 63:


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


== Редактирование переменной ==
== Редактирование переменной ==
Чтобы отредактировать переменную:


# Откройте меню и выберите '''Все переменные'''.
# Откройте меню и выберите '''Все переменные'''.
# В столбце '''Имя''' выберите имя переменной, которую хотите отредактировать.
# В столбце '''Имя''' выберите имя переменной, которую хотите отредактировать.
# Отредактируйте и проверьте переменную.
# Отредактируйте и проверьте переменную. То, как вы редактируете переменную, зависит от '''Типа'''.
#* То, как вы редактируете переменную, зависит от '''Типа'''. Подробности и примеры см. в разделах:
#** '''DQL-переменная'''
#** '''Переменная-список'''
#** '''Переменная-код'''
#** '''Переменная свободного текста'''
# Выберите соответствующую кнопку, чтобы закрыть панель '''Переменные'''.
# Выберите соответствующую кнопку, чтобы закрыть панель '''Переменные'''.


== Удаление переменной ==
== Удаление переменной ==
'''Чтобы удалить переменную с дашборда'''
Чтобы удалить переменную с дашборда:


# Откройте меню и выберите '''Все переменные'''.
# Откройте меню и выберите '''Все переменные'''.
Строка 168: Строка 83:
Если дашборд имеет одну или несколько переменных, они перечислены по имени в левом верхнем углу дашборда, под именем дашборда. Когда вы изменяете значения переменных, содержимое дашборда пересчитывается и отображается в соответствии с новыми значениями.
Если дашборд имеет одну или несколько переменных, они перечислены по имени в левом верхнем углу дашборда, под именем дашборда. Когда вы изменяете значения переменных, содержимое дашборда пересчитывается и отображается в соответствии с новыми значениями.


'''Чтобы изменить значение переменной'''
Чтобы изменить значение переменной:


# В левом верхнем углу дашборда найдите имя переменной.
# В левом верхнем углу дашборда найдите имя переменной.
Строка 177: Строка 92:


== Изменение порядка переменных ==
== Изменение порядка переменных ==
'''Чтобы изменить порядок переменных на вашем дашборде'''
Чтобы изменить порядок переменных на вашем дашборде:


# Откройте меню и выберите '''Все переменные'''.
# Откройте меню и выберите '''Все переменные'''.
# Перетащите переменные в нужный порядок.
# Перетащите переменные в нужный порядок. Как вариант: откройте меню для переменной, которую хотите переместить, и выберите '''Переместить вверх''' или '''Переместить вниз'''.
 
Как вариант: откройте меню для переменной, которую хотите переместить, и выберите '''Переместить вверх''' или '''Переместить вниз'''.


== Типы переменных ==
== Типы переменных ==
=== DQL-переменная ===
'''Чтобы определить DQL-переменную'''
# Установите '''Имя''' — имя, которое хотите дать вашей переменной.
#* Оно отображается в верхней части дашборда и указано на панели '''Переменные'''. Оно может содержать любые символы, например: <code>status</code>, <code>myHosts</code>, <code>Variable01</code> или <code>My Total</code>.
#* Ключ-АСТРОМ выводит ключ из имени, заменяя любой символ, не являющийся буквой или цифрой, на _. Например, имя <code>My Total</code> становится ключом <code>My_Total</code>. Используйте ключ с префиксом $, чтобы ссылаться на переменную в запросах, коде и заголовках.
#* Ключ не может начинаться с зарезервированного префикса <code>dt_</code>.
#* Чтобы найти ключ переменной, откройте её меню или проверьте выноску, отображаемую, пока переменная ещё не используется.
# Установите '''Тип''' в <code>DQL</code>.
# В разделе '''Данные''' введите запрос. Обязательно используйте <code>summarize</code> и <code>collectDistinct</code> для получения уникальных значений из источников данных, таких как логи.
# Выберите '''Запустить''' и проверьте результаты в разделе '''Предварительный просмотр''', чтобы убедиться, что всё работает как ожидалось.
# Если вы хотите иметь возможность выбирать более одного значения за раз, включите '''Множественный выбор'''.
Если вы добавите оба примера ниже на ваш дашборд, вы сможете фильтровать дашборд по хосту и уровню серьёзности логов. Обязательно включите '''Множественный выбор''', если хотите выбирать более одного за раз.
'''Пример DQL-переменной'''
* '''Имя''': <code>Hosts</code>
* '''Тип''': <code>DQL</code>
* '''Определение''':
<pre>
fetch dt.entity.host
  | fields id
</pre>Если вы хотите использовать человекочитаемое имя, используйте <code>| fields entity.name</code> вместо <code>| fields id</code>.
=== Замена переменных ===
В плитках '''DQL''' у вас есть четыре варианта обёртывания значения переменной и того, как заполнитель переменной заменяется перед выполнением запроса. Эти параметры применяются только к плиткам '''DQL''' и игнорируются для плиток '''Код''' и '''Markdown'''.
<code>$varName</code> '''(по умолчанию)**:'''
* Если вы не указываете стратегию (например, <code>$varName</code>), значение переменной оборачивается в двойные кавычки ("). Это полезно для строк, таких как имена сущностей или категории.
* Любые кавычки внутри переменных экранируются и игнорируются.
* Чтобы экранировать символ двойной кавычки, используйте двойную обратную косую черту: <code>\\"</code>.
* Например, для сервиса с именем <code>PaymentBackend</code> в запросе '''DQL''', где мы фильтруем по этому сервису, со стратегией по умолчанию мы заменим заполнитель переменной после = в правой части фильтра так:
<pre>
| filter dt.entity.service = "PaymentBackend"
</pre><code>$varName:noquote</code>:
* Если вы следуете за именем переменной с <code>:noquote</code> (например, <code>$varName:noquote</code>), значение переменной не оборачивается в кавычки. Это полезно для чисел, единиц измерения или имён функций.
* Разрешены только алфавитно-цифровые символы, точка (.), подчёркивание (_) и дефис (-).
* Запрос завершится ошибкой, если значения содержат любые другие символы.
* Например, для сервиса с именем <code>PaymentBackend</code> в запросе '''DQL''', где мы фильтруем по этому сервису, со стратегией no-quote мы заменим заполнитель переменной после = в правой части фильтра так:
<pre>
| filter dt.entity.service = PaymentBackend
</pre><code>$varName:backtick</code>:
* Если вы следуете за именем переменной с <code>:backtick</code> (например, <code>$varName:backtick</code>), значение переменной оборачивается в символы обратной кавычки.
* Чтобы экранировать обратную кавычку, используйте двойную обратную косую черту: <code>\\`</code>.
* Любые обратные кавычки внутри переменных экранируются и игнорируются.
* '''Пример использования''': идентификаторы полей.
* Например, для сервиса с именем <code>PaymentBackend</code> в запросе '''DQL''', где мы фильтруем по этому сервису, со стратегией backtick мы заменим заполнитель переменной после = в правой части фильтра так:
<pre>
| filter dt.entity.service = `PaymentBackend`
</pre><code>$varName:triplequote</code>:
* Если вы следуете за именем переменной с <code>:triplequote</code> (например, <code>$varName:triplequote</code>), значение переменной оборачивается в символы """. Это полезно для необработанного содержимого, такого как '''JSON''', без экранирования.
* Ничего не экранируется внутри значения.
* Запрос завершится ошибкой, если значение содержит """.
* Например, для сервиса с именем <code>PaymentBackend</code> в запросе '''DQL''', где мы фильтруем по этому сервису, со стратегией triple quote мы заменим заполнитель переменной после = в правой части фильтра так:
<pre>
| filter dt.entity.service = """PaymentBackend"""
</pre>
=== Переменная-список ===
=== Переменная-список ===
'''Чтобы определить переменную-список'''
Чтобы определить переменную-список:


# Установите '''Имя''' — имя, которое хотите дать вашей переменной.
# Установите '''Имя''' — имя, которое хотите дать вашей переменной. Оно отображается в верхней части дашборда и указано на панели '''Переменные'''. Оно может содержать любые символы, например: <code>status</code>, <code>myHosts</code>, <code>Variable01</code> или <code>My Total</code>.
#* Оно отображается в верхней части дашборда и указано на панели '''Переменные'''. Оно может содержать любые символы, например: <code>status</code>, <code>myHosts</code>, <code>Variable01</code> или <code>My Total</code>.
#* '''Ключ-АСТРОМ''' выводит ключ из имени, заменяя любой символ, не являющийся буквой или цифрой, на <code>_</code>. Используйте ключ с префиксом <code>$</code>, чтобы ссылаться на переменную.
#* Ключ-АСТРОМ выводит ключ из имени, заменяя любой символ, не являющийся буквой или цифрой, на _. Например, имя <code>My Total</code> становится ключом <code>My_Total</code>. Используйте ключ с префиксом $, чтобы ссылаться на переменную в запросах, коде и заголовках.
# Установите '''Тип''' в '''Список'''.
#* Ключ не может начинаться с зарезервированного префикса <code>dt_</code>.
#* Чтобы найти ключ переменной, откройте её меню или проверьте выноску, отображаемую, пока переменная ещё не используется.
# Установите '''Тип''' в <code>Список</code>.
# В разделе '''Данные''' введите список возможных значений через запятую, например: <code>dog,cat,horse</code>. Обязательно удалите лишние пробелы из вашего списка.
# В разделе '''Данные''' введите список возможных значений через запятую, например: <code>dog,cat,horse</code>. Обязательно удалите лишние пробелы из вашего списка.
# Проверьте результаты в разделе '''Предварительный просмотр''', чтобы убедиться, что всё работает как ожидалось.
# Проверьте результаты в разделе '''Предварительный просмотр''', чтобы убедиться, что всё работает как ожидалось.
# Если вы хотите иметь возможность выбирать более одного значения за раз, включите '''Множественный выбор'''.
# Если вы хотите иметь возможность выбирать более одного значения за раз, включите '''Множественный выбор'''. Ваши изменения сохраняются автоматически.
# Ваши изменения сохраняются автоматически.
# Закройте панель '''Переменная'''.
# Закройте панель '''Переменная'''.


'''Пример переменной-списка'''
'''Пример переменной-списка''' Этот пример добавит переменную <code>$Status</code> на ваш дашборд с возможностью выбора более одного статуса за раз и с четырьмя возможными значениями: <code>WARN</code>, <code>ERROR</code>, <code>INFO</code>, <code>NONE</code>.
 
Этот пример добавит переменную <code>$Status</code> на ваш дашборд с возможностью выбора более одного статуса за раз и с четырьмя возможными значениями: <code>WARN</code>, <code>ERROR</code>, <code>INFO</code>, <code>NONE</code>.


* '''Имя''': <code>Status</code>
* '''Имя''': <code>Status</code>
Строка 274: Строка 117:


=== Переменная-код ===
=== Переменная-код ===
'''Чтобы определить переменную-код'''
Чтобы определить переменную-код:


# Установите '''Имя''' — имя, которое хотите дать вашей переменной.
# Установите '''Имя''' — имя, которое хотите дать вашей переменной.
#* Оно отображается в верхней части дашборда и указано на панели '''Переменные'''. Оно может содержать любые символы, например: <code>status</code>, <code>myHosts</code>, <code>Variable01</code> или <code>My Total</code>.
# Установите '''Тип''' в '''Код'''.
#* Ключ-АСТРОМ выводит ключ из имени, заменяя любой символ, не являющийся буквой или цифрой, на _. Например, имя <code>My Total</code> становится ключом <code>My_Total</code>. Используйте ключ с префиксом $, чтобы ссылаться на переменную в запросах, коде и заголовках.
# В разделе '''Данные''' введите код JavaScript. По соображениям безопасности при использовании переменных в плитках кода вы можете получить к ним доступ только внутри функции по умолчанию.
#* Ключ не может начинаться с зарезервированного префикса <code>dt_</code>.
#* Чтобы найти ключ переменной, откройте её меню или проверьте выноску, отображаемую, пока переменная ещё не используется.
# Установите '''Тип''' в <code>Код</code>.
# В разделе '''Данные''' введите код '''JavaScript'''.
#* По соображениям безопасности при использовании переменных в плитках кода вы можете получить к ним доступ только внутри функции по умолчанию.
# Выберите '''Запустить''' и проверьте результаты в разделе '''Предварительный просмотр''', чтобы убедиться, что всё работает как ожидалось.
# Выберите '''Запустить''' и проверьте результаты в разделе '''Предварительный просмотр''', чтобы убедиться, что всё работает как ожидалось.
# Если вы хотите иметь возможность выбирать более одного значения за раз, включите '''Множественный выбор'''.
# Если вы хотите иметь возможность выбирать более одного значения за раз, включите '''Множественный выбор'''. Ваши изменения сохраняются автоматически.
# Ваши изменения сохраняются автоматически.
# Закройте панель '''Переменная'''.
# Закройте панель '''Переменная'''.


Строка 294: Строка 131:
* '''Тип''': <code>Код</code>
* '''Тип''': <code>Код</code>
* '''Определение''':
* '''Определение''':
<pre>
<pre>/*
/*
* This will run JavaScript in the Astromkey
* This will run JavaScript in the Astromkey
* serverless environment.
* serverless environment.
Строка 302: Строка 138:
export default async function () {
export default async function () {
return ["val1", "val2", "val3"]
return ["val1", "val2", "val3"]
}
}</pre>
</pre>


=== Переменная свободного текста ===
=== Переменная свободного текста ===
'''Чтобы определить переменную свободного текста'''
Чтобы определить переменную свободного текста:


# Установите '''Имя''' — имя, которое хотите дать вашей переменной.
# Установите '''Имя''' — имя, которое хотите дать вашей переменной.
#* Оно отображается в верхней части дашборда и указано на панели '''Переменные'''. Оно может содержать любые символы, например: <code>status</code>, <code>myHosts</code>, <code>Variable01</code> или <code>My Total</code>.
# Установите '''Тип''' в '''Свободный текст'''.
#* Ключ-АСТРОМ выводит ключ из имени, заменяя любой символ, не являющийся буквой или цифрой, на _. Например, имя <code>My Total</code> становится ключом <code>My_Total</code>. Используйте ключ с префиксом $, чтобы ссылаться на переменную в запросах, коде и заголовках.
#* Ключ не может начинаться с зарезервированного префикса <code>dt_</code>.
#* Чтобы найти ключ переменной, откройте её меню или проверьте выноску, отображаемую, пока переменная ещё не используется.
# Установите '''Тип''' в <code>Свободный текст</code>.
# Вы можете ввести '''Значение по умолчанию'''.
# Вы можете ввести '''Значение по умолчанию'''.


== Ограничения при использовании переменных в плитках ==
== Ограничения при использовании переменных в плитках ==
Переменные в ваших плитках могут быть строкового или числового типа. Случаи, требующие другого типа данных (например, длительности), приводят к неудачным запросам. Ниже приведены некоторые примеры того, как обойти такие ситуации.
Переменные в ваших плитках могут быть строкового или числового типа. Случаи, требующие другого типа данных (например, длительности), приводят к неудачным запросам.


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


=== Разрешение в команде DQL ===
'''Максимальный общий размер переменных в URL дашборда''' Если значения переменных превышают 30 КБ, они не могут быть сохранены в URL дашборда.
Прямое использование переменной <code>$resolution</code> (как в следующем запросе) не работает, поскольку <code>resolution</code> требует предопределённого формата данных, а переменная возвращает строковое значение.<pre>
fetch logs
    | ...
    | summarize count(), by: {loglevel, bin(timestamp, $resolution)}
</pre>В качестве обходного пути вы можете использовать функцию <code>duration</code> вместе с функцией преобразования '''DQL'''. Это обеспечивает требуемый вывод на основе вашего значения <code>$resolution</code>.<pre>
fetch logs
    | ...
    | summarize count(), by: {loglevel, bin(timestamp, duration(toLong($resolution), unit:"m"))}
</pre>


=== Преобразование значений переменных в другие типы данных ===
* Если вы поделитесь URL дашборда со значениями переменных, превышающими ограничение размера, значения переменных не будут сохранены в URL, поэтому человек, открывающий дашборд по общей ссылке, не увидит выбранные значения.
Если вы хотите отфильтровать числовое значение, но сравнить его со строковым представлением, вы можете использовать встроенную функцию преобразования '''DQL''', такую как <code>toString</code>.<pre>
* Если вы сохраните URL дашборда в закладки со значениями переменных, превышающими ограничение размера, и откроете дашборд из этой закладки через 90 дней, выбранные значения не будут установлены.
fetch logs
    | filter amount = toString($amount)
    | ...
</pre>
 
== Максимальный общий размер переменных в URL дашборда ==
Если значения переменных превышают 30 КБ, они не могут быть сохранены в '''URL''' дашборда.
 
* Если вы поделитесь '''URL''' дашборда со значениями переменных, превышающими ограничение размера, значения переменных не будут сохранены в '''URL''', поэтому человек, открывающий дашборд по общей ссылке, не увидит выбранные значения.
* Если вы сохраните '''URL''' дашборда в закладки со значениями переменных, превышающими ограничение размера, и откроете дашборд из этой закладки через 90 дней, выбранные значения не будут установлены.


== Устранение неполадок переменных ==
== Устранение неполадок переменных ==
Строка 352: Строка 164:
* Значок предупреждения.
* Значок предупреждения.


Чтобы исследовать предупреждение, выберите значок предупреждения (или выберите '''> Все переменные'''), чтобы перечислить все переменные.
Чтобы исследовать предупреждение, выберите значок предупреждения (или выберите '''> Все переменные'''), чтобы перечислить все переменные. Там снова четыре переменные. Две из этих переменных — <code>Variable1</code> и <code>Variable2</code> — отображают значок предупреждения, указывающий на возможные проблемы с каждой из них. Чтобы увидеть, почему есть предупреждение для конкретной переменной, выберите её.
 
* Там снова четыре переменные: <code>LogLevels</code>, <code>MyFreeTextVariable</code>, <code>Variable1</code> и <code>Variable2</code>.
* Две из этих переменных — <code>Variable1</code> и <code>Variable2</code> — отображают значок предупреждения, указывающий на возможные проблемы с каждой из них. Чтобы увидеть, почему есть предупреждение для конкретной переменной, выберите её.


В этом примере мы выбрали <code>Variable1</code>, чтобы отобразить определение переменной и любое связанное сообщение об ошибке или предупреждении. Отсюда мы видим, что забыли сослаться на переменную где-либо.
В этом примере мы выбрали <code>Variable1</code>, чтобы отобразить определение переменной и любое связанное сообщение об ошибке или предупреждении. Отсюда мы видим, что забыли сослаться на переменную где-либо.

Текущая версия от 21:54, 16 ноября 2026

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

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

Устарело: поля dt.entity.* Если вы видите следующее сообщение:

> Поля dt.entity.* устарели. Пожалуйста, используйте поля dt.smartscape.* вместо них.

мы рекомендуем использовать эквивалентное поле dt.smartscape.*. Устаревшие поля dt.entity.* в конечном итоге будут удалены.

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

Чтобы добавить переменную на дашборд:

  1. В заголовке дашборда откройте меню Добавить и выберите Переменные. Сочетание клавиш: Shift+V. Отображается панель Переменная.
  2. Определите переменную.
    • Имя: имя переменной. Оно отображается на дашборде и может содержать любые символы.
    • Ключ-АСТРОМ выводит ключ из имени, заменяя любой символ, не являющийся буквой или цифрой, на _. Добавьте префикс $ к ключу, чтобы ссылаться на переменную в коде и заголовках. Ключ не может начинаться с зарезервированного префикса dt_. Чтобы найти ключ переменной, откройте её меню или проверьте выноску, отображаемую, пока переменная ещё не используется.
    • Тип: может быть одним из следующих:
      • Код: значение возвращается из кода, который вы вводите при определении переменной.
      • Список: список значений с разделителями-запятыми (CSV). Чтобы определить возможные значения, введите их (через запятую) в поле под Данными. Чтобы определить значение по умолчанию, выберите одно из списка Значение по умолчанию. Чтобы разрешить выбор нескольких значений одновременно, включите Множественный выбор.
      • Свободный текст: произвольный текст. Вы можете ввести Значение по умолчанию. Ваши изменения сохраняются автоматически.
  3. Настройте Параметры отображения:
    • Если раскрывающийся список переменной должен отображаться на дашборде, включите Отображать как фильтр на дашборде. Отключите его, когда хотите скрыть его, например, когда переменная используется как статическое значение across плиток, но не должна отображаться пользователю дашборда.
    • Если пользователи вашего дашборда должны иметь возможность выбирать несколько значений одновременно в раскрывающемся списке переменной, включите Множественный выбор. Отключите его, когда хотите использовать только отдельные значения раскрывающегося списка переменной.
    • Выберите Значение по умолчанию для раскрывающегося списка переменной. Если вы ничего не введёте в это поле, будет выбрано первое доступное значение.
  4. Когда закончите, выберите < Переменная в верхней части, чтобы перейти на панель Переменные, или выберите соответствующую кнопку, чтобы закрыть панель Переменные.

Переменные в дашбордах могут быть определены как зависимые от других переменных. Значение переменной пересчитывается, если её определение ссылается на другую переменную и значение другой переменной изменяется. Например, если значение переменной A изменяется, значение любой переменной, определение которой ссылается на переменную A, пересчитывается. Циклы не допускаются. Например, если значение переменной A зависит от значения переменной B, значение переменной B не может зависеть от значения переменной A.

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

После создания переменной вы готовы использовать её. Всегда помните о необходимости добавлять префикс $ к ключу переменной. Ключ-АСТРОМ выводит ключ из имени переменной, заменяя любой символ, не являющийся буквой или цифрой, на _. Например, переменная с именем My Total получает ключ My_Total, поэтому вы ссылаетесь на неё как $My_Total.

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

Использование с плиткой Explore

Чтобы использовать переменную в плитке данных Explore:

  1. Откройте меню и выберите Логи.
  2. Выберите соответствующий значок и затем выберите host.name из Доступных фильтров.
  3. В добавленном поле фильтра введите $, чтобы получить предложения для всех доступных переменных, затем выберите $Host.

Примечание: добавление переменных в плитки Explore работает только для переменных с одиночным выбором в сочетании с оператором =.

Список переменных

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

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

В этом примере для дашборда определены четыре переменные — LogLevels, MyFreeTextVariable, Variable1 и Variable2, и мы можем видеть их текущие значения под их именами. Две из переменных — Variable1 и Variable2 — отображают значок предупреждения. Подробности см. в разделе «Устранение неполадок переменных».

Отсюда у вас есть следующие параметры, специфичные для переменных:

  • Чтобы просмотреть или изменить определение переменной, выберите её имя.
  • Чтобы добавить переменную, выберите Переменная.
  • Чтобы скрыть или отобразить переменную, выберите соответствующий значок.
    • Скрытая переменная с одиночным или множественным выбором автоматически определяет своё значение из доступных параметров; она не использует сохранённое значение по умолчанию.
    • Скрытые переменные с множественным выбором определяются как * (все параметры).
    • Скрытые переменные с одиночным выбором определяются как первый доступный параметр.
    • Сохранённое значение по умолчанию сохраняется и восстанавливается, если вы снова сделаете переменную видимой. Чтобы закрепить скрытую переменную за конкретным значением, используйте вместо этого переменную свободного текста.
  • Чтобы переместить переменную вверх или вниз по списку, выберите соответствующий значок и перетащите переменную на новую позицию в списке.
  • Чтобы увидеть другие параметры, специфичные для переменной — Редактировать, Дублировать, Переместить вверх, Переместить вниз и Удалить — откройте меню.

Сброс переменных

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

Редактирование переменной

Чтобы отредактировать переменную:

  1. Откройте меню и выберите Все переменные.
  2. В столбце Имя выберите имя переменной, которую хотите отредактировать.
  3. Отредактируйте и проверьте переменную. То, как вы редактируете переменную, зависит от Типа.
  4. Выберите соответствующую кнопку, чтобы закрыть панель Переменные.

Удаление переменной

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

  1. Откройте меню и выберите Все переменные.
  2. Найдите переменную, которую хотите удалить, в столбце Имя, откройте меню для этой строки и выберите Удалить.
  3. Выберите соответствующую кнопку, чтобы закрыть панель Переменные.

Изменение значений переменных

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

Чтобы изменить значение переменной:

  1. В левом верхнем углу дашборда найдите имя переменной.
  2. Используйте меню или поле редактирования под именем переменной, чтобы изменить значение.
    • Если переменная допускает только один выбор (значение) за раз, выберите значение, которое хотите применить к дашборду.
    • Если переменная допускает несколько выборов (значений) за раз, установите флажок для каждого значения, которое хотите применить к дашборду. Имя меню для этой переменной показывает, сколько значений выбрано.
    • Для переменной Свободный текст вы можете редактировать текст в поле под именем переменной.

Изменение порядка переменных

Чтобы изменить порядок переменных на вашем дашборде:

  1. Откройте меню и выберите Все переменные.
  2. Перетащите переменные в нужный порядок. Как вариант: откройте меню для переменной, которую хотите переместить, и выберите Переместить вверх или Переместить вниз.

Типы переменных

Переменная-список

Чтобы определить переменную-список:

  1. Установите Имя — имя, которое хотите дать вашей переменной. Оно отображается в верхней части дашборда и указано на панели Переменные. Оно может содержать любые символы, например: status, myHosts, Variable01 или My Total.
    • Ключ-АСТРОМ выводит ключ из имени, заменяя любой символ, не являющийся буквой или цифрой, на _. Используйте ключ с префиксом $, чтобы ссылаться на переменную.
  2. Установите Тип в Список.
  3. В разделе Данные введите список возможных значений через запятую, например: dog,cat,horse. Обязательно удалите лишние пробелы из вашего списка.
  4. Проверьте результаты в разделе Предварительный просмотр, чтобы убедиться, что всё работает как ожидалось.
  5. Если вы хотите иметь возможность выбирать более одного значения за раз, включите Множественный выбор. Ваши изменения сохраняются автоматически.
  6. Закройте панель Переменная.

Пример переменной-списка Этот пример добавит переменную $Status на ваш дашборд с возможностью выбора более одного статуса за раз и с четырьмя возможными значениями: WARN, ERROR, INFO, NONE.

  • Имя: Status
  • Тип: Список
  • Определение: WARN,ERROR,INFO,NONE
  • Множественный выбор: включён

Переменная-код

Чтобы определить переменную-код:

  1. Установите Имя — имя, которое хотите дать вашей переменной.
  2. Установите Тип в Код.
  3. В разделе Данные введите код JavaScript. По соображениям безопасности при использовании переменных в плитках кода вы можете получить к ним доступ только внутри функции по умолчанию.
  4. Выберите Запустить и проверьте результаты в разделе Предварительный просмотр, чтобы убедиться, что всё работает как ожидалось.
  5. Если вы хотите иметь возможность выбирать более одного значения за раз, включите Множественный выбор. Ваши изменения сохраняются автоматически.
  6. Закройте панель Переменная.

Пример переменной-кода

  • Имя: CodeVariable
  • Тип: Код
  • Определение:
/*
* This will run JavaScript in the Astromkey
* serverless environment.
* To generate variable options return string array.
*/
export default async function () {
return ["val1", "val2", "val3"]
}

Переменная свободного текста

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

  1. Установите Имя — имя, которое хотите дать вашей переменной.
  2. Установите Тип в Свободный текст.
  3. Вы можете ввести Значение по умолчанию.

Ограничения при использовании переменных в плитках

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

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

Максимальный общий размер переменных в URL дашборда Если значения переменных превышают 30 КБ, они не могут быть сохранены в URL дашборда.

  • Если вы поделитесь URL дашборда со значениями переменных, превышающими ограничение размера, значения переменных не будут сохранены в URL, поэтому человек, открывающий дашборд по общей ссылке, не увидит выбранные значения.
  • Если вы сохраните URL дашборда в закладки со значениями переменных, превышающими ограничение размера, и откроете дашборд из этой закладки через 90 дней, выбранные значения не будут установлены.

Устранение неполадок переменных

Дашборд с одной или несколькими определёнными переменными отображает переменные в строке под именем дашборда. В этом примере вы можете видеть:

  • Меню переменных.
  • Четыре переменные: LogLevels, MyFreeTextVariable, Variable1 и Variable2.
  • Значок предупреждения.

Чтобы исследовать предупреждение, выберите значок предупреждения (или выберите > Все переменные), чтобы перечислить все переменные. Там снова четыре переменные. Две из этих переменных — Variable1 и Variable2 — отображают значок предупреждения, указывающий на возможные проблемы с каждой из них. Чтобы увидеть, почему есть предупреждение для конкретной переменной, выберите её.

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