Журналы агента

На этой странице:

• Расположение журналов
  • Linux
  • Windows
  • Docker
  • Kubernetes
  • Журналы установки
• Уровень подробности
• Параметры журналирования
• Ротация файлов
• Отправка в syslog
• Что искать в журналах

Эта страница описывает собственные журналы агента — сообщения о его работе. Сбор логов приложений и систем описан в разделе Получение логов от внешних источников.

Расположение журналов

Каждый компонент агента пишет в свой файл.

Linux

Каталог /var/log/protoobp/:

sudo tail -f /var/log/protoobp/agent.log
sudo tail -f /var/log/protoobp/trace-agent.log

Агент также пишет журнал в стандартный вывод, поэтому сообщения служб доступны через systemd:

journalctl -u protoobp-agent -u protoobp-agent-trace --since "1 hour ago"

Windows

Каталог C:\ProgramData\Protoobp\logs\.

Если служба не запускается и журнал агента пуст, проверьте журнал событий Windows (Просмотр событий → Журналы Windows → Приложение) — см. Типовые проблемы.

Docker

В контейнере агент пишет журнал в стандартный вывод, поэтому все компоненты видны в журнале контейнера:

docker logs --since 1h protoobp-agent
docker logs -f protoobp-agent 2>&1 | grep -i error

Строки разных компонентов различаются префиксом: CORE, TRACE, PROCESS.

Kubernetes

В поде агента каждый компонент работает в отдельном контейнере:

# основной агент
kubectl logs <под агента> -n protoobp -c agent --since=1h
# trace-агент
kubectl logs <под агента> -n protoobp -c trace-agent --since=1h
# Cluster Agent
kubectl logs deploy/protoobp-cluster-agent -n protoobp --since=1h

Список контейнеров пода: kubectl get pod <под агента> -n protoobp -o jsonpath='{.spec.containers[*].name}'. Если контейнер перезапускался, журнал предыдущего запуска выводится с ключом --previous.

Журналы установки

Уровень подробности

Параметр log_level в protoobp.yaml (переменная окружения POBP_LOG_LEVEL) задаёт минимальный уровень сообщений: trace, debug, info (по умолчанию), warn, error, critical, off. Значение 'off' указывается в кавычках.

log_level: debug

Изменение в файле вступает в силу после перезапуска агента. Чтобы не перезапускать агента, уровень можно поменять у работающего процесса:

sudo protoobp-agent config set log_level debug

Такое изменение действует до перезапуска — см. Изменение параметров без перезапуска.

Уровень trace-агента задаётся тем же log_level.

Параметры журналирования

Ротация файлов

Агент ротирует журналы сам: когда файл достигает log_file_max_size, он сохраняется как архивная копия, а запись продолжается в новый файл. Хранится log_file_max_rolls старых файлов; 0 — без ограничения.

log_file_max_size: 50MB
log_file_max_rolls: 5

Значение log_file_max_size задаётся с единицей (10MB) или числом байт (10485760). Внешняя ротация (logrotate) для этих файлов не требуется.

Отправка в syslog

log_to_syslog: true
syslog_uri: udp://syslog.corp.local:514   # без параметра — локальный сокет syslog
syslog_rfc: true

Даже при log_to_syslog: false systemd может перенаправлять стандартный вывод агента в системный журнал. Чтобы полностью исключить сообщения агента из syslog, установите также log_to_console: false.

Что искать в журналах

Строка журнала содержит время, компонент, уровень, место в коде и сообщение:

2026-10-15 10:12:03 UTC | CORE | ERROR | (pkg/forwarder/...) | ... 

Поиск ошибок:

sudo grep -E '\| (ERROR|WARN) \|' /var/log/protoobp/agent.log | tail -50

Если причину найти не удалось, приложите к обращению в техническую поддержку журналы agent.log и trace-agent.log за период проблемы и вывод status (status --file status.txt).