Перейти к основному содержимому
Версия: 8.6

Чтение логов

Для чтения логов в Monq воспользуемся агентом и плагином агента tail.

  1. На целевом сервере установите агент Monq (версии 2.1.0 или выше)

  2. Сконфигурируйте агент следующим образом

    # Базовый URI системы Monq
    BaseUri="https://<Enter MONQ-GLOBAL-DOMAIN>"
    # API-ключ координатора для авторизации агента
    ApiKey="<Enter API-KEY>"
    FileStorage=""
    Timeout=100
    [Plugins]
    CSharpPath="/opt/monq-agent/plugins"
    [Connection]
    Timeout=100
    RetryCount=12
    [Agent]
    Description=""
    SlotsCount=2
    [WorkConfigs]
    Path="/opt/monq-agent/workconfigs"
    • BaseUri - укажите адрес вашего пространства Monq
    • ApiKey - укажите API-ключ координатора агентов
    • WorkConfigs.Path - укажите путь к каталогу с рабочими конфигурациями (например, /opt/monq-agent/workconfigs)
  3. Создайте каталог /opt/monq-agent/workconfigs и перейдите в него

  4. Создайте файл рабочей конфигурации в текущем каталоге (например, tail-python-program.yaml) в формате YAML:

    continuous-jobs:
    - init-step:
    plugin: tail
    with:
    bufferType: memory
    bufferSize: 32768
    chunkSize: 32768
    paths:
    - /opt/program-1/*.log
    - /opt/program-2/*.log
    dataBase: PluginTail.db
    readFromHead: true
    multilineParser:
    - python
    refresh: 1000
    streamKey: d8b3268a-ae01-4052-a70e-a1aec874337e
    • paths - укажите список путей по которым нужно прочитать лог-файлы
    • multilineParser - укажите один из предустановленных парсеров мультистрок: go, python или java
    • streamKey - укажите API-ключ потока данных, в который будут отправлены полученные логи
  5. Запустите агент при помощи команды monq-agent start или в качестве службы

    В логах агента вы должны увидеть следующие записи:

    [2024-09-02 09:16:07 +03:00 INF]  Loading work configurations from /opt/monq-agent/workconfigs...
    [2024-09-02 09:16:07 +03:00 INF] 1 work configurations were loaded.
    [2024-09-02 09:16:07 +03:00 INF] Establishing connection.
    [2024-09-02 09:16:08 +03:00 INF] Connection established.