Установка агента на Linux
Установка, настройка, обновление и удаление агента ProtoOBP на Linux, в том числе на системах без systemd.
Агент Proto Observability Platform
Агент платформы наблюдаемости: что он собирает, установка на Linux, Windows, Docker и Kubernetes, настройка, проверка работы и журналы.
На этой странице:
- Описание
- Установка
- Работа агента через proxy
- Дополнительная настройка агента
- Файлы конфигурации агента
- Проверка работы агента
- Логи агента
- Собираемые метрики
Описание
ProtoOBP агент автоматически собирает метрики, трейсы и логи и отправляет полученные данные на ProtoOBP Backend сервер.
Сбор трейсов приложения осуществляется с помощью трейсеров, автоматически инструментируя код следующих языков программирования:
Сбор метрик осуществляется автоматически для всех поддерживамых технологий
Схема взаимодействия компонентов ProtoOBP
Поддерживаемые технологии
Установка
Список поддерживаемых версий операционных систем и оркестраторов — на странице Поддерживаемые технологии.
Linux
Установка из DEB- и RPM-пакетов, настройка, обновление и управление службами, в том числе на системах без systemd, — на странице Установка агента на Linux.
Windows
Установка из MSI-пакета, запуск под GMSA и управление службой — на странице Установка агента на Windows.
Docker
Запуск в отдельном контейнере, через docker compose и в Docker Swarm — на странице Запуск агента в Docker.
Kubernetes
Установка Helm-чартом, в том числе в OpenShift и в непривилегированном режиме, — на странице Установка агента в Kubernetes.
Работа агента через proxy
Если прямого доступа от агента до ProtoOBP Backend нет, соединения можно направить через корпоративный HTTP(S)-прокси (секция proxy в protoobp.yaml) или через промежуточный сервер-ретранслятор. Оба способа описаны на странице Работа агента через прокси-сервер.
Дополнительная настройка агента
| Страница | Что описано |
|---|---|
| Команды и проверка работы | Запуск, остановка и перезапуск на всех платформах, команда status, справочник команд |
| Журналы агента | Расположение журналов, уровень подробности, ротация, syslog |
| Cluster Agent | Cluster Agent в Kubernetes, токен, проверки уровня кластера, Admission Controller |
| Имя хоста и теги | Как агент определяет имя хоста, как задать его явно, теги хоста |
| Работа через прокси | Корпоративный HTTP(S)-прокси, исключения no_proxy, сервер-ретранслятор |
| Управление секретами | Ссылки ENC[] вместо паролей в конфигурации: файлы, Kubernetes Secrets, HashiCorp Vault, собственная программа |
| Автообнаружение | Шаблоны интеграций в лейблах Docker и аннотациях подов, переменные шаблонов, исключение контейнеров |
Файлы конфигурации агента
Основной конфигурационный файл агента:
| Платформа | Путь и имя файла |
|---|---|
| Linux | /etc/protoobp-agent/protoobp.yaml |
| Windows | %ProgramData%\Protoobp\protoobp.yaml |
Файлы конфигурации модулей для мониторинга технологий находятся в папке <путь к папке конфигурации>/conf.d/<технология>.d/..
Путь к папке конфигурации зависит от платформы:
| Платформа | Путь |
|---|---|
| Linux | /etc/protoobp-agent/conf.d/ |
| Windows | %ProgramData%\Protoobp\conf.d |
Например, для мониторинга MySQL на агента Linux путь к файлу конфигурации MySQL будет иметь вид:
/etc/protoobp-agent/conf.d/mysql.d/conf.yaml
Проверка работы агента
Быстрая проверка — команда status: на Linux sudo protoobp-agent status, в Docker docker exec -it protoobp-agent agent status. Команды для всех платформ, разбор вывода и справочник команд — на странице Управление агентом и проверка работы.
Логи агента
Журналы агента на Linux лежат в /var/log/protoobp/, на Windows — в C:\ProgramData\Protoobp\logs\. Журналы в Docker и Kubernetes, уровень подробности, ротация и отправка в syslog — на странице Журналы агента.
Собираемые метрики
Справочник системных метрик хоста и метрик контейнеров — на странице Метрики, собираемые агентом.
Установка агента на Windows
Установка агента ProtoOBP на Windows, запуск под GMSA, настройка и управление службой, типовые проблемы.
Запуск агента в Docker
Запуск агента ProtoOBP в отдельном контейнере, через docker compose и в Docker Swarm.
Установка агента в Kubernetes
Установка агента ProtoOBP в Kubernetes и OpenShift с помощью Helm-чарта, непривилегированный режим, изменение параметров и удаление.
Cluster Agent и проверки уровня кластера
Назначение Cluster Agent в Kubernetes, его параметры в Helm-чарте, токен связи с агентами на нодах, проверки уровня кластера (cluster checks) и диагностика.
Управление агентом и проверка работы
Запуск, остановка и перезапуск агента ProtoOBP на всех платформах, проверка работы командой status и справочник команд агента для диагностики.
Журналы агента
Где лежат журналы агента ProtoOBP и его компонентов на Linux, Windows, в Docker и Kubernetes, как изменить уровень подробности, ротацию и вывод в syslog.
Имя хоста и теги хоста
Как агент ProtoOBP определяет имя хоста, под которым отображаются его метрики, трейсы и логи, как задать это имя явно и как добавить к данным хоста собственные теги.
Работа агента через прокси-сервер
Как направить исходящие соединения агента ProtoOBP через корпоративный HTTP(S)-прокси или через промежуточный сервер-ретранслятор.
Управление секретами в конфигурации агента
Как убрать пароли, токены и ключ API из файлов конфигурации агента ProtoOBP: ссылки ENC[] и получение значений из файлов, Kubernetes Secrets, HashiCorp Vault или собственной программы.
Автообнаружение интеграций в контейнерах
Как агент ProtoOBP находит контейнеры и подключает к ним мониторинг: шаблоны в лейблах Docker, аннотациях подов Kubernetes и файлах conf.d, переменные шаблонов, включение и исключение контейнеров.
Метрики, собираемые агентом
Справочник системных метрик хоста и метрик контейнеров, которые агент ProtoOBP собирает по умолчанию.