IKuznetsov в 21:56, 18 июля 2026

2026-07-18T21:56:23Z

IKuznetsov: Новая страница: «= API для приема логов (Logs Classic) = Классический мониторинг логов Ключ-АСТРОМ автоматически собирает данные логов и событий из множества различных технологий. С помощью API для приема логов вы можете передавать записи логов в систему потоком, а Ключ-АСТРОМ...»

2026-07-18T21:55:45Z

Новая страница: «= API для приема логов (Logs Classic) = Классический мониторинг логов Ключ-АСТРОМ автоматически собирает данные логов и событий из множества различных технологий. С помощью API для приема логов вы можете передавать записи логов в систему потоком, а Ключ-АСТРОМ...»

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

= API для приема логов (Logs Classic) =

Классический мониторинг логов

Ключ-АСТРОМ автоматически собирает данные логов и событий из множества различных технологий. С помощью API для приема логов вы можете передавать записи логов в систему потоком, а Ключ-АСТРОМ преобразует этот поток в содержательные сообщения логов.

API для приема логов позволяет передавать записи логов в систему потоком. Он доступен через прием логов в формате '''JSON''' и '''TXT''' (Logs Classic) или через прием логов в формате '''OTLP'''.

Для Ключ-АСТРОМ Managed конечная точка приема логов доступна на ваших узлах, начиная с версии Ключ-АСТРОМ 1.292.
Если в качестве конечной точки в вашей локальной среде вы выбрали АктивныйШлюз или ваш управляемый кластер использует версию ниже 1.292, установите экземпляр АктивногоШлюза:
# Перейдите в раздел '''Развертывание Ключ-АСТРОМ'''.
# Выберите '''Установить ActiveGate'''.
API для приема логов версии 2 автоматически включается в АктивныйШлюз. АктивныйШлюз отвечает за предоставление доступа к конечной точке, сбор данных и их пересылку в Ключ-АСТРОМ партиями.

Управляемые конечные точки Ключ-АСТРОМ версии 1.292+:
* <code>https://{your-domain}/e/{your-environment-id}/api/v2/logs/ingest</code>
* <code>https://{your-domain}/e/{your-environment-id}/api/v2/otlp/v1/logs</code>

Конечные точки окружения АктивногоШлюза:
* <code>https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/logs/ingest</code>
* <code>https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/otlp/v1/logs</code>

== Очередь данных лога в среде АктивногоШлюза ==
Вы можете настроить свойства очереди данных лога, отредактировав файл <code>custom.properties</code> (см. Свойства конфигурации и параметры АктивногоШлюза) на вашем АктивномШлюзе и задав следующие значения:

{| class="wikitable"
|<pre>
[generic_ingest]
#disk_queue_path=<custom_path> # по умолчанию используется временная папка
#disk_queue_max_size_mb=<limit> # по умолчанию 300 МБ
</pre>
|}

=== Достигнут лимит полезного пространства 503 ===
API для приема данных логов возвращает ошибку <code>503 Usable space limit reached</code>, если объем принимаемых данных превышает заданный размер очереди. Как правило, это временная ситуация, возникающая только во время пиковых нагрузок. Если ошибка повторяется, увеличьте значение параметра <code>disk_queue_max_size_mb</code> в <code>custom.properties</code>, чтобы разрешить постановку в очередь пиковых нагрузок при приеме данных логов.

== Пример ==
В этом примере API-запрос обрабатывает данные лога, которые создадут событие лога с определенными атрибутами <code>content</code>, <code>status</code>, <code>service.name</code>, и <code>service.namespace</code>.

API-токен передается в заголовке <code>Authorization</code>.

Ответ содержит код ответа <code>204</code>.

'''cURL''' запрос:
{| class="wikitable"
|<pre>
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"
}
]'
</pre>
|}

* '''URL запроса''': <code>https://environment.activegate.domain.com:9999/e/abc123a/api/v2/logs/ingest</code>
* '''Содержание ответа''': Успех
* '''Код ответа''': <code>204</code>

== Поиск неисправностей ==
Посетите сообщество Ключ-АСТРОМ, чтобы найти руководства по устранению неполадок, а также ознакомьтесь с разделом «Устранение неполадок мониторинга логов (Logs Classic)».

* Устранение неполадок при приеме логов через API — отправка логов методом POST.

← Предыдущая версия		Версия от 21:56, 18 июля 2026
Строка 1:		Строка 1:
	= API для приема логов ~~(Logs Classic)~~ =		= 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>

	== Поиск неисправностей ==		== Поиск неисправностей ==
	Посетите сообщество Ключ-АСТРОМ, чтобы найти руководства по устранению неполадок, а также ознакомьтесь с разделом «Устранение неполадок мониторинга ~~логов (Logs Classic)»~~.		Посетите сообщество Ключ-АСТРОМ, чтобы найти руководства по устранению неполадок, а также ознакомьтесь с разделом «Устранение неполадок мониторинга логов».

	* Устранение неполадок при приеме логов через API — отправка логов методом POST.		* Устранение неполадок при приеме логов через API — отправка логов методом POST.

API для приема логов - История изменений

IKuznetsov в 21:56, 18 июля 2026