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

В динамических или крупных средах ручное присвоение тегов для хостов может быть нецелесообразным. Для динамических развертываний, включающих часто меняющиеся компоненты и имена хостов (например, AWS или MS Azure), следует автоматизировать добавление тегов и метаданных к хостам.

=== Теги ===
Для автоматизации добавления тегов к хостам с помощью ЕдиногоАгента '''версии 1.189''' '''и выше''' используйте параметры командной строки ЕдиногоАгента. Для более ранних версий используйте файл конфигурации тегов хостов.

=== Параметры командной строки ЕдиногоАгента для тегов ===
<code>ЕдиныйАгент версии 1.189+</code>

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

* Linux и AIX - <code>./oneagentctl --set-host-tag=TestHost --set-host-tag=role=fallback --set-host-tag=Gdansk</code>
* Windows - <code>.\oneagentctl.exe --set-host-tag=TestHost --set-host-tag=role=fallback --set-host-tag=Gdansk</code>  Вы можете добавить или изменить несколько тегов в одной команде. Вы также можете определить теги с одним и тем же ключом, но разными значениями.

Для получения дополнительной информации <code>oneagentctl</code> см. раздел Настройка ЕдиногоАгента через интерфейс командной строки.

=== Редактировать файл конфигурации тега хоста ===
<code>ЕдиныйАгент версии 1.187 и более ранних</code>
{| class="wikitable"
|'''Кодировка UTF-8'''

Любые созданные файлы <code>hostcustomproperties.conf</code> и <code>hostautotag.conf</code> должны быть в кодировке UTF-8.
|}
Во время установки ЕдиногоАгента установщик создаёт простой файл конфигурации <code>hostautotag.conf</code> на контролируемом хосте. В '''Windows''' этот файл находится в папке <code>%PROGRAMDATA%\astromkey\oneagent\agent\config</code>, а в Linux — в папке <code>/var/lib/astromkey/oneagent/agent/config</code>.

Файл должен содержать список строк или пар «ключ/значение», которые будут отправляться на сервер при каждом изменении файла. Для разделения значений тегов используются новые строки или пробелы. Например:
{| class="wikitable"
|TestHost Gdansk role=fallback
|}

=== Результат ===
После настройки теги отображаются в верхней части раздела '''Свойства и теги''' на странице обзора хоста.

Теги, созданные с помощью <code>oneagentctl</code>, ведут себя аналогично автоматизированным тегам, основанным на правилах, и тегам, основанным на переменных среды .

Они имеют префикс в виде строки <code>[Environment]</code> и не могут быть удалены вручную с хоста. Их можно удалить только с помощью команды <code>oneagentctl</code>. Чтобы удалить тег, выполните следующую команду:

* Linux и AIX - <code>./oneagentctl --remove-host-tag=TestHost</code>
* Windows - <code>.\oneagentctl.exe --remove-host-tag=TestHost</code>

Для получения дополнительной информации см. раздел Настройка ЕдиногоАгента через интерфейс командной строки .

=== Другие варианты автоматической маркировки ===
Вы также можете настроить автоматическую создание тегов хостов в своей среде, используя:

* Автоматизированные правила
* Переменные среды
* Smartscape и API топологии

== Метаданные хоста ==
Для автоматизации добавления метаданных к хостам с помощью ЕдиногоАгента '''версии 1.189 и выше''' используйте параметры командной строки. Для более ранних версий используйте файл конфигурации метаданных хоста.

=== Параметры командной строки ЕдиногоАгента для метаданных хоста ===
<code>ЕдиныйАгент версии 1.189+</code>

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

* Linux и AIX - <code>./oneagentctl --set-host-property=AppName=easyTravel --set-host-property=Environment=Dev</code>
* Windows - <code>.\oneagentctl.exe --set-host-property=AppName=easyTravel --set-host-property=Environment=Dev</code>  Вы можете добавить или изменить более одного свойства в одной команде.

Чтобы установить контекст безопасности для вашего хоста, используйте следующую команду:

* Linux и AIX - <code>./oneagentctl --set-host-property=dt.security_context=easytrade_sec</code>
* Windows - <code>.\oneagentctl.exe --set-host-property=dt.security_context=easytrade_sec</code>

Используется <code>dt.security_context</code> несколькими функциями Ключ-АСТРОМ, такими как контекст безопасности логов и контекст безопасности бизнес-событий. Кроме того, если вы администратор учётной записи и хотите предоставить доступ к отслеживаемым объектам на основе их контекста безопасности, см. раздел Предоставление доступа к объектам с контекстом безопасности.

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

* Linux и AIX - <code>./oneagentctl --remove-host-property=AppName --remove-host-property=Environment=Dev</code>
* Windows - <code>.\oneagentctl.exe --remove-host-property=AppName --remove-host-property=Environment=Dev</code>

Для получения дополнительной информации см. раздел Настройка ЕдиногоАгента через интерфейс командной строки.

=== Редактировать файл конфигурации метаданных хоста ===
<code>ЕдиныйАгент версии 1.187 и более ранних</code>

Процесс настройки свойств аналогичен процессу настройки тегов, но здесь они настраиваются через файл <code>hostcustomproperties.conf</code>, который вам необходимо создать и добавить в директории конфигурации ЕдиногоАгента.

* Windows: <code>%PROGRAMDATA%\dynatrace\oneagent\agent\config</code>
* Все Unix-подобные системы: <code>/var/lib/dynatrace/oneagent/agent/config</code>

=== Результат ===
После настройки пользовательские свойства отображаются в разделе '''Метаданные среды''' в разделе '''Свойства и теги''' на странице обзора хоста. Вы можете настроить правила автоматической маркировки, чтобы включить маркировку этих свойств.