Разница между Хранилище, Журнал ModBus и Журнал автоматизации
| Раздел | Что показывает | Когда открывать |
|---|---|---|
| Хранилище | Файлы конфигурации, профили устройств, служебные данные на SPIFFS и SD Card. | Когда нужно проверить, что реально сохранено на устройстве. |
| Журнал ModBus | Историю опроса и команд Modbus, сгруппированную по дереву папок и файлов. | Когда устройство не отвечает, значения stale или команда возвращает ошибку. |
| Журнал автоматизации | Историю выполнения сценариев автоматизации. | Когда нужно понять, почему правило сработало или не сработало. |
Хранилище как источник сохраненной правды
Хранилище не заменяет Конфигурация, но помогает сервисному инженеру увидеть, какие файлы реально лежат на устройстве. Для обычного изменения устройства используйте Конфигурация. Хранилище нужен для проверки, скачивания, анализа и аккуратного обслуживания.
Файловый браузер
Выбранный файл
SPIFFS и SD Card
| Носитель | Роль | Особенности |
|---|---|---|
| SPIFFS | Внутреннее хранилище устройства. | Доступно всегда, но ограничено по объему. Для polling logs может применяться циклическая очистка по свободному месту. |
| SD Card | Основное место для объемных журналов и сервисных данных, если карта установлена. | Общие runtime/event logs сохраняются только на SD. Резерв для записи равен 1% ёмкости в диапазоне 8–64 МиБ и учитывает ожидающую запись. При нехватке места удаляются только старейшие завершённые каталоги дней Modbus внутри собственного корня; текущий файл и сторонние данные не затрагиваются. |
Как читать Журнал ModBus
Современный интерфейс разделяет дерево папок и файловые операции: слева выбирается папка или область, справа отображаются файлы и действия. Это уменьшает риск потерять нужный файл в глубокой структуре.
Что собрать перед обращением в поддержку
- Скриншот ModBus с выбранным устройством и видимым состоянием.
- Файл Журнал ModBus для нужной линии и устройства.
- Журнал автоматизации, если проблема связана с автоматизацией.
- Скриншот Система с режимом линии, MQTT/gateway и состоянием хранения.
- Файлы конфигурации устройства из Хранилище, если проблема воспроизводится после перезагрузки.
Безопасные действия
| Действие | Когда использовать | Риск |
|---|---|---|
| Download | Перед обслуживанием, удалением или передачей данных в поддержку. | Минимальный. Проверьте, что файл не содержит секретов. |
| Refresh | После изменения настроек, перезагрузки или длительного ожидания. | Минимальный. Может показать новое состояние дерева. |
| Delete | Только когда файл точно не нужен или занимает место. | Высокий для конфигурации. Сначала скачайте файл. |
| Редактирование | Для сервисного исправления, если Конфигурация не подходит. | Высокий. Ошибка JSON может нарушить загрузку конфигурации. |
Формат CBOR: что находится внутри файла
Журнал опроса хранится как бинарный поток CBOR. Его нельзя открывать как UTF-8 текст:
байты надо сначала скачать без изменения, а затем разобрать Workbench или другим CBOR-инструментом.
Имя файла имеет вид modbus_<id>_<YYYYMMDD_HHMMSS>[_suffix].cbor.
| Элемент | Поле | Смысл |
|---|---|---|
| Заголовок | h | Упорядоченный массив имён каналов. |
| Запись | t | Временная метка измерения. |
| Запись | id | Modbus ID устройства. |
| Запись | v | Значения в порядке заголовка; reader также понимает прежнюю map-форму. |
Скачать CBOR через Agent Tool
python gateway_agent_tool.py list-modbus-logs --storage auto --path "" --max 500
python gateway_agent_tool.py download-modbus-log --storage auto --file "<relative/path/modbus_137_YYYYMMDD_HHMMSS.cbor>" --output .\modbus_137.cbor- Если ответ содержит
truncated:true, сузьте--path, а не увеличивайте запрос бесконечно. - Не используйте абсолютный путь и
... Tool не перезаписывает локальный файл без--overwrite. - Проверьте
/api/system/usage: активное хранилище, резерв, storage pressure и счётчики drop/no-space. - Не добавляйте сырые журналы клиента в Git; сохраняйте только обезличенный итог.
Ротация и нехватка места
Файлы имеют ограниченный размер и ротируются. При нехватке места retention работает только внутри собственного корня Modbus-журналов и выбирает самые старые завершённые каталоги. Текущий файл и посторонние данные удалять нельзя. Если резерв восстановить невозможно, это должно быть видно как storage pressure и рост счётчиков потерь, а не как «успешная запись».