Просмотр кода страницы Определение тегов на основе переменных среды

= Определение тегов на основе переменных среды =

Ключ-АСТРОМ предоставляет возможность определять теги, как в переменных среды, для процессов и групп процессов.

== Рекомендация ==
Определение тегов в самой среде имеет свои преимущества. Однако это не рекомендуется в качестве универсального решения, поскольку это довольно громоздко и требует тщательного предварительного планирования. Кроме того, это затрудняет внесение изменений в дальнейшем. Поэтому его следует использовать с осторожностью.

Мы рекомендуем определять дополнительные метаданные в развернутой системе. Как правило, следует думать о дополнительных и стандартных метаданных, а не о тегах (то есть метках).

Используйте переменную среды <code>DT_CUSTOM_PROP</code> для определения метаданных. Это позволит вам использовать правила автоматической разметки, основанные на существующих или пользовательских метаданных, для определения наборов фильтров для диаграмм, оповещений и многого другого. Эти теги и правила можно изменять и адаптировать в любое время, и они применяются практически мгновенно без каких-либо изменений в контролируемой среде или приложениях.

== Определите теги как переменные среды ==
Вы можете определить переменную среды <code>DT_TAGS</code> на уровне процесса или хоста. Формат переменной прост. Переменная может содержать простые строки или пары ключ/значение (например, <code>DT_TAGS=MikesStuff easyTravel=Mike</code>). Как видно в приведенном ниже примере процесса '''Windows''', вы можете определить несколько тегов. Пробелы используются для разделения значений тегов.

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

=== Как задать переменную среды для IIS версий ниже 10 ===
Чтобы настроить переменную среды в версиях '''IIS''' младше 10, следуйте приведенным ниже инструкциям.

# Настройте расширенные параметры пула приложений.
# Установите параметр '''Загрузить профиль пользователя''' в значение '''Верно'''.
# Перезапустите '''IIS'''. В командной строке с правами администратора введите <code>iisreset</code>.
# Откройте реестр и перейдите по следующему пути: <code>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\hivelist</code>
# Запустите приложение, чтобы инициализировать пул приложений (или установите режим запуска пула приложений на '''Всегда работает'''), обновите страницу <code>hivelist</code> и найдите новые записи.
# Проверьте <code>C:\Users</code> имя пользователя, который управляет пулом приложений.
# В реестре перейдите к идентификатору пользователя <code>HKEY_USERS</code> и добавьте строковое значение с именем <code>DT_CUSTOM_PROP</code>.
# Введите нужное значение, разделяя пары ключ/значение пробелами.
# Перезапустите '''IIS''' еще раз и проверьте процесс Ключ-АСТРОМ на наличие метаданных среды.

=== Как задать переменную среды для Windows ===
Чтобы настроить группировку процессов для служб '''Windows''', откройте редактор реестра на локальном компьютере и создайте ключ с именем <code>Environment</code> типа <code>REG_MULTI_SZ</code> в <code>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<servicename></code>. Имя переменной должно начинаться со строки <code>DT_CUSTOM_PROP</code>, например, <code>DT_CUSTOM_PROP=NAME_A=valueA</code>. Ключ может содержать несколько записей.

Пример:

<code>DT_CUSTOM_PROP=COUNTRY=Austria CITY=Linz</code>

Применение тегов к хостам (вместо продуманной настройки переменных окружения, как описано здесь) не рекомендуется. То же самое относится к приложениям и процессам. Подробную информацию о настройке <code>DT_CUSTOM_PROP</code> переменных окружения для метаданных приложений '''Tomcat''' или '''WebSphere''', аннотаций '''Kubernetes''' для развертываний на основе '''Kubernetes''' или тегирования '''AWS''' см. в разделе «Метаданные и тегирование приложений».

== Фильтрация объектов на основе переменных среды ==
В пользовательском интерфейсе Ключ-АСТРОМ указанная выше переменная среды приводит к отображению новых фильтров на странице обзора соответствующего процесса. На страницах обзора групп процессов отображается сумма всех тегов всех процессов в группе.

В настоящее время эта функция доступна только для процессов, которые отслеживаются с помощью Единого Агента ('''Java''', веб-сервер '''Apache''', '''NGINX''', '''.NET''', '''Node.js''', '''PHP''', '''Go''' и '''IIS''').