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

Материал из Документация Ключ-АСТРОМ
Версия от 14:15, 10 июня 2026; IKuznetsov (обсуждение | вклад)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

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

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

Рекомендация

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

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

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

Определите теги как переменные среды

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

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

Как задать переменную среды для IIS версий ниже 10

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

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

Как задать переменную среды для Windows

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

Пример:

DT_CUSTOM_PROP=COUNTRY=Austria CITY=Linz

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

Фильтрация объектов на основе переменных среды

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

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