Метрики баз данных
Трассы показывают запросы к базе со стороны приложения. Что происходит внутри самой базы — сколько подключений и далеко ли до лимита, какая транзакция висит дольше всех, кто ждёт блокировку, хватает ли Redis памяти, копятся ли сообщения в RabbitMQ — агент NablOps собирает сам.
Ставить экспортер не нужно: агент уже работает рядом с базой. Он находит контейнер или под базы в своём стеке и раз в минуту опрашивает её теми же запросами, что стандартные экспортеры Prometheus.
Какие базы и что видно
| База | Что видно |
|---|---|
| PostgreSQL 10+ | подключения и лимит max_connections, сессии по состоянию (в том числе «idle in transaction»), самая долгая открытая транзакция, блокировки и кто их ждёт, коммиты и откаты, взаимоблокировки, попадания в кэш, временные файлы, размер баз, отставание реплики |
| MySQL, MariaDB | подключения и лимит, выполняющиеся и медленные запросы, коммиты и откаты, ожидания блокировок строк, взаимоблокировки, попадания в буфер InnoDB, временные таблицы на диске, отставание реплики |
| Redis, Valkey | клиенты и заблокированные, память и лимит maxmemory, фрагментация, вытесненные и истёкшие ключи, попадания и промахи, ключи по базам, связь реплики с мастером, сохранение на диск |
| RabbitMQ | сообщения в очередях — ждущие и без подтверждения, очереди, подключения, каналы и получатели, публикация и доставка, память и диск относительно порогов, тревоги |
Метрики появляются на вкладке «Метрики» стека источником «PostgreSQL · db» (по имени сервиса). На них работают графики, уведомления по порогам и поиск причин сбоя. Если агент перестал получать метрики базы, сработает правило «Источник метрик не отвечает».
Как подключить
Агенту нужен отдельный пользователь базы с правами только на статистику. Он не видит ваших данных и ничего не может изменить, поэтому утечка его пароля почти безвредна. Пароль вы придумываете сами и передаёте только агенту: в NablOps он не попадает.
NablOps сам подскажет, какую базу подключить: в разделе «Покрытие» на странице проекта появится задание «Нет метрик базы …» с готовыми командами, в которые уже подставлено имя сервиса.
1. Создайте пользователя
Выполните команду внутри контейнера базы: в Docker Compose — docker compose exec <сервис> …, в Kubernetes — kubectl -n <namespace> exec -it <под> -- …. Подойдёт и любой SQL-клиент с правами администратора, в том числе консоль облака.
PostgreSQL:
docker compose exec db psql -U postgres -d postgres -c "CREATE ROLE nablops LOGIN PASSWORD '<пароль>'; GRANT pg_monitor TO nablops;"Вместо postgres после -U укажите суперпользователя базы, если он другой (переменная POSTGRES_USER).
MySQL, MariaDB:
docker compose exec mysql mysql -u root -p -e "CREATE USER 'nablops'@'%' IDENTIFIED BY '<пароль>' WITH MAX_USER_CONNECTIONS 3; GRANT PROCESS, REPLICATION CLIENT ON *.* TO 'nablops'@'%';"Redis. Если у Redis нет пароля, ничего делать не нужно: агент опрашивает его сразу. Если пароль есть — создайте пользователя (Redis 6+):
docker compose exec redis redis-cli -a '<пароль Redis>' ACL SETUSER nablops on '><пароль>' +info +pingЕсли у вас старый Redis с одним общим паролем (requirepass), передайте агенту этот пароль.
RabbitMQ. В RabbitMQ 3.8 и новее плагин Prometheus включён по умолчанию — агент берёт метрики с порта 15692 без пароля. Если плагин выключен, агент обратится к API управления (порт 15672). Для него нужен пользователь с тегом monitoring:
docker compose exec rabbitmq rabbitmqctl add_user nablops '<пароль>'docker compose exec rabbitmq rabbitmqctl set_user_tags nablops monitoringОдин пользователь nablops с одним паролем используется для всех баз стека. Другое имя можно задать агенту переменной NABL_DB_USER.
2. Передайте пароль агенту
Docker Compose — добавьте переменную в сервис агента и перезапустите его:
nabl-agent:
environment:
NABL_DB_PASSWORD: "<пароль>"docker compose up -d nabl-agentKubernetes — положите пароль в Secret агента и передайте его в Deployment:
kubectl -n <namespace> patch secret nabl-agent -p '{"stringData":{"db-password":"<пароль>"}}'kubectl -n <namespace> set env deployment/nabl-agent --from=secret/nabl-agent --keys=db-password --prefix=NABL_Через минуту метрики базы появятся на вкладке «Метрики» стека, а задание в покрытии закроется само. Нужен агент 0.23 или новее — как обновить.
Проще всего попросить об этом ИИ-ассистента: «подключи метрики баз в стеке shop». Он создаст пользователя, сгенерирует пароль и передаст его агенту — вам останется подтвердить команды.
Если метрик нет
Агент сообщает, что у него с доступом к каждой базе. Состояние видно в списке источников на вкладке «Метрики» и в задании покрытия:
- Пароль не передан.
NABL_DB_PASSWORDу агента не задан. К PostgreSQL и MySQL агент тогда не подключается вовсе, поэтому в журнале базы не появляются отказы. - Нет доступа. Неверный пароль, нет пользователя или прав. Для PostgreSQL проверьте роль
pg_monitor, для MySQL — праваPROCESSиREPLICATION CLIENT. Пока доступа нет, агент пробует подключиться всё реже — до раза в 6 часов, а после смены пароля пробует сразу. Отказы пользователюnablopsв журнале базы NablOps не считает ошибками приложения. - Не подключиться. Агент не в одной сети с базой или у PostgreSQL файл
pg_hba.confне пускает адрес агента. Официальный образ PostgreSQL пускает сеть контейнеров по паролю. В своей установке может понадобиться строкаhost all nablops <сеть контейнеров> scram-sha-256.
Если метрики базы не нужны
Выключите источник базы на вкладке «Метрики» стека. Агент перестанет присылать её метрики, а задание в покрытии закроется. Удалить такой источник нельзя: агент заведёт его снова.
Чего агент не делает
- Не читает данные и тексты запросов. Самые тяжёлые запросы видны по трассам.
- Не трогает
pg_stat_statementsи не меняет настройки базы. - Держит одно соединение на базу раз в минуту, с таймаутом 5 секунд.
- Опрашивает только базы в контейнерах своего стека. Базы на сервере без контейнера и управляемые облачные базы пока не опрашивает.
Другие базы и брокеры
MongoDB, ClickHouse, Elasticsearch, Kafka и NATS агент пока не опрашивает сам. Для них поставьте экспортер и подключите его источником метрик или нажмите в задании покрытия «Попросить добавить в агента». По таким обращениям мы решаем, какую базу агент научится опрашивать следующей.
Экспортер PostgreSQL, MySQL, Redis или RabbitMQ у вас уже стоит? Тогда пользователь не нужен: укажите адрес экспортера источником метрик.
Что дальше
- Медленные запросы к БД и N+1 — запросы со стороны приложения.
- Свои метрики — уведомления по порогам и экспортеры.
- Как работает агент — доступы, сеть и безопасность.
Первый сервер или стек подключается за пару минут. Бесплатно в раннем доступе.
Нашли неточность или не хватает ответа? Напишите в поддержку