IKuznetsov: Новая страница: «При создании среды ЕдиныйАгент поставляется с большим набором функций, активированных...»

2025-08-29T19:44:39Z

Новая страница: «При создании среды ЕдиныйАгент поставляется с большим набором функций, активированных...»

Новая страница

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

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

* Для новых сред вы можете активировать или деактивировать функции ЕдиногоАгента (согласиться) в зависимости от конкретного варианта использования.
* Для существующих сред вновь добавленные функции ЕдиногоАгента по-прежнему требуют отдельной активации от пользователей с разрешением «Запись настроек» (<code>settings.write</code>) в [[Настройки API — таблица схем функций ЕдиногоАгента|таблице схемы API настроек ЕдиногоАгента.]]

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

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

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

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

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

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

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

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

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

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

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

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

[[Файл:Image4023.png|граница]]

=== Конфигурация через API ===
Используя API настроек, вы можете:

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

{| class="wikitable"
|Для использования API необходим токен доступа с правами «Чтение настроек» (<code>settings.read</code>) и «Запись настроек» (<code>settings.write</code>). Чтобы узнать, как его получить, см. раздел [[Токены и аутентификация (API)|Создание токена доступа]].
|}

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

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

Пример: полезная нагрузка '''JSON''' для отключения расширения контекста логов '''Java''' для неструктурированных логов для определенной группы процессов.
{| class="wikitable"
|[

{

"schemaId": "builtin:oneagent.features",

"scope": "PROCESS_GROUP-1",

"value": {

"enabled": false,

"key": "JAVA_LOG_ENRICHMENT_UNSTRUCTURED"

}

}

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

Пример: полезная нагрузка '''JSON''' для обеспечения глобальной поддержки '''Kafka Streams'''
{| class="wikitable"
|[

{

"schemaId": "builtin:oneagent.features",

"scope": "Environment",

"value": {

"enabled": true,

"key": "JAVA_KAFKA_STREAMS"

}

}

]
|}

Возможности ЕдиногоАгента - История изменений

IKuznetsov: Новая страница: «При создании среды ЕдиныйАгент поставляется с большим набором функций, активированных...»