API для приема логов: различия между версиями
Новая страница: «= API для приема логов (Logs Classic) = Классический мониторинг логов Ключ-АСТРОМ автоматически собирает данные логов и событий из множества различных технологий. С помощью API для приема логов вы можете передавать записи логов в систему потоком, а Ключ-АСТРОМ...» |
Нет описания правки |
||
| Строка 1: | Строка 1: | ||
= API для приема логов | = API для приема логов = | ||
Классический мониторинг логов | Классический мониторинг логов | ||
| Строка 14: | Строка 14: | ||
Управляемые конечные точки Ключ-АСТРОМ версии 1.292+: | Управляемые конечные точки Ключ-АСТРОМ версии 1.292+: | ||
* <code>https://{your-domain}/e/{your-environment-id}/api/v2/logs/ingest</code> | * <code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/logs/ingest</nowiki></code> | ||
* <code>https://{your-domain}/e/{your-environment-id}/api/v2/otlp/v1/logs</code> | * <code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/otlp/v1/logs</nowiki></code> | ||
Конечные точки окружения АктивногоШлюза: | Конечные точки окружения АктивногоШлюза: | ||
* <code>https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/logs/ingest</code> | * <code><nowiki>https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/logs/ingest</nowiki></code> | ||
* <code>https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/otlp/v1/logs</code> | * <code><nowiki>https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/otlp/v1/logs</nowiki></code> | ||
== Очередь данных лога в среде АктивногоШлюза == | == Очередь данных лога в среде АктивногоШлюза == | ||
| Строка 60: | Строка 60: | ||
|} | |} | ||
* '''URL запроса''': <code>https://environment.activegate.domain.com:9999/e/abc123a/api/v2/logs/ingest</code> | * '''URL запроса''': <code><nowiki>https://environment.activegate.domain.com:9999/e/abc123a/api/v2/logs/ingest</nowiki></code> | ||
* '''Содержание ответа''': Успех | * '''Содержание ответа''': Успех | ||
* '''Код ответа''': <code>204</code> | * '''Код ответа''': <code>204</code> | ||
== Поиск неисправностей == | == Поиск неисправностей == | ||
Посетите сообщество Ключ-АСТРОМ, чтобы найти руководства по устранению неполадок, а также ознакомьтесь с разделом «Устранение неполадок мониторинга | Посетите сообщество Ключ-АСТРОМ, чтобы найти руководства по устранению неполадок, а также ознакомьтесь с разделом «Устранение неполадок мониторинга логов». | ||
* Устранение неполадок при приеме логов через API — отправка логов методом POST. | * Устранение неполадок при приеме логов через API — отправка логов методом POST. | ||
Текущая версия от 21:56, 18 июля 2026
API для приема логов
Классический мониторинг логов
Ключ-АСТРОМ автоматически собирает данные логов и событий из множества различных технологий. С помощью API для приема логов вы можете передавать записи логов в систему потоком, а Ключ-АСТРОМ преобразует этот поток в содержательные сообщения логов.
API для приема логов позволяет передавать записи логов в систему потоком. Он доступен через прием логов в формате JSON и TXT (Logs Classic) или через прием логов в формате OTLP.
Для Ключ-АСТРОМ Managed конечная точка приема логов доступна на ваших узлах, начиная с версии Ключ-АСТРОМ 1.292. Если в качестве конечной точки в вашей локальной среде вы выбрали АктивныйШлюз или ваш управляемый кластер использует версию ниже 1.292, установите экземпляр АктивногоШлюза:
- Перейдите в раздел Развертывание Ключ-АСТРОМ.
- Выберите Установить ActiveGate.
API для приема логов версии 2 автоматически включается в АктивныйШлюз. АктивныйШлюз отвечает за предоставление доступа к конечной точке, сбор данных и их пересылку в Ключ-АСТРОМ партиями.
Управляемые конечные точки Ключ-АСТРОМ версии 1.292+:
https://{your-domain}/e/{your-environment-id}/api/v2/logs/ingesthttps://{your-domain}/e/{your-environment-id}/api/v2/otlp/v1/logs
Конечные точки окружения АктивногоШлюза:
https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/logs/ingesthttps://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/otlp/v1/logs
Очередь данных лога в среде АктивногоШлюза
Вы можете настроить свойства очереди данных лога, отредактировав файл custom.properties (см. Свойства конфигурации и параметры АктивногоШлюза) на вашем АктивномШлюзе и задав следующие значения:
[generic_ingest] #disk_queue_path=<custom_path> # по умолчанию используется временная папка #disk_queue_max_size_mb=<limit> # по умолчанию 300 МБ |
Достигнут лимит полезного пространства 503
API для приема данных логов возвращает ошибку 503 Usable space limit reached, если объем принимаемых данных превышает заданный размер очереди. Как правило, это временная ситуация, возникающая только во время пиковых нагрузок. Если ошибка повторяется, увеличьте значение параметра disk_queue_max_size_mb в custom.properties, чтобы разрешить постановку в очередь пиковых нагрузок при приеме данных логов.
Пример
В этом примере API-запрос обрабатывает данные лога, которые создадут событие лога с определенными атрибутами content, status, service.name, и service.namespace.
API-токен передается в заголовке Authorization.
Ответ содержит код ответа 204.
cURL запрос:
curl -X POST \
https://environment.activegate.domain.com:9999/e/abc123a/api/v2/logs/ingest \
-H 'Content-Type: application/json; charset=utf-8' \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
-d '[
{
"content": "Exception: Custom error log sent via Log Ingest API",
"status": "error",
"service.name": "log-monitoring-tenant",
"service.namespace": "dev-stage-cluster"
}
]'
|
- URL запроса:
https://environment.activegate.domain.com:9999/e/abc123a/api/v2/logs/ingest - Содержание ответа: Успех
- Код ответа:
204
Поиск неисправностей
Посетите сообщество Ключ-АСТРОМ, чтобы найти руководства по устранению неполадок, а также ознакомьтесь с разделом «Устранение неполадок мониторинга логов».
- Устранение неполадок при приеме логов через API — отправка логов методом POST.
