LOGORIC / KNOWLEDGE

Инструкции и шаблоны

Настройка каждого раздела, проверка результата и готовые сценарии для вашего проекта.

Подключение · Руководство на русском

HTTP JSON и OpenTelemetry

HTTP JSON: /api/v1/ingest. OTLP/HTTP logs: /v1/logs. OTLP/gRPC logs: порт 4317 с Authorization metadata.

Порядок настройки

  1. Создайте источник и возьмите токен. Для JSON используйте рецепт ниже; адрес подставляется из текущего браузера. SOURCE_TOKEN заменяйте только на своей машине.
  2. Для OTLP подключите существующий Collector: exporter otlphttp с endpoint, равным корневому URL Logoric; он добавит /v1/logs. Передайте Authorization: Bearer через secret/env.
  3. Настройте service.name у sender для своей инфраструктуры. В Logoric назначение определяется токеном источника, связанным с сервисом; не используйте один токен для независимых систем.
  4. Передавайте severity и duration_ms для JSON. p95 требует duration_ms; логовая успешность — это доля error-событий, она не равна доступности HTTP без корректной инструментализации.
  5. При повторах JSON задавайте стабильный UUID event_id: дедупликация действует 10 минут. Не генерируйте новый UUID для retry того же события.
  6. Откройте «Источники» → «Подключить источник»: готовые curl, OTLP/HTTP, Collector, Python и агент содержат адрес установки. Для контейнеров и удалённых отправителей используйте сетевой адрес сервера, доступный именно отправителю.

Ожидаемый результат

Первый безопасный сигнал виден в Live; после закрытия минуты появляется агрегат. Исходный body в историю не записывается.

Если не получается

404 — перепутан OTLP /v1/logs и control /api/v1. Для Collector используйте log pipeline; traces/metrics OTLP здесь не реализованы.