Эксплуатация

Общие сведения

«Метрика про энерго» — кроссплатформенная система автоматизированного коммерческого учёта электроэнергии (АСКУЭ) для мониторинга, сбора телеметрии и формирования отчётности.

Веб-интерфейс доступен по адресу, настроенному при установке (по умолчанию http://localhost:8080). Интерфейс полностью на русском языке — навигация, формы, сообщения об ошибках, справка и отчёты. Для работы нужен браузер: Chrome 90+, Firefox 90+, Safari 15+, Яндекс.Браузер 23+.

Управление пользователями

Ролевая модель (RBAC)

ПО реализует ролевую модель доступа с тремя встроенными ролями:

Создание пользователя

1. Перейдите в Настройки → Пользователи
2. Нажмите Добавить пользователя
3. Заполните поля: ФИО, email, роль
4. Система отправит приглашение на email с одноразовым кодом (OTP)
5. Пользователь авторизуется по OTP и устанавливает пароль

Привязка к объектам

Для ролей user и viewer доступна привязка к конкретным объектам учёта — пользователь видит только назначенные объекты:

1. Откройте карточку пользователя
2. В разделе Доступ к объектам добавьте нужные объекты
3. Сохраните изменения

Аутентификация

Управление объектами учёта

Иерархия объектов

ПО использует четырёхуровневую иерархию:

Карточка объекта

Каждый объект содержит:

• Наименование и адрес
• Реквизиты договора энергоснабжения
• Перечень оборудования (УСПД, счётчики, трансформаторы тока)
• Контактные лица
• Параметры опроса (протокол, интервал, расписание)
• Даты установки и поверки приборов
• Коэффициенты трансформации

Добавление объекта

1. Перейдите в Объекты → Добавить объект
2. Выберите регион (или создайте новый)
3. Заполните реквизиты объекта
4. Добавьте фидеры и каналы (приборы учёта)
5. Настройте параметры подключения к УСПД

Сбор телеметрии

Поддерживаемые протоколы

Режимы сбора данных

Данные телеметрии

Для каждого канала (прибора учёта) система собирает:

• Активная мощность (P), реактивная мощность (Q), полная мощность (S)
• Напряжение, ток, частота, cos φ
• Профили нагрузки с интервалом 1–30 минут
• Расход электроэнергии по тарифным зонам (пиковая, полупиковая, ночная)
• Журнал событий: обрыв связи, выход за уставки, вскрытие клеммной крышки

Аналитика и отчётность

Дашборды

Главный экран содержит дашборды:

• Потребление электроэнергии — по объектам, периодам, тарифным зонам
• Состояние оборудования — онлайн/офлайн, последний опрос
• Каналы связи — статус подключений к УСПД
• Аномалии и события — отклонения и тревоги

Отчёты

Экспорт данных

Экспорт отчётов в XLSX с сохранением текущих фильтров. Кнопка Экспорт доступна на каждом дашборде и в разделе Отчёты.

Администрирование системы

Раздел «Настройки»

Переменные окружения

Основные переменные для настройки:

Журналирование действий

Все действия пользователей фиксируются в журнале аудита:

• Входы и выходы из системы
• Создание и изменение объектов
• Изменение настроек
• Экспорт данных

Журнал доступен в Настройки → Журнал событий (только для роли admin).

Сообщения об ошибках

При возникновении ошибок ПО отображает информативные сообщения на русском языке:

При возникновении ошибок, не перечисленных выше, обращайтесь в техническую поддержку: support@metrica.pro.

Мониторинг и диагностика

Health-эндпоинты

Логирование

ПО использует структурированные логи в формате JSON (slog). Логи выводятся в stdout и могут направляться в систему сбора логов (Loki, ELK).

Метрики и трейсинг

ПО поддерживает экспорт метрик и трейсов через OpenTelemetry (OTLP/HTTP) для интеграции с системами мониторинга (Prometheus, Grafana, Jaeger).

Резервное копирование и восстановление

Резервное копирование базы данных

Рекомендуемый метод — pg_dump:

pg_dump -U metrica -d metrica_energo -F c -f backup_$(date +%Y%m%d).dump

Рекомендуемое расписание: ежедневно, хранение копий — не менее 30 дней.

Восстановление из резервной копии

pg_restore -U metrica -d metrica_energo -c backup_20260202.dump

Docker-установка

При контейнерной установке данные PostgreSQL хранятся в Docker Volume:

docker compose exec db pg_dump -U metrica metrica_energo -F c > backup.dump

Обновление ПО

Бинарная установка

1. Остановите службу: sudo systemctl stop metrica-energo
2. Замените исполняемый файл новой версией
3. Запустите службу: sudo systemctl start metrica-energo

ПО автоматически выполнит миграцию базы данных при необходимости. Лицензия сохраняется при обновлении.

Docker-установка

1. Обновите тег образа в docker-compose.yaml
2. Выполните:

docker compose pull
docker compose up -d

О документе