IKuznetsov: Новая страница: «Вы можете использовать локальную конечную точку '''API''' `http://localhost:/v2/logs/ingest<...»`


2026-01-15T18:27:11Z
Новая страница: «Вы можете использовать локальную конечную точку '''API''' <code><nowiki>http://localhost</nowiki>:<port>/v2/logs/ingest<...»
Новая страница
Вы можете использовать локальную конечную точку '''API''' <code><nowiki>http://localhost</nowiki>:<port>/v2/logs/ingest</code> для отправки локально полученных логов в Ключ-АСТРОМ по защищенному и аутентифицированному каналу. Эта конечная точка доступна только локальным клиентам и недоступна с удаленных хостов.



Конечная точка приема логов ЕдиногоАгента имитирует поведение общедоступного [[API мониторинг логов - POST прием логов]].



== Включите API для приема логов. ==

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





<u>Включение на уровне среды</u>



# Перейдите в '''Настройки''' и выберите '''Предпочтения''' '''> Контроллер выполнения расширений'''.

# Включите параметр '''Контроллер выполнения расширений'''.

# Включите локальный '''API для сбора HTTP-метрик, логов и событий'''.



<u>Включение на уровне группы хостов</u>



# Перейдите в раздел '''Статус развертывания''', а затем выберите '''ЕдиныйАгент'''.

# На странице развертывания ЕдиногоАгента отключите параметр '''Показывать новые развертывания ЕдиногоАгента'''.

# Отфильтруйте таблицу <code>Host group</code> и выберите группу хостов, которую хотите настроить. <br />Свойство '''Группа хостов''' не отображается, если выбранный хост не принадлежит ни к одной группе хостов.   <br />Здесь отображается страница развертывания ЕдиногоАгента, отфильтрованная по выбранной группе хостов. Для каждого хоста в списке есть ссылка '''Группа хостов:''' <code><group name></code> , где <code><group name></code>— это имя группы хостов, которую вы хотите настроить.

# Выберите имя группы хостов в любой строке. <br />Поскольку вы отфильтровали данные по группе хостов, все отображаемые хосты будут отнесены к одной и той же группе.

# В настройках группы хостов выберите '''Контроллер выполнения расширений'''.

# Включите параметр '''Контроллер выполнения расширений'''.



<u>Включить на уровне одного хоста</u>



# Перейдите в раздел '''Хосты'''.

# Найдите и выберите свой хост, чтобы отобразить страницу обзора хоста.

# В правом верхнем углу страницы обзора хоста выберите '''Дополнительно ( … ) > Настройки'''.

# В настройках хоста выберите '''Контроллер''' '''выполнения''' '''расширений'''.

# Включите параметр '''Контроллер''' '''выполнения''' '''расширений'''.



== Формат событий логов ==

Запрос <code>application/json</code> принимает полезную нагрузку с указанной кодировкой символов <code>charset=utf-8</code>. Для получения дополнительной информации о формате см. [[API мониторинг логов - POST прием логов]].



== Ограничения ==

На события логов, передаваемые в Ключ-АСТРОМ с помощью '''API''' приема логов ЕдиногоАгента, распространяются те же ограничения, что и на общедоступный [[API мониторинг логов - POST прием логов]].



== Пример ==

С помощью этой команды <code>curl</code> вы получите событие <code>Exception: Custom error log sent via OneAgent log ingest</code>, установив уровень серьезности на <code>error</code> и пользовательский атрибут на <code>attribute value</code>. Поскольку метка времени не указана, событие автоматически получает метку времени чтения события. Вы сможете получить доступ к событию в [[Программа просмотра логов|средстве просмотра логов]].

{| class="wikitable"

|curl -i -X POST "<nowiki>http://127.0.0.1:14499/v2/logs/ingest</nowiki>" -H "Content-Type: application/json; charset=utf-8" -d "{\"content\":\"Exception: Custom error log sent via Generic Log Ingest\",\"custom.attribute\":\"attribute value\",\"severity\": \"error\"}"

|}

В случае успешного ответа возвращается код <code>204</code>.

{| class="wikitable"

|HTTP/1.1 204 No Content



Content-Type: application/json



Server: EEC



Content-Length: 116

|}



== Коммуникационный порт ==

{| class="wikitable"

|Начиная с версии ЕдиногоАгента 1.267 и выше, системы AIX также поддерживают сбор метрик.

|}

Порт приема метрик по умолчанию — <code>14499</code>. При необходимости вы можете использовать команду [[ЕдиныйАгент настройка через интерфейс командной строки|oneagentctl]] для проверки или изменения порта. Изменение порта приема метрик требует перезапуска ЕдиногоАгента. Добавьте <code>--restart-service</code> к команде для автоматического перезапуска ЕдиногоАгента.



=== Проверка локального порта ===

Параметр <code>--get-extensions-ingest-port</code> по умолчанию отображает текущий локальный порт приема данных <code>14499</code>.



* '''Linux , AIX''' : <code>./oneagentctl --get-extensions-ingest-port</code>

* '''Windows''' : <code>.\oneagentctl.exe --get-extensions-ingest-port</code>



=== Укажите пользовательский порт для приема данных. ===

Используйте параметр <code>--set-extensions-ingest-port=<arg></code> для установки пользовательского локального порта приема данных.



* '''Linux , AIX''' : <code>./oneagentctl --set-extensions-ingest-port=14499 --restart-service</code>

* '''Windows''' : <code>.\oneagentctl.exe --set-extensions-ingest-port=14499 --restart-service</code>



=== Настройка прокси ===

Настройте прокси-сервер вашего хоста таким образом, чтобы по умолчанию разрешать трафик с локального хоста, направляемый на порт приема метрик <code>14499</code>.



Обратите внимание, что изменение порта для '''API''' приема логов ЕдиногоАгента также влияет на [[API метрик ЕдиногоАгента]], [[Интеграция скриптов метрик|интеграцию скриптов метрик]] и [[Отправка метрик Telegraf в Ключ-АСТРОМ|интеграцию метрик Telegraf]].
API для приема логов ЕдиногоАгента - История изменений

IKuznetsov: Новая страница: «Вы можете использовать локальную конечную точку '''API''' http://localhost:/v2/logs/ingest<...»

IKuznetsov: Новая страница: «Вы можете использовать локальную конечную точку '''API''' `http://localhost:/v2/logs/ingest<...»`
