Любому растущему интернет-магазину, сервису подписки или b2b-проекту необходима наглядная аналитика: ежедневная динамика выручки, средний чек, когортный анализ повторных покупок и воронки оформления заказов. Исторически бизнес решал эту задачу двумя путями: либо вручную сводил выгрузки в Excel, либо подключал облачные SaaS-платформы вроде PowerBI и Tableau. Однако в современных реалиях облачные западные сервисы стали недоступны для оплаты, несут риски внезапной блокировки учетных записей и нарушают требования 152-ФЗ о локализации персональных данных клиентов на территории РФ. Открытая BI-платформа Metabase (более 50 000 звёзд на GitHub, лицензия AGPLv3) решает эту проблему радикально: она разворачивается за 15 минут в Docker Compose на собственном российском VDS, подключается к рабочей базе данных в изолированном режиме чтения и предоставляет сотрудникам интуитивный визуальный конструктор отчетов без необходимости писать сложные SQL-запросы.
1. Архитектура Metabase: почему это идеальный выбор для бизнеса
В отличие от тяжеловесных enterprise-комбайнов (таких как Apache Superset) или систем мониторинга серверных метрик (Grafana), Metabase с самого начала проектировалась с упором на демократизацию данных внутри команды. Это означает, что маркетолог, операционный директор или менеджер склада могут самостоятельно собрать нужный срез по продажам за пару кликов мыши, не отвлекая разработчиков и администраторов баз данных составлением кастомных SQL-скриптов.
Архитектурно Metabase состоит из трех ключевых уровней:
- Ядро визуализации и API (Java Runtime): высокопроизводительный сервис на базе Clojure/Java, который транслирует клики пользователя в оптимизированные SQL-запросы под конкретную СУБД, кэширует результаты выборок и отрисовывает интерактивные графики.
- Внутренняя база метаданных (Application Database): хранилище для учетных записей пользователей, настроек прав доступа, структуры дашбордов, формул метрик и сохраненных вопросов. В боевой среде здесь категорически запрещено использовать встроенную SQLite/H2 — стандартом надежности является выделенный контейнер
postgres:16-alpine. - Внешние аналитические источники (Data Sources): ваши рабочие СУБД (PostgreSQL интернет-магазина, MySQL от CRM, ClickHouse или реплика базы данных), к которым Metabase обращается строго по протоколу Read-Only.
| Критерий | Metabase (Self-Hosted) | Microsoft PowerBI | Apache Superset | Grafana |
|---|---|---|---|---|
| Лицензия и контроль | Open Source (AGPLv3) | Проприетарный SaaS | Open Source (Apache 2.0) | Open Source (AGPLv3) |
| Порог входа для не-технарей | Минимальный (No-Code UI) | Средний (язык DAX) | Высокий (требуется SQL) | Средний (PromQL / SQL) |
| Потребление памяти (RAM) | 1.5 – 2 ГБ RAM | Облачные ресурсы | 4 – 8 ГБ RAM (тяжелый стек) | 150 – 300 МБ RAM |
| Фокус использования | Бизнес-метрики, продажи, воронки | Корпоративная отчетность | Big Data, Data Science | Мониторинг серверов и логов |
| Соответствие 152-ФЗ РФ | 100% (хранение на вашем VDS) | Риск утечки в зарубежные ЦОД | 100% (при своем сервере) | 100% (при своем сервере) |
Для небольших и средних команд Metabase выступает идеальным балансом: в ней нет избыточной сложности enterprise-решений, но есть мощный графический построитель вопросов (Query Builder), сводные таблицы, фильтры перекрестных связей и возможность автоматического экспорта отчетов в PDF, CSV или Telegram.
2. Подготовка операционной системы VDS и изоляция сетевых портов
Развертывание аналитической платформы рекомендуется выполнять на базе чистого дистрибутива Ubuntu 24.04 LTS или Debian 12. Поскольку Metabase функционирует внутри виртуальной машины Java (JVM), критически важно защитить операционную систему от внезапного завершения процессов через Out Of Memory (OOM) Killer при пиковых нагрузках, а также закрыть прямой доступ к портам сервисов через файрвол UFW.
Первым шагом подключаемся к серверу по SSH, обновляем пакетную базу и подключаем файл подкачки (Swap) объемом 4 ГБ, который послужит амортизатором при резких скачках потребления оперативной памяти:
# Обновление системных репозиториев
sudo apt update && sudo apt upgrade -y
# Создание и активация файла подкачки (Swap) на 4 ГБ
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# Автоматическое монтирование при загрузке системы
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
# Оптимизация агрессивности свопинга (swappiness = 10)
sudo sysctl vm.swappiness=10
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
Далее устанавливаем официальный стек Docker Engine и плагин Docker Compose. Не используйте устаревшие пакеты docker-compose из штатных репозиториев Ubuntu, устанавливайте современный Docker CLI v2:
# Установка вспомогательных утилит
sudo apt install -y ca-certificates curl gnupg lsb-release
# Добавление официального GPG-ключа и репозитория Docker
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# Проверка корректности установки Docker
sudo docker --version && sudo docker compose version
Для сетевой защиты настраиваем межсетевой экран ufw. Наружу должны смотреть исключительно стандартные порты SSH (22), HTTP (80) и HTTPS (443). Порт самого веб-интерфейса Metabase (3000) и порт внутренней базы данных (5432) мы привяжем к петлевому интерфейсу 127.0.0.1, исключая несанкционированные попытки сканирования через внешние сети. Проверить доступность портов сервера после настройки всегда можно с помощью бесплатного онлайн-инструмента проверки открытых портов SysKit:
# Базовые правила UFW: запретить входящие, разрешить исходящие
sudo ufw default deny incoming
sudo ufw default allow outgoing
# Открытие портов SSH, HTTP и HTTPS
sudo ufw allow 22/tcp comment 'SSH'
sudo ufw allow 80/tcp comment 'Nginx HTTP'
sudo ufw allow 443/tcp comment 'Nginx HTTPS'
# Активация файрвола
sudo ufw enable
sudo ufw status verbose
3. Боевой Docker Compose манифест с базой PostgreSQL 16
Для развертывания создаем изолированный рабочий каталог /opt/metabase, в котором разместим переменные окружения, манифест контейнеров и конфигурационные файлы прокси-сервера:
sudo mkdir -p /opt/metabase/nginx
sudo chmod 750 /opt/metabase
cd /opt/metabase
Создаем файл переменных окружения .env. Для генерации надежного криптографического ключа MB_ENCRYPTION_SECRET_KEY и паролей к базе данных используем утилиту openssl или встроенный генератор надежных паролей SysKit:
# Генерация 32-байтного ключа шифрования AES-256 для учетных записей Metabase
MB_SECRET_KEY=$(openssl rand -base64 32)
POSTGRES_PWD=$(openssl rand -base64 24 | tr -d "=+/" | cut -c1-20)
cat <<EOF | sudo tee /opt/metabase/.env
# Основные параметры Metabase
MB_SITE_URL=https://bi.yourdomain.ru
MB_ENCRYPTION_SECRET_KEY=${MB_SECRET_KEY}
MB_ANON_TRACKING_ENABLED=false
MB_ENABLE_EMBEDDING=true
# Параметры внутренней базы метаданных (PostgreSQL 16)
POSTGRES_DB=metabase_app
POSTGRES_USER=metabase_user
POSTGRES_PASSWORD=${POSTGRES_PWD}
# Настройки выделения памяти для виртуальной машины Java
JAVA_OPTS=-Xms512m -Xmx1536m -XX:+UseG1GC -Dfile.encoding=UTF-8
EOF
sudo chmod 600 /opt/metabase/.env
Теперь создаем боевой файл /opt/metabase/docker-compose.yml. Обратите внимание на директивы mem_limit, которые предотвращают утечки памяти, и привязку порта Metabase строго к адресу 127.0.0.1:3000. Чтобы быстро собрать рецепты для смежных контейнеров, вы всегда можете воспользоваться нашим интерактивным генератором Docker Compose:
services:
postgres:
image: postgres:16-alpine
container_name: metabase_postgres
restart: unless-stopped
environment:
POSTGRES_DB: ${POSTGRES_DB}
POSTGRES_USER: ${POSTGRES_USER}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
volumes:
- postgres_data:/var/lib/postgresql/data
networks:
- metabase_net
mem_limit: 512m
cpus: 1.0
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
interval: 10s
timeout: 5s
retries: 5
metabase:
image: metabase/metabase:v0.65.2
container_name: metabase_app
restart: unless-stopped
depends_on:
postgres:
condition: service_healthy
ports:
- "127.0.0.1:3000:3000"
mem_limit: 2048m
cpus: 2.0
environment:
MB_DB_TYPE: postgres
MB_DB_DBNAME: ${POSTGRES_DB}
MB_DB_PORT: 5432
MB_DB_USER: ${POSTGRES_USER}
MB_DB_PASS: ${POSTGRES_PASSWORD}
MB_DB_HOST: postgres
MB_ENCRYPTION_SECRET_KEY: ${MB_ENCRYPTION_SECRET_KEY}
MB_SITE_URL: ${MB_SITE_URL}
MB_ANON_TRACKING_ENABLED: ${MB_ANON_TRACKING_ENABLED}
MB_ENABLE_EMBEDDING: ${MB_ENABLE_EMBEDDING}
JAVA_OPTS: ${JAVA_OPTS}
volumes:
- metabase_plugins:/plugins
networks:
- metabase_net
networks:
metabase_net:
driver: bridge
volumes:
postgres_data:
driver: local
metabase_plugins:
driver: local
Запускаем контейнеры в фоновом режиме и контролируем процесс первичной инициализации схемы базы данных:
cd /opt/metabase
sudo docker compose up -d
# Просмотр логов запуска (первичная миграция базы занимает 30-45 секунд)
sudo docker compose logs -f metabase
Когда в журнале появится строка вида INFO metabase.core :: Metabase Initialization COMPLETE, сервис готов к приему входящего трафика.
4. Конфигурация Nginx Reverse Proxy, Let's Encrypt SSL и сжатия
Для безопасного доступа пользователей и защиты веб-сессий настраиваем обратный прокси-сервер Nginx с автоматическим выпуском бесплатного сертификата Let's Encrypt. Важная особенность Metabase — аналитические запросы к крупным таблицам могут выполняться от 10 до 60 секунд, поэтому стандартные таймауты Nginx (60с) необходимо увеличить до 300 секунд во избежание ошибок 504 Gateway Time-out.
Устанавливаем Nginx и клиент Certbot:
sudo apt install -y nginx certbot python3-certbot-nginx
Чтобы избежать распространенной ошибки chicken-and-egg (когда тест nginx -t падает из-за еще не существующих файлов сертификатов), настройку проводим в два последовательных шага. Сначала создаем базовый HTTP-конфиг /etc/nginx/sites-available/metabase.conf для прохождения валидации домена:
upstream metabase_upstream {
server 127.0.0.1:3000;
keepalive 32;
}
server {
listen 80;
listen [::]:80;
server_name bi.yourdomain.ru;
location / {
proxy_pass http://metabase_upstream;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Активируем конфигурацию, проверяем синтаксис и выпускаем сертификат Let's Encrypt с автоматической настройкой редиректа на HTTPS:
# Активация виртуального хоста
sudo ln -s /etc/nginx/sites-available/metabase.conf /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
# Получение SSL-сертификата через Certbot с автоматическим редиректом на HTTPS
sudo certbot --nginx -d bi.yourdomain.ru --non-interactive --agree-tos --redirect -m admin@yourdomain.ru
После успешного получения сертификата дополняем /etc/nginx/sites-available/metabase.conf боевыми параметрами безопасности, поддержкой WebSockets, сжатием Gzip и расширенными таймаутами для аналитических выборок. Вы также можете сгенерировать готовые наборы директив в нашем бесплатном генераторе конфигураций Nginx:
upstream metabase_upstream {
server 127.0.0.1:3000;
keepalive 32;
}
server {
listen 80;
listen [::]:80;
server_name bi.yourdomain.ru;
# Автоматический редирект HTTP на HTTPS
return 301 https://$host$request_uri;
}
server {
# В штатных версиях Nginx из дистрибутивов Ubuntu 24.04 (nginx 1.24) и Debian 12 (nginx 1.22)
# протокол HTTP/2 объявляется прямо в директиве listen:
listen 443 ssl http2;
listen [::]:443 ssl http2;
# Примечание: если вы используете upstream-репозиторий nginx.org (v1.26+), синтаксис раздельный: listen 443 ssl; http2 on;
server_name bi.yourdomain.ru;
# Пути к сертификатам Let's Encrypt
ssl_certificate /etc/letsencrypt/live/bi.yourdomain.ru/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/bi.yourdomain.ru/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_prefer_server_ciphers on;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
# Лимиты загрузки (для импорта кастомных CSV-датасетов)
client_max_body_size 50M;
# Расширенные таймауты для тяжелых аналитических выборок
proxy_connect_timeout 300s;
proxy_send_timeout 300s;
proxy_read_timeout 300s;
send_timeout 300s;
# Включение сжатия Gzip для ускорения передачи дашбордов и JSON
gzip on;
gzip_vary on;
gzip_proxied any;
gzip_comp_level 6;
gzip_types text/plain text/css text/xml application/json application/javascript application/rss+xml image/svg+xml;
# Заголовки безопасности
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-XSS-Protection "1; mode=block" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
location / {
proxy_pass http://metabase_upstream;
proxy_http_version 1.1;
# Проброс WebSockets для мгновенного обновления дашбордов
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
# Передача реальных IP-адресов клиента
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# Буферизация ответов
proxy_buffering on;
proxy_buffer_size 128k;
proxy_buffers 4 256k;
proxy_busy_buffers_size 256k;
}
}
Применяем обновленную боевую конфигурацию:
sudo nginx -t && sudo systemctl reload nginx
После выпуска сертификата проверьте корректность цепочки шифрования с помощью онлайн-утилиты проверки SSL-сертификатов, а также убедитесь в отсутствии циклических редиректов через проверку редиректов SysKit.
5. Системные требования и подбор оптимального тарифа VDS
Поскольку ядро Metabase написано на Clojure и работает поверх Java Virtual Machine (JVM), сервис требует фиксированного запаса оперативной памяти для сборщика мусора (G1 Garbage Collector) и компиляции внутренних плагинов визуализации. Если на VDS не хватает RAM, контейнер быстро упадет с ошибкой java.lang.OutOfMemoryError.
В зависимости от объема обрабатываемых данных и количества одновременных пользователей инженеры SysKit выделили три конфигурационных профиля:
| Профиль проекта | Пользователи | Рекомендуемые ресурсы VDS | Параметры JAVA_OPTS |
|---|---|---|---|
| Стартовый (Малый бизнес) | 1 – 5 аналитиков | 2 vCPU • 4 ГБ RAM • 40 ГБ NVMe | -Xms512m -Xmx1536m |
| Стандартный (Интернет-магазин / CRM) | 5 – 25 пользователей | 4 vCPU • 8 ГБ RAM • 80 ГБ NVMe | -Xms1024m -Xmx3584m |
| Enterprise / Аналитический отдел | 25 – 100+ сотрудников | 8 vCPU • 16 ГБ RAM • 160 ГБ NVMe | -Xms2048m -Xmx7168m |
Для надежного размещения аналитической платформы рекомендуется выбирать проверенные российские дата-центры с быстрыми накопителями NVMe: скорость дисковых операций напрямую влияет на скорость считывания временных таблиц PostgreSQL при построении сложных срезов.
Рекомендуемые VDS-провайдеры
Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с
Timeweb Cloud — Быстрые NVMe VDS
Оптимальная производительность NVMe-накопителей и скоростной канал до 1 Гбит/с для аналитической базы и мгновенной загрузки тяжелых графиков Metabase.
Selectel — Надежная Enterprise-инфраструктура
Изолированные ресурсы в дата-центрах Tier III в Москве и Санкт-Петербурге с гарантированной защитой от DDoS и совместимым S3 для дампов базы.
Beget — Простота управления и надежность
Удобная панель управления, автоматические ежедневные снапшоты диска и мгновенная установка Docker в один клик при создании сервера.
6. Первый запуск: инициализация администратора и защита учетных записей
После успешного запуска контейнеров и настройки Nginx перейдите в браузере по адресу вашего домена https://bi.yourdomain.ru. Вас встретит стартовый мастер первоначальной настройки Metabase:
- Выбор языка: выберите «Русский» (интерфейс Metabase полностью переведен, включая подсказки конструктора запросов).
- Создание учетной записи администратора: укажите имя, фамилию, рабочий корпоративный email и сгенерируйте сложный пароль не менее чем из 16 символов с помощью генератора паролей SysKit. Избегайте использования банальных логинов
adminилиroot. - Подключение базы данных: на первом шаге нажмите «Я сделаю это позже» (I'll add my data later), чтобы сначала завершить настройку базовой безопасности системы.
- Сбор данных и телеметрия: снимите галочку с отправки анонимных данных разработчикам (мы также принудительно заблокировали ее переменной
MB_ANON_TRACKING_ENABLED=falseна уровне контейнера).
Сразу после входа в панель перейдите в раздел Настройки администратора (Admin settings) → Параметры (Settings) → Аутентификация:
- Двухфакторная аутентификация (2FA / TOTP): обязательно активируйте обязательный ввод 6-значного кода из приложений Google Authenticator или Яндекс Ключ для всех пользователей с правами администратора.
- Таймаут неактивной сессии: установите принудительное завершение веб-сессии через 24–48 часов неактивности (Session Expiration), предотвращая несанкционированный доступ с забытых рабочих станций.
- Права групп (Permissions): создайте отдельные группы пользователей (например, «Маркетинг», «Бухгалтерия», «Руководство»). По умолчанию встроенная группа All Users должна иметь минимальные права только на чтение общедоступных сводок без права скачивания сырых данных.
7. Безопасное подключение боевых баз данных в режиме Read-Only
Главная ошибка начинающих администраторов — подключение Metabase к рабочей базе данных с учетной записью суперпользователя (postgres или root). Это несет колоссальные риски: случайный запрос на обновление или зависшая тяжелая выборка с декартовым произведением строк может заблокировать таблицы в боевых транзакциях интернет-магазина. Подключение выполняется исключительно через изолированного пользователя с правами SELECT и жестким лимитом времени выполнения запросов.
Для PostgreSQL (боевая база магазина или CRM):
Подключаемся к PostgreSQL через терминал и создаем роль с изолированными правами и принудительным лимитом времени выполнения запроса в 30 секунд:
-- Создание пользователя только для чтения
CREATE ROLE metabase_ro WITH LOGIN PASSWORD 'Secr3t_Metabase_RO_Pass!2026';
-- Разрешение на подключение к анализируемой базе данных
GRANT CONNECT ON DATABASE shop_production TO metabase_ro;
-- Переход в контекст целевой базы данных
\c shop_production
-- Предоставление прав на чтение схемы и всех существующих таблиц
GRANT USAGE ON SCHEMA public TO metabase_ro;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO metabase_ro;
GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO metabase_ro;
-- Автоматическое назначение прав SELECT на любые новые таблицы в будущем
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO metabase_ro;
-- Защита боевой базы: принудительный обрыв любого запроса Metabase дольше 30 секунд
ALTER ROLE metabase_ro SET statement_timeout = '30s';
Для MySQL / MariaDB:
-- Создание пользователя с доступом только на чтение
CREATE USER 'metabase_ro'@'%' IDENTIFIED BY 'Secr3t_Metabase_RO_Pass!2026';
-- Выдача прав строго на выборку данных и просмотр представлений
GRANT SELECT, SHOW VIEW ON shop_production.* TO 'metabase_ro'@'%';
FLUSH PRIVILEGES;
Важное отличие MySQL от PostgreSQL: в MySQL директива SET GLOBAL max_execution_time применяется глобально ко всем запросам всех пользователей на сервере, что может привести к нежелательному обрыву легитимных тяжелых операций интернет-магазина. Поэтому для MySQL таймаут изолируется строго на уровне сессии подключения Metabase: в настройках источника данных в интерфейсе Metabase (блок Advanced options → Additional JDBC connection string options) укажите параметр:
sessionVariables=max_execution_time=30000
Это ограничит время выполнения аналитических выборок ровно 30 секундами только для соединений Metabase, гарантируя бесперебойную работу боевых клиентских транзакций. Для высоконагруженных проектов с тысячами заказов в день подключение Metabase рекомендуется выполнять к отдельной Read-Only реплике СУБД.
Подключение в интерфейсе Metabase:
В панели Metabase открываем Admin → Databases → Add database:
- Database type: выберите PostgreSQL или MySQL.
- Display name: наглядное имя (например, «Интернет-магазин (Production RO)»).
- Host: IP-адрес сервера базы данных (или имя хоста в Docker-сети).
- Port: стандартный
5432(PostgreSQL) или3306(MySQL). - Database name:
shop_production. - Username / Password: созданный пользователь
metabase_ro. - Advanced options: обязательно включите опцию «Периодическое сканирование схемы» (Sync schema) в ночное время (например, в 03:00), чтобы Metabase не нагружала СУБД частым анализом метаданных в разгар рабочего дня.
После сохранения источника данных перейдите в подраздел Admin → Data Model. Здесь вы можете скрыть из аналитического конструктора технические служебные колонки (например, хэши паролей password_hash, токены сессий и персональные номера телефонов), защитив данные в строгом соответствии с требованиями 152-ФЗ.
8. Построение дашбордов, визуальные запросы без SQL и когортный анализ
Основное преимущество Metabase — интерактивный конструктор вопросов (Question Builder), который позволяет анализировать продажи даже сотрудникам без знания синтаксиса SQL:
Пример 1: Построение графика ежедневной выручки интернет-магазина
- Нажмите «+ Новый» (New) → «Вопрос» (Question) и выберите таблицу
orders(Заказы). - В блоке Фильтр (Filter) добавьте условие:
status = 'delivered'иcreated_at: Предыдущие 30 дней. - В блоке Суммировать (Summarize) выберите агрегацию:
Сумма (Sum) от поля total_amount. - В блоке Группировать по (Group by) укажите дату:
created_at: По дням. - Нажмите «Визуализация» и переключитесь на «Линейный график» (Line Chart) или «Диаграмму с областями». Система мгновенно отобразит динамику выручки по дням со средним чеком.
Пример 2: Когортный анализ удержания клиентов (Retention)
Для понимания того, как часто покупатели возвращаются за повторными заказами, в Metabase используется визуальный сводный отчет (Pivot Table):
- Строки сводной таблицы: месяц первой покупки клиента (когорта).
- Колонки: порядковый номер последующего месяца (+1, +2, +3 мес.).
- Значения ячеек: процент пользователей когорты, совершивших повторный заказ в указанный интервал.
- Цветовая тепловая карта (Heatmap) наглядно подсветит, в какой именно месяц происходит основной отток покупателей.
Все полученные графики объединяются в единый интерактивный Дашборд руководителя (Executive Dashboard). На дашборд выносятся ключевые метрики (KPI карточки с выручкой за сегодня), графики динамики заказов, топ-10 популярных товаров и глобальный фильтр по диапазону дат, переключающий все графики одновременно одним кликом.
9. Автоматизация отчетов: рассылка сводок в Telegram и регламент бэкапов
Руководству и операционным менеджерам удобнее получать ключевые цифры прямо в Telegram, не заходя каждый день в веб-интерфейс. В современной архитектуре Metabase (v0.50+, v0.64 LTS, v0.65+) официальным и гарантированно стабильным способом программной выгрузки метрик является REST API агрегации данных: эндпоинт POST /api/card/:id/query/json. Он возвращает точные вычисленные показатели (суммарная выручка, число оформленных заказов, средний чек), которые за секунду форматируются в наглядную утреннюю сводку для Telegram-канала или чата руководителей.
Для безопасного хранения учетных записей не прописывайте пароли открытым текстом в скриптах — сохраните их в защищенном файле конфигурации /opt/metabase/.telegram_report.env с правами доступа только для суперпользователя:
sudo apt install -y jq curl
cat <<EOF | sudo tee /opt/metabase/.telegram_report.env
METABASE_URL="https://bi.yourdomain.ru"
MB_USER="admin@yourdomain.ru"
MB_PASSWORD="YourStrongAdminPassword2026"
CARD_ID="1"
TELEGRAM_BOT_TOKEN="123456789:ABCdefGhIJKlmNoPQRstuVWXyz"
TELEGRAM_CHAT_ID="-1001234567890"
EOF
sudo chmod 600 /opt/metabase/.telegram_report.env
Создаем автоматический скрипт /opt/metabase/send_telegram_report.sh с надежным извлечением метрик через jq:
#!/usr/bin/env bash
set -euo pipefail
# Загрузка изолированных учетных данных
CONFIG_FILE="/opt/metabase/.telegram_report.env"
if [[ ! -f "${CONFIG_FILE}" ]]; then
echo "Ошибка: Конфигурационный файл ${CONFIG_FILE} не найден" >&2
exit 1
fi
# shellcheck source=/dev/null
source "${CONFIG_FILE}"
# 1. Авторизация в REST API Metabase (или передача постоянного ключа X-API-KEY)
AUTH_RESPONSE=$(curl -s -X POST "${METABASE_URL}/api/session" \
-H "Content-Type: application/json" \
-d "{\"username\": \"${MB_USER}\", \"password\": \"${MB_PASSWORD}\"}")
SESSION_TOKEN=$(echo "${AUTH_RESPONSE}" | jq -r '.id // empty')
if [[ -z "${SESSION_TOKEN}" ]]; then
echo "Ошибка аутентификации в Metabase API: ${AUTH_RESPONSE}" >&2
exit 1
fi
# 2. Выгрузка суточных агрегированных метрик через официальный эндпоинт query/json
METRICS_JSON=$(curl -s -X POST "${METABASE_URL}/api/card/${CARD_ID}/query/json" \
-H "X-Metabase-Session: ${SESSION_TOKEN}")
# 3. Извлечение ключевых показателей через jq (выручка, число заказов, средний чек)
TOTAL_REVENUE=$(echo "${METRICS_JSON}" | jq -r '.[0].total_revenue // .[0].sum // "0"')
ORDERS_COUNT=$(echo "${METRICS_JSON}" | jq -r '.[0].orders_count // .[0].count // "0"')
AVG_CHECK=$(echo "${METRICS_JSON}" | jq -r '.[0].avg_check // "0"')
YESTERDAY=$(date -d "yesterday" +%d.%m.%Y 2>/dev/null || date -v-1d +%d.%m.%Y)
# 4. Формирование наглядного текста сводки
MESSAGE=$(cat <<EOF
📊 Сводка продаж интернет-магазина за ${YESTERDAY}:
💰 Выручка: ${TOTAL_REVENUE} ₽
📦 Оформлено заказов: ${ORDERS_COUNT}
💳 Средний чек: ${AVG_CHECK} ₽
🔗 Открыть дашборд: ${METABASE_URL}
EOF
)
# 5. Отправка форматированного сообщения в Telegram-канал
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
--data-urlencode "chat_id=${TELEGRAM_CHAT_ID}" \
--data-urlencode "text=${MESSAGE}" > /dev/null
Совет по безопасности: в современных версиях Metabase (v0.50+) в разделе Admin → Settings → Authentication → API Keys можно сгенерировать постоянный API-ключ. В этом случае шаг авторизации через логин и пароль исключается, а в запрос выгрузки графика достаточно передать заголовок -H "X-API-KEY: mb_...".
Делаем скрипт исполняемым и добавляем его в планировщик cron для ежедневной отправки в 09:00 утра:
sudo chmod 700 /opt/metabase/send_telegram_report.sh
# Добавление задания в crontab
(crontab -l 2>/dev/null; echo "0 9 * * * /opt/metabase/send_telegram_report.sh >/dev/null 2>&1") | crontab -
Регламент резервного копирования метабазы
Вся ценность инсталляции Metabase сосредоточена в ее внутренней базе PostgreSQL (настроенные вопросы, формулы метрик, дашборды и права пользователей). Для создания ежедневного дампа метабазы перенаправляем стандартный вывод pg_dump напрямую в файл на хосте (исключая сохранение дампа внутри изолированного контейнера), после чего архивируем его для отправки в объектное S3-хранилище (например, с использованием Kopia и дедупликации):
# Создание локального каталога бэкапов на хосте
sudo mkdir -p /var/backups
# Создание горячего дампа метабазы с прямой записью потока данных на хост
sudo docker exec metabase_postgres pg_dump -U metabase_user -d metabase_app -F c -b > /var/backups/metabase_$(date +%Y%m%d_%H%M%S).dump
# Ротация локальных архивов старше 30 дней
find /var/backups/ -name "metabase_*.dump" -mtime +30 -delete
Чек-лист системного администратора для запуска Metabase в Production:
- В манифесте Docker Compose используется внешний контейнер
postgres:16-alpineвместо встроенной базы H2. - В файле
.envзадан постоянный 32-байтный криптографический ключMB_ENCRYPTION_SECRET_KEY. - Параметры памяти JVM зафиксированы через
JAVA_OPTSи соответствуют лимитуmem_limitв Docker Compose. - Порт
3000привязан строго к127.0.0.1и закрыт от прямого внешнего доступа через файрвол UFW. - В Nginx настроен защищенный протокол HTTPS, протоколы TLSv1.2/1.3 и таймауты проксирования увеличены до 300 секунд.
- Все боевые базы данных подключены через отдельную учетную запись
metabase_roстрого с правамиSELECT. - Для роли
metabase_roв PostgreSQL заданstatement_timeout = '30s', а в MySQL передан параметр сессииsessionVariables=max_execution_time=30000. - В модели данных (Data Model) скрыты служебные поля, пароли и персональные данные клиентов.
- Для учетных записей администраторов включена двухфакторная аутентификация TOTP.
- Настроено ежедневное резервное копирование базы
metabase_appв изолированное S3-хранилище.