Определение тегов на основе переменных окружения¶
- How-to guide
Dynatrace предоставляет возможность определять теги в виде переменных окружения для процессов и групп процессов.
Рекомендация¶
Определение тегов непосредственно в окружении имеет свои применения. Однако это не рекомендуется в качестве универсального решения, поскольку это довольно громоздко и требует значительного предварительного планирования. Это также затрудняет внесение изменений в дальнейшем. Поэтому используйте этот подход с осторожностью.
Мы рекомендуем определять дополнительные метаданные на уровне развёрнутой системы. Как правило, следует думать о дополнительных метаданных и стандартных метаданных, а не о тегах (то есть метках).
Используйте переменную окружения DT_CUSTOM_PROP для определения метаданных. Это позволяет использовать правила автоматической маркировки на основе существующих или пользовательских метаданных для определения наборов фильтров для графиков, оповещений и многого другого. Эти теги и правила можно изменять и адаптировать в любое время, и они применяются практически мгновенно без каких-либо изменений в контролируемом окружении или приложениях.
Определение тегов как переменных окружения¶
Вы можете определить переменную окружения с именем DT_TAGS на уровне процесса или хоста. Формат переменной прост. Переменная может содержать простые строки или пары ключ/значение (например, DT_TAGS=MikesStuff easyTravel=Mike). Как видно в примере процесса Windows ниже, вы можете определить несколько тегов. Пробелы используются для разделения значений тегов.
Для настройки группы процессов IIS необходимо определить переменную окружения, которую можно использовать в рамках правила. Для настройки переменной окружения в IIS версии 10 или более поздней см. Переменные окружения.
Как определить переменную окружения для IIS ранее версии 10
Настройка переменной окружения для версий IIS ранее 10¶
Для настройки переменной окружения в версиях IIS ранее 10 выполните следующие инструкции.
- Настройте Advanced Settings для Application Pool.
2. Установите Load User Profile в значение True.
3. Перезапустите IIS.
В командной строке с правами администратора введите iisreset.
4. Откройте реестр и перейдите к HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\hivelist
5. Запустите приложение для инициализации AppPool (или установите AppPool Start Mode в значение Always Running), обновите hivelist и найдите новые записи.
6. Проверьте C:\Users для имени пользователя, от которого запускается AppPool.
7. В реестре перейдите к идентификатору пользователя в разделе HKEY_USERS и добавьте String Value с именем DT_CUSTOM_PROP.
8. Добавьте нужное значение с пробелами между парами ключ/значение.
9. Перезапустите IIS ещё раз и проверьте метаданные окружения процесса в Dynatrace.
Как определить переменную окружения для Windows
Для настройки группировки процессов для служб Windows откройте Registry Editor на локальной машине и создайте ключ с именем Environment типа REG_MULTI_SZ в HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<servicename>. Имя переменной должно начинаться со строки DT_CUSTOM_PROP, например, DT_CUSTOM_PROP=NAME_A=valueA. Ключ может содержать несколько записей.
Пример:
Применение тегов к хостам (вместо продуманной настройки переменных окружения, как описано здесь) не рекомендуется. То же самое относится к приложениям и процессам. Подробности о настройке переменной окружения DT_CUSTOM_PROP для метаданных приложений Tomcat или WebSphere, аннотаций Kubernetes для развёртываний на основе Kubernetes или маркировки в AWS см. в разделе Метаданные приложений и маркировка.
Фильтрация сущностей на основе переменных окружения¶
В пользовательском интерфейсе Dynatrace показанная выше переменная окружения приводит к отображению новых фильтров на соответствующей странице обзора процессов (см. ниже). Страницы обзора групп процессов отображают совокупность всех тегов всех процессов в группе.
Эта функция в настоящее время доступна только для процессов, которые глубоко мониторятся через OneAgent (Java, Apache Webserver, NGINX, .NET, Node.js, PHP, Go и IIS).