Передача логов в Ключ-АСТРОМ с помощью Fluent Bit

Материал из Документация Ключ-АСТРОМ
Версия от 21:47, 18 июля 2026; IKuznetsov (обсуждение | вклад) (Новая страница: «= Передача логов в Ключ-АСТРОМ с помощью Fluent Bit (Logs Classic) = Классический мониторинг логов Вы можете отправлять логи в Ключ-АСТРОМ с помощью '''Fluent Bit'''. Настройте '''Fluent Bit''' для отправки логов в универсальный API приема данных Ключ-АСТРОМ. == Возможности == * '''Flue...»)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

Передача логов в Ключ-АСТРОМ с помощью Fluent Bit (Logs Classic)

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

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

Возможности

  • Fluent Bit — это многоплатформенный обработчик и пересыльщик логов, позволяющий собирать данные/логи из различных источников, объединять их и отправлять в несколько пунктов назначения. Он совместим со средами Docker и Kubernetes.
  • Благодаря настраиваемым параметрам Fluent Bit, Ключ-АСТРОМ можно настроить в качестве целевой среды для управления логами и анализа данных http output.
  • Для передачи логов и событий из вашего приложения в Ключ-АСТРОМ вы можете использовать любой из плагинов ввода Fluent Bit.

Конфигурация

Плагин Fluent Bit http output позволяет пересылать ваши логи на конечную точку приема логов Ключ-АСТРОМ.

  1. Получите токен API Ключ-АСТРОМ с областью действия logs.ingest (Ingest Logs).
  2. Разверните Fluent Bit.
  3. Для отправки логов в конечную точку приема логов Ключ-АСТРОМ настройте плагин вывода HTTP через файл конфигурации.
  4. В основной конфигурационный файл Fluent Bit добавьте в раздел Output следующие параметры:
[OUTPUT]
    name http
    match *
    header Content-Type application/json; charset=utf-8
    header Authorization Api-Token {ваш-API-токен-здесь}
    allow_duplicated_headers false
    host {your-environment-id}.live.astromkey.com
    port 443
    uri /api/v2/logs/ingest
    format json
    json_date_format iso8601
    json_date_key timestamp
    tls On
    tls.verify On

Вы можете разместить свой API-токен в заголовке или в качестве переменной GET в URI (см. пример ниже).

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

  1. Перейдите в раздел Развертывание Ключ-АСТРОМ, затем выберите Установить ActiveGate.
  2. API для приема логов версии 2 автоматически включается в АктивныйШлюз.

Пример

Fluent Bit — это рекомендуемое решение, когда критически важно сократить потребление ресурсов. В приведенном ниже примере вам необходимо загрузить логи AWS Fargate. FireLens позволяет настроить Fluent Bit для этой задачи.

Загрузка логов AWS Fargate с помощью Fluent Bit

При создании нового определения задачи с помощью консоли управления AWS раздел интеграции FireLens позволяет легко добавить контейнер маршрутизации логов. Выполните следующие шаги для запуска процесса приема данных:

  1. В консоли управления AWS перейдите в раздел интеграции с Firelens.
  2. Выберите встроенный образ Fluent Bit.
  3. Отредактируйте контейнер, в котором выполняются логи, генерирующие ваше приложение.
  4. В разделе Хранение и ведение логов выберите awsfirelens в качестве драйвера для ведения логов.
  5. Настройки драйвера логов должны указывать на API приема логов вашего SaaS-клиента. Вам необходимо предоставить два заголовка для Fluent Bit: тип контента и токен авторизации. Поскольку FireLens поддерживает только один заголовок, вы можете передать токен как часть URL-адреса. Ваша конфигурация для AWS FireLens должна содержать следующее:
Name: http
TLS: enabled
Format: json
Header: Content-Type application/json; charset=utf-8
Host: {your-environment-id}.live.astromkey.com
Port: 443
URI: /api/v2/logs/ingest?api-token={your-API-token-here}
Allow_Duplicated_Headers: "false"
Json_Date_Format: "iso8601"
Json_Date_Key: "timestamp"

Чтобы избежать публикации токена в открытом виде, следуйте инструкциям AWS Secrets Manager. После того, как ваше приложение начнет публиковать логи, вы сможете просмотреть их в пользовательском интерфейсе Ключ-АСТРОМ.

Для получения JSON-файла с описанием задачи и конфигурацией Ключ-АСТРОМ обратитесь к примерам в репозитории AWS.

Для получения более подробной информации о настройке см. Руководство разработчика Amazon ECS.

Поиск неисправностей

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

Логи ошибок, полученные через Fluent Bit, используются для устранения неполадок.

Источник — https://doc.ruscomtech.ru/index.php?title=Передача_логов_в_Ключ-АСТРОМ_с_помощью_Fluent_Bit&oldid=6452