Возможности ЕдиногоАгента

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

Новые функции ЕдиногоАгента полностью поддерживаются и тестируются сразу после их появления.

• Для новых сред вы можете активировать или деактивировать функции ЕдиногоАгента (согласиться) в зависимости от конкретного варианта использования.
• Для существующих сред вновь добавленные функции ЕдиногоАгента по-прежнему требуют отдельной активации от пользователей с разрешением «Запись настроек» (settings.write) в таблице схемы API настроек ЕдиногоАгента.

Область применения

Новые функции ЕдиногоАгента обычно активируются глобально (для всей среды). Однако вы можете включить или отключить их в рамках группы процессов. Настройки группы процессов переопределяют глобальные настройки той же функции ЕдиногоАгента.

Варианты использования

• Поскольку в ЕдиномАгенте постоянно добавляются новые функции, вам необходимо снова включить их в существующих средах мониторинга, чтобы избежать непредвиденных изменений.
• Вы можете отключить некоторые функции ЕдиногоАгента на детальном уровне при решении проблем. Это может быть полезно для определения первопричины проблемы вплоть до конкретной функции. Подробнее см. в статье Устранение неполадок, связанных с глубоким мониторингом ЕдиногоАгента.

Веб-интерфейс или API

• Вы можете включить или отключить функции ЕдиногоАгента через веб-интерфейс Ключ-АСТРОМ на странице функций ЕдиногоАгента на соответствующем уровне (глобальном или группе процессов).
• Вы можете использовать API настроек Ключ-АСТРОМ , чтобы задать те же настройки с помощью вызовов API.

Конфигурация через веб-интерфейс

Чтобы включить или отключить функции ЕдиногоАгента через веб-интерфейс Ключ-АСТРОМ, используйте страницу функций ЕдиногоАгента на соответствующем уровне.

Для каждой функции на странице функций ЕдиногоАгента представлен список требований:

• Минимальная версия ЕдиногоАгента определяет минимальную требуемую версию ЕдиногоАгента. Вы можете включить функцию только в том случае, если версия ЕдиногоАгента соответствует требованиям.
• Требуется перезапуск — указывает, требует ли функция перезапуска процесса, прежде чем она начнет работать.

Глобальная конфигурация

Чтобы включить или отключить функцию ЕдиногоАгента глобально

1. Перейдите в раздел Настройки и выберите Настройки > Функции ЕдиногоАгента.
2. Найдите функцию в списке и включите или выключите ее.

Конфигурация группы процессов

Чтобы включить или отключить функцию ЕдиногоАгента для группы процессов

1. Перейдите в раздел Топология Smartscape.
2. Выберите Процессы.
3. На карте топологии наведите курсор на процесс и нажмите значок ссылки, чтобы перейти на страницу сведений о процессе (пример ниже).
4. На странице сведений о процессе выберите > Настройки.
5. На странице настроек группы процессов выберите вкладку Функции ЕдиногоАгента.
6. Выберите Добавить переопределение, чтобы добавить параметр для конкретного процесса, который переопределяет параметр среды.
7. Введите строку поиска в поле Функция, чтобы найти и выбрать функцию.
8. Установите необходимые переключатели для переопределения, а затем выберите Сохранить изменения.

Конфигурация через API

Используя API настроек, вы можете:

• Включите/отключите настройки функций ЕдиногоАгента.
• Переопределите область действия функции ЕдиногоАгента, чтобы задать другие настройки для определенной группы процессов или процесса.
• Экспортировать текущую конфигурацию из среды

Для использования API необходим токен доступа с правами «Чтение настроек» (settings.read) и «Запись настроек» (settings.write). Чтобы узнать, как его получить, см. раздел Создание токена доступа.

Чтобы использовать API настроек

1. Чтобы узнать формат JSON, необходимый для публикации вашей конфигурации, используйте конечную точку «GET схему» . Идентификатор схемы — builtin:oneagent.features.
2. Для отправки конфигурации используйте конечную точку «POST объект».

Пример: полезная нагрузка JSON для отключения расширения контекста логов Java для неструктурированных логов для определенной группы процессов.

[      {      "schemaId":  "builtin:oneagent.features",      "scope": "PROCESS_GROUP-1",      "value": {              "enabled": false,              "key": "JAVA_LOG_ENRICHMENT_UNSTRUCTURED"          }      } ]

Вы также можете изменить настройки, применяемые ко всей среде, используя область действия среды.

Пример: полезная нагрузка JSON для обеспечения глобальной поддержки Kafka Streams

[      {      "schemaId":  "builtin:oneagent.features",      "scope": "Environment",      "value": {              "enabled": true,              "key": "JAVA_KAFKA_STREAMS"          }      } ]