Мониторинг Tantor с помощью Proto Observability

Сбор метрик Tantor

Tantor — российская СУБД от Tantor Labs, являющаяся форком PostgreSQL. Wire-протокол и SQL-поведение Tantor полностью совместимы с PostgreSQL, поэтому ProtoOBP-агент собирает метрики Tantor той же проверкой postgres, что и для ванильного PostgreSQL — отдельной интеграции устанавливать не нужно. Инструкция ниже подходит для редакций Tantor BE (Basic Edition), SE (Standard Edition), SE 1C и Certified, для версий PostgreSQL-ядра 14, 15, 16 и 17.

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

Создайте пользователя с правами read-only для агента ProtoOBP в admin базе данных Tantor:

• Для версий с ядром PostgreSQL 10 и выше (вся актуальная линейка Tantor 14/15/16/17):

  create user protoobp with password '<PASSWORD>';
  grant pg_monitor to protoobp;
  grant SELECT ON pg_stat_database to protoobp;
  

Если требуется собирать query-level метрики (postgresql.queries.*), загрузите расширение pg_stat_statements через shared_preload_libraries в postgresql.conf и выполните в наблюдаемой базе:

CREATE EXTENSION IF NOT EXISTS pg_stat_statements;

Конфигурация ProtoOBP агента

Если агент запускается в виде службы systemd на хосте

1. В файле конфигурации ProtoOBP агента (/etc/protoobp-agent/conf.d/postgres.d/conf.yaml) укажите адрес и порт Tantor и учетную запись под которой агент сможет подключиться к базе:

   init_config:
   
   instances:
     - host: localhost
       port: 5432
       username: protoobp
       password: protoobp
       #По-умолчанию используется dbname - postgres
       dbname: "<DB_NAME>"
   

2. Перезапустите ProtoOBP агента выполнив systemctl restart protoobp-agent

3. Выполните проверку работы агента и убедитесь, что в разделе Postgres нет ошибок.

Если агент запускается в виде Docker контейнера

1. Добавьте следующие лейблы к Docker контейнеру с Tantor:

   • в docker-compose.yaml

     labels:
       com.protoobp.ad.check_names: '["postgres"]'
       com.protoobp.ad.init_configs: "[{}]"
       com.protoobp.ad.instances: '[{"host":"%%host%%", "port":5432,"username":"protoobp","password":"<PASSWORD>"}]'
     

   • или в Dockerfile

     LABEL "com.protoobp.ad.check_names"='["postgres"]'
     LABEL "com.protoobp.ad.init_configs"='[{}]'
     LABEL "com.protoobp.ad.instances"='[{"host":"%%host%%", "port":5432,"username":"protoobp","password":"<PASSWORD>"}]'
     

2. Примените изменения лейблов для контейнера с Tantor (перезапуском контейнера), а также перезапустите контейнер с агентом ProtoOBP.

3. Выполните проверку работы агента и убедитесь, что в разделе Postgres нет ошибок.

Собираемые данные

Метрики

Список метрик идентичен PostgreSQL — Tantor использует ту же модель данных и те же pg_stat_* представления, поэтому проверка postgres собирает с него ровно те же postgresql.* серии.