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

Материал из Документация Ключ-АСТРОМ
Версия от 16:38, 21 июля 2025; IKuznetsov (обсуждение | вклад) (Новая страница: «В динамических или крупных средах ручное присвоение тегов для хостов может быть нецелес...»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)

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

Теги

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

Параметры командной строки ЕдиногоАгента для тегов

ЕдиныйАгент версии 1.189+

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

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

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

Редактировать файл конфигурации тега хоста

ЕдиныйАгент версии 1.187 и более ранних

Кодировка UTF-8

Любые созданные файлы hostcustomproperties.conf и hostautotag.conf должны быть в кодировке UTF-8.

Во время установки ЕдиногоАгента установщик создаёт простой файл конфигурации hostautotag.conf на контролируемом хосте. В Windows этот файл находится в папке %PROGRAMDATA%\astromkey\oneagent\agent\config, а в Linux — в папке /var/lib/astromkey/oneagent/agent/config.

Файл должен содержать список строк или пар «ключ/значение», которые будут отправляться на сервер при каждом изменении файла. Для разделения значений тегов используются новые строки или пробелы. Например:

TestHost Gdansk role=fallback

Результат

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

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

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

  • Linux и AIX - ./oneagentctl --remove-host-tag=TestHost
  • Windows - .\oneagentctl.exe --remove-host-tag=TestHost

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

Другие варианты автоматической маркировки

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

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

Метаданные хоста

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

Параметры командной строки ЕдиногоАгента для метаданных хоста

ЕдиныйАгент версии 1.189+

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

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

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

  • Linux и AIX - ./oneagentctl --set-host-property=dt.security_context=easytrade_sec
  • Windows - .\oneagentctl.exe --set-host-property=dt.security_context=easytrade_sec

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

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

  • Linux и AIX - ./oneagentctl --remove-host-property=AppName --remove-host-property=Environment=Dev
  • Windows - .\oneagentctl.exe --remove-host-property=AppName --remove-host-property=Environment=Dev

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

Редактировать файл конфигурации метаданных хоста

ЕдиныйАгент версии 1.187 и более ранних

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

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

Результат

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

Источник — https://doc.fit4u.kz/index.php?title=Определение_тегов_и_метаданных_хостов&oldid=5494