Overvis Cloud — це комплексна IoT-платформа для моніторингу та керування промисловим обладнанням. Підключайте пристрої Modbus, візуалізуйте дані в реальному часі, налаштовуйте сповіщення та інтегруйтеся зі своїми системами через API.
Overvis Cloud — це промислова IoT-платформа для віддаленого моніторингу й керування обладнанням через протокол Modbus. Вона підключає ваші польові пристрої — температурні контролери, лічильники енергії, ПЛК, датчики — до хмари, надаючи доступ до даних у реальному часі, збереження історії показань, сповіщень і віддаленого керування з будь-якого місця через веб-браузер.
Посібник призначений для інженерів, інтеграторів і ентузіастів автоматизації, які знайомі з Modbus і промисловим обладнанням, але лише починають працювати з платформою Overvis. Докладні відомості про діагностику підключення та альтернативні способи з’єднання дивіться в Підключення обладнання. Докладніше про функції платформи, зокрема сповіщення, візуалізації й звіти, дивіться в документації Overvis Cloud.
Комунікаційний контролер Modbus TCP — працює як шлюз між вашими пристроями Modbus RTU та інтернетом. Для найпростішого налаштування ми рекомендуємо Overvis MC252. Інші контролери, сумісні з Overvis, наведені на overvis.com/equipment.
Пристрій Modbus RTU — обладнання, яке ви хочете моніторити або яким хочете керувати (наприклад, температурний контролер, лічильник енергії, ПЛК, датчик). Цей пристрій підключається до контролера через RS-485.
Кабель RS-485 — вита пара для підключення пристрою Modbus RTU до порту RS-485 контролера.
Інтернет-з’єднання — Ethernet-кабель або мобільний інтернет (SIM-карта) для комунікаційного контролера.
Комп’ютер або смартфон — з веб-браузером для доступу до Overvis Cloud.
Також можуть знадобитися:
Блок живлення для комунікаційного контролера (дивіться документацію контролера щодо напруги та типу роз’єму).
Документація на Modbus-пристрій — карта регістрів, адреса Modbus і параметри зв’язку вашого RTU-пристрою. Вони знадобляться, щоб налаштувати параметри в Overvis.
Перш ніж ви зможете зареєструвати контролер в Overvis, він має бути увімкнений і підключений до інтернету.
Наведені нижче кроки стосуються Overvis MC252. Інші сумісні з Overvis контролери з наліпкою з PIN-кодом налаштовуються подібним чином — точні вказівки дивіться в інструкції до конкретного контролера.
Встановіть пристрій і підключіть блок живлення 12 В DC (підтримується діапазон 9–30 В).
Підключіть Ethernet-кабель до порту LAN або вставте SIM-карту з передачею даних у слот SIM і під’єднайте GSM-антену.
Увімкніть живлення. Ініціалізація пристрою триває приблизно 15 секунд.
Натисніть кнопку R, щоб активувати дисплей. На ньому з’явиться поточна IP-адреса з префіксом (E) для Ethernet або (G) для GSM, а також швидкості передавання даних.
За замовчуванням контролер використовує DHCP, тому в більшості випадків після підключення Ethernet-кабелю він автоматично отримує IP-адресу. Якщо використовується SIM-карта без PIN-блокування, з’єднання через мобільну мережу зазвичай встановлюється протягом хвилини без будь-яких дій з боку користувача.
Якщо на дисплеї показано 0.0.0.0, пристрій ще не отримав адресу — перевірте кабель або SIM-карту. Докладні інструкції з налаштування та діагностики дивіться в Короткому посібнику MC252.
Перейдіть на ocp.overvis.com і натисніть Створити обліковий запис.
На сторінці реєстрації заповніть:
Email — буде використовуватися для входу та сповіщень. Перевірте адресу перед надсиланням форми.
Пароль — щонайменше 5 символів.
Назва організації — необов’язково. Якщо поле залишити порожнім, типову назву буде сформовано з вашої електронної адреси. Її можна буде змінити пізніше.
Прапорець згоди — щоб продовжити, потрібно погодитися з Умовами обслуговування та Політикою конфіденційності.
Натисніть Зареєструватися.
Після реєстрації ви автоматично входите в систему й переходите на сторінку Створити мережу (її описано в наступному кроці). На вказану адресу буде надіслано лист із підтвердженням — перейдіть за посиланням у ньому протягом 24 годин, щоб обліковий запис залишався активним.
Під час реєстрації Overvis створює організацію для вашого облікового запису. В Overvis організація — це одиниця білінгу й керування доступом: вона об’єднує мережі, користувачів і права доступу. Вона не обов’язково має відповідати реальній компанії: одна компанія може використовувати кілька організацій Overvis, щоб розділити різні об’єкти, проєкти або центри витрат. Докладніше про керування організаціями та запрошення членів команди дивіться в Організації та користувачі.
В Overvis мережа представляє комунікаційний контролер і всі пристрої Modbus RTU, доступні через нього. Наступний крок — створити мережу, тобто повідомити Overvis, як знайти ваш контролер і як отримати доступ до нього.
Перейдіть на сторінку Створити мережу — якщо ви щойно зареєструвалися, ви вже на ній.
Знайдіть наліпку на MC252 (або іншому сумісному з Overvis контролері). На ній є QR-код і PIN — 8-символьний буквено-цифровий код (наприклад, A1B2C3D4).
Введіть PIN з наліпки пристрою в поле PIN-код і натисніть Перевірити підключення, щоб переконатися, що контролер онлайн і доступний.
Якщо перевірка успішна, Overvis підтвердить з’єднання й покаже інформацію про контролер. Якщо перевірка не вдалася, переконайтеся, що контролер увімкнений, підключений до інтернету (див. Крок 1), і спробуйте ще раз.
Дайте мережі зрозумілу назву (наприклад, «Склад», «Офіс (HVAC)», «Опалення будинку») і натисніть Створити мережу, щоб завершити створення.
Після створення ви перейдете на сторінку мережі, де побачите контролер і його стан підключення. Перш ніж переходити до наступного кроку, переконайтеся, що контролер відображається як підключений.
Крок 4: Підключіть пристрій Modbus RTU через RS-485
Тепер, коли контролер зареєстровано в Overvis, час підключити до нього реальний пристрій Modbus RTU. Цей крок має дві частини: фізичне з’єднання через RS-485 і реєстрація пристрою в Overvis.
Підключіть пристрій Modbus RTU до комунікаційного контролера за допомогою витої пари:
Клема контролера A (неінверсна, D+) → клема пристрою A (D+, +)
Клема контролера B (інверсна, D-) → клема пристрою B (D-, -)
Переконайтеся, що обидва пристрої використовують однакові параметри послідовного зв’язку: бодова швидкість, парність і стоп-біти. У MC252 за замовчуванням встановлено 9600 бод, Modbus RTU та автоматичне визначення стоп-біта. Звіртеся з документацією свого пристрою й за потреби змініть налаштування контролера у веб-інтерфейсі MC252 на вкладці Modbus — див. Короткий посібник MC252.
Заповніть поля Назва та Modbus ID (ідентифікатор пристрою, 0–255 — дивіться документацію пристрою або DIP-перемикачі).
У випадаючому списку Ініціалізувати з шаблону виберіть шаблон, що відповідає моделі вашого пристрою. Шаблони попередньо налаштовують усі параметри (адреси регістрів, типи даних, назви, одиниці), тому вам не доведеться задавати їх вручну. Overvis містить шаблони для багатьох поширених промислових пристроїв.
Натисніть Створити пристрій.
Якщо шаблон для вашого пристрою відсутній, ви можете додати параметри вручну після створення пристрою — див. Крок 5 і документацію Мережі, пристрої та параметри. Ви також можете створювати власні шаблони для повторного використання — див. Шаблони пристроїв.
Після того як пристрій додано до мережі, ви можете переглядати його дані в Overvis.
На сторінці мережі натисніть назву пристрою, щоб відкрити його сторінку.
На сторінці Деталі зверху показано час останнього зчитування, а нижче — список параметрів. Параметри згруповані в секції: Відстежувані (значення зберігаються в історії), Програмовані (параметри, значення яких можна змінювати) і Невідстежувані (зчитуються, але не зберігаються). Якщо ви застосували шаблон пристрою, усі параметри вже будуть налаштовані з назвами, типами даних і цими прапорцями.
У кожному рядку параметра показано назву параметра, його адресу Modbus і поточне значення (з одиницями). Натисніть на значення, щоб оновити його з пристрою за запитом.
Якщо ви не використовували шаблон або вам потрібно додати додаткові параметри, натисніть Додати параметр у бічній панелі та вкажіть:
Назва — зрозуміла назва параметра.
Адреса пам’яті пристрою — номер регістру Modbus (з документації до пристрою).
Тип регістра — Holding Register, Input Register, Coil або Discrete Input.
Тип — як інтерпретувати значення регістру (Int16, Uint16, Int32, Float32 тощо).
Одиниці — одиниці вимірювання для відображення (°C, kWh, V, A тощо).
Overvis дозволяє записувати значення в регістри Modbus на пристрої — наприклад, змінювати температурну уставку, вмикати або вимикати вихід чи коригувати конфігураційний параметр.
Параметри в секції Програмовані (тобто параметри з прапорцем Програмований, заданим шаблоном або вручну під час додавання параметра) мають значок олівця поруч зі значенням. Щоб змінити значення:
Натисніть значок олівця біля параметра, який потрібно змінити.
У рядку з’явиться вбудований редактор — введіть нове значення (або виберіть його зі списку для параметрів із переліком значень).
Підтвердьте запис.
Overvis надсилає команду запису Modbus на пристрій через контролер. Показане значення оновиться під час наступного циклу зчитування (за замовчуванням кожні 10 хвилин, цей інтервал можна змінити в налаштуваннях пристрою).
Тепер у вас є робоче налаштування Overvis Cloud із живими даними з вашого обладнання. Ось що варто спробувати далі:
Сповіщення — налаштуйте автоматичні повідомлення (електронна пошта, SMS, голосовий виклик), коли значення параметрів виходять за межі порогів або пристрої втрачають зв’язок.
Візуалізації — створюйте власні інтерактивні інформаційні панелі з графіками, індикаторами та елементами керування.
Шаблони пристроїв — використовуйте попередньо налаштовані набори параметрів для швидкого додавання пристроїв або створюйте власні.
Кожен новий обліковий запис отримує бонус 30 € — цього вистачає на 1–2 місяці вільного тестування залежно від кількості підключених мереж. Щоб почати, оплата не потрібна. Подробиці про тарифи та способи оплати дивіться в Білінг.
Проблеми з підключенням (пристрій не підключається, помилки тайм-ауту, немає даних) — дивіться Підключення обладнання для діагностики й альтернативних способів підключення.
Питання щодо платформи (навігація, функції, налаштування) — дивіться відповідний розділ документації Overvis Cloud.
Overvis Cloud обмінюється даними з польовим обладнанням через Modbus TCP. У типовій конфігурації контролер зв’язку (шлюз Modbus TCP) підключається до інтернету й підтримує з’єднання з сервером Overvis. Пристрої Modbus RTU — регулятори температури, лічильники енергії, ПЛК, датчики — підключаються до шлюзу через RS-485 і доступні Overvis через шлюз.
graph LR
A["Пристрої<br/>Modbus RTU"] -->|"RS-485<br/>Modbus RTU"| B["Контролер зв’язку<br/>(шлюз Modbus TCP)"]
B -->|"Інтернет<br/>Modbus TCP"| C["Хмара Overvis"]
C -->|"Веб / HTTPS"| D["Користувач<br/>(браузер)"]
У Overvis увесь цей ланцюг відображається як мережа: один контролер зв’язку плюс усі пристрої Modbus RTU, доступні через нього. Кожен пристрій у мережі має унікальну адресу Modbus (ідентифікатор вузла) і набір параметрів — окремих значень регістрів, які Overvis зчитує з пристрою або записує в нього. Деталі щодо керування мережами, пристроями та параметрами після підключення див. у розділі Мережі, пристрої та параметри.
На цій сторінці описано все необхідне для встановлення з’єднання: реєстрація шлюзу в Overvis, підключення пристроїв RS-485, налаштування послідовного інтерфейсу, вирішення конфліктів із раніше зареєстрованими пристроями та діагностика проблем з’єднання.
Overvis підтримує три способи підключення шлюзу Modbus TCP до платформи. Перші два (PIN-код і код активації) використовують зворотне з’єднання — контролер ініціює вихідне TCP-з’єднання з Overvis, що дозволяє обійти проблеми з брандмауером і NAT. Третій спосіб (пряме з’єднання) вимагає, щоб Overvis підключався до контролера вхідним з’єднанням, для чого потрібні статична публічна IP-адреса та прокидання портів.
PIN-код — це 8-символьний буквено-цифровий код (наприклад A1B2C3D4), надрукований на наклейці на корпусі пристрою. На наклейці також є QR-код із URL на кшталт https://c.overvis.com/A1B2C3D4.
Це найпростіший спосіб підключення й рекомендований вибір для першого налаштування контролерів, сумісних з Overvis (MC252, EM-482, EM-483 та ін.).
Як це працює:
Контролер виходить на Overvis і ідентифікує себе за MAC-адресою. Коли користувач вводить PIN-код, Overvis знаходить MAC-адресу, пов’язану з цим PIN, і прив’язує її до мережі користувача. Оскільки з’єднання ініціює контролер, прокидання портів і статична публічна IP-адреса не потрібні — з’єднання працює через брандмауери, NAT і динамічні IP-адреси.
sequenceDiagram
participant C as Контролер
participant O as Overvis
participant U as Користувач
C->>O: Підключитися й передати MAC-адресу (встановлення з'єднання)
O->>C: Підтвердити встановлення з'єднання
Note over C,O: Зворотне з’єднання встановлено, очікування прив’язки
U->>O: Ввести PIN на сторінці «Створити мережу»
O->>O: Знайти MAC-адресу за PIN
O->>O: Прив’язати з’єднання до мережі користувача
O->>U: Мережу створено
loop Опитування
O->>C: Читання регістрів (Modbus TCP)
C->>O: Повернути дані
end
Кроки:
Переконайтеся, що контролер увімкнено й підключено до інтернету (Ethernet або GSM). Перевірте зв’язок на дисплеї пристрою або у веб-інтерфейсі.
Знайдіть наклейку на пристрої. Відскануйте QR-код телефоном (відкриється сторінка створення мережі з уже введеним PIN) або запишіть PIN для ручного введення.
Увійдіть у Overvis на ocp.overvis.com і перейдіть на сторінку Створити мережу.
Оберіть Використовуйте PIN-код, надрукований на наклейці пристрою, введіть PIN і натисніть Перевірити підключення.
Якщо перевірка успішна, Overvis підтверджує, що контролер онлайн, і показує його дані (модель і версія прошивки). Якщо ні — переконайтеся, що контролер має доступ до інтернету, і повторіть спробу.
Введіть зрозумілу назву мережі й натисніть Створити мережу.
Важливі особливості:
PIN-код багаторазовий — його можна використовувати кілька разів, наприклад після видалення й повторного створення мережі.
Якщо контролер уже прив’язаний до мережі у вашому обліковому записі, Overvis попередить, що наявну мережу буде від’єднано, і запропонує продовжити. Усі дані в старій мережі зберігаються.
Якщо контролер уже прив’язаний до мережі в іншому обліковому записі, PIN-код не може переприв’язати його. Потрібно скористатися методом коду активації (див. Код активації) або попросити поточного власника відв’язати пристрій (див. Конфлікти пристроїв і перехоплення контролю).
Код активації — це 8-значний числовий код (наприклад 38571098), згенерований сервером Overvis і надісланий контролеру після встановлення зворотного з’єднання. Код відображається на екрані контролера (якщо він є) або в локальному веб-інтерфейсі.
Застосовують цей метод, коли наклейка з PIN недоступна або коли потрібно перехопити контроль над контролером, уже зареєстрованим під іншим обліковим записом Overvis. Оскільки для зчитування коду активації потрібен фізичний або локальний доступ до пристрою, це підтверджує право власності.
Як це працює:
Контролер виходить на Overvis і отримує унікальний код активації, який показує на екрані або у веб-інтерфейсі. Користувач зчитує код і вводить його в Overvis, щоб прив’язати пристрій до свого облікового запису. Код змінюється щоразу, коли контролер повторно встановлює з’єднання з сервером (доки не виконано прив’язку).
sequenceDiagram
participant C as Контролер
participant O as Overvis
participant U as Користувач
C->>O: Підключитися й передати MAC-адресу (встановлення з'єднання)
O->>O: Згенерувати 8-значний код активації
O->>C: Надіслати код активації
C->>C: Показати код на екрані / у веб-інтерфейсі
Note over C,O: Зворотне з’єднання встановлено, очікування прив’язки
U->>C: Зчитати код активації з дисплея або веб-інтерфейсу
U->>O: Ввести код активації на сторінці «Створити мережу»
O->>O: Перевірити код, знайти MAC-адресу
O->>O: Прив’язати з’єднання до мережі користувача
O->>C: Підтвердити прив’язку
C->>C: Показати «active»
O->>U: Мережу створено
loop Опитування
O->>C: Читання регістрів (Modbus TCP)
C->>O: Повернути дані
end
Кроки:
Переконайтеся, що контролер увімкнено й підключено до інтернету.
Отримайте код активації:
Контролери з дисплеєм (наприклад MC252): 8-значний код з’являється на екрані після встановлення з’єднання з сервером. На дисплеї код має префікс (E) для Ethernet або (G) для GSM (наприклад (E) 38571098).
Контролери без дисплея (наприклад EM-482, EM-483, EM-130): відкрийте локальний веб-інтерфейс за IP-адресою пристрою. Код зазвичай на сторінці стану/параметрів у полі на кшталт «Код активації сервера зберігання даних» або подібному.
Увійдіть у Overvis на ocp.overvis.com і перейдіть на сторінку Створити мережу.
Оберіть Використовуйте одноразовий код, відображений на екрані пристрою, введіть 8-значний код і натисніть Перевірити підключення.
Якщо перевірка успішна, введіть назву мережі й натисніть Створити мережу.
Після успішної прив’язки на дисплеї контролера (MC252) замість числового коду з’явиться active, або на сторінці стану веб-інтерфейсу (EM-483, EM-130) буде показано «Active». Код активації перестає змінюватися — пристрій постійно прив’язаний до цієї мережі.
Важливі особливості:
Код активації має вищий пріоритет, ніж PIN-код. Він дозволяє перехопити контроль над контролером, прив’язаним до іншого облікового запису, бо зчитування коду підтверджує фізичний доступ.
Після прив’язки контролер залишається пов’язаним із цією мережі навіть після повторних підключень — Overvis не генерує новий код активації, доки пристрій не відв’язано.
Код активації одноразовий: кожен код дійсний лише до використання або до повторного підключення контролера (що генерує новий код).
Де знайти код активації за моделлю пристрою:
Пристрій
Розташування
MC252
Дисплей пристрою та веб-інтерфейс (вкладка Cloud)
EM-482
Вебінтерфейс, сторінка стану
EM-483
Вебінтерфейс, сторінка стану
EM-130
Вебінтерфейс, сторінка налаштувань/параметрів («Код активації сервера зберігання даних»)
При прямому з’єднанні Overvis ініціює TCP-з’єднання з вашим контролером за його публічною IP-адресою та портом. Цей метод працює з будь-яким стандартним пристроєм Modbus TCP — не потрібна прошивка чи інтеграція, специфічні для Overvis. Водночас прямий спосіб складніший у налаштуванні й менш безпечний, ніж зворотні способи підключення.
Як це працює:
Overvis встановлює TCP-з’єднання з указаною IP-адресою та портом, далі обмінюється даними за стандартним протоколом Modbus TCP. З’єднання ініціює сервер Overvis, тому цільовий пристрій має бути доступний з інтернету.
sequenceDiagram
participant U as Користувач
participant O as Overvis
participant R as Маршрутизатор
participant C as Контролер
U->>O: Створити мережу з прямим з’єднанням<br/>(IP, порт, Modbus ID шлюзу)
O->>R: TCP-з’єднання з публічною IP:порт
R->>C: Перенаправити на контролер (прокидання портів)
C->>R: Відповідь Modbus TCP
R->>O: Переслати відповідь
O->>U: З’єднання перевірено, мережу створено
loop Опитування
O->>R: Запит читання регістрів
R->>C: Перенаправити на контролер
C->>R: Повернути дані
R->>O: Переслати відповідь
end
Передумови:
Статична публічна IP-адреса від провайдера. Динамічні IP не підтримуються — якщо IP зміниться, Overvis втратить з’єднання.
Прокидання портів на маршрутизаторі для перенаправлення зовнішнього трафіку на локальну IP-адресу контролера та порт Modbus TCP (за замовчуванням 502).
Резервування DHCP або статична IP-адреса для контролера в локальній мережі, щоб правила прокидання залишалися коректними.
Кроки:
Отримайте статичну публічну IP-адресу від провайдера.
Налаштуйте маршрутизатор на прокидання обраного зовнішнього порту на внутрішню IP-адресу контролера та порт Modbus TCP (за замовчуванням 502).
Забезпечте, щоб контролер завжди мав ту саму локальну IP-адресу — через резервування DHCP на маршрутизаторі або статичну IP-адресу на контролері.
Увійдіть у Overvis і перейдіть на сторінку Створити мережу.
Оберіть Встановити пряме підключення Modbus TCP.
Заповніть обов’язкові поля:
Контролер Modbus TCP — оберіть модель зі списку або «Інший пристрій Modbus TCP» для стороннього обладнання.
Адреса шлюзу Modbus — ідентифікатор вузла Modbus самого шлюзу (за замовчуванням 111 для MC252; див. документацію пристрою).
Після реєстрації контролера зв’язку в Overvis наступний крок — підключити польові пристрої: регулятори температури, лічильники, ПЛК, датчики, ПЧ та інше обладнання Modbus RTU до порту RS-485 контролера.
RS-485 використовує диференційну пару сигналів — два дроти з однаковим сигналом протилежної полярності. Підключайте клеми контролера та пристрою так:
Клема контролера A (неінвертована, D+) → клема пристрою A (D+)
Клема контролера B (інвертована, D−) → клема пристрою B (D−)
За потреби з’єднайте клему екрану/землі (позначки ⊥, GND або G) між пристроями, якщо вона є.
Використовуйте екрановану виту пару (категорія 1 або краще). Екран заземлюйте на одному кінці шини згідно з ANSI/TIA/EIA-485-A-1998.
Топологія шини:
RS-485 — шинна топологія: усі пристрої з’єднуються «гірляндою» (пристрій до пристрою), а не зіркою. Уникайте відгалужень (Т-подібних відводів) довших за кілька сантиметрів — вони викликають відбиття сигналу.
graph LR
A["Контролер<br/>(ведучий)"] --- B["Пристрій 1<br/>ID: 1"]
B --- C["Пристрій 2<br/>ID: 2"]
C --- D["Пристрій 3<br/>ID: 3"]
D --- E["..."]
Термінація:
Довгі шини RS-485 або робота на високих швидкостях можуть потребувати термінуючих резисторів (зазвичай 120 Ω) на обох кінцях шини для зменшення відбиттів. У частини контролерів термінація вбудована (наприклад EM-482 має внутрішній термінатор 1000 Ω). Якщо на довгій шині бувають переривчасті помилки зв’язку, спочатку спробуйте додати термінуючі резистори.
Усі пристрої на шині RS-485 мають використовувати однакові налаштування послідовного інтерфейсу. Невідповідність будь-якого з параметрів унеможливлює обмін.
Бітрейт — швидкість передачі даних у бітах за секунду. Типові значення:
Бітрейт
Типове застосування
1200
Повільне/застаріле обладнання
2400
Застаріле обладнання
4800
Старіше обладнання
9600
Найпоширеніше за замовчуванням
19200
Швидше опитування
38400
Швидкі пристрої
57600
Високошвидкісні пристрої
115200
Максимум для більшості RS-485
Бітрейт має збігатися між контролером і всіма підключеними пристроями. Вищі швидкості передачі дають швидше опитування, але можуть бути ненадійними на довгих лініях або в умовах електромагнітних завад.
Формат байта (парність і стоп-біти):
Кожен байт на шині RS-485 може містити необов’язкову парність і стоп-біти для виявлення помилок. Формат має збігатися на всіх пристроях. Поширені варіанти:
Формат
Опис
8N1 (ABSENT)
8 біт даних, без парності, 1 стоп-біт
8N2 (STOP)
8 біт даних, без парності, 2 стоп-біти
8E1 (EVEN)
8 біт даних, парна парність, 1 стоп-біт
8O1 (ODD)
8 біт даних, непарна парність, 1 стоп-біт
SPACE
8 біт даних, парність SPACE (нуль), 1 стоп-біт
MARK
8 біт даних, парність MARK (одиниця), 1 стоп-біт
AUTO-STOP
Автовизначення — передача з 2 стоп-бітами, прийом 1 або 2 стоп-бітів. Доступно на деяких контролерах, сумісних з Overvis.
Найпоширеніші конфігурації — 9600 бод, 8N1 або 9600 бод, 8E1. Перевіряйте документацію пристрою щодо потрібних налаштувань.
Налаштування послідовного інтерфейсу на контролерах, сумісних з Overvis:
Для контролерів, підключених зворотним з’єднанням (PIN або код активації), Overvis може зчитувати й змінювати налаштування RS-485 віддалено. Після створення мережі на сторінці налаштувань мережі відображаються поточні Бітрейт та Формат байта контролера, їх можна змінити.
Для сторонніх контролерів із прямим з’єднанням налаштовуйте послідовний інтерфейс через інтерфейс самого контролера (веб-інтерфейс, передню панель, DIP-перемикачі тощо).
Стандарт RS-485 (ANSI/TIA/EIA-485-A) визначає максимальну довжину шини 1200 метрів (4000 футів). На практиці досяжна відстань залежить від бітрейту, якості кабелю та рівня завад:
Бітрейт
Практична максимальна відстань
9600
до 1200 м
19200
до 1200 м
38400
до 1000 м
57600
до 700 м
115200
до 500 м
Це наближені значення. У шумних умовах (поблизу ПЧ, високовольтних ліній, зварювального обладнання) використовуйте коротші траси. Якщо потрібна довжина понад 1200 м — повторювачі RS-485 або другий контролер зв’язку з окремою мережею Overvis.
Максимальна кількість пристроїв:
Кількість пристроїв на одній шині RS-485 залежить від вхідного імпедансу приймачів:
Вхідний струм приймача
Макс. пристроїв
1 мА (стандарт)
32
0,5 мА (1/2 одиничного навантаження)
64
0,25 мА (1/4 одиничного навантаження)
128
0,125 мА (1/8 одиничного навантаження)
256
Більшість сучасних пристроїв Modbus RTU використовують приймачі з навантаженням 1/4 або 1/8 одиничного навантаження, що дозволяє 128–256 пристроїв на одній шині. Перевіряйте специфікації приймачів RS-485 у паспортах пристроїв.
Кожен пристрій має мати унікальну адресу Modbus (ідентифікатор вузла) у діапазоні 0–255. Адреса 0 зарезервована для широкомовних команд у протоколі Modbus (запис на всі пристрої, відповіді не очікується).
Modbus через RS-485 підтримує два режими кадрування:
Modbus RTU — бінарне кадрування з контролем CRC-16. Стандартний режим для переважної більшості пристроїв. Дані компактні, передача ефективна.
Modbus ASCII — кадрування в ASCII з контролем LRC. Кожен байт передається як два шістнадцяткові символи ASCII, дані читабельні людиною, але потрібна подвоєна смуга. Використовується в деяких старих або спеціалізованих пристроях.
Обидва режими використовують ту саму модель регістрів і коди функцій — відрізняється лише кодування байтів на лінії.
Більшість контролерів, сумісних з Overvis, за замовчуванням використовують Modbus RTU. Якщо підключений пристрій вимагає Modbus ASCII, налаштуйте це в параметрах послідовного порту контролера (веб-інтерфейс або регістри Modbus). Сам Overvis спілкується з контролером через Modbus TCP, що не залежить від режиму — контролер виконує перетворення RTU/ASCII на боці RS-485.
Кожен фізичний пристрій Modbus RTU, підключений до порту RS-485 контролера, у Overvis представлений як пристрій, ідентифікований ідентифікатором вузла Modbus у межах мережі.
Щоб додати пристрій, відкрийте сторінку мережі в Overvis і натисніть Додати пристрій. Вкажіть назву пристрою, Modbus ID і за бажанням оберіть Шаблон пристрою для попереднього налаштування всіх параметрів. Якщо шаблону немає, параметри можна додати вручну, вказавши адреси регістрів, типи даних і назви.
Інформацію про карту регістрів Modbus, підтримувані коди функцій і типи даних зазвичай наведено в документації або паспорті пристрою, часто в розділах «Регістри Modbus», «Протокол обміну» або «Карта регістрів».
Коли ви намагаєтеся створити мережу з контролером, уже зареєстрованим у Overvis, поведінка залежить від способу підключення та того, чи належить контролер вашому обліковому запису чи іншому.
Якщо PIN-код уже прив’язаний до мережі в вашому обліковому записі, Overvis показує попередження:
Код підключення ABCD1234 уже прив’язаний до мережі Склад. Після надсилання цієї форми цю мережу буде від’єднано. Усі дані збережуться.
Можна продовжити — стару мережу буде від’єднано, контролер прив’яжеться до нової. Стара мережа та її дані (параметри пристроїв, історія зчитувань) залишаються доступними.
Якщо контролер уже прив’язаний до мережі в іншому обліковому записі Overvis, PIN-код не може переприв’язати його. PIN-код має нижчий пріоритет — він підтверджує наявність наклейки, але не обов’язково фізичний доступ до пристрою.
Щоб перехопити контроль над контролером, скористайтеся методом коду активації.
Код активації має вищий пріоритет, ніж PIN-код, бо потрібно зчитати код з дисплея або веб-інтерфейсу, що підтверджує фізичний доступ. За його допомогою можна перехопити контроль над контролером від будь-якого облікового запису — після прив’язки пристрій вилучається з мережі попереднього власника.
Щоб відв’язати контролер від поточної мережі (щоб його можна було зареєструвати знову — вами або іншим користувачем), скористайтеся одним із способів:
Видаліть мережу в Overvis, до якої прив’язано контролер.
Змініть налаштування з’єднання мережі на інший спосіб (наприклад зі зворотного на пряме з’єднання).
Скиньте активацію на пристрої — у веб-інтерфейсі контролера натисніть «Restart Activation» (MC252, EM-483) або «Reset Activation Code» (EM-130). Пристрій буде вилучено з мережі Overvis і згенерується новий код активації.
Після відв’язування контролер знову підключається до Overvis і отримує новий код активації, готовий до повторної реєстрації.
Деякі контролери підтримують захист доступу паролями для читання та/або запису регістрів. Якщо на контролері налаштовано паролі, додайте їх у розділі Паролі доступу на контролері. Overvis надсилає ці паролі контролеру після підключення в тому вигляді, в якому їх введено.
Можна додати кілька паролів — наприклад окремо для читання та запису. Контролер визначає, який рівень доступу дає кожен пароль.
Визначає, скільки запитів Modbus Overvis надсилає в цю мережу одночасно (паралельно). За замовчуванням 1 — Overvis чекає відповіді на кожен запит перед наступним (послідовний режим).
Збільшення значення дозволяє надсилати кілька запитів одразу, що може прискорити опитування, якщо контролер це підтримує. Водночас багато контролерів RS-485 обробляють запити послідовно на шині незалежно від цього, тому високе значення може не дати вигоди й спричинити тайм-аути при переповненні черги запитів контролера.
Залишайте значення 1, доки не впевнені, що ваш контролер підтримує паралельну обробку запитів.
Мережі можна вимкнути, щоб призупинити весь обмін без видалення мережі й втрати даних. Вимкнена мережа зупиняє зчитування, запис, фонове відстеження та обробку сповіщень. Дашборди та візуалізації не мають доступу до вимкнених мереж. Усі наявні дані та налаштування зберігаються, мережу можна знову увімкнути будь-коли.
Проблеми з’єднання поділяються на три рівні. Починайте зверху вниз — кожен наступний рівень має сенс після вирішення попереднього.
graph TD
A["Проблема з доступом до даних"] --> B{"Чи шлюз<br/>онлайн в Overvis?"}
B -->|Ні| C["Рівень 1:<br/>Шлюз недоступний"]
B -->|Так| D{"Чи пристрій<br/>відповідає на читання?"}
D -->|Ні| E["Рівень 2:<br/>Пристрій недоступний"]
D -->|Так| F{"Чи дані<br/>коректні?"}
F -->|Ні| G["Рівень 3:<br/>Дані некоректні"]
F -->|Так| H["Поза межами<br/>цього посібника"]
Симптом: У Overvis мережа відображається як офлайн. Дані з жодного пристрою не зчитуються. У підказці стану з’єднання: «Пристрій не підключився до сервера» (зворотні з’єднання) або «Сервер не встановив з’єднання» (прямі з’єднання).
Це означає, що Overvis не може обмінюватися даними з контролером зв’язку. Для зворотних з’єднань — контролер не встановив або втратив вихідне з’єднання з Overvis. Для прямих — Overvis не досягає IP-адреси й порту контролера.
Переконайтеся, що контролер увімкнено й працює. Перевірте індикатор живлення:
Пристрій
Нормальний індикатор живлення
MC252
Світлодіод PWR горить; на дисплеї показані IP-адреси
EM-482
Світлодіод PWR зелений
EM-483
Індикатор живлення увімкнено; індикатор помилки (⚠) вимкнено
EM-130
Індикатор On/Off увімкнено
Якщо на MC252 не горить PWR, перевірте джерело 9–30 В пост. струму та запобіжник. Якщо на EM-482 PWR постійно червоний або швидко блимає червоним — можлива несправність, зверніться до виробника. Якщо на EM-483 індикатор помилки (⚠) після увімкнення стабільно або періодично червоний — несправність пристрою.
2. Мережеве з’єднання (Ethernet / Wi-Fi)
Контролер має мати робоче з’єднання з локальною мережею, перш ніж досягне Overvis.
MC252 (Ethernet): Переконайтеся, що кабель підключено й активний світлодіод LAN (блимає під час передачі). На дисплеї показана призначена IP-адреса з префіксом (E). Якщо (E) 0.0.0.0 — DHCP ще узгоджується, зачекайте 20–60 с. Якщо (E) 192.168.0.111 — DHCP не вдався, пристрій перейшов на заводську статичну IP-адресу. Перевірте кабель, DHCP у маршрутизаторі або налаштуйте статичну IP-адресу у веб-інтерфейсі (вкладка LAN/Internet).
EM-482 (Wi-Fi): Світлодіод WI-FI повільно блимає (кожні 3 с) під час підключення й горить постійно після з’єднання. Якщо WI-FI блимає довше 2 хв — налаштована точка доступу недоступна: перевірте SSID, пароль, відстань до точки та її живлення. Якщо WI-FI і SRV блимають по черзі — пристрій у режимі налаштування Wi-Fi: завершіть налаштування у веб-інтерфейсі або вийдіть з режиму, утримуючи кнопку R близько 3 с.
EM-130 (Wi-Fi): Потрібен режим клієнта Wi-Fi з увімкненим клієнтом Overvis. Якщо Wi-Fi вимкнено або ввімкнено режим точки доступу, пристрій не підключиться до інтернету. Налаштуйте клієнтський режим у веб-інтерфейсі.
3. Доступ до інтернету та сервера Overvis
Навіть при робочому локальному з’єднанні контролер має досягати сервера Overvis через інтернет.
MC252: Перевірте світлодіод SRV — він показує активне з’єднання з хмарою/сервером. У веб-інтерфейсі (вкладка Cloud) переконайтеся, що хмарне з’єднання увімкнено й адреса сервера коректна (за замовчуванням ocp.overvis.com, порт 20502).
EM-482:SRV має увімкнутися невдовзі після WI-FI. Якщо SRV залишається вимкненим довше 2 хв — пристрій не досягає інтернету. Перевірте адресу сервера у веб-інтерфейсі. Переконайтеся, що брандмауер мережі не блокує вихідні з’єднання.
EM-130: У налаштуваннях віддаленого доступу веб-інтерфейсу переконайтеся, що клієнт Overvis увімкнено (параметр увімкнення клієнта — «Так») й адреса сервера коректна (за замовчуванням modbus.overvis.com, порт 20502).
4. Брандмауер і порти
Контролер ініціює вихідне TCP-з’єднання до сервера Overvis на порт 20502. Корпоративні мережі та брандмауери можуть це блокувати. Попросіть адміністратора дозволити вихідний TCP на ocp.overvis.com:20502 (або modbus.overvis.com:20502 для EM-130).
5. Перевірка DNS
Контролеру потрібно розв’язати ім’я хоста сервера Overvis. Якщо DNS у локальній мережі не працює, налаштуйте публічний DNS на контролері (наприклад 8.8.8.8). EM-130 за замовчуванням використовує 208.67.222.222 та 8.8.8.8.
6. З’єднання GSM/LTE (MC252)
Для контролерів із стільниковим зв’язком:
Переконайтеся, що SIM-карта повністю вставлена (до клацання) і має активні дані.
Перевірте підключення антени до роз’єму ANT.
Перевірте рівень GSM-сигналу на дисплеї MC252 (має бути >0%).
У веб-інтерфейсі (LAN/Internet → GSM) переконайтеся, що APN відповідає вимогам оператора.
Якщо на SIM увімкнено PIN, введіть його в налаштуваннях GSM. Якщо не впевнені, спочатку вимкніть PIN на телефоні.
Спробуйте змінити положення антени для кращого сигналу.
7. Хмарне з’єднання вимкнено на контролері
Деякі контролери постачаються з вимкненим за замовчуванням хмарним з’єднанням:
MC252: У веб-інтерфейсі відкрийте вкладку Cloud і переконайтеся, що хмарне з’єднання увімкнено. Після ввімкнення натисніть «Зберегти й перезавантажити».
EM-130: Клієнт Overvis за замовчуванням вимкнено. Увімкніть його в налаштуваннях віддаленого доступу веб-інтерфейсу.
EM-482, EM-483: Хмарне з’єднання за замовчуванням увімкнено. Якщо його вимкнули — увімкніть знову у веб-інтерфейсі.
Статична IP-адреса — переконайтеся, що публічна IP-адреса не змінилася. Уточніть у провайдера або перевірте сайт «яка моя IP» з мережі контролера.
Прокидання портів — перевірте, що правило прокидання на маршрутизаторі активне й вказує на правильну внутрішню IP-адресу та порт (за замовчуванням Modbus TCP: 502).
Локальна IP-адреса контролера — чи не змінилася локальна IP-адреса (закінчився термін DHCP)? Повторно налаштуйте резервування DHCP або статичну IP-адресу на контролері.
Брандмауер — переконайтеся, що жоден брандмауер між Overvis і маршрутизатором не блокує налаштований порт.
Контролер — переконайтеся, що контролер увімкнено, працює й служба Modbus TCP активна на очікуваному порту. На MC252 у веб-інтерфейсі на вкладці Modbus переконайтеся, що Modbus TCP Server увімкнено на порту 502.
Симптом: Мережа онлайн (шлюз підключено), але один або кілька пристроїв показують помилки читання, тайм-аути або «немає відповіді» для всіх параметрів.
Контролер обмінюється з Overvis, але не може зв’язатися з кінцевим пристроєм на шині RS-485.
1. Перевірка адреси Modbus
Переконайтеся, що адреса Modbus (ідентифікатор вузла) пристрою в Overvis збігається з адресою на фізичному пристрої. Адресу зазвичай задають DIP-перемикачами, передньою панеллю або ПЗ конфігурації. Типові адреси за замовчуванням різняться за виробником — див. керівництво пристрою.
2. Полярність проводки RS-485
Поміняйте місцями дроти A і B на контролері або на пристрої. Переполюсована пара — найчастіша проблема RS-485 і не пошкоджує обладнання. Виробники по-різному позначають клеми — те, що один називає «A», інший може назвати «B». Орієнтуйтеся на D+/D− або +/-.
3. Збіг налаштувань послідовного інтерфейсу
Усі пристрої на шині RS-485 мають мати однакові налаштування. Невідповідність будь-якого параметра дає повну тишу (немає відповідей) або помилки CRC:
Бітрейт — переконайтеся, що швидкість на контролері збігається з швидкістю пристрою. Найпоширеніше за замовчуванням — 9600.
Парність / стоп-біти — переконайтеся, що формат байта (наприклад 8N1 проти 8E1) збігається між контролером і всіма пристроями. Якщо не впевнені, спробуйте режим AUTO-STOP на контролерах, що підтримують (MC252, EM-482) — передача з 2 стоп-бітами, прийом 1 або 2.
Modbus RTU проти ASCII — переважна більшість пристроїв у режимі RTU. Якщо пристрій вимагає ASCII, налаштуйте контролер відповідно.
Для контролерів, сумісних з Overvis, ці параметри можна змінити:
MC252: Вебінтерфейс (вкладка Modbus → розділ RS-485) або віддалено в налаштуваннях мережі Overvis.
EM-482: Вебінтерфейс під час налаштування або віддалено в налаштуваннях мережі Overvis.
4. Інструмент пошуку пристроїв MC252
У веб-інтерфейсі MC252 є вбудований інструмент Пошук пристроїв (вкладка Modbus → кнопка «Пошук пристроїв»), який сканує всі адреси Modbus і за потреби пробує різні швидкості, парність і протокол. Це допомагає виявити підключені пристрої та їх фактичну конфігурацію. Повне сканування займає 30–60 хв; якщо відомо, що всі пристрої з однаковими налаштуваннями, використовуйте Швидкий пошук.
5. Інструмент «Надіслати запит» на MC252
У веб-інтерфейсі MC252 є інструмент Надіслати запит (вкладка Modbus → кнопка «Надіслати запит»), який надсилає один запит Modbus і показує сиру відповідь. Використовуйте для перевірки зв’язку з конкретною адресою. Код винятку у відповіді не обов’язково означає несправність пристрою — можливо, у пристрої немає запитуваного регістра.
RS-485 має бути з’єднаний «гірляндою» (шина), а не зіркою. Уникайте довгих Т-відводів.
На довгих шинах (>100 м) або високих швидкостях (>38400) додайте термінуючі резистори 120 Ω на обох кінцях. У EM-482 є вбудований термінатор 1000 Ω.
Спробуйте коротший кабель для перевірки.
7. Живлення та стан пристрою
Переконайтеся, що пристрій увімкнено й у нормальному режимі (не в конфігурації, оновленні прошивки чи стані помилки). Деякі пристрої вимикають Modbus у певних режимах.
8. Конфлікти на шині
Переконайтеся, що жодні два пристрої на одній шині RS-485 не мають однакової адреси Modbus. Дублікати спричиняють колізії та спотворені відповіді.
Якщо наближаєтеся до ліміту пристроїв для типу приймача (32 для стандартних 1 мА, 128–256 для малопотужних), спробуйте від’єднати частину пристроїв і перевірити, чи покращиться зв’язок.
9. Електромагнітні завади
Зв’язок RS-485 можуть порушувати ПЧ, двигуни, високовольтне комутаційне обладнання чи зварювання. Прокладайте кабелі RS-485 подалі від силових ліній, використовуйте екрановану виту пару. Екран заземлюйте на одному кінці шини.
Рівень 3: пристрій відповідає, але дані некоректні
Симптом: Пристрій відповідає, але значення в Overvis неправильні — невірні числа, завжди нуль, від’ємні замість додатних тощо.
Шлях обміну працює, але конфігурація параметрів не відповідає карті регістрів пристрою.
1. Зміщення адреси регістра
Конвенції адресації регістрів Modbus різняться між виробниками. У посібниках деяких пристроїв адреси наведено починаючи з 0, в інших — з 1, у третіх — з 40001 (конвенція Modicon, де 40001 = holding register 0). Якщо значення зміщене на один регістр або систематично зсунуте, спробуйте змінити адресу регістра на ±1.
2. Невідповідність типу регістра
Modbus визначає чотири типи регістрів. Неправильний тип читає з іншого простору адрес:
Тип регістра
Коди функцій
Типове застосування
Регістри зберігання
3 (читання), 6/16 (запис)
Читання/запис конфігурації та даних
Вхідні регістри
4 (читання)
Лише читання вимірювань
Котушки
1 (читання), 5/15 (запис)
Однобітові стани вкл/викл
Дискретні входи
2 (читання)
Однобітові лише для читання
Переконайтеся, що параметр у Overvis використовує той самий тип регістра, що й у документації пристрою.
3. Тип даних і порядок байтів
Температура як 32-біт float виглядатиме як «сміття», якщо зчитувати як два незалежні 16-бітні цілі. Поширені типи:
16-бітне беззнакове ціле (1 регістр)
16-бітне знакове ціле (1 регістр)
32-біт float IEEE 754 (2 регістри)
32-бітне беззнакове/знакове ціле (2 регістри)
Для значень на кілька регістрів перевірте порядок байтів (big-endian vs little-endian) і порядок слів (AB CD vs CD AB). Інструмент «Надіслати запит» у веб-інтерфейсі MC252 допомагає інтерпретувати сирі значення регістрів.
4. Коефіцієнт масштабування
Багато пристроїв зберігають значення з неявною десятковою комою. Наприклад, 23,5 °C може зберігатися як ціле 235 (×10) або 2350 (×100). EM-130, наприклад, представляє десяткові значення як цілі з коефіцієнтом за кількістю знаків після коми (1 знак = ×10, 2 = ×100, 3 = ×1000). Перевіряйте документацію щодо масштабу.
5. Документація пристрою
Карта регістрів Modbus — основне джерело адрес, типів і масштабу. Зазвичай вона в керівництві, окремому документі «протокол обміну» або на сайті виробника. Для пристроїв, сумісних з Overvis, карти наведено в документації:
На сторінці стану веб-інтерфейсу EM-483 показано з’єднання з сервером: код активації (очікування прив’язки), «Active» (прив’язано до Overvis) або «No Code» (зареєстровано через QR/PIN наклейку).
У EM-130 один індикатор On/Off і кнопка Wi-Fi — дисплея немає. Діагностуйте стан через веб-інтерфейс. У налаштуваннях віддаленого доступу переконайтеся, що клієнт Overvis увімкнено й показано код активації (з’єднання з сервером встановлено).
Overvis Cloud Documentation
Мережі, пристрої та параметри
Overvis організовує польові дані в трирівневу ієрархію:
Рівень
Батьківський об’єкт
Що представляє
Основна відповідальність
Мережа
Організація
Одне підключення контролера або шлюзу
Доступність і зв’язок на рівні контролера
Пристрій
Мережа
Один вузол Modbus усередині цієї мережі
Опитування та поведінка запису для цього вузла
Параметр
Пристрій
Одне читане або записуване значення на пристрої
Адресація, перетворення типу, зберігання та можливість запису
Ця сторінка — довідка для всіх трьох рівнів: що вони зберігають, як пов’язані між собою й як їхні налаштування впливають на зв’язок і обробку даних. Порядок такий самий, як у ієрархії: спочатку мережі, потім пристрої, потім параметри. Для практичного введення див. Початок роботи. Щодо способів підключення та усунення несправностей див. Підключення обладнання.
Кожна мережа, кожен пристрій і кожен параметр мають два ідентифікатори:
Внутрішній ідентифікатор — числовий первинний ключ, що використовується в API та базі даних.
Слаг — URL-дружній рядок, отриманий з назви об’єкта (наприклад warehouse, temperature-controller, current-temperature). Слаг унікальний у межах батьківської області: слаг мережі — у межах організації, слаг пристрою — у межах мережі, слаг параметра — у межах пристрою. Overvis використовує слаги в URL сторінок.
Мережі та пристрої можна вимкнути, не видаляючи їх. Вимкнення зберігає всю конфігурацію та збережені дані, але зупиняє зв’язок:
Вимкнена мережа зупиняє всі читання, записи й фонове опитування для кожного пристрою та параметра під нею.
Вимкнений пристрій зупиняє всі читання, записи й фонове опитування для кожного параметра під ним.
Мережі та пристрої можуть бути вимкнені користувачем, системою білінгу (коли вичерпано баланс організації) або адміністратором платформи. Час вимкнення та ініціатор фіксуються, щоб причина була завжди видима.
Повторне ввімкнення одразу відновлює нормальну роботу — переналаштування не потрібне.
Окремого перемикача увімкнено / вимкнено для окремих параметрів немає. Відстежуваний і програмований керують опитуванням, історією та записами (див. Прапорці поведінки); параметр з обома вимкненими прапорцями все одно можна читати на вимогу. Щоб зупинити весь трафік Modbus для пристрою — включно з читаннями на вимогу — вимкніть пристрій або мережу.
Щоб створити мережу, перейдіть до списку мереж організації й натисніть Додати мережу. Форма створення проводить через вибір способу підключення та введення параметрів з’єднання. Покроковий опис кожного способу підключення див. у Підключення обладнання.
Змістовна назва мережі (наприклад «Warehouse», «Office HVAC»).
Опис
Необов’язковий довільний текстовий опис.
Підключення
Як Overvis досягає контролера: зворотне підключення (PIN-код або код активації) або прямий Modbus TCP (IP-адреса та порт). Докладніше про кожен спосіб див. Підключення обладнання.
Контролер Modbus TCP:
Модель контролера зв’язку (наприклад MC252, EM-482, EM-130 або «Інший пристрій Modbus TCP» для стороннього обладнання). Визначає доступні вбудовані функції та налаштування. Відповідає полю Контролер Modbus TCP: у формі мережі.
Адреса шлюзу Modbus
Modbus unit ID самого контролера на TCP-зв’язку (типово 111). Використовується, коли Overvis має звертатися до шлюзу безпосередньо — наприклад, щоб читати або змінювати налаштування послідовного порту на сумісному з Overvis контролері. Це не адреса жодного польового пристрою.
Паролі доступу на контролері
Паролі, що надсилаються контролеру після підключення. Деякі контролери вимагають один або кілька паролів для доступу на читання та/або запис. Можна налаштувати кілька паролів (наприклад окремі паролі читання й запису).
Кількість одночасних запитів
Скільки запитів Modbus Overvis одночасно надсилає в цю мережу (типово 8). Збільшення дозволяє паралельні запити й може прискорити опитування, якщо контролер це підтримує. Багато контролерів обробляють запити RS-485 послідовно незалежно від цього, тож високе значення може не покращити швидкодію й спричинити тайм-аути.
На підтримуваних контролерах з’являється блок Налаштування Modbus на контролері (швидкість лінії та формат байта). Overvis зчитує поточні значення з контролера й може записувати зміни тим самим каналом. Показується лише коли тип контролера підтримує це й мережа підключена. Див. Налаштування послідовного інтерфейсу, щоб обрати значення, узгоджені з польовими пристроями.
Налаштування мережі не містять Modbus-адрес пристроїв за контролером, адрес регістрів параметрів чи правил інтерпретації даних. Це рівні пристрою та параметра.
Сторінка мережі показує стан підключення шлюзу та список усіх пристроїв у мережі.
Список пристроїв показує Modbus ID кожного пристрою, назву, кількість відстежуваних параметрів, період оновлення та час останнього зчитування. З цієї сторінки можна вмикати або вимикати окремі пристрої, відкривати налаштування пристрою або видалити пристрій.
Для мереж зі зворотним підключенням (PIN-код або код активації) сторінка також показує стан з’єднання та дії керування, наприклад розрив з’єднання.
Пристрій представляє один вузол Modbus усередині мережі — одну адресовану кінцеву точку за контролером. Усі пристрої мережі використовують те саме підключення контролера.
Ключовий ідентифікатор — Modbus ID (unit ID, 0–255), який має бути унікальним у межах мережі й збігатися з адресою, налаштованою на фізичному пристрої (DIP-перемикачі, передня панель або ПЗ конфігурації пристрою).
Щоб створити пристрій, відкрийте сторінку мережі й натисніть Додати пристрій.
Форма створення запитує:
Назва та необов’язковий опис.
Modbus ID — адреса вузла фізичного пристрою.
Шаблон пристрою (необов’язково) — виберіть шаблон, щоб заздалегідь налаштувати всі параметри. Доступні вбудовані шаблони або шаблони, створені в організації. Докладніше див. Шаблони пристроїв.
Якщо для вашого пристрою немає шаблону, після створення пристрою можна додати параметри вручну.
Після створення пристрою Overvis одразу починає з ним обмін (якщо мережа підключена й пристрій увімкнений).
Modbus unit ID (0–255). Має збігатися з адресою фізичного пристрою та бути унікальним у межах мережі.
Інтервал зчитування (сек.)
10 хв
Як часто Overvis виконує фонові читання відстежуваних параметрів на цьому пристрої. Коротші періоди дають частіші дані, але збільшують навантаження на мережу.
Розмір групи читання
1
Максимальна кількість послідовних регістрів, які Overvis об’єднує в один запит Modbus на читання. У формі налаштувань пристрою допустимі значення 1–16; у базі даних — до 255 (наприклад, якщо задано через імпорт шаблону). Більші значення зменшують кількість запитів, читаючи більші блоки регістрів за раз, що прискорює опитування. Значення 1 означає, що кожен параметр читається окремо.
Функція запису Modbus
0x6 для одного регістра, 0x10 для кількох регістрів (типово)
Який код функції Modbus використовувати під час запису значень параметрів. Типовий варіант відповідає цій позначці в інтерфейсі (Overvis обирає функцію 06 для однорегістрових значень і 16 для багаторегістрових). Інші варіанти: Always use function 06 (примусово запис одного регістра), Always use function 16 (примусово запис кількох регістрів). Деякі пристрої приймають лише один конкретний тип запису — див. документацію пристрою.
Максимальна кількість повторних запитів
3
Скільки разів Overvis повторює запит після тайм-ауту або помилки «немає відповіді», перш ніж позначити пристрій як недоступний.
Налаштування пристрою не визначають шлях підключення до контролера (це рівень мережі) і не визначають, як декодуються окремі значення регістрів (це рівень параметра).
Сторінка пристрою — місце перегляду та взаємодії зі значеннями параметрів. Параметри згруповано за прапорцями поведінки (відстежуваний, програмований) у розділи — визначення див. Прапорці поведінки.
Сторінка пристрою показує:
Останнє зчитування — часову мітку останнього фонового зчитування для цього пристрою.
Наступне зчитування — коли відбудеться наступне заплановане фонове зчитування.
Список параметрів — усі параметри, згруповані в три розділи (відстежувані, програмовані, невідстежувані), з категоріями в кожному розділі.
За замовчуванням відстежувані параметри показують останнє збережене значення. Воно може бути з останнього фонового опитування, не обов’язково «живе».
Щоб зчитати живе значення з пристрою:
Клацніть по значенню параметра, щоб почати читати його з пристрою в реальному часі. Overvis автоматично оновлюватиме це значення, доки ви не клацнете знову. Працює й для відстежуваних, і для невідстежуваних параметрів.
Клацніть іконку оновлення в заголовку стовпця, щоб одночасно зчитати всі видимі значення параметрів.
Невідстежувані параметри показують «---», доки не виконано зчитування на вимогу.
Біля значення програмованих параметрів є іконка олівця. Клацання відкриває вбудований редактор:
Для числових параметрів з’являється текстове поле для введення нового значення.
Для параметрів переліку з’являється список із визначеними підписами (наприклад «Standby», «Heating», «Cooling») — Overvis записує відповідне числове значення на пристрій.
Запис одразу надсилається на пристрій. Якщо запис не вдається, Overvis показує повідомлення про помилку з причиною.
Параметр — найменший операційний об’єкт ієрархії. Він представляє одне визначення значення на пристрої — один фрагмент даних, який Overvis може читати або в який може записувати.
Параметр може представляти:
Один holding register або input register.
Один coil або discrete input.
Один біт усередині регістра.
Неперервний діапазон бітів усередині регістра.
Багаторегістрове значення (наприклад 32-бітний float на двох регістрах або 64-бітний integer на чотирьох).
Щоб додати параметр вручну, відкрийте сторінку пристрою й натисніть Додати параметр. Форма містить усі поля, описані нижче: назва, адреса, тип регістру, тип значення, прапорці поведінки, налаштування перетворення та необов’язкові значення переліку.
Щоб редагувати наявний параметр, клацніть його назву на сторінці пристрою, щоб відкрити налаштування параметра. З’являється та сама форма з попередньо заповненими поточними значеннями.
Якщо на пристрої багато параметрів, швидше використати шаблон пристрою, ніж додавати їх по одному.
Кожен параметр зберігає такі поля ідентифікації та організації:
Поле
Опис
Назва
Основна мітка для відображення (наприклад «Current Temperature», «Setpoint», «Operating Mode»).
Мнемоніка
Необов’язковий короткий код або абревіатура (до 20 символів), зазвичай з документації пристрою (наприклад «PV», «SV», «St»). Якщо задано, Overvis показує його перед назвою.
Опис
Необов’язковий пояснювальний текст.
Категорія
Групує параметри на сторінці пристрою (наприклад «Measurement», «Settings», «Diagnostics»). Категорії лише організаційні — вони не впливають на адресацію, опитування чи запис. Параметри без категорії з’являються під «Без категорії».
Одиниці
Мітка одиниці вимірювання для відображення (наприклад °C, кВт·год, В, А, %).
Кожен параметр відповідає місцю в карті пам’яті Modbus пристрою. Повну адресу задає комбінація:
Поле
Опис
Адреса пам’яті пристрою
Номер регістра Modbus (0–65535). У формі параметра позначено як Адреса пам’яті пристрою: (те саме поняття, що «адреса регістра» в друкованих інструкціях).
Для типів значень bit і bit-group: який біт у регістрі (0 = найменш значущий).
Довжина групи бітів
Для типу bit-group: скільки послідовних бітів охоплює значення. Позначено як Довжина групи бітів: у формі параметра.
Довжина рядка
Для рядкових типів: скільки регістрів займає рядок.
Та сама адреса пам’яті пристрою може законно з’являтися в кількох параметрах, коли параметри представляють різні подання тих самих даних — наприклад, числове значення всього регістра й один біт-прапорець у тому самому регістрі або кілька незалежних біт-прапорців з одного статусного регістра.
Тип значення визначає, як інтерпретуються сирі дані регістра. Від цього залежать двійковий формат, порядок байтів і кількість регістрів, які займає параметр.
Overvis підтримує широкий діапазон типів значень:
Категорія
Типи значень
Регістри
8-bit integers
Unsigned Byte, Signed Byte
1
16-bit integers
Unsigned/Signed Short (big-endian and byte-swapped variants)
1
32-bit integers
Unsigned/Signed Int (big-endian, byte-swapped, and word-swapped variants)
2
64-bit integers
Unsigned/Signed Long (big-endian, byte-swapped, and word-swapped variants)
Byte String (2 символи ASCII на регістр) або Word String (1 символ ASCII на регістр)
Змінна
IP address
IPv4-адреса в порядку байтів або слів
2
MAC address
MAC-адреса в порядку байтів або слів
3
Special
Unsigned 48-bit Int (3 регістри), Unsigned 3 Last Bytes in Words (3 регістри)
3
Порядок байтів має значення. Багато пристроїв зберігають багатобайтові значення в порядку big-endian (спочатку найстарший байт), але деякі використовують byte-swapped або word-swapped. Якщо значення читається як «сміття» або нереалістичне число, ймовірно неправильний порядок байтів — спробуйте інші варіанти для тієї самої ширини даних.
Три прапорці керують тим, як Overvis обробляє параметр операційно:
Відстежуваний — відстежуваний параметр бере участь у фоновому опитуванні та постійному зберіганні:
Overvis читає його періодично згідно з періодом оновлення батьківського пристрою.
Кожне зчитування зберігається в базі даних із часовою міткою.
Історичні дані доступні в графіках, звітах і на Огляді.
Невідстежуваний параметр лишається частиною моделі пристрою й може читатися на вимогу, але не опитується автоматично й його значення не зберігаються.
Програмований — програмований параметр можна записувати через Overvis. Непрограмовані параметри в інтерфейсі Overvis доступні лише для читання, незалежно від того, чи підтримує запис базовий регістр.
Відстежуваний і програмований — незалежні прапорці. Параметр може бути:
Лише відстежуваний — моніториться й зберігається, але не записується через Overvis.
Лише програмований — записується, але не опитується автоматично й не зберігається.
Обидва — опитується, зберігається й доступний для запису.
Жоден — існує в моделі пристрою лише для читання на вимогу.
Завжди читати та писати одним запитом — якщо увімкнено, Overvis тримає все багаторегістрове значення в одному запиті Modbus замість розбиття на окремі запити. Це важливо для параметрів більш ніж на одному регістрі (наприклад 32-бітні float, 64-бітні цілі, рядки), де часткові читання можуть дати некоректні значення, якщо пристрій не оновлює всі регістри одночасно.
Після зчитування сирого значення з пристрою Overvis може перетворити його для відображення за трьома налаштуваннями рівня параметра:
Налаштування
Опис
Мультиплікатор
Масштабує сире значення. Застосовується як множення.
Зсув
Додає фіксоване зміщення після масштабування.
Точність відображення
Керує кількістю десяткових цифр у відформатованому значенні.
Формула перетворення:
відображуване значення = сире значення × мультиплікатор + зсув
Наприклад, якщо датчик температури зберігає значення в десятих градуса (сире значення 235 означає 23,5 °C), установіть мультиплікатор у 0.1, щоб перевести в градуси. Якщо пристрій зберігає значення з фіксованим зміщенням, використовуйте зсув для компенсації.
Overvis зберігає в базі сирі значення регістрів і застосовує перетворення під час відображення. Тож мультиплікатор і зсув впливають на вигляд усіх зчитувань — і старих, і нових. Зміна мультиплікатора ретроспективно змінює вигляд старих даних у графіках і звітах. Точність відображення впливає лише на форматування, не на збережене значення.
Якщо мультиплікатор і зсув не задані, Overvis вважає значення немасштабованим: відображуване значення дорівнює сирому значенню регістра (еквівалент мультиплікатора 1 і зсуву 0).
Enumeration — тип значення для параметрів, де числовий регістр кодує дискретний стан або режим — наприклад стан машини, режим роботи або тип тривоги. На рівні Modbus це працює як будь-який інший числовий параметр, але Overvis зіставляє сирі значення з людинозрозумілими підписами за допомогою таблиці пошуку.
Кожен рядок таблиці переліку містить:
Поле
Опис
Значення
Сире числове значення з пристрою.
Відображати як
Мітка для відображення в інтерфейсі (наприклад «Running», «Standby», «Error»).
Опис
Необов’язковий пояснювальний текст для цього стану.
Наприклад, для параметра «Operating Mode» зіставлення може бути таким:
Значення
Відображати як
0
Standby
1
Heating
2
Cooling
3
Error
Під час читання Overvis показує «Heating» замість 1. Під час запису програмованого параметра переліку користувач обирає зі списку визначених підписів, а Overvis записує відповідне числове значення на пристрій.
Таблиці переліку можна спільно використовувати для кількох параметрів — це корисно, коли кілька параметрів на різних пристроях мають той самий набір станів.
Параметри можуть необов’язково визначати мінімум та максимум значення. Це інформаційні межі — вони допомагають обмежувати введення при записі в інтерфейсі й дають контекст очікуваних діапазонів. Вони не впливають на те, як значення читаються з пристрою.
Зазвичай це означає, що тип значення або порядок байтів не відповідає тому, що пристрій фактично надсилає. Наприклад, читання 32-бітного float як 16-бітного беззнакового цілого або використання big-endian, коли пристрій використовує word-swapped.
Як виправити:
Відкрийте налаштування параметра й перевірте тип значення. Переконайтеся, що він відповідає документації пристрою для цього регістра.
Якщо ширина даних правильна, але значення все одно виглядає некоректно, спробуйте інші варіанти порядку байтів для тієї самої ширини (наприклад перейдіть з «Float big-endian» на «Float word-swapped» або «Float byte-swapped»).
Перевірте адресу пам’яті пристрою — деякі керівництва використовують нумерацію з 1, тоді як Overvis — з 0. Якщо в керівництві вказано регістр 40001, адреса в Overvis типово 0 (holding register).
Якщо налаштовані мультиплікатор або зсув, переконайтеся, що формула перетворення дає змістовні результати.
Пристрій не відповідає на запити Modbus у межах тайм-ауту.
Поширені причини та виправлення:
Неправильний Modbus ID — переконайтеся, що Modbus ID у Overvis збігається з адресою на фізичному пристрої. Перевірте DIP-перемикачі, передню панель або ПЗ конфігурації.
Пристрій без живлення або не підключений — переконайтеся, що пристрій увімкнений і підключений до шини RS-485, з’єднаної з контролером шлюзу.
Дубльовані Modbus ID — два фізичні пристрої на одній шині RS-485 з однаковою адресою Modbus заважатимуть одне одному й спричинятимуть переривчасті збої або пошкоджені відповіді.
Значення «---» означає, що Overvis не має збереженого зчитування для цього параметра. Це нормально для невідстежуваних параметрів, які жодного разу не читали вручну.
Як виправити:
Клацніть по полю значення, щоб виконати зчитування на вимогу з пристрою. Якщо пристрій онлайн і адреса параметра коректна, з’явиться поточне значення.
Якщо потрібні історичні дані для цього параметра, увімкніть прапорець відстежуваний у налаштуваннях параметра.
Якщо зчитування на вимогу не вдається, пристрій може бути недоступним — див. розділ Пристрій недоступний.
Коли Overvis не може записати значення в параметр, поширені причини:
Параметр не програмований — запис дозволено лише для параметрів із увімкненим прапорцем програмований. Увімкніть його в налаштуваннях параметра.
Неправильна функція запису — деякі пристрої приймають лише код функції 06 (запис одного регістра) або лише 16 (запис кількох регістрів), але не обидва. Змініть функцію запису Modbus в налаштуваннях пристрою з «Normal» на конкретну функцію, яку очікує пристрій.
Регістр лише для читання — базовий тип регістра Modbus (наприклад input register, discrete input) не підтримує запис. Перевірте документацію пристрою.
Значення поза діапазоном пристрою — пристрій може відхиляти значення поза своїми внутрішніми межами навіть якщо параметр у Overvis їх дозволяє.
Відсутній пароль доступу на контролер — деякі контролери вимагають пароль доступу на запис. Перевірте паролі доступу на контролері в налаштуваннях мережі.
Якщо відстежувані параметри оновлюються рідше за налаштований період оновлення:
Кілька пристроїв на одному контролері — усі пристрої мережі використовують те саме підключення. Якщо в одній мережі багато пристроїв із багатьма параметрами, опитування всіх займає час. Фактичний цикл може перевищувати період оновлення.
Занадто малий розмір групи читання — розмір групи читання 1 означає, що кожен параметр читається окремо, тобто потрібен один запит Modbus на параметр. Збільшення розміру групи читання (у межах 1–16 у формі налаштувань пристрою або до 255, де це дозволено) об’єднує послідовні регістри в менше запитів і прискорює опитування.
Занадто багато одночасних запитів на повільному контролері — багато контролерів RS-485 обробляють запити послідовно. Занадто висока кількість одночасних запитів може спричинити тайм-аути черги під час очікування, повторні спроби й подальше уповільнення циклу.
Часті повторні спроби — якщо деякі пристрої на шині недоступні або переривчасто відмовляють, Overvis витрачає час на повторні спроби перед переходом далі. Кожна спроба чекає тайм-аут, перш ніж вважається невдалою.
На сторінці пристрою можна масово змінювати прапорці поведінки. Позначте потрібні параметри прапорцями й скористайтеся кнопками під списком параметрів, щоб позначити їх як відстежувані або невідстежувані. Відстежування можна змінити й в індивідуальних налаштуваннях параметра.
Увімкнення відстежування запускає фонове опитування й зберігання даних для цього параметра. Вимкнення зупиняє опитування й зберігання, але наявні історичні дані зберігаються.
Чи можна використовувати ту саму адресу пам’яті пристрою для кількох параметрів?
Так. Це типова ситуація, коли один регістр містить кілька незалежних біт-прапорців — можна створити окремі параметри типу bit для кожного прапорця з однаковою адресою пам’яті пристрою, але різною позицією біта. Аналогічно можна мати один параметр, що читає весь регістр як число, і інший — один біт статусу з нього.
Що відбувається з історичними даними при зміні налаштувань параметра?
Зміна типу значення, мультиплікатора або зсуву ретроспективно змінює вигляд усіх збережених зчитувань — див. Перетворення значення. Зміна адреси пам’яті пристрою або типу регістра змушує параметр надалі читати з іншого місця; старі дані все ще показують значення з попередньої адреси.
Мережі, пристрої та параметри — основа інших функцій Overvis:
Огляд — відстежувані параметри можна закріпити на панелі моніторингу організації для швидкого огляду. Панель моніторингу групує відображення за мережею та пристроєм.
Сповіщення — порогові сповіщення та сповіщення про недоступність налаштовуються на окремих параметрах або пристроях. Стан сповіщень показано на сторінці пристрою та панелі моніторингу.
Візуалізації — настроювані інтерактивні панелі, що читають значення параметрів у реальному часі.
Звіти HACCP — звіти відповідності вимогам безпеки харчових продуктів на основі відстежуваних температурних параметрів.
Шаблони пристроїв — багаторазові конфігурації параметрів для швидкого налаштування пристроїв.
Overvis Cloud Documentation
Огляд
Огляд — це сторінка загального перегляду на рівні організації в Overvis Cloud. На одному екрані зібрано найважливіші параметри з усіх ваших мереж і пристроїв: можна відстежувати актуальні значення, перевіряти стан підключення, бачити активні сповіщення й записувати значення в програмовані параметри — без переходів на окремі сторінки пристроїв.
На панелі моніторингу є два типи вмісту:
Віджети параметрів — окремі параметри, які ви додали на панель моніторингу. Вони автоматично групуються за мережею та пристроєм.
Візуалізації — настроювані інтерактивні віджети, які відображаються на панелі моніторингу. Вони показуються над віджетами параметрів. Докладніше див. Візуалізації.
Набір віджетів параметрів спільний для організації — усі користувачі однієї організації бачать на панелі моніторингу ті самі параметри. Персональних макетів, довільного розташування чи кількох панелей моніторингу на організацію немає.
Повнофункціональна панель для операторів і адміністраторів. Підтримує додавання/видалення віджетів параметрів, запис значень у програмовані параметри та перехід до налаштувань мереж і пристроїв.
Моніторинг
/view/
Панель лише для читання — для екранів відображення та користувачів з правом лише перегляду. Показує ті самі дані й макет, але приховує елементи керування (додавання/видалення, запис).
Обидва режими показують той самий загальноорганізаційний набір віджетів параметрів і візуалізацій. Користувачі без прав керування, які відкривають панель у режимі керування, автоматично перенаправляються на панель моніторингу.
На панелі моніторингу є два варіанти макета — перемикаються кнопками Віджетний вигляд / Табличний вигляд у верхній частині сторінки. Вибраний вигляд зберігається в браузері.
Якщо на панелі моніторингу більше трьох пристроїв (за всіма мережами), поруч із перемикачем вигляду з’являються кнопки Згорнути все / Розгорнути все, щоб одночасно розгорнути або згорнути всі панелі мереж і пристроїв.
«Невідомий пристрій» — пристрій не ідентифіковано.
Індикатори сповіщень і подій для цього пристрою.
Посилання Звіт за накопиченими даними, що відкриває звіт зчитувань для всіх віджетів параметрів, показаних для цього пристрою.
Віджети параметрів — у кожній панелі пристрою кожен параметр показує:
Назву параметра.
Останнє відформатоване значення (з одиницями) або «–», якщо зчитування недоступне або пристрій заблокований.
Час останнього зчитування.
Візуальний стан залежно від активних сповіщень — звичайний (типово), стиль попередження або критичний.
Розгортання віджета параметра. Клацання по віджету параметра розгортає його й показує:
Мінімальне та максимальне значення за останні 24 години.
24-годинний графік історії з останнім днем зчитувань з інтервалом 15 хвилин.
Посилання Повна історія на повний звіт зчитувань для цього параметра.
Розділ зчитувань у реальному часі, який опитує живі значення з пристрою щосекунди, доки віджет розгорнуто. Значення показані як компактна стовпчикова діаграма, що заповнюється зчитуваннями з часом.
Зчитування в реальному часі працює лише поки віджет параметра розгорнуто. Згортання віджета зупиняє опитування. Якщо пристрій заблокований, у розділі реального часу показується «Пристрій заблокований» замість живих значень.
Запис значень. У режимі керування клацання по значенню програмованого параметра відкриває діалог запису, де можна ввести нове числове значення й надіслати його на пристрій. Програмовані параметри позначені пунктирним підкресленням і іконкою пера на значенні. Клацання по значенню відкриває модальне вікно запису; клацання в іншому місці віджета розгортає/згортає його.
Табличний вигляд показує ті самі віджети параметрів у компактній табличній формі. Замість вкладених панелей мереж і пристроїв пристрої перелічені пласкими рядками: кожен рядок підписано назвою мережі та назвою пристрою, розділеними » (той самий вигляд, що й в інтерфейсі).
Розгортання рядка пристрою показує таблицю зі стовпцями, описаними нижче. У інтерфейсі в рядку заголовка текстово лише Параметр; наступна комірка заголовка — лише іконка синхронізації; третя й четверта комірки заголовка без текстових підписів.
Стовпець
Вміст
Параметр
Назва параметра та індикатори сповіщень/подій.
Синхронізація
Перемикач для запуску/зупинки зчитування в реальному часі для цього параметра. Іконка обертається, поки активна.
Значення
Останнє відформатоване значення (живе значення, коли синхронізація активна).
Графік
Посилання на повну історію зчитувань для цього параметра.
Іконка синхронізації в рядку заголовка пристрою вмикає зчитування в реальному часі для всіх показаних параметрів цього пристрою одразу.
Табличний вигляд не надає елементів запису чи видалення. Використовуйте його для екранів моніторингу, коли потрібно бачити багато параметрів одразу.
У кожній панелі пристрою у віджетному вигляді є кнопка Додати відображення параметра (видима лише в режимі керування). Клацання відкриває модальне вікно зі списком відстежуваних параметрів пристрою, згрупованих за категоріями. Параметри, які вже на панелі моніторингу, зі списку виключені.
Цей спосіб пропонує лише параметри, уже позначені як відстежувані. Якщо потрібного параметра немає в списку, додайте його зі сторінки пристрою (див. нижче).
На сторінці деталей пристрою виберіть один або кілька параметрів прапорцями та натисніть Додати до огляду.
Цей спосіб гнучкіший:
Можна додати кілька параметрів одразу.
Якщо вибраний параметр ще не відстежуваний, Overvis автоматично позначає його як відстежуваний перед додаванням (відображення на панелі моніторингу потребує періодичних зчитувань).
У режимі керування у віджетному вигляді кожен віджет параметра має кнопку видалення (іконка кошика), щоб відкріпити його з панелі моніторингу. Видалення віджета параметра не видаляє сам параметр чи його історичні дані — лише прибирає з вигляду панелі моніторингу.
Якщо параметр видалено з конфігурації пристрою, його віджет на панелі моніторингу зникає автоматично.
Поле пошуку у верхній частині панелі моніторингу фільтрує за назвою мережі та назвою пристрою. Назви параметрів до пошуку не входять.
Якщо ввести кілька слів, Overvis знаходить пристрої, у яких об’єднана назва мережі та пристрою містить усі слова в будь-якому порядку. Наприклад, запит «склад температура» знаходить пристрій «Контролер температури» в мережі «Склад».
Панель моніторингу підтримує актуальність даних через автоматичні оновлення:
Повна структура (список мереж, список пристроїв, віджети параметрів) завантажується один раз під час відкриття сторінки.
Значення та стан (зчитування параметрів, стан підключення, час зчитування пристроїв, стан сповіщень) оновлюються кожні 10 секунд для розгорнутих мереж і пристроїв. Згорнуті панелі не опитуються — їхні значення оновлюються після розгортання.
Зчитування в реальному часі для окремо розгорнутих віджетів параметрів опитується кожну 1 секунду, доки вони розгорнуті.
Вимкнені мережі та пристрої лишаються видимими на панелі моніторингу, але їхня поведінка змінюється:
Для вимкнених пристроїв показується статус «Пристрій заблокований» замість часу наступного зчитування.
Значення параметрів показують «–» і не оновлюються (зчитування й запис не виконуються).
Діалог запису недоступний для параметрів на вимкнених пристроях.
Зчитування в реальному часі показує «Пристрій заблокований» замість живих значень.
Вимкнення не прибирає віджети параметрів з панелі моніторингу. Після повторного ввімкнення мережі або пристрою звичайне опитування й оновлення відображення відновлюються. Докладніше про вимкнення див. Мережі, пристрої та параметри — Вимкнення.
Якщо параметр не з’являється після додавання, перезавантажте сторінку — панель моніторингу завантажує повну структуру один раз під час завантаження сторінки й може не відображати зміни, зроблені в іншій вкладці. Якщо параметр досі не з’являється, переконайтеся, що він належить пристрою поточної організації й параметр не видалено.
Параметр ще жодного разу не читався — якщо на пристрої показано «Немає зчитувань.», дочекайтеся наступного циклу фонового зчитування або запустіть ручне зчитування зі сторінки пристрою.
Якщо значення оновлюються на сторінці пристрою, але не на панелі моніторингу, розгорніть панелі мережі та пристрою — згорнуті панелі не опитуються для нових значень.
Пошук враховує лише назви мереж та назви пристроїв — назви параметрів не враховуються. Якщо ви шукаєте параметр за назвою, знайдіть його за назвою пристрою або мережі.
Кілька слів збігаються незалежно: усі слова мають з’явитися десь у поєднаній назві мережі та пристрою (в будь-якому порядку).
Зчитування в реальному часі потребує розгортання (клацання) окремого віджета параметра. Якщо ви розгорнули віджет і досі не бачите значень у реальному часі:
Пристрій може бути заблокований або недоступним — перевірте стан пристрою.
Мережа може бути від’єднана — перевірте іконку стану підключення в заголовку мережі.
У табличному вигляді використовуйте іконку перемикача синхронізації, щоб запустити зчитування в реальному часі для окремих параметрів або всіх параметрів пристрою.
Ні. У кожної організації одна панель моніторингу з одним спільним набором віджетів параметрів. Усі користувачі організації бачать ті самі параметри. Макет панелі моніторингу (групування за мережею та пристроєм) автоматичний і його не можна переставити.
Чому розгорнуті панелі скидаються після перезавантаження сторінки?
Стан розгортання/згортання панелей мереж і пристроїв зберігається в локальному сховищі браузера — зберігається між перезавантаженнями. Натомість розгорнуті віджети параметрів (для зчитувань у реальному часі) та пошукові запити за задумом скидаються під час перезавантаження.
Якщо стан панелей втрачено, можливо, ви очистили дані браузера або використовуєте інший браузер чи пристрій.
Розгорніть віджет параметра у віджетному вигляді, щоб побачити 24-годинний міні-графік (спарклайн). Натисніть посилання Повна історія під графіком, щоб відкрити детальний звіт зчитувань. У табличному вигляді використовуйте іконку графіка в останньому стовпці для переходу безпосередньо до звіту зчитувань.
У чому різниця між віджетним і табличним виглядом?
Віджетний вигляд показує параметри як інтерактивні картки з міні-графіками (спарклайнами), зчитуваннями в реальному часі, елементами запису та можливістю додавати/видаляти параметри. Найкраще для активного моніторингу та керування.
Табличний вигляд показує параметри в компактній таблиці з перемикачами синхронізації для значень у реальному часі. Немає запису чи додавання/видалення. Найкраще для екранів моніторингу й ситуацій, коли потрібно бачити багато параметрів одразу.
Чому на панелі моніторингу показуються застарілі значення для деяких пристроїв?
Панель моніторингу оновлює значення лише для розгорнутих панелей мереж і пристроїв. Якщо панель мережі або пристрою згорнута, значення її параметрів не опитуються, доки ви її не розгорнете. Розгорніть панель, щоб побачити останні значення.
Як додати параметр, якого немає в модальному вікні «Додати відображення параметра»?
Модальне вікно «Додати відображення параметра» на панелі моніторингу показує лише параметри, уже відстежувані (увімкнено автоматичні періодичні зчитування). Якщо потрібного параметра немає в списку:
Перейдіть на сторінку пристрою.
Виберіть параметр прапорцем.
Натисніть Додати до огляду.
Overvis автоматично увімкне відстежування для параметра й додасть його на панель моніторингу.
Overvis Cloud Documentation
Шаблони пристроїв
Для кожного пристрою Modbus потрібен набір параметрів, перш ніж Overvis зможе зчитувати з нього дані — адреси регістрів, типи значень, назви, одиниці, прапорці відстеження тощо. Налаштовувати це вручну для лічильника на 50 регістрів трудомістко; для двадцяти однакових лічильників — непрактично.
Шаблони пристроїв саме це й вирішують. Шаблон — це збережена багаторазова конфігурація параметрів для конкретної моделі пристрою. Виберіть шаблон під час створення пристрою (або застосуйте пізніше), і Overvis автоматично налаштує всі параметри, віджети панелі моніторингу, візуалізації та сповіщення.
Налаштування рівня пристрою — метадані й налаштування зв’язку за замовчуванням:
Name, manufacturer і version — ідентифікують шаблон (наприклад PAC3200, Siemens, 1.0). Шаблон унікально ідентифікується в межах своєї області (глобальної або організації) комбінацією name, manufacturer і version.
Category — довільне текстове групування (наприклад Temperature controller, Energy meter).
Read group size — скільки послідовних регістрів об’єднати в один запит Modbus на читання (1–255, типово 1).
Write function — який код функції запису Modbus використовувати: normal (автовибір за кількістю регістрів), always-6 (завжди код 06 — Write Single Register) або always-16 (завжди код 16 — Write Multiple Registers).
Description — необов’язкові примітки про пристрій або шаблон.
Визначення параметрів — по одному запису на кожен регістр або біт, який надає пристрій:
Name — зрозуміла назва (наприклад Supply temperature).
Address — номер регістра Modbus (0–65535).
Register kind — holding, input, coil або discrete-input.
Value type — як інтерпретувати сирі дані регістра. Overvis підтримує широкий діапазон типів: знакові та беззнакові цілі різної ширини (8/16/32/48/64 біт), числа з плаваючою комою (32 і 64 біт), BCD, витяг бітів і груп бітів, рядки, IP-адреси, MAC-адреси та значення переліку. Багаторегістрові типи можуть використовувати big-endian, byte-swapped або word-swapped порядок байтів. Регістри coil і discrete-input мають використовувати тип значення bit.
Units — одиниці вимірювання (°C, кВт, бар тощо).
Category та label — для групування й короткого позначення в інтерфейсі.
Multiplier та shift — лінійне масштабування сирого значення: displayed = raw × multiplier + shift. Недоступно для типів bit, string, IP address і MAC address.
Decimal precision — кількість десяткових знаків для відображення (0–20).
Bit position (0–15) та bits amount (1–16) — для типів значень bit і bits: які біти в регістрі витягувати.
String length — для типів byte-str і word-str: кількість символів (1–255).
Is tracked — чи зберігає Overvis історичні зчитування для цього параметра.
Is programmable — чи можна записувати значення параметра з інтерфейсу.
Read as group — чи включати цей параметр у групові читання.
Auto-add widget — чи створювати віджет панелі моніторингу для цього параметра під час застосування шаблону.
Enumeration mappings — для параметрів типу enum таблиця відповідності числових значень людинозрозумілому тексту (наприклад 0 → Off, 1 → On, 2 → Error).
Min/max values — очікуваний діапазон значень для перевірки та відображення.
Необов’язкові додатки:
Шаблони сповіщень — попередньо задані сповіщення у форматі YAML. Після застосування шаблону Overvis може створити сповіщення автоматично (наприклад «надіслати лист, коли температура перевищить 80°C»). Див. Довідник шаблонів сповіщень щодо синтаксису YAML.
Візуалізація пристрою — вбудовувана візуалізація (HTML/JS), яка додається до сторінки пристрою.
Переклади — назви параметрів, описи, категорії, одиниці та підписи переліку кількома мовами (англійська, українська, польська, російська).
Overvis підтримує глобальні шаблони; вони доступні всім користувачам. Вони охоплюють поширені промислові пристрої — контролери, лічильники енергії, ПЛК, датчики та шлюзи. Редагувати глобальні шаблони не можна, але їх можна клонувати до своєї організації для налаштування.
Шаблони організації належать конкретній організації. Їх бачать лише учасники цієї організації. Такі шаблони можна вільно створювати, редагувати, клонувати, видаляти та експортувати.
У веб-інтерфейсі Overvis перейдіть до Шаблони в лівій боковій панелі:
Ваші шаблони показує шаблони, що належать поточній організації.
Глобальні шаблони показує спільну бібліотеку.
У обох виглядах відображаються назва шаблону, виробник, версія та кількість параметрів (відстежувані та програмовані). Натисніть шаблон, щоб побачити повний список параметрів і налаштування.
Ваші шаблони перелічує шаблони, якими володіє ваша організація або які ви клонували:
Глобальні шаблони перелічує спільну бібліотеку, яку підтримує Overvis:
Якщо глобальний шаблон близький до потрібного, але потребує змін — інше масштабування, додаткові параметри, скориговані сповіщення — клонуйте його:
Відкрийте глобальний шаблон.
Натисніть Копіювати шаблон.
Клон з’являється у шаблонах вашої організації з тими самими параметрами, готовий до редагування.
Якщо шаблон з такою самою назвою вже існує, клон створюється з числовим суфіксом (наприклад PAC3200 (1)). Таблиці відповідності переліку та переклади повністю копіюються в клон.
Якщо ви вже налаштували пристрій вручну — задали всі параметри, одиниці, прапорці відстеження тощо — можна зберегти цю конфігурацію як шаблон:
Відкрийте сторінку пристрою.
Натисніть Зберегти як шаблон.
Введіть назву шаблону (обов’язково). Форма запитує лише назву; Overvis копіює всі параметри, налаштування регістрів, відображення переліку, read group size, write function і метадані пристрою в новий шаблон.
Натисніть Створити шаблон.
Новий шаблон з’являється в бібліотеці вашої організації з тими самими параметрами, налаштуваннями регістрів і відображеннями переліку, що й пристрій. Назву, виробника, версію, категорію й опис можна змінити пізніше на сторінці налаштувань шаблону.
Для нових моделей пристроїв або коли потрібен повний контроль над кожним полем створіть шаблон як файл Excel .xlsx і імпортуйте його.
Перейдіть до Ваші шаблони.
Натисніть Завантажити шаблон.
Завантажте файл .xlsx.
Overvis перевіряє структуру файлу та вміст. Якщо є помилки, вони показуються з назвою аркуша, рядком і посиланням на комірку.
У разі успіху шаблон додається до бібліотеки вашої організації.
Якщо в організації вже є шаблон з тією самою назвою, версією та виробником, імпорт замінює його — старий шаблон видаляється, новий займає його місце.
Файл Excel має містити аркуш Info та аркуш Params. Необов’язкові аркуші: Visualization (вихідний код візуалізації пристрою) та Alerts (YAML шаблону сповіщень). Інші назви аркушів заборонені. Повну специфікацію див. у Довіднику шаблонів пристроїв.
Після створення або клонування шаблону можна редагувати його метадані (name, manufacturer, version, category і description) на сторінці налаштувань шаблону. На сторінці налаштувань також є поле Шаблон сповіщень у форматі YAML:, де можна додавати або редагувати визначення сповіщень без повторного імпорту Excel.
Щоб змінити окремі визначення параметрів, експортуйте шаблон у Excel, внесіть зміни в таблицю та імпортуйте знову.
Будь-який шаблон — глобальний або організації — можна експортувати як файл .xlsx. Експортований файл має ту саму структуру, що й формат імпорту, тож можна виконати цикл: експорт → редагування в таблиці → повторний імпорт.
Під час додавання пристрою до мережі виберіть шаблон у списку. Пристрій буде створено з усіма заздалегідь налаштованими параметрами шаблону. Overvis записує, який шаблон використано, тож на сторінці пристрою видно початковий шаблон.
Під час застосування шаблону ви керуєте кількома налаштуваннями:
Параметри:
Параметри шаблону зіставляються з наявними параметрами пристрою за композитним ключем register address, register kind, bit position та bits amount. Якщо відповідний параметр на пристрої вже є, він оновлюється на місці. Якщо ні — створюється новий параметр.
Видалити параметри пристрою, які відсутні в шаблоні — за бажанням видалити параметри пристрою, для яких немає відповідника в шаблоні. Корисно при заміні одного шаблону іншим.
Сповіщення:
Додати сповіщення із шаблону — основний прапорець (типово ввімкнено). Якщо позначено, Overvis створює сповіщення з YAML шаблону. Два додаткові вкладені прапорці діють лише коли основний увімкнено:
Замінити наявні сповіщення, представлені в шаблоні — видалити наявні сповіщення, що збігаються з визначенням у шаблоні, потім додати сповіщення з шаблону (чисте повторне застосування для цих визначень).
Видалити сповіщення, пов’язані з цим пристроєм, які відсутні в шаблоні — видалити наявні сповіщення, яких немає в шаблоні.
Якщо позначено лише Додати сповіщення із шаблону, сповіщення шаблону додаються поряд із наявними.
Якщо ввімкнено лише перший вкладений прапорець, застосовується додати й видалити представлені. Якщо лише другий — додати й видалити відсутні.
Якщо ввімкнено обидва вкладені прапорці, усі наявні сповіщення видаляються, потім додаються сповіщення з шаблону.
Зніміть Додати сповіщення із шаблону, щоб пропустити створення сповіщень (вкладені прапорці мають бути вимкнені).
Віджети панелі моніторингу:
Додати віджети із шаблону на панель моніторингу — основний прапорець (типово ввімкнено). Якщо позначено, Overvis створює віджети панелі моніторингу для параметрів із позначкою auto-add widget у шаблоні.
Додатковий вкладений прапорець Видалити віджети пристрою, які відсутні в шаблоні — прибирає віджети панелі моніторингу для параметрів, які не відповідають рядку шаблону з увімкненим auto-add widget (зокрема для параметрів без прив’язки до застосованого шаблону).
Зніміть Додати віджети із шаблону на панель моніторингу, щоб пропустити створення віджетів (вкладений прапорець має бути вимкнений).
Візуалізації:
Створити візуалізацію пристрою з шаблону — основний прапорець (типово ввімкнено). Якщо в шаблоні є візуалізація пристрою, вона додається до пристрою.
Вкладений прапорець Видалити наявні візуалізації пристрою (типово ввімкнено): коли обидва увімкнено, будь-яка наявна візуалізація замінюється версією з шаблону.
Якщо позначено лише Створити візуалізацію пристрою з шаблону, додається візуалізація з шаблону без видалення наявних.
Зніміть Створити візуалізацію пристрою з шаблону, щоб пропустити створення візуалізації (Видалити наявні візуалізації пристрою має бути вимкнено).
Після застосування Overvis оновлює конфігурацію пристрою на операторі зв’язку, тож опитування починається одразу з новими параметрами.
Натисніть будь-який шаблон, щоб побачити повні деталі: налаштування рівня пристрою, повний список параметрів з адресами, типами значень, прапорцями відстеження та відображеннями переліку.
Шаблони підтримують багатомовні назви параметрів, описи, категорії, одиниці та підписи переліку. Базова мова завжди англійська. Додаткові переклади (українська, польська, російська) можна включити в файл Excel або керувати ними в налаштуваннях шаблону.
Під час застосування шаблону ви вибираєте мову. Overvis підставляє переклади для цієї мови до назв параметрів та інших текстових полів. Якщо для поля немає перекладу, використовується англійське значення.
Деякі параметри пристрою представляють дискретні стани, а не безперервні значення — режими роботи, коди помилок, прапорці статусу. Шаблони обробляють їх типом значення enum.
Відображення переліку визначає, якому числовому значенню регістра відповідає який текст. Наприклад, регістр статусу може мати відображення 0 → Stopped, 1 → Running, 2 → Error, 3 → Maintenance.
Відображення переліку задаються для кожного параметра в шаблоні й можуть містити переклади. Після застосування шаблону з параметрами enum Overvis створює відображення автоматично, тож на панелі моніторингу та в поданнях параметрів показуються текстові мітки замість сирих чисел.
Під час імпорту шаблону з Excel Overvis перевіряє структуру файлу та кожне значення поля. Поширені причини помилок валідації:
Відсутні обов’язкові аркуші — файл має містити аркуші Info та Params. Будь-який аркуш з невідомою назвою спричиняє помилку.
Відсутні обов’язкові поля на аркуші Info — read group size і write function мають бути на аркуші Info.
Некоректний тип значення або тип регістра — переконайтеся, що стовпці Type та Register Kind містять точні значення з Довідника шаблонів пристроїв.
Некоректний тип значення для coil/discrete-input — регістри coil і discrete-input мають використовувати тип значення bit. Інші типи заборонені.
Multiplier і shift для несумісних типів — типи bit, string, IP address і MAC address не підтримують multiplier і shift. Установіть 1 і 0 (або залиште порожнім).
Поля бітів для небітових типів — bit position і bits amount слід задавати лише для типів значень bit і bits.
Перелік без відображень — параметри з типом значення enum мають містити принаймні одне відображення в стовпці Represent As.
Невідповідність перекладів переліку — якщо відображення переліку перекладені, кожна мова має мати однакову кількість відображень з тими самими числовими значеннями.
Повідомлення про помилку містить назву аркуша, номер рядка та посилання на комірку, щоб знайти проблему.
Параметри не оновлюються після застосування шаблону
Якщо застосування шаблону не оновлює наявні параметри, як очікувалося:
Зіставлення відбувається за адресою та типом регістра, а не за назвою параметра. Параметр шаблону оновлює наявний параметр пристрою лише коли збігаються адреса регістра, тип регістра, bit position і bits amount. Якщо вони відрізняються (наприклад, ви змінили адресу в шаблоні), старий параметр лишається й створюється новий.
Перевірте дублікати адрес — якщо на пристрої два параметри з однаковою адресою та типом регістра, поведінка зіставлення може бути неочікуваною. Приберіть дублікати перед застосуванням.
Перевірте синтаксис YAML сповіщень — некоректний YAML блокує створення сповіщень. Повну специфікацію див. у Довіднику шаблонів сповіщень.
Переконайтеся, що параметри існують — кожна умова сповіщення посилається на параметр за адресою та типом регістра. Якщо параметра, на який посилається умова, немає в шаблоні, сповіщення не створюється.
Перевірте опції застосування — переконайтеся, що в формі застосування увімкнено Додати сповіщення із шаблону (а також що YAML сповіщень і посилання на параметри коректні).
Перевірте наявність помилок — якщо на сторінці імпорту немає помилок, але шаблон не з’являється, спробуйте оновити сторінку.
Перевірте правильну організацію — шаблони обмежені поточною організацією. Переконайтеся, що переглядаєте шаблони потрібної організації.
Заміна за збігом назви — якщо шаблон з такою самою назвою, виробником і версією вже існував, його було замінено. Шаблон є, але старий вміст перезаписано.
Так. Шаблони можна застосовувати послідовно. Кожне застосування об’єднує або замінює параметри згідно з логікою зіставлення (адреса, тип регістра, bit position, bits amount). Щоб об’єднати параметри з двох шаблонів, застосуйте перший, потім другий без увімкнення Видалити параметри пристрою, які відсутні в шаблоні.
Що відбувається з наявними параметрами під час застосування шаблону?
Типово наявні параметри зберігаються. Параметри, що збігаються з параметром шаблону (за адресою, типом регістра, bit position і bits amount), оновлюються налаштуваннями шаблону. Параметри шаблону без відповідника додаються як нові. Увімкніть Видалити параметри пристрою, які відсутні в шаблоні, щоб видалити незіставлені параметри пристрою.
Масового повторного застосування немає. Щоб оновити всі пристрої, що використовують шаблон, імпортуйте оновлений шаблон, потім застосуйте його до кожного пристрою окремо. Використовуйте Видалити параметри пристрою, які відсутні в шаблоні, якщо потрібно, щоб кожен пристрій точно відповідав шаблону.
Ні, не напряму. Шаблони належать одній організації або глобальній бібліотеці. Щоб поділитися шаблоном, експортуйте його як .xlsx і імпортуйте в іншу організацію. Глобальна бібліотека спільна для всіх організацій, але змінювати її можуть лише суперкористувачі.
У чому різниця між глобальними шаблонами та шаблонами організації?
Overvis підтримує глобальні шаблони: вони доступні всім і лише для читання. Шаблони організації належать вашій організації, приватні для учасників і їх можна вільно редагувати. Клонуйте глобальний шаблон до своєї організації, якщо потрібні зміни.
Чи можна редагувати окремі параметри в шаблоні без повторного імпорту?
Ні. Веб-інтерфейс дозволяє редагувати лише метадані шаблону (name, manufacturer, version, category, description) та YAML сповіщень. Щоб змінити визначення параметрів, експортуйте шаблон у Excel, відредагуйте таблицю та імпортуйте знову.
Що буде, якщо видалити шаблон, з якого створювали пристрої?
Нічого не ламається. Пристрої зберігають параметри й працюють як раніше. Посилання пристрою на шаблон очищається, але параметри й налаштування не видаляються.
Overvis безперервно зчитує значення параметрів з ваших пристроїв. Сповіщення дозволяють задавати умови для цих зчитувань — і отримувати сповіщення електронною поштою, SMS або голосовим дзвінком, коли щось іде не так. Сповіщення також ведуть журнал кожного спрацьовування та завершення умов, даючи вам аудиторський слід інцидентів.
Умови — правила, які порівнюють поточні зчитування параметрів із пороговими значеннями. Наприклад: «температура вище 8°C» або «у параметра помилка зчитування».
Дії — повідомлення, які надсилаються, коли умови стають істинними. Ви обираєте канал (електронна пошта, SMS, голосовий дзвінок), одержувача та, за потреби, затримку.
Подальші дії — додаткові сповіщення для пізніших етапів інциденту: коли сповіщення підтверджено, коли воно завершилося само або коли ніхто не відповів протягом певного часу.
Overvis перевіряє умови автоматично після кожного циклу зчитування параметрів. Коли умови виконуються, сповіщення активується і починає виконувати дії. Коли умови більше не виконуються, сповіщення завершується автоматично.
Дайте сповіщенню змістовну назву (наприклад «Температура холодильної камери занадто висока»). Назва з’являється в повідомленнях і в журналі сповіщень, тому вона має бути одразу зрозумілою тому, хто отримує повідомлення. Довжина назви — до 200 символів.
Опис необов’язковий і може містити додатковий контекст.
Кожна умова відстежує один параметр пристрою і порівнює його значення з порогом.
Щоб додати умову, виберіть мережу, потім пристрій у цій мережі, потім параметр на цьому пристрої. Доступні лише відстежувані параметри — не відстежувані параметри не опитуються, тож немає з чим порівнювати.
Далі оберіть оператор порівняння і введіть порогове значення:
Оператор
Значення
Більше ніж
Значення > поріг
Більше або дорівнює
Значення ≥ поріг
Менше ніж
Значення < поріг
Менше або дорівнює
Значення ≤ поріг
Дорівнює
Значення = поріг
Не дорівнює
Значення ≠ поріг
Помилка зчитування
Параметр не вдалося зчитати (поріг не потрібен)
Поріг порівнюється з відображуваним значенням параметра — значенням після застосування множника з налаштувань параметра. Вводьте поріг у тих самих інженерних одиницях, що на сторінці пристрою (наприклад °C, кВт), а не в сирих значеннях регістрів.
«Помилка зчитування» — особлива умова: вона спрацьовує, коли параметр взагалі не вдається зчитати — наприклад, пристрій офлайн або адреса Modbus некоректна. Порогове значення не потрібне. Щоб уникнути хибних спрацьовувань під час запуску системи, умови помилки зчитування приглушуються приблизно на 2 хвилини після старту системи.
Логіка умов. Якщо в сповіщенні кілька умов, ви обираєте, як вони поєднуються:
Усі умови повинні бути виконані (AND) — сповіщення активується лише коли всі умови одночасно істинні.
При виконанні будь-якої з умов (OR) — сповіщення активується, коли істинна хоча б одна умова.
Дії визначають, що відбувається під час активації сповіщення. Кожна дія задає:
Канал: електронна пошта, SMS або голосовий дзвінок.
Одержувач: електронна адреса або номер телефону. Залиште порожнім, щоб використати типову адресу або телефон організації для сповіщень (у налаштуваннях організації). Якщо одержувач порожній і типове значення не задане, повідомлення пропускається.
Затримка: скільки чекати перед надсиланням повідомлення. Варіанти від «Негайно» до «Якщо не завершено протягом 2 год».
Затримка допомагає уникнути хибних тривог через короткі коливання. Якщо сповіщення завершиться до закінчення затримки, повідомлення не надсилається.
Подальші дії дозволяють ескалювати або сповіщати на пізніших етапах інциденту:
Етап
Значення
Коли подію завершено
Умови більше не виконуються, і сповіщення само деактивувалося. Використовуйте, щоб повідомити, що ситуація нормалізувалася.
Коли подію підтверджено
Хтось підтвердив сповіщення (див. Підтвердження сповіщень нижче). Використовуйте, щоб повідомити команду, що проблемою займаються.
Якщо не підтверджено і не завершено протягом…
Ніхто не підтвердив сповіщення за вказаний час. Використовуйте для ескалації — наприклад, зателефонуйте керівнику, якщо початковий SMS не підтверджено протягом 30 хвилин.
Для етапу «не підтверджено» ви обираєте тайм-аут (від 5 хвилин до 48 годин). Якщо сповіщення підтверджено або завершено до цього тайм-ауту, подальше повідомлення скасовується.
Кожна подальша дія задає канал (електронна пошта / SMS / голосовий дзвінок) і одержувача, як і дії.
flowchart LR
A["Неактивне<br/>(моніторинг)"] -->|"Умови<br/>виконані"| B["Активне<br/>(надіслано сповіщення)"]
B -->|"Користувач<br/>підтверджує"| C["Підтверджено"]
B -->|"Умови<br/>зняті"| D["Завершено"]
C -->|"Умови<br/>зняті"| D
D -.->|"Готово до<br/>наступного інциденту"| A
Неактивне — умови не виконуються. Сповіщення моніторить ситуацію, але ще не спрацювало.
Активно — одна або кілька умов стали істинними (залежно від логіки AND/OR). Overvis створює запис сповіщення в журналі й починає виконувати дії «Дія…». Генерується код підтвердження. Якщо налаштовано подальші дії «Якщо не підтверджено і не завершено протягом…», їхні таймери ескалації починають відлік.
Підтверджено — хтось підтвердив сповіщення через посилання в листі або відповідь SMS (див. нижче). Виконуються подальші дії «Коли подію підтверджено», а всі відкладені таймери ескалації скасовуються.
Завершено — умови більше не істинні. Overvis закриває запис сповіщення й виконує подальші дії «Коли подію завершено» (якщо було надіслано «початкове» повідомлення). Усі інші відкладені дії скасовуються. Сповіщення повертається в стан Неактивне і готове знову активуватися під час наступного інциденту.
Поки сповіщення Активно і не підтверджено, подальші дії ескалації («Якщо не підтверджено і не завершено протягом…») спрацьовують у налаштовані терміни. Це не окремий стан — сповіщення лишається активним, ескалація може повторюватися з різними тайм-аутами (наприклад SMS через 15 хвилин, голосовий дзвінок через 1 годину).
Щоразу, коли сповіщення активується, а згодом завершується, у журналі створюється окремий запис сповіщення. Одночасно може бути лише один активний (незавершений) запис.
Коли сповіщення спрацьовує, повідомлення містять спосіб підтвердити сповіщення:
Повідомлення електронною поштою містять посилання підтвердження. Перехід відкриває сторінку, що підтверджує сповіщення й показує деталі події.
SMS-повідомлення містять 5-значний код підтвердження. Відповідайте цим кодом на той самий номер для підтвердження.
Підтвердження виконує дві функції:
Запускає будь-які подальші дії «Коли подію підтверджено» (наприклад повідомлення команди, що проблемою займаються).
Скасовує всі відкладені дії ескалації «Якщо не підтверджено».
Після підтвердження сповіщення лишається активним, доки умови не зникнуть і воно не завершиться автоматично. Підтвердження не приглушує й не завершує сповіщення — лише сигналізує, що про проблему вже відомо.
Сторінка Сповіщення перелічує всі сповіщення поточної організації. Для кожного сповіщення видно:
назву сповіщення та опис;
іконку дзвіночка кольором за рівнем журналювання. Якщо сповіщення зараз активне, іконка підсвічена;
таблицю умов з мережею, пристроєм, параметром, умовою, останнім зчитаним значенням і часовою міткою зчитування для кожної умови. Спрацьовані умови виділені візуально;
підсумок дій з переліком налаштованих повідомлень.
З цієї сторінки доступні Налаштування, Журнал, Дублювати або Видалити для кожного сповіщення.
Журнал сповіщень фіксує кожну активацію та завершення сповіщення. Є два вигляди:
Журнал організації (Сповіщення → Журнал сповіщень у боковій панелі) — усі записи сповіщень усіх сповіщень, спочатку новіші.
Журнал одного сповіщення (відкрийте сповіщення → Журнал) — лише записи для одного сповіщення.
Кожен запис журналу показує:
Стовпець
Вміст
Дата
Коли сповіщення активувалося.
Назва події
Назва сповіщення з префіксом рівня журналювання (наприклад «Попередження: Температура холодильної камери занадто висока»).
Поточний статус
Активно, Підтверджено (дата) або Завершено (дата).
Можна розгорнути кожен запис, щоб побачити деталі з часовими мітками — хронологічний список подій інциденту (спрацьовані умови, надіслані повідомлення, підтвердження, завершення).
Технічні менеджери можуть очистити журнал для сповіщення — видаляючи завершені (закриті) записи старші за обраний період: 1 день, 1 тиждень, 1 місяць, 1 рік або всі завершені записи.
Якщо ви керуєте багатьма схожими пристроями, можна включати визначення сповіщень у шаблон пристрою. Після застосування шаблону до пристрою Overvis створює сповіщення автоматично — без повторного налаштування тих самих порогів і дій для кожного пристрою.
Шаблони сповіщень пишуться в YAML і додаються до шаблону пристрою через веб-інтерфейс або у файлі Excel шаблону. Див. Довідник шаблонів сповіщень щодо синтаксису YAML і прикладів.
Надіслані SMS (пункт бокової панелі в розділі «Сповіщення») показує запис усіх SMS і голосових викликів, надісланих системою сповіщень. Кожен запис містить:
дату й час надсилання повідомлення;
пов’язану назву сповіщення;
текст повідомлення;
номери телефонів відправника й одержувача;
чи це SMS, чи голосовий виклик;
вартість доставки.
Корисно для перевірки доставки повідомлень і обліку використання та вартості SMS і голосових викликів.
Параметр не відстежується. Лише відстежувані параметри опитуються для зчитувань. Якщо параметр не відстежується, Overvis не має значень для порівняння. Перейдіть на сторінку пристрою й переконайтеся, що для параметра увімкнено прапорець «Відстежувані». Див. Прапорці поведінки.
Пристрій або мережа вимкнені. Вимкнені пристрої та мережі не обробляють сповіщення. Переконайтеся, що й мережа, і пристрій увімкнені.
У параметра немає недавніх зчитувань. Якщо параметр ще жодного разу не зчитувався (наприклад пристрій ще не опитувався), умови неможливо оцінити. Перевірте стовпець «Останнє зчитування» на сторінці огляду сповіщень — якщо там «-», параметр ще не зчитувався.
Поріг у неправильних одиницях. Поріг порівнюється з відображуваним значенням (після множника). Якщо ввести сире значення регістра замість інженерного, умова може ніколи не спрацювати. Переконайтеся, що поріг у тих самих одиницях, що на сторінці пристрою.
Невідповідність логіки умов. Якщо кілька умов з «Усі умови повинні бути виконані» (AND), усі мають бути істинні одночасно. Перевірте, чи одна умова не блокує активацію сповіщення.
Не налаштовано типового одержувача. Якщо поле одержувача порожнє, Overvis використовує типову електронну адресу або телефон організації для сповіщень. Якщо нічого не налаштовано, повідомлення тихо пропускається. Задайте типових одержувачів у налаштуваннях організації або вкажіть одержувача явно в дії сповіщення.
Лист потрапляє в спам. Перевірте папку «Спам» або папку небажаної пошти. Додайте адресу відправника сповіщень Overvis до білого списку.
SMS вимкнено для організації. Якщо надсилання SMS вимкнено (наприклад через білінг), SMS і голосові повідомлення не доставляються. Перевірте, чи з’являється повідомлення про вимкнені SMS у верхній частині сторінки «Сповіщення».
Затримка ще не минула. Якщо налаштовано затримку (наприклад «Якщо не завершено протягом 30 хв»), повідомлення не надішлеться, доки не спливе період затримки. Якщо сповіщення завершиться раніше, повідомлення скасовується.
Використовуйте затримки дій. Задайте затримку на кшталт «Якщо не завершено протягом 5 хв» або довшу. Короткі коливання, що швидко зникають, не ініціюють повідомлення.
Підкоригуйте пороги. Якщо поріг занадто близький до нормального робочого діапазону, малі коливання спричинять сповіщення. Додайте запас на нормальні коливання.
Використовуйте логіку AND для кількох умов. Вимога виконання всіх умов одночасно зменшує хибні спрацьовування від окремих сплесків.
Повідомлення «Коли подію завершено» не надсилаються
Подальші дії «Коли подію завершено» надсилаються лише якщо хоча б одне повідомлення активації вже було надіслано або заплановано. Якщо сповіщення активувалося й завершилося надто швидко (до спрацювання будь-якої дії «Дія…»), повідомлення про завершення не надсилається. Це навмисно — щоб уникнути «сирітських» повідомлень про завершення для подій, надто коротких, щоб про них сповістити.
Посилання підтвердження в листі. Переконайтеся, що ви переходите за посиланням з оригінального повідомлення. Посилання прив’язані до конкретної події сповіщення — посилання з попередньої події не спрацює для нової.
SMS-код підтвердження. Відповідайте 5-значним кодом на той самий номер, з якого надіслано SMS. Код дійсний лише поки сповіщення активне й ще не підтверджено.
Сповіщення вже завершено. Якщо сповіщення завершилося до вашого підтвердження, сторінка підтвердження вкаже, що подію вже завершено. У цьому випадку підтвердження більше не потрібне.
Так. У кожної дії та подальшої дії своє поле одержувача. Можна налаштувати одне сповіщення на лист оператору та інше на SMS керівнику. В межах одного сповіщення можна додати кілька дій, щоб сповістити різних людей різними каналами.
Якщо пристрій недоступний, параметри матимуть помилки зчитування. Можна використати умову «Помилка зчитування», щоб отримувати сповіщення, коли пристрій перестає відповідати. Після запуску системи умови помилки зчитування приглушуються приблизно на 2 хвилини, щоб уникнути хибних тривог під час старту.
Чи можна тимчасово вимкнути сповіщення без видалення?
Кнопки «пауза» в налаштуваннях сповіщення немає. Щоб тимчасово зупинити спрацьовування, можна прибрати умови або дії й пізніше відновити їх, або встановити всі дії на «Нічого» (без повідомлення). Альтернативно, дублювання сповіщення перед редагуванням зберігає початкову конфігурацію для легкого відновлення.
Overvis обчислює умови сповіщень одразу після кожного зчитування параметра. Швидкість залежить від інтервалу опитування мережі — зазвичай від кількох секунд до хвилини. Додаткової затримки між зчитуванням параметра та перевіркою умов немає.
Дії («Дія…») спрацьовують під час першої активації сповіщення. Це початкові повідомлення. Можна додати затримку (наприклад «Якщо не завершено протягом 10 хв»), щоб відсіяти короткі події.
Подальші дії («Подальша дія…») спрацьовують на пізніших етапах: коли сповіщення завершується, коли його хтось підтвердив або коли ніхто не підтвердив у межах тайм-ауту. Використовуються для ескалації та відстеження завершення.
Чи впливає очищення журналу на активні сповіщення?
Ні. Очищення журналу видаляє лише завершені записи сповіщень старші за обраний період. Активні записи сповіщень і сама конфігурація сповіщення не змінюються.
Чи можна побачити, які повідомлення були надіслані?
Так. Розгорніть запис журналу сповіщення, щоб побачити детальну часову шкалу всіх повідомлень під час інциденту, з часовими мітками й одержувачами. Для деталей доставки SMS і голосових викликів відкрийте сторінку Надіслані SMS.
Звіт про значення параметрів — інтерактивний інструмент для дослідження історичних даних ваших відстежуваних параметрів. На одній сторінці поєднано графік часового ряду, таблицю даних і можливості експорту. Можна накладати кілька параметрів з різних пристроїв, наближати окремі часові інтервали й завантажувати сирі дані у форматі CSV або Excel.
Головне меню — перейдіть до Звіти > Історія читань. Звіт відкривається без вибраних параметрів; використайте дерево параметрів, щоб обрати, що показувати.
Сторінка пристрою — натисніть іконку графіка поруч із будь-яким відстежуваним параметром. Звіт відкривається з уже завантаженим цим параметром.
Сторінка параметра — натисніть посилання дії Зчитування в боковій панелі.
Режим моніторингу — той самий звіт доступний в інтерфейсі моніторингу лише для читання. Користувачів із доступом лише для перегляду сюди автоматично перенаправляють.
Коли ви відкриваєте звіт зі сторінки пристрою або параметра, URL містить paramIds=..., тож графік одразу завантажується з даними для цих параметрів.
Дерево параметрів у верхній частині сторінки показує ієрархію організації: мережі, пристрої та їхні параметри. У дереві з’являються лише відстежувані параметри (з увімкненим записом історії).
Розгорніть вузли дерева, щоб знайти параметри для аналізу.
Позначте параметри, які потрібно включити. Лічильник поруч із деревом показує, скільки параметрів зараз вибрано. Є налаштовуване обмеження на кількість параметрів, що відображаються одночасно (показано в повідомленні-підказці під деревом).
Натисніть Показати звіт, щоб завантажити дані.
Коли ви змінюєте вибір параметрів, часовий діапазон скидається на пресет Останні 24 години, якщо поточний пресет — Задати…. Якщо ж уже вибрано пресет, відмінний від Задати…, він зберігається. Графік і таблиця перезавантажуються з новим вибором.
Два поля дати й часу (YYYY-MM-DD HH:mm) дозволяють задати довільні від і до. Можна вводити значення безпосередньо в поля або скористатися спливаючим календарем. Натисніть Enter, щоб застосувати введене значення, або Escape, щоб скасувати.
Коли ви панорамуєте або масштабуєте графік (див. нижче), пресет автоматично перемикається на Задати…, а поля дати й часу оновлюються відповідно до нового діапазону.
Десяткова точність — випадаючий список (від 0 до 6 десяткових знаків) керує тим, як значення показуються на підписах осей графіка, у підказці, легенді та таблиці. Типово 2 десяткові знаки.
Розгорнути графік / Згорнути графік — перемикає графік між звичайною та подвійною висотою.
Графік показує значення параметрів у часі кольоровими лініями. Кожен вибраний параметр отримує власну лінію з окремим кольором (до 10 кольорів, далі цикл повторюється). Якщо пристрій був офлайн або опитування переривалося, на графіку з’являються розриви лінії там, де не було зчитувань.
Під час наведення курсора на графік з’являється підказка з часовою міткою та значенням кожного видимого параметра в цій точці. Найближча лінія виділена жирним. Коли видиме часове вікно коротше за 10 хвилин, у часових мітках показуються секунди.
Перетягування по горизонталі зсуває часове вікно вліво або вправо.
Утримуйте Shift і перетягуйте, щоб виділити прямокутну область і збільшити масштаб у ній.
Прокручуйте коліщатко миші над графіком, щоб збільшити або зменшити масштаб відносно положення курсора.
На сенсорних пристроях: перетягування одним пальцем для панорамування, щипок двома пальцями для масштабу.
Кнопки швидкого масштабу під графіком дозволяють перейти до фіксованої тривалості (10хв, 15хв, 30хв, 1год, 8год, 24год), що закінчується на правому краї поточного перегляду.
Кнопки кроку (< і >) зсувають вікно вліво або вправо на одну ширину вікна.
Уся навігація синхронно оновлює поля дати й часу та таблицю даних.
У кожному рядку легенди є вбудовані керування множником (×) і зсувом (+). Вони дозволяють візуально масштабувати окремі лінії, щоб порівнювати параметри з різними одиницями або порядками величин на одному графіку.
Множник — масштабує значення параметра. Введіть число й натисніть Enter для застосування (наприклад введіть 0.001, щоб перевести з мілівольт у вольти).
Зсув — зміщує значення параметра вгору або вниз.
нормалізувати — автоматично обчислює множник і зсув, щоб лінія вмістилася в поточний видимий діапазон осі Y.
скинути — повертає множник до 1 і зсув до 0. З’являється лише коли для лінії задано нетипові перетворення.
Перетворення лише візуальні — вони впливають лише на відображення графіка, не на таблицю даних і не на експорт.
Типово вісь Y показує шкалу, що охоплює всі видимі лінії. Клацання по лінії на графіку закріплює підписи осі Y за шкалою цього параметра (запис у легенді підсвічено). Повторне клацання або клацання по іншій лінії змінює прив’язку. Клацання поза будь-якою лінією (по тлу графіка) скасовує прив’язку й повертає автоматичне підганяння шкали.
Під графіком таблиця перелічує зчитування в межах поточного часового вікна.
Стовпці:
Стовпець
Вміст
Час
Часова мітка зчитування
Стовпці параметрів
По одному стовпцю на вибраний параметр: у заголовку назва пристрою, нижче — назва параметра
Зчитування різних параметрів, що відбулися в межах 60 секунд одне від одного, об’єднуються в один рядок. Під час панорамування або масштабування графіка таблиця оновлюється, показуючи лише рядки в межах видимого вікна.
Форма експорту з’являється під таблицею даних, коли вибрано параметри. Вона має власні поля вибору дати від/до (лише дата, без часу — експорт завжди охоплює повні дні), незалежні від діапазону перегляду графіка.
Задайте дати З і до для періоду експорту.
Оберіть формат: CSV або Excel (XLSX).
Натисніть Завантажити. Файл завантажується в новій вкладці браузера.
Експортований файл містить усі сирі зчитування (без дискретизації) для вибраних параметрів у межах обраного діапазону дат. Поля дат типово встановлені на останні 7 днів. Часові мітки в експортованому файлі використовують локальний часовий пояс вашого браузера.
Під час перегляду звіту з вибраними параметрами форма збереження з’являється в рядку поруч із панеллю дій дерева параметрів:
Введіть назву звіту (мінімум 3 символи).
Натисніть Зберегти звіт. Звіт зберігає поточний вибір параметрів і стан перегляду (десяткова точність, видимість ліній, перетворення множник/зсув і вибраний пресет).
Під час перегляду збереженого звіту форму збереження замінено формою оновлення (заголовок сторінки може містити Оновити збережений звіт). Можна змінити назву, вибір параметрів, перетворення ліній і натиснути Оновити звіт, щоб зберегти зміни.
Відкрийте Звіти > Історія читань, потім у розділі зчитувань використайте Збережені звіти, щоб відкрити список збережених звітів (це не окремий пункт на тому самому рівні меню, що й перші два). У списку показано назву кожного звіту та дату створення.
Для кожного збереженого звіту можна налаштувати автоматичну доставку даних зчитувань одержувачам електронної пошти:
Відкрийте налаштування розсилки збереженого звіту (іконка шестерні в списку збережених звітів).
Введіть адресу електронної пошти.
Оберіть період: Щоденно, Щотижня або Щомісяця.
Оберіть формат: Excel (XLSX) або CSV.
Натисніть Додати одержувача.
Можна додати кількох одержувачів з різними періодами та форматами. Кожна комбінація email–період–формат має бути унікальною для звіту.
Таблиця списку розсилки показує для кожного одержувача:
Стовпець
Вміст
Email
Адреса одержувача
Останнє відправлення
Дата, коли звіт востаннє надіслано цьому одержувачу
Помилка надсилання
Повідомлення про помилку, якщо остання спроба надсилання не вдалася
Наступне відправлення
Запланована дата наступної доставки звіту
Період
Щоденно, Щотижня або Щомісяця
Формат
XLSX або CSV
Автоматична розсилка надсилає дані за попередній період: щоденні листи містять попередній день, щотижневі — попередні 7 днів, щомісячні — попередній місяць. Часові мітки в розісланих звітах використовують UTC.
URL звіту зберігає повний стан перегляду в хеші URL, зокрема часовий діапазон, десяткову точність і налаштування видимості/перетворень для кожної лінії. Можна скопіювати URL з адресного рядка браузера й поділитися ним — будь-хто з доступом до організації побачить той самий перегляд.
Розриви позначають періоди, коли зчитування не записувалися. Зазвичай це буває, коли:
Пристрій був офлайн або шлюз втратив підключення до інтернету.
Опитування тимчасово переривалося (наприклад під час переналаштування мережі).
Параметр додали до відстеження після того, як для інших параметрів уже зібрали дані.
Для минулих розривів виправлення немає — вони відображають фактичну наявність даних. Щоб уникнути розривів надалі, забезпечте стабільне інтернет-з’єднання шлюзу й живлення пристрою.
У файлі експорту немає даних або менше рядків, ніж очікувалося
Якщо переглядаєте довгий діапазон (наприклад Останні 365 днів), майте на увазі: графік дискретизує до 1000 точок на параметр для швидкої роботи. Повні дані доступні через експорт.
Обмеження налаштовується окремо для кожного розгортання. Точне число показано в повідомленні-підказці під деревом параметрів, коли нічого не вибрано (те саме формулювання, що в застосунку, наприклад Будь ласка, виберіть до {} параметрів для відображення. — з підставленим лімітом, наприклад 10). Якщо потрібно порівняти більше параметрів, створіть кілька збережених звітів з різними наборами параметрів.
Ні. Графік показує до 1000 дискретизованих точок на параметр для видимого вікна. Ця дискретизація забезпечує швидку роботу графіка навіть на довгих інтервалах. Для повних сирих даних без дискретизації натисніть Завантажити на формі експорту — файл містить усі зчитування в межах обраного діапазону дат.
Так. Скопіюйте URL з адресного рядка браузера — він містить поточний часовий діапазон, десяткову точність і налаштування перетворень ліній у хеші URL. Будь-хто з доступом до тієї самої організації може відкрити посилання й побачити той самий перегляд. Потрібно бути в системі Overvis.
У чому різниця між даними на графіку та експортованими даними?
Графік і таблиця показують дискретизовані дані — до 1000 точок на параметр, розподілених по видимому часовому вікну. Цього достатньо для візуального аналізу, але це не повний набір даних.
Експорт даних (кнопка Завантажити) створює файл з усіма сирими зчитуваннями — кожним записаним значенням для вибраних параметрів у межах діапазону дат експорту. Використовуйте його, коли потрібні повні дані для зовнішнього аналізу або архівування.
Чому в деяких рядках таблиці немає значень для окремих параметрів?
Таблиця об’єднує зчитування різних параметрів, що відбулися в межах 60 секунд одне від одного, в один рядок. Якщо поблизу цієї мітки не було зчитування для параметра, у комірці показується риска (-). Це нормально, коли параметри мають різні інтервали опитування або частоти подання даних.
Що буде, якщо видалити збережений звіт із автоматичною розсилкою?
Видалення збереженого звіту також видаляє всі пов’язані записи розсилки. Одержувачі перестануть отримувати автоматичні звіти. Перед видаленням показується крок підтвердження.
Чи можна користуватися звітом в інтерфейсі моніторингу (лише перегляд)?
Так. Звіт доступний в інтерфейсі моніторингу за тим самим шаблоном URL. Користувачі з доступом лише перегляду можуть переглядати графіки, таблиці й користуватися експортом даних (кнопка Завантажити). Натомість збереження звітів і налаштування автоматичної розсилки потребують доступу рівня керування.
Overvis Cloud Documentation
Звіт про споживання ресурсів
Звіт про споживання ресурсів — це інструмент для аналізу накопичених даних лічильників і витратомірів. Він показує приріст споживання за вибрані часові періоди, розбиті на півгодинні, погодинні або денні сегменти.
Цей звіт допомагає аналізувати зчитування параметрів, які відображають безперервне накопичення ресурсу: лічильники електроенергії (кВт·год), водоміри (м³), газові лічильники та будь-які інші наростаючі значення. Якщо значення параметра з часом постійно зростає, цей звіт дозволяє аналізувати характер такого зростання.
Звіт ділить вибраний часовий інтервал на сегменти: по півгодини, по годинах або по днях. Для кожного сегмента він знаходить найбільше зчитування, зафіксоване всередині сегмента, і віднімає від нього останнє зчитування перед початком цього сегмента. Отримана різниця — дельта — показує, наскільки виріс лічильник за цей інтервал. Якщо для параметра налаштовано множник або зсув, вони застосовуються і до дельти (дельта × множник + зсув).
Звіти організовані як дерево. Головні гілки верхнього рівня формують окремі графіки. Гілки можуть містити дочірні вузли: інші гілки, окремі значення параметрів, формули або посилання на гілки з інших звітів. Значення гілки дорівнює сумі значень її дочірніх вузлів, тому ви можете групувати лічильники за відділом, будівлею або типом ресурсу і бачити як загальну суму, так і деталізацію.
Уявімо об’єкт із кількома відділами, кожен з яких має власні лічильники:
Відділ 1
Лічильник електроенергії 1 (E11) — кВт·год
Лічильник електроенергії 2 (E12) — кВт·год
Лічильник води 1 (W11) — м³
Відділ 2
Лічильник електроенергії 3 (E21) — кВт·год
Лічильник води 2 (W21) — м³
Звіт можна побудувати так:
Total Resources
├── Total Energy
│ ├── Department 1 Energy
│ │ ├── E11
│ │ └── E12
│ └── Department 2 Energy
│ └── E21
└── Total Water
├── Department 1 Water
│ └── W11
└── Department 2 Water
└── W21
З такою структурою звіт показуватиме загальне споживання електроенергії та води для всієї компанії з деталізацією за відділами й до окремих лічильників. Ви зможете порівнювати відділи між собою та бачити, який відділ або лічильник найбільше впливає на загальне споживання.
Сторінка перегляду звіту показує інтерактивні стовпчикові графіки — по одному для кожної головної гілки. Кожен стовпчик відповідає часовому сегменту, а його висота показує дельту споживання за цей період. Якщо налаштовані маркери рівня, на графіку вони відображаються як горизонтальні опорні лінії, а стовпчики змінюють колір при перевищенні порогу.
Легенда над графіками показує всі головні гілки у вигляді прапорців. Зніміть прапорець, щоб сховати відповідний графік. Випадаючий список угорі дозволяє перемикатися між звітами поточної організації.
Під графіками доступні три кнопки експорту: Експорт в Excel, Завантажити як PDF і Надіслати PDF на e-mail. До експорту потрапляють лише ті гілки, які зараз видимі (позначені в легенді).
Детальний звіт — прапорець поруч із кнопками експорту (його бачать лише менеджери). Якщо він увімкнений, експортований файл містить повну ієрархію гілок, підгілок, окремих зчитувань лічильників і обчислень формул. Якщо він вимкнений (або звіт переглядає монітор), експортуються лише головні (верхньорівневі) гілки — зведення, зручне для керівників.
Надіслати PDF на e-mail — натисніть кнопку, введіть електронну адресу отримувача, і звіт буде згенеровано й надіслано негайно. Використовуються той самий часовий діапазон, сегментація й набір гілок, що й для звичайного PDF-експорту.
Перейдіть до Звіти → Споживання ресурсів і натисніть Додати, щоб відкрити конструктор звіту. Звіт задається деревом — ви будуєте ієрархію гілок, що описує, як мають групуватися й обчислюватися ваші дані споживання.
Кожен вузол дерева має тип, який визначає, звідки береться його значення:
Тип
Призначення
Гілка
Контейнер для дочірніх вузлів. Її значення дорівнює сумі всіх дочірніх елементів. Використовуйте для групування: за відділом, будівлею, типом ресурсу тощо. Вкладення допускається до 5 рівнів нижче кореня.
Значення
Посилання на один параметр пристрою. Показує споживання цього параметра, тобто дельту за часовий сегмент. Параметр вибирається через три послідовні випадаючі списки: мережа → пристрій → параметр.
Розрахувати
Обчислює формулу, яка комбінує кілька параметрів. Параметри у формулі вказуються через їхній ID з префіксом #, наприклад #561 * 2 + #558. Див. Використання формул для деталей синтаксису.
Посилання
Посилається на вже існуючу гілку з цього або іншого звіту в тій самій організації. У засобі вибору посилань показано всі гілки з усіх звітів, тож можна повторно використовувати спільні структури без дублювання.
Щоб побудувати дерево, почніть із натискання Додати гілку, щоб створити головну гілку верхнього рівня (кореневу). Усередині кожної гілки натисніть Додати гілку, щоб додати дочірні вузли будь-якого типу. Дерево росте зверху вниз: головні гілки нагорі, листові вузли (Значення, Розрахувати, Посилання) унизу.
Головні гілки мають два додаткові налаштування, які впливають на онлайн-перегляд:
Категорія — необов’язковий ярлик, який групує споріднені гілки під заголовком. Наприклад, усі гілки електроенергії можна згрупувати під “Електроенергію”, а всі гілки води — під “Воду”. Гілки без категорії з’являються першими, далі йдуть групи за категоріями. Категорії використовуються лише в онлайн-перегляді й не з’являються в експортах Excel/PDF.
Маркери рівня — до 4 порогових значень, кожне зі своїм кольором. На графіку вони показуються як горизонтальні опорні лінії та як кольорові сегменти в стовпчиках. Наприклад, можна задати жовтий маркер на 50 кВт·год і червоний на 100 кВт·год, щоб підсвічувати перевищення очікуваного споживання. Маркери рівня використовуються лише в онлайн-перегляді й не з’являються в експортах Excel/PDF.
Під час перегляду звіту часовий діапазон і сегментація задаються через панель керування над графіками.
Часовий діапазон визначає, який період аналізувати. Випадаючий список пресетів пропонує Останній день, Останні 7 днів і Останні 30 днів, або можна обрати Задати… і задати конкретні дати через поля вибору дати.
Сегментація визначає, як часовий діапазон ділиться на інтервали: Півгодинна (30-хвилинні інтервали), Погодинно або За днями (денні інтервали). Менші інтервали дають більше деталей, але також генерують більше точок — на великих діапазонах дат із багатьма параметрами може знадобитися більший інтервал, щоб не перевищити ліміт експорту.
Графіки та експорт використовують часовий пояс браузера. Межі сегментів також вирівнюються за вашим локальним часовим поясом.
Тип вузла Розрахувати використовує формули для комбінування кількох параметрів. У формулах параметри посилаються на ID з префіксом #, а обчислення виконуються для кожного сегмента на основі дельт цього сегмента.
Приклад формули:
(#561 + 10) / 2 + #558
Ця формула бере дельту параметра #561, додає 10, ділить на 2, а потім додає дельту параметра #558.
Якщо для якогось параметра немає даних у конкретному сегменті, наприклад через недоступний пристрій або видалений параметр, його значення вважається 0.
Користувачі з роллю Менеджер можуть створювати, редагувати й видаляти звіти, а також бачать прапорець Детальний звіт при експорті.
Моніторингові користувачі можуть отримати доступ лише для перегляду до конкретного звіту про споживання ресурсів. Вони можуть переглядати графіки та завантажувати експорти, але лише коротку версію — прапорець детального звіту для них прихований. Вони не можуть створювати або редагувати звіти. Такий доступ налаштовується під час запрошення користувача до організації, коли роль можна прив’язати до конкретного звіту.
Вибрана комбінація діапазону дат, сегментації та кількості параметрів перевищує ліміт експорту. У повідомленні про помилку показується найближча доступна дата для вибраної сегментації.
Що робити:
Зменште діапазон дат.
Виберіть більший інтервал сегментації, наприклад За днями замість Погодинно.
Сховайте частину головних гілок перед експортом — експортуються тільки видимі.
Швидше за все, вибрані параметри не є накопичувальними лічильниками. Цей звіт обчислює різницю між зчитуваннями в кожному сегменті. Якщо значення параметра між зчитуваннями не змінюється (наприклад, це миттєва величина, як-от температура), усі дельти будуть нульовими.
Що робити:
Переконайтеся, що вибрані параметри є накопичувальними лічильниками.
ID параметра у формулі не збігається з жодним існуючим параметром (відсутні ID трактуються як 0).
Синтаксис формули некоректний (помилки розбору за замовчуванням дають 0).
Що робити:
Наведіть курсор на кожен параметр на сторінці пристрою, щоб підтвердити його ID.
Переконайтеся, що всі посилання #id у формулі відповідають існуючим параметрам у вашій організації.
Перевірте формулу на синтаксичні помилки — під час введення формули назви параметрів з’являються під полем, а відсутні або некоректні ID підсвічуються.
Експортований звіт порожній або в ньому бракує гілок
Онлайн-графік може обмежити початкову дату, якщо запитаний діапазон перевищує ліміт точок даних на графіку. Експорт використовує повний запитаний діапазон дат. Через це в графіку може бути коротший часовий діапазон, ніж у завантажених XLSX/PDF.
Будь-які параметри, що представляють накопичувальний лічильник: електроенергія, вода, газ, мотогодини, виробничі лічильники. Параметри миттєвих значень, наприклад температура, тиск або напруга, для цього звіту не підходять — використовуйте Звіт про значення параметрів.
Чи можна включати параметри з різних пристроїв в один звіт?
Для кожного сегмента система знаходить найбільше зчитування всередині сегмента і віднімає від нього останнє зчитування перед початком цього сегмента. Якщо попереднього зчитування немає, використовується нуль. Потім результат множиться на множник параметра й коригується його значенням зсуву (якщо налаштовано).
Чи можна повторно використовувати частини одного звіту в іншому?
Так, під час створення звіту використовуйте тип вузла Посилання. Він дозволяє посилатися на будь-яку гілку з будь-якого звіту в тій самій організації, тож не потрібно наново будувати спільні структури.
Ні. Звіти про споживання ресурсів можна надсилати на електронну адресу тільки вручну через кнопку Надіслати PDF на e-mail. Для автоматичної розсилки використовуйте Звіт про значення параметрів.
Якщо параметр, на який посилається вузол Значення, буде видалено, такий вузол перестане показувати дані (порожні дельти). Якщо видалити параметр, на який посилається формула типу Розрахувати, його значення в обчисленні буде вважатися 0. Структура самого звіту зберігається — можна відредагувати її, щоб замінити відсутній параметр.
Так. Експорти обмежені загальною кількістю точок даних — це кількість сегментів, помножена на кількість параметрів. Точні межі залежать від формату: для PDF вони нижчі, ніж для Excel. Якщо ліміт перевищено, з’явиться помилка Segment limit exceeded із запропонованим діапазоном дат.
HACCP (аналіз небезпечних факторів і контроль у критичних точках) — це системний підхід до управління безпечністю харчових продуктів, який визначає, оцінює та контролює небезпеки по всьому ланцюгу виробництва й зберігання харчових продуктів. У холодильних системах і холодовому ланцюгу HACCP вимагає безперервного моніторингу температури в критичних контрольних точках та документального підтвердження того, що межі безпеки дотримувалися.
Інструмент звітів HACCP в Overvis автоматизує документування відповідності вимогам моніторингу температури для холодильних і морозильних контрольних точок. Він отримує температурні показники з контрольованих пристроїв і формує структуровані звіти, які:
Відображають значення температури з налаштовуваними часовими інтервалами (від 15 хвилин до 1 дня)
Виявляють перевищення операційних і критичних порогів
Позначають відсутність даних або невідомий стан обладнання
Дозволяють документувати коригувальні дії для виявлених винятків
Дають змогу виконувати формальний перегляд і затвердження уповноваженими особами
Дозволяють експортувати дані в Excel для зберігання та аудитів
Цей інструмент підтримує вимоги до документації моніторингу температури в поширених рамках HACCP, зокрема в принципах Codex Alimentarius і правилах ЄС щодо гігієни харчових продуктів (EC 852/2004). Він призначений саме для HACCP-перегляду холодильних і морозильних установок і не є універсальною HACCP-системою для всіх типів небезпек.
Кожен звіт прив’язаний до однієї організації. Якщо ви керуєте кількома об’єктами, створюйте окремі звіти для кожної організації.
Усі температури обробляються як значення у градусах Цельсія. Усі обчислення дати й часу використовують часовий пояс, налаштований для організації, включно з правильною обробкою переходів на літній час.
Налаштуйте звіт (див. Конструктор звіту). Перейдіть у Звіти > HACCP: на вкладці рядка дій буде Звіт HACCP, а заголовок сторінки конструктора — HACCP. Задайте назву звіту, діапазон дат, часовий інтервал (каденцію) і режим відображення температури. Додайте один або кілька температурних параметрів, вибираючи для кожного мережу, пристрій і параметр. За потреби налаштуйте параметри уставки, розморожування й увімкн./вимкн. Встановіть операційні та критичні пороги.
Збережіть як шаблон (необов’язково, див. Шаблони звітів). Збережіть поточну конфігурацію як шаблон для повторного використання. Шаблони зберігають усе, крім діапазону дат, тому ви можете швидко повторно генерувати звіти для нових періодів без повторного налаштування параметрів і порогів.
Згенеруйте звіт (див. Згенерований звіт). Натисніть Показати звіт, щоб побудувати звіт на основі поточних даних. Підсумок відхилень з’явиться одразу, показуючи всі порушення порогів, прогалини в даних і невідомі стани обладнання за вибраний період.
Задокументуйте коригувальні дії (див. Нотатки про коригувальні дії). Перегляньте підсумок відхилень і додайте нотатки про коригувальні дії до винятків, де це потрібно. Нотатки прив’язуються до конкретних інтервалів винятків і включаються до фінального звіту.
Підтвердити перевірку (див. Перегляд звіту). Уповноважений користувач додає коментарі до перевірки й підтверджує перегляд. Це створює постійний, незмінний знімок звіту — включно з усіма показниками, винятками та нотатками про коригувальні дії у стані на момент генерації.
Експорт в Excel (див. Експорт у Excel). Експортуйте звіт у файл Excel у будь-який момент після генерації — як до, так і після перегляду. Експортована книга містить ті самі дані, які видно в браузері.
Щоб відкрити звіт HACCP, перейдіть у Звіти > HACCP у головному меню навігації (1) (вкладка Звіт HACCP, заголовок сторінки конструктора — HACCP).
Функція поділена на три секції (2), доступні через вкладки у верхній частині сторінки:
Звіт HACCP — коротка назва на вкладці; заголовок сторінки конструктора — HACCP. Конструктор звіту, де ви налаштовуєте параметри, генеруєте звіти, документуєте коригувальні дії та надсилаєте перегляди.
Шаблони — коротка назва на вкладці; заголовок сторінки списку — Шаблони HACCP. Тут збережені конфігурації звітів, які можна завантажити в конструктор для швидкої повторної генерації з новими діапазонами дат.
Перевірені звіти — коротка назва на вкладці в рядку дій; заголовок сторінки списку — Перевірені звіти HACCP. Тут показано всі надіслані знімки звітів, доступні для перегляду та експорту.
Вкладки навігації залишаються видимими на всіх сторінках HACCP, включно зі сторінкою деталей шаблону, сторінкою підтвердження видалення та сторінкою деталей переглянутого звіту.
Конструктор звіту — це основна робоча область сторінки з заголовком HACCP (на вкладці рядка дій — Звіт HACCP). Він дозволяє налаштувати, які температурні параметри потрібно моніторити, задати період звітування та часовий інтервал, визначити допустимі температурні пороги й згенерувати звіт.
Конструктор завжди видимий у верхній частині цієї сторінки. Після генерації звіту результати з’являються нижче. Ви можете вільно змінювати налаштування конструктора, не втрачаючи згенерований звіт чи чернетки нотаток про коригувальні дії — зміни застосовуються лише після натискання Показати звіт. Повторна генерація замінює попередній звіт і видаляє всі чернетки нотаток про коригувальні дії.
Назва звіту — довільна назва звіту. Вона відображається в заголовку звіту, у списках шаблонів і переглянутих звітів, а також в експортованому файлі Excel. Обов’язково.
Дата від / Дата до — діапазон дат звіту, включно. За замовчуванням встановлено останні 7 днів. Ви можете вибрати будь-який діапазон дат; система обмежує загальний розмір набору даних залежно від кількості параметрів і розміру інтервалу. Усі дати й час у звіті використовують часовий пояс, збережений для організації. Якщо потрібен інший часовий пояс, зверніться до адміністратора Overvis або підтримки — в інтерфейсі не завжди є окреме поле Часовий пояс у Налаштуваннях організації на всіх інсталяціях.
Розмір інтервалу — часова каденція, за якою показники групуються у сегменти. Доступні варіанти:
1 день — один сегмент на календарний день
1 година — сегменти, вирівняні по кожній годині дня
30 хвилин — сегменти, вирівняні по кожній півгодині
15 хвилин — сегменти, вирівняні по кожній чверті години
Коротші інтервали дають більш деталізовані звіти, але збільшують їхній розмір. Поєднання діапазону дат, розміру інтервалу та кількості налаштованих параметрів визначає загальний обсяг даних.
Значення температури — визначає, як обчислюється значення температури для кожного сегмента, якщо всередині нього є кілька показників:
Початок інтервалу — показник, найближчий до початку сегмента
Середнє — середнє арифметичне всіх показників у сегменті
Мінімум — найнижчий показник у сегменті
Максимум — найвищий показник у сегменті
Цей вибір впливає як на відображення значень, так і на виявлення порогових винятків. Наприклад, якщо вибрано Середнє, короткий сплеск вище критичної межі може не викликати виняток, якщо середнє залишиться в межах норми.
Список температурних параметрів визначає, які контрольні точки включені до звіту. Кожен елемент представляє один контрольований температурний параметр разом з його додатковими допоміжними параметрами та порогами.
Перед генерацією звіту потрібно налаштувати принаймні один температурний параметр. В одному звіті можна використовувати до 100 параметрів.
Щоб додати параметр, натисніть Додати параметр температури під списком. Щоб редагувати існуючий параметр, натисніть його назву в списку. Щоб видалити його, натисніть значок кошика в його рядку. Щоб змінити порядок параметрів, перетягніть їх за ручку зліва — список покаже нову позицію під час перетягування.
Діалог налаштування параметра відкривається, коли ви додаєте або редагуєте температурний параметр. Він містить такі секції:
Параметр температури (обов’язковий) — основний температурний показник для цієї контрольної точки. Виберіть мережу, потім пристрій, а далі конкретний параметр. Для вибору доступні лише відстежувані параметри — це параметри пристроїв, які Overvis періодично зчитує у фоновому режимі та зберігає в базі даних. Якщо потрібного параметра немає в списку, переконайтеся, що він налаштований як відстежуваний у конфігурації пристрою.
Параметр уставки (необов’язковий) — еталонне значення уставки, яке використовується для кольорового відображення відхилення в таблиці звіту. Якщо цей параметр налаштовано, кожна комірка фарбується градієнтом від синього через білий до помаранчевого залежно від того, наскільки температура відхиляється від уставки. Шкала відхилення використовує кроки по 1°C на кожен рівень кольору. Уставка не впливає на виявлення винятків — вона використовується лише для візуальної індикації.
Щоб додати уставку, натисніть Параметр уставки, щоб розгорнути секцію, а потім виберіть мережу, пристрій і параметр. Щоб видалити його, натисніть значок кошика поруч із назвою секції.
Параметр розморожування (необов’язковий) — показує, чи перебуває обладнання в циклі розморожування. Коли розморожування активне, відповідні комірки в таблиці звіту підсвічуються жовтим фоном. Статус розморожування показується лише як інформаційний контекст — він не створює винятків і не пригнічує порушення порогів.
Параметр увімкн./вимкн. (необов’язковий) — показує, чи працює обладнання. Коли обладнання вимкнене, відповідні комірки показуються із сірим фоном. Факт вимкнення обладнання є лише інформаційним і сам по собі не створює винятків. Однак порушення порогів усе одно виявляються, навіть якщо обладнання вимкнене. Якщо обладнання увімкнене (або його стан невідомий), а температурний показник відсутній, це позначається як виняток невідомого статусу.
Для параметрів розморожування та увімкн./вимкн. доступні ще два додаткові налаштування:
Режим оцінювання — визначає, як логічний стан виводиться з показників усередині сегмента:
Вважати true, якщо в інтервалі було хоча б одне true — стан вважається активним, якщо будь-який показник у сегменті відповідає значенню true
Вважати false, якщо в інтервалі було хоча б одне false — стан вважається активним, якщо будь-який показник у сегменті не відповідає значенню true
За значенням на початку інтервалу — використовується лише показник, найближчий до початку сегмента (це та сама логіка “найближче до початку”, яка використовується Значення температури > Початок інтервалу, але застосована до логічного параметра замість температурного)
Значення true — числове значення, яке представляє активний стан. За замовчуванням це 1. Усі параметри порівнюються чисельно незалежно від того, як вони можуть відображатися в інших частинах Overvis. Для обладнання, де активний стан позначається значенням 0 (інвертоване підключення), встановіть значення true як 0.
Для кожного температурного параметра можна налаштувати до чотирьох порогових значень. Пороги визначають допустимі температурні діапазони для контрольної точки та керують виявленням винятків у згенерованому звіті.
Робочі пороги визначають нормальний робочий діапазон:
Нижній — найнижча допустима температура в нормальному режимі. Температури нижче цього значення викликають виняток операційне відхилення.
Верхній — найвища допустима температура в нормальному режимі. Температури вище цього значення викликають виняток операційне відхилення.
Операційні відхилення означають, що температура вийшла за межі бажаного робочого діапазону, але ще не досягла критичного з погляду безпеки рівня. Зазвичай вони потребують перевірки та коригувальних дій, щоб запобігти подальшому погіршенню ситуації.
Критичні пороги визначають абсолютні межі безпеки:
Нижній — мінімальна безпечна температура. Температури нижче цього значення викликають виняток критичне порушення межі.
Верхній — максимальна безпечна температура. Температури вище цього значення викликають виняток критичне порушення межі.
Порушення критичних меж означають прямий ризик для безпеки харчових продуктів і вимагають негайних коригувальних дій та документування.
Встановлюйте критичні пороги відповідно до критичних меж, визначених у вашому плані HACCP. Операційні пороги мають бути вужчими за критичні, щоб забезпечити раннє попередження до критичного порушення — це дає вашій команді час на коригувальні дії до того, як безпечність продуктів буде поставлена під загрозу.
Усі порогові значення є необов’язковими. Якщо поріг не налаштовано, відповідний тип винятку для цього параметра не перевіряється. У межах кожної пари (операційної або критичної) нижнє значення не може бути вищим за верхнє.
Порушення порогів виявляються на основі обчисленого значення сегмента (визначеного налаштуванням Значення температури), а не на основі окремих сирих показників усередині сегмента. Якщо критичний поріг порушено, він має пріоритет над операційним порушенням для того самого сегмента.
Після натискання Показати звіт звіт з’являється нижче конструктора. Він складається з трьох частин: блоку заголовка (з легендою, підсумковими лічильниками відхилень і формою перегляду), таблиці «Підсумок відхилень» і детальної таблиці, яка завантажується за потреби.
Заголовок показує назву звіту, вибраний діапазон дат і розмір інтервалу. Поруч із метаданими розташована кольорова легенда, яка пояснює значення всіх візуальних стилів, використаних у звіті:
Градієнт відхилення — 11-рівнева шкала від синього через білий до помаранчевого, яка показує, наскільки температура відхиляється від уставки. Кожен рівень відповідає 1°C. Синій означає нижче уставки, помаранчевий — вище уставки, білий — близько до уставки.
Нижче нижньої межі / Вище верхньої межі (операційний поріг) — тонка внутрішня рамка синього кольору (нижче операційної нижньої межі) або червоного кольору (вище операційної верхньої межі), без жирного тексту. Товщина дозволяє відрізнити це порушення від критичного на тому ж боці.
Нижче критичної межі / Вище критичної межі — товстіша внутрішня рамка того ж синього або червоного кольору та жирний текст. Критичне порушення використовує помітніший контур, ніж операційне, тому їх легко розрізнити без зміни кольору.
Розморожування — жовтий фон означає, що обладнання перебуває в циклі розморожування.
Вимкнено — сірий фон означає, що обладнання вимкнене.
Відсутнє або невідоме значення — курсивний текст (часто з - у комірці) означає відсутнє температурне значення або невідомий/виведений контекст; деталі дивіться в підказках.
Під легендою показуються підсумкові лічильники:
Усього відхилень — загальна кількість виявлених інтервалів відхилень для всіх параметрів.
Відхилення без коригувальної дії — скільки інтервалів відхилень ще не мають прив’язаної нотатки про коригувальні дії.
Інтервали з невідомим станом/даними — кількість інтервалів, у яких бракувало даних або статус обладнання був невідомий.
Таблиця «Підсумок відхилень» — це основна поверхня перегляду HACCP. Вона містить усі виявлені інтервали винятків для всіх налаштованих параметрів, відсортовані за параметром і часом.
Кожен рядок показує:
Параметр — назву температурного параметра, а над нею — мережу та пристрій для контексту.
Виняток — один із трьох типів винятків (див. нижче); у таблиці інтерфейсу заголовок стовпця короткий — Виняток.
Початок / Кінець — локальні дату й час початку та завершення інтервалу винятку.
Тривалість — тривалість винятку.
Мін. / Макс. — мінімальні та максимальні обчислені значення сегментів у межах інтервалу винятку. Вони відображають вибраний режим Значення температури (початок інтервалу, середнє, мінімум або максимум), а не сирі окремі показники.
Межа / уставка — порогове значення або значення уставки, яке було порушено.
Коригувальна дія — чи було додано нотатку про коригувальні дії до цього винятку.
Звіт виявляє три типи винятків. Якщо до одного й того самого часового сегмента одночасно застосовуються кілька умов, використовується виняток із найвищим пріоритетом.
Критичне порушення межі (найвищий пріоритет) — обчислене температурне значення для сегмента нижче налаштованої критичної нижньої межі або вище налаштованої критичної верхньої межі. Це означає прямий ризик для безпеки харчових продуктів і потребує негайних коригувальних дій та документування. У детальній таблиці критичні порушення показуються жирним текстом і товстішою кольоровою внутрішньою рамкою (синьою для низьких значень, червоною для високих).
Операційне відхилення (середній пріоритет) — обчислене значення температури знаходиться поза операційним пороговим діапазоном, але ще не досягло критичної межі. Це означає, що система відхиляється від цільових робочих умов і може потребувати корекції, щоб уникнути критичного порушення. Операційні відхилення використовують ті самі сині/червоні кольори рамки, що й критичні порушення з цього ж боку, але з тоншою рамкою та без жирного тексту.
Невідомий статус/дані (найнижчий пріоритет) — температурні дані відсутні або параметр статусу обладнання має невідомий стан. Це може трапитися, коли:
температурний показник відсутній, а обладнання підтверджено як увімкнене
температурний показник відсутній, а параметр увімкн./вимкн. не налаштовано
температурний показник відсутній, а сам стан увімкн./вимкн. невідомий
налаштований параметр розморожування або увімкн./вимкн. не має жодного показника в сегменті
Цей тип винятку охоплює дві різні ситуації під однією назвою: відсутність температурних показників (відмова моніторингу) та невизначений стан обладнання (питання статусу обладнання). Обидві ситуації відображаються як «невідомий статус/дані» в підсумку відхилень, але точна причина показується в підказці або примітці комірки. Якщо обладнання підтверджено як вимкнене і температурний показник відсутній, такий інтервал не позначається як виняток невідомого статусу.
Як формуються інтервали винятків: звіт аналізує кожен часовий сегмент окремо, класифікує його за наведеними вище правилами, а потім об’єднує послідовні сегменти одного типу винятку в безперервні інтервали. Коли тип винятку змінюється між сусідніми сегментами, починається новий інтервал. Наприклад, дві години операційного відхилення, всередині яких є 20-хвилинне критичне порушення, дадуть три окремі інтервали: операційне відхилення, порушення критичної межі та знову операційне відхилення.
Важливо: стани розморожування й вимкнення мають лише інформаційний характер — вони самі по собі не створюють винятків і не пригнічують порушення порогів. Якщо критичний або операційний поріг порушений під час циклу розморожування або коли обладнання вимкнене, виняток усе одно буде виявлено й показано. У детальній таблиці індикатори порушення порогів (рамки та жирний текст) накладаються поверх фону розморожування або вимкнення, тож обидва стани залишаються видимими одночасно (див. стилізацію комірок).
Ви можете додати нотатку про коригувальні дії до будь-якого інтервалу винятку в підсумку відхилень. Нотатки слугують документацією того, які дії були виконані у відповідь на виявлений виняток.
Щоб додати нотатку, натисніть комірку коригувальної дії у відповідному рядку винятку. Кожна нотатка зберігає введений текст, відображуване ім’я користувача та час створення. Поки ви працюєте із згенерованим звітом, нотатки можна вільно редагувати й видаляти.
Після надсилання звіту на перегляд усі нотатки про коригувальні дії стають частиною незмінного переглянутого знімка і більше не можуть бути змінені.
Детальна таблиця показує повну матрицю часових сегментів для всіх налаштованих параметрів. За замовчуванням вона прихована й не завантажується, доки ви явно не розгорнете її, натиснувши Показати детальну таблицю. Це дозволяє зберігати швидке початкове формування звіту, оскільки детальна таблиця може бути дуже великою.
Кожен рядок у таблиці представляє один налаштований температурний параметр (ідентифікований за мережею, пристроєм і назвою параметра). Колонки організовані за днями, і кожен день містить:
Уставка — значення уставки на початку дня. Якщо уставка змінюється протягом дня, біля початкового значення з’являється позначка *. Якщо для цього дня відсутній показник уставки, відображається -.
Сегментні стовпці — одна колонка на кожен часовий сегмент дня. У кожній комірці показується обчислене значення температури (або - за відсутності даних) з візуальним стилем, який швидко показує стан сегмента.
Статус — узагальнення найгіршого стану, зафіксованого протягом дня, у такому порядку пріоритетів: критичне порушення > операційне відхилення > немає даних > невідомі значення > норма.
Візуальне оформлення комірок використовує такий порядок пріоритетів (від найвищого):
Вимкнено (сірий фон) — обладнання вимкнене в цьому сегменті.
Розморожування (жовтий фон) — обладнання перебуває в циклі розморожування.
Колір відхилення (градієнт від синього до помаранчевого) — відхилення температури від уставки, якщо уставка доступна. Кожен крок кольору відповідає 1°C відхилення.
Білий фон — уставка не налаштована або температура дорівнює уставці.
Порушення порогів накладаються поверх фону:
Операційне порушення порогу: тонка внутрішня рамка — синя, якщо значення нижче операційної нижньої межі, червона — якщо вище операційної верхньої межі.
Критичне порушення порогу: товстіша внутрішня рамка того ж синього або червоного кольору та жирний текст.
Відсутні або невідомі значення показуються курсивом із символом -.
У нижній частині кожної денної групи колонок рядок підсумку показує лічильники: загальну кількість сегментів, кількість сегментів з операційними відхиленнями, кількість сегментів із критичними порушеннями та кількість сегментів із невідомими значеннями.
Звіт можна експортувати у файл Excel (.xlsx) у будь-який момент після генерації. Для згенерованого звіту натисніть Експорт в Excel. На сторінці деталей переглянутого звіту використовуйте Експорт в Excel або Експортувати перевірений звіт (підписи можуть трохи відрізнятися залежно від вигляду; обидва варіанти формують книгу з поточного контексту). Під час експорту згенерованого звіту дані відображають показники, зафіксовані на момент генерації. Під час експорту переглянутого звіту дані беруться зі збереженого незмінного знімка.
Експортована книга містить два аркуші:
Аркуш 1 — «Звіт HACCP» містить:
Заголовок звіту: назву звіту, організацію, діапазон дат, інтервал і час генерації.
Метадані перегляду: тип експорту (Експорт згенерованого звіту або Експорт перевіреного звіту), ім’я того, хто перевірив, дату перегляду та коментарі до перевірки.
Підсумки винятків: загальну кількість винятків, кількість винятків без коригувальних дій і кількість інтервалів з невідомим станом/даними.
Таблицю підсумку відхилень: ті самі дані, що й у браузерному підсумку відхилень — параметр, Виняток (тип винятку; заголовок стовпця в таблиці — короткий підпис Виняток), час початку та кінця, тривалість, мінімальні та максимальні температури, відповідну межу або уставку й нотатки про коригувальні дії. Нотатки включаються до експорту незалежно від того, чи був звіт уже надісланий на перегляд.
Аркуш 2 — «Деталі» містить:
Легенду кольорів: довідковий ключ, який пояснює кольори комірок, товщину рамок (тонші для операційних меж, товстіші для критичних) і стилі тексту відповідно до таблиці в браузері.
Повну матрицю сегментів: ту саму детальну таблицю, що й у браузері — один рядок на параметр, одна колонка на часовий сегмент, з групуванням за днями. Включає колонки уставки, денні статуси та денні підсумки.
Примітки комірок: там, де браузер показує підказки для невідомих або виведених значень, Excel-файл додає ті самі пояснення як коментарі комірок.
Книга форматована для друку в альбомному режимі A4, повторює рядки заголовків на кожній сторінці й додає нижній колонтитул із нумерацією сторінок і текстом «Generated by Overvis (www.overvis.com)» (у експорті залишається англійською).
Шаблони зберігають конфігурацію звіту для повторного використання, щоб ви могли швидко генерувати звіти для нових діапазонів дат без повторного налаштування параметрів і порогів. Шаблони належать організації — усі користувачі організації можуть їх бачити й використовувати.
Шаблон зберігає:
назву звіту
налаштовані температурні параметри (разом з усіма необов’язковими параметрами та порогами)
розмір інтервалу (каденцію)
режим відображення температурного значення
Шаблон не зберігає діапазон дат, згенеровані дані звіту, нотатки про коригувальні дії чи метадані перегляду. Коли ви завантажуєте шаблон, діапазон дат за замовчуванням встановлюється на останні 7 днів.
Збереження шаблону. Після налаштування конструктора на головній сторінці звіту HACCP натисніть Зберегти шаблон. Шаблон буде збережено з поточною назвою звіту та конфігурацією. Після цього ви будете перенаправлені на сторінку деталей шаблону. (Якщо конструктор уже відкрито в контексті шаблону, кнопка збереження нового шаблону може бути підписана Зберегти новий шаблон — див. нижче.)
Завантаження шаблону. Відкрийте вкладку Шаблони, щоб побачити список збережених шаблонів. Натисніть назву шаблону, щоб відкрити конструктор із попередньо заповненою конфігурацією шаблону. Потім за потреби змініть діапазон дат і натисніть Показати звіт.
Оновлення шаблону. Перебуваючи на сторінці конструктора, пов’язаній із шаблоном, змініть налаштування за потреби та натисніть Оновити шаблон, щоб зберегти зміни. Ви також можете натиснути Зберегти новий шаблон, щоб створити окремий шаблон із зміненою конфігурацією.
Видалення шаблону. У списку шаблонів натисніть значок кошика поруч із шаблоном. Перед остаточним видаленням з’явиться сторінка підтвердження.
Список шаблонів показує назву кожного шаблону (як посилання) і дату створення. Збереження, оновлення та видалення шаблонів потребують прав редагування в організації.
Після генерації звіту та документування коригувальних дій уповноважений користувач може надіслати його на перегляд. Це створює постійний, незмінний запис звіту.
Форма перегляду з’являється в області заголовка згенерованого звіту і містить:
Перевірив — автоматично встановлюється ім’я користувача, який надсилає звіт. Не редагується.
Перевірено о — автоматично встановлюються поточні дата й час. Не редагується.
Коментарі до перевірки — текстове поле для коментарів до перевірки. Редагується до надсилання.
Натисніть Підтвердити перевірку, щоб остаточно зафіксувати звіт. Система збереже повний знімок усіх показників, інтервалів винятків і нотаток про коригувальні дії у стані на момент генерації. Після надсилання ви будете перенаправлені на сторінку деталей переглянутого звіту.
Надсилання на перегляд вимагає прав редагування в організації. Скасувати перегляд неможливо — після надсилання знімок і весь його вміст стають постійними.
Вкладка Перевірені звіти (у верхньому рядку дій) відкриває сторінку з заголовком Перевірені звіти HACCP; там показано всі знімки звітів, уже надіслані для організації. Список відображає:
назву звіту (клікабельне посилання на сторінку деталей)
діапазон дат
хто перевірив
коли перевірено
коментарі до перевірки
Натисніть назву звіту, щоб відкрити сторінку деталей. Сторінка деталей показує той самий вигляд звіту, що й згенерований звіт — заголовок, легенду, підсумок відхилень із нотатками про коригувальні дії та детальну таблицю, яку можна розгорнути — але в режимі лише для читання. Форма конструктора на цій сторінці не відображається. Усі дані беруться зі збереженого знімка, а не з поточних показників.
Переглянуті звіти зберігаються безстроково. Ви можете експортувати переглянутий звіт до Excel з його сторінки деталей. Експортований файл використовує дані зі збереженого знімка, тож він завжди точно відповідає тому, що було переглянуто.
Власники організації можуть видалити переглянутий звіт, натиснувши дію видалення у списку. Видалення прибирає звіт зі списку й робить його сторінку деталей недоступною. Якщо видалений звіт потрібно відновити (наприклад, для аудиту), зверніться до support@overvis.com.
Мого температурного параметра немає в діалозі. Що робити?
У списках вибору відображаються лише відстежувані параметри. Переконайтеся, що параметр налаштований як відстежуваний у параметрах пристрою. Після цього Overvis почне зчитувати та зберігати його значення, і параметр з’явиться в діалозі вибору HACCP.
Обладнання перевищує пороги під час циклів розморожування. Як це обробляти?
Цикли розморожування не пригнічують виявлення порогових винятків. Якщо ваше обладнання регулярно перевищує пороги під час розморожування, звіт показуватиме це як винятки щоразу. Ви можете документувати такі випадки стандартною нотаткою про коригувальні дії, пояснюючи, що відхилення сталося під час запланованого циклу розморожування. Якщо винятки, пов’язані з розморожуванням, очікувані та не становлять ризику для безпеки харчових продуктів, розгляньте можливість коригування порогів відповідно до нормальної поведінки обладнання або залиште пороги не налаштованими для параметрів, де піки під час розморожування є звичними.
Я надіслав переглянутий звіт з неправильними даними. Чи можна це виправити?
Переглянуті звіти є незмінними і не можуть бути відредаговані після надсилання. Щоб виправити запис, згенеруйте новий звіт за той самий діапазон дат із правильними налаштуваннями, додайте відповідні нотатки про коригувальні дії та надішліть його на перегляд. Власники організації можуть видалити неправильний переглянутий звіт зі списку.
Що відбувається, якщо в сегменті є лише один показник?
Усі режими температурного значення (початок інтервалу, середнє, мінімум, максимум) повертають те саме значення, якщо в сегменті є лише один показник. Режим має значення лише тоді, коли в межах сегмента є кілька показників.
Як перехід на літній час впливає на звіт?
Звіт використовує часовий пояс організації і правильно обробляє переходи на літній і зимовий час. У дні зміни часу кількість сегментів може відрізнятися від звичайної — 23-годинна доба матиме менше сегментів, а 25-годинна — більше. Межі сегментів завжди вирівнюються за місцевим часом.
Чи можна запланувати автоматичну генерацію звітів?
Ні. HACCP-звіти генеруються на вимогу. Ви можете зберегти шаблон, щоб прискорити повторні налаштування, але діапазон дат щоразу потрібно встановлювати вручну й натискати Показати звіт.
Як часто слід генерувати звіти?
Це залежить від вимог вашого плану HACCP. Деякі об’єкти генерують звіти щодня, інші — щотижня. Використовуйте діапазон дат і шаблони, щоб узгодити звітність із вашим графіком перегляду.
Що робити, якщо пристрій надовго стане недоступним?
Відсутні показники позначаються у звіті як винятки «невідомий статус/дані». Підсумок відхилень покаже точні часові інтервали з відсутніми даними, щоб ви могли з’ясувати причину та задокументувати коригувальні дії. Якщо обладнання було навмисно вимкнене, налаштуйте параметр увімкн./вимкн., щоб уникнути хибних спрацювань.
Чи можуть кілька користувачів одночасно працювати з коригувальними діями для одного звіту?
Ні. Згенерований звіт існує лише в браузері користувача, який його створив. Кожен користувач повинен згенерувати власний екземпляр звіту. Лише один користувач може надіслати звіт на перегляд.
Який максимальний діапазон дат можна охопити у звіті?
Фіксованої межі для діапазону дат немає. Система обмежує загальний розмір набору даних залежно від поєднання діапазону дат, розміру інтервалу та кількості налаштованих параметрів. Якщо звіт буде надто великим, під час спроби генерації з’явиться повідомлення про помилку. У такому разі скоротіть діапазон дат, використайте більший інтервал або розбийте роботу на кілька менших звітів.
Чи можна додати до звіту супровідні документи (фото, сертифікати калібрування)?
Вкладення безпосередньо в HACCP-звіті не підтримуються. Якщо потрібно додати супровідні документи, експортуйте звіт у Excel і об’єднайте його з вкладеннями у своїй системі керування документами. Аналогічно, якщо переглянутий звіт потребує електронного підпису, експортуйте його в Excel і підпишіть у системі електронного документообігу вашої організації.
Як довго зберігаються переглянуті звіти?
Переглянуті звіти зберігаються безстроково. Їх можна переглядати, експортувати й використовувати для аудитів у будь-який час. Власники організації можуть видаляти переглянуті звіти, які більше не потрібні; видалені звіти можна відновити, звернувшись до support@overvis.com.
Контрольна точка — точка в холодовому ланцюгу, де контролюється температура; зазвичай це холодильник, морозильник або холодне сховище.
Коригувальна дія — дія, виконана у відповідь на виявлений виняток і задокументована як нотатка, прив’язана до інтервалу винятку у звіті.
Інтервал винятку — безперервний період, протягом якого зберігається умова винятку. Сусідні часові сегменти з однаковим типом винятку об’єднуються в один інтервал.
Розмір інтервалу — часовий період, який використовується для поділу звіту на сегменти для аналізу. Також називається каденцією. Варіанти в інтерфейсі: 1 день, 1 година, 30 хвилин, 15 хвилин.
Шаблон — збережена конфігурація звіту (параметри, пороги, розмір інтервалу, режим відображення), яку можна повторно завантажити для швидкої генерації звіту за новий діапазон дат.
Перевірений звіт — незмінний знімок згенерованого звіту, який було надіслано на перегляд і який містить усі показники, винятки, нотатки про коригувальні дії та метадані перегляду.
Сегмент — окремий часовий слот у межах дня, визначений розміром інтервалу. Наприклад, при інтервалі 1 година кожен день має 24 сегменти (23 або 25 у день переходу на літній час).
Уставка — цільова температура контрольної точки, яка використовується для кольорового відображення відхилення в таблиці звіту.
Відстежуваний параметр — параметр пристрою, який Overvis періодично зчитує та зберігає в базі даних. Лише відстежувані параметри можуть використовуватися у HACCP-звітах.
Overvis Cloud Documentation
Візуалізації
Візуалізації в Overvis Cloud — це власні інтерактивні сторінки (HTML/SVG/JavaScript), які показують поточний стан обладнання й дають змогу керувати ним віддалено. Це та сама функція, що в навігації застосунку позначена як Візуалізації. Overvis сам займається підключенням пристроїв, збором даних і обробкою сповіщень, а візуалізації дозволяють представити цю інформацію так, як вам потрібно.
Візуалізації — це код HTML/SVG/JavaScript, вбудований у сторінки Overvis. Ви створюєте макет у будь-якому редакторі векторної графіки, експортуєте в SVG, потім додаєте спеціальні атрибути для прив’язки живих даних з пристроїв до графіки.
Після натискання «Створити візуалізацію» результат такий:
Можна навіть додати візуалізацію на Огляд в Overvis:
Ця візуалізація статична. Щоб показувати реальні дані пристрою, потрібні прив’язки даних — спеціальні атрибути HTML/SVG, що з’єднують елементи графіки з параметрами пристроїв.
У цьому посібнику створюється повна візуалізація для моніторингу холодильного обладнання: живі температури, інтерактивні уставки, індикатори тривог і перемикачі.
Створіть макет у векторному редакторі. У цьому прикладі — план складського приміщення з морозильними камерами:
План приміщення
Показ температури для кожного холодильника
Елементи керування уставкою
Індикатори тривог
Лічильник енергії
Перемикач режиму відтаювання
Індикатор стану дверей
Під час проєктування дотримуйтеся таких правил:
Типові значення-заповнювачі. Для всіх динамічних даних задайте типові значення. Для від’ємних температур з одним знаком після коми використовуйте “-12.3” — так зручніше верстати макет.
Розділяйте динаміку й статику. Динамічні значення й статичні підписи робіть окремими об’єктами. Наприклад “-12.3” і “°C” — окремі текстові об’єкти, щоб оновлювалося лише число.
Текст лишайте текстом. Динамічний текст не перетворюйте на криві чи контури. Статичний можна конвертувати для зменшення файлу; динамічний лишається редагованим текстом.
Сумісні шрифти. Краще веб-безпечні шрифти (Arial, Times New Roman, Courier) або Droid Sans, який Overvis підключає до всіх візуалізацій. Власні шрифти потребують додаткового CSS.
Розташування одразу. Елементи розташуйте одразу на фінальних місцях, зокрема ті, що спочатку приховані (індикатори тривог у обох станах, перемикачі в положеннях увімкнено/вимкнено).
Назви шарів. Давайте шарам зрозумілі назви — вони часто стають id елементів у SVG і спрощують пошук при додаванні прив’язок.
Атрибут on-click="edit-param:..." відкриває діалог для введення нового значення. Після збереження Overvis записує значення на пристрій і оновлює візуалізацію.
Додайте до стилю cursor:pointer, щоб курсор показував, що по елементу можна натиснути.
Використовуйте on-param-value, щоб показувати або ховати елементи залежно від значення параметра. Зручно для індикаторів тривог, які мають з’являтися лише при спрацюванні:
Кожен стан має on-param-value, який показує його при відповідності параметра (:=1 для ON, :=0 для OFF). Батьківська група має on-click="toggle-param:PARAM_REF:DEFAULT_VALUE:VALUE_ON:OPTIONS" і перемикає параметр між 0 і 1 при кліку. Опція :g в кінці оновлює всі дані візуалізації після зміни.
Щоб користувач міг редагувати підписи чи назви, які не зберігаються в регістрах пристрою, використовуйте власне сховище даних візуалізації. Спочатку увімкніть його атрибутом на кореневому <svg>:
<svguse-vis-data="yes" ...>
Потім позначте текстові елементи, які мають бути редагованими й збереженими:
Атрибут text-replacement задає ключ у сховищі. Початковий текст вмісту — значення за замовчуванням. Клік по елементу (on-click="edit-visdata:...") відкриває діалог; нове значення зберігається в базі.
Без прапорця :r береться останнє значення з бази (оновлюється приблизно кожні 5 хвилин), а не прямий опит пристрою. Це зменшує навантаження на мережу для значень, яким не потрібне оновлення в реальному часі.
Готова візуалізація показує живі дані обладнання, дозволяє взаємодію й оновлюється автоматично:
За замовчуванням param-value читає останнє збережене значення з бази. Опція :r зчитує значення безпосередньо з пристрою в реальному часі. Обирайте залежно від задачі:
Читання з бази (без :r), коли:
Значення змінюється рідко
Абсолютна актуальність у реальному часі не критична
Потрібно зменшити трафік і прискорити цикл оновлення
Кілька візуалізацій показують ті самі дані
Параметр відстежується в системі
Читання в реальному часі (:r), коли:
Потрібне саме поточне значення
Параметр часто змінюється
Взаємодія користувача потребує миттєвого відгуку
Показуються стани керування після щойних змін користувачем
Коли одночасно показуєте кілька тривог, створіть окремі елементи-індикатори для кожного типу й розташуйте їх без накладання. Для кожного свій on-param-value. У складних сценаріях можна динамічно позиціонувати індикатори через JavaScript.
Прив’язки даних покривають більшість випадків; для складнішої логіки можна використовувати JavaScript. Візуалізації виконуються в контексті сторінки Overvis — доступний повний API браузера та функції Overvis.
Перевірте інтервал оновлення, відповідність адрес параметрів конфігурації пристроїв і те, що пристрої онлайн і відповідають. У консолі розробника (F12) перегляньте помилки JavaScript.
Замість даних коди помилок (NOLR, NOPR, NORV тощо)
NOLR (немає останнього зчитування) — параметр ніколи не читали або він не відстежується. Позначте параметр як відстежуваний у налаштуваннях пристрою або додайте :r для читання в реальному часі.
NOPR (немає параметра для realtime) — для слота realtime не вдалося визначити параметр. Перевірте, що посилання на параметр у візуалізації коректне.
NORV (немає значення в реальному часі) — читання в реальному часі не повернуло значення. Перевірте зв’язок і спробуйте зчитати параметр на сторінці параметрів пристрою, щоб побачити фактичну помилку.
NON (немає мережі) — мережа не існує або немає доступу.
NOP (немає параметра) — параметра немає в пристрої.
Інтерактивні елементи не працюють
Перевірте синтаксис on-click за документацією. Має бути cursor:pointer у стилі. Переконайтеся, що інший елемент не перекриває клікабельний (порядок шарів SVG важливий).
Стилі виглядають неправильно
Переконайтеся, що при експорті SVG текст не перетворено на криві. Використовуйте inline-стилі в елементах SVG, щоб уникнути конфліктів зі стилями сторінки. За потреби перевірте SVG валідатором.
Оновлення повільніше, ніж очікується
Якщо багато параметрів з :r, кожен потребує запиту до пристрою. Наступний цикл оновлення не починається, доки не завершиться попередній. Для некритичних значень використовуйте читання з бази без :r або збільшіть update-period-sec.
Чи можна підключати зовнішні бібліотеки JavaScript (Chart.js, D3.js)?
Так. Підключайте через CDN у <script> на початку вихідного коду візуалізації. Великі бібліотеки можуть сповільнити завантаження сторінки.
Чи можна зробити багатосторінкову візуалізацію?
Візуалізація за структурою односторінкова, але можна імітувати кілька екранів через показ і приховування секцій у JavaScript або створити кілька окремих візуалізацій і зв’язати їх on-click="goto:vis:...".
Як відлагоджувати JavaScript у візуалізації?
Інструменти розробника в браузері (F12): консоль, точки зупинки, мережа. Перевірте помилки API та прив’язок.
Чи можуть візуалізації читати дані кількох організацій?
Ні. Кожна візуалізація належить одній організації й бачить лише її мережі та пристрої. API забезпечує це через токени автентифікації.
У чому різниця між system ID параметра та адресою параметра?
Адреса параметра — адреса регістра Modbus на пристрої (наприклад 101). System ID — внутрішній ідентифікатор у базі Overvis. У посиланнях використовуйте адреси на кшталт 12-34-56-78-90-ab>1>101 або system ID з префіксом #: #1234567.
Чи можна застосовувати CSS-фреймворки?
Так, підключіть CSS у <style> або <link>. На сторінці Overvis уже є власні стилі — можливі конфлікти. Використовуйте конкретні селектори або inline-стилі.
Як працювати з часовими поясами?
Усі дати з API Overvis у UTC. У JavaScript використовуйте Date і toLocaleString() для локального часу користувача або задайте конкретний часовий пояс.
Якщо потрібна допомога з візуалізаціями Overvis, пишіть на support@overvis.com. Допоможемо з власними візуалізаціями, відповімо на запитання щодо розширених можливостей і уточнимо документацію.
Overvis Cloud Documentation
Організації та користувачі
Overvis Cloud використовує організації, щоб розділяти обладнання, дані та білінг між різними клієнтами або проєктами. Кожен обліковий запис користувача може належати до однієї або кількох організацій, а кожне членство має конкретну роль, яка визначає, що саме користувач може робити.
Організація — це контейнер верхнього рівня в Overvis. Усі мережі, пристрої, параметри, сповіщення, візуалізації, звіти та білінг належать конкретній організації. Дані повністю ізольовані між організаціями — користувач бачить лише дані тієї організації, з якою зараз працює.
Власники та менеджери організації можуть редагувати такі налаштування. На бічній панелі цю сторінку відкривають через Деталі під назвою організації; заголовок сторінки — Налаштування організації.
Назва — відображувана назва організації (до 200 символів)
Країна та контактний телефон
Мова сповіщень — мова автоматичних електронних листів і SMS-сповіщень. Доступні мови: англійська, українська, польська, російська.
Електронна адреса і телефон за замовчуванням для сповіщень — використовуються як значення за замовчуванням під час створення нових сповіщень
Платіжна інформація — повне ім’я, країна, місто, адреса, поштовий індекс, телефон, електронна адреса та номер ПДВ (використовується в рахунках)
Власники додатково бачать параметри керування учасниками на сторінках організації.
Організація створюється автоматично під час реєстрації нового облікового запису Overvis. Назву організації задають під час реєстрації. Якщо залишити її порожньою, назва за замовчуванням формується з вашої електронної адреси:
Якщо домен електронної адреси має 10 або більше символів (наприклад, user@longcompany.com), як назву використовується домен (longcompany.com).
Якщо домен коротший (наприклад, user@acme.co), як назву використовується повна електронна адреса (user@acme.co).
Ви завжди належите принаймні до однієї організації. Якщо власник вилучає вас з організації, а інших членств у вас немає, для вас автоматично створюється нова порожня організація.
Якщо ви належите до кількох організацій (наприклад, як власник власної та як переглядач у організації клієнта), ви працюєте в одній організації за раз. Між ними можна перемикатися за допомогою селектора організації у верхній панелі навігації.
Після входу Overvis автоматично вибирає організацію, у якій у вас є роль власника або менеджера. Якщо в жодній організації немає ролі власника чи менеджера, вибирається перша доступна організація.
Обліковий запис користувача відповідає одній людині. Кожен обліковий запис має унікальну електронну адресу та автоматично згенероване ім’я користувача і може належати до однієї або кількох організацій.
Адреса електронної пошти — використовується для входу та сповіщень (після реєстрації її потрібно підтвердити)
Пароль — мінімум 5 символів
Назва організації (необов’язково) — назва організації, яка буде створена для вас
Ім’я користувача генерується автоматично з вашої електронної адреси під час реєстрації. Увійти можна як за електронною адресою, так і за іменем користувача.
Якщо ви отримали посилання-запрошення, ви можете зареєструватися через нього — ваш обліковий запис буде додано до організації, що запросила, замість створення нової.
Після реєстрації або зміни електронної адреси ви отримуєте лист для підтвердження. На підтвердження нової адреси відведено 24 години. Протягом цього пільгового періоду платформа вважає електронну адресу підтвердженою, і ви можете користуватися всіма функціями як зазвичай. Якщо протягом 24 годин ви не підтвердите адресу, частина дій (наприклад, керування пристроями або створення сповіщень) обмежується, доки ви не підтвердите електронну адресу.
У налаштуваннях облікового запису (Налаштування користувача > Особиста інформація на бічній панелі) ви можете змінити:
Ім’я, по батькові, прізвище та номер телефону
Додаткові дії з бокової панелі:
Змінити електронну пошту — потрібне повторне підтвердження протягом 24 годин
Змінити пароль — потрібен поточний пароль
Ключі API — керування токенами програмного доступу (див. Ключі API)
Видалити обліковий запис — остаточне видалення облікового запису
Мова інтерфейсу змінюється перемикачем мови в панелі навігації (англійська, українська, польська, російська). Це налаштування зберігається в обліковому записі.
Видалити обліковий запис можна в розділі Налаштування користувача > Видалити обліковий запис. Це назавжди видаляє ваш обліковий запис, ключі API та пов’язані дані.
Видалення облікового запису може бути заблоковано в таких випадках:
Ви є власником організації, в якій є інші учасники. Спочатку потрібно видалити всіх інших учасників або передати власність іншому користувачу, перш ніж видаляти обліковий запис.
У вашої організації позитивний баланс облікового запису. Зверніться до підтримки, щоб вирішити питання балансу перед видаленням.
Якщо ви єдиний учасник організації, ця організація та всі її мережі й пристрої деактивуються під час видалення облікового запису.
Кожне членство в організації має рівно одну роль. Роль визначає, що користувач може робити в межах цієї організації. Є вісім ролей, поділених на дві групи: ролі з повним інтерфейсом (доступ до повного інтерфейсу керування Overvis) та моніторингові ролі (доступ лише до спрощеного інтерфейсу моніторингу за адресою /view/).
Ці ролі дають доступ до повного інтерфейсу керування Overvis з різним рівнем дозволів.
Власник — найвища роль. Власник має повний контроль над організацією, зокрема:
Перегляд усіх даних, надсилання команд на пристрої
Створення та редагування мереж, пристроїв, параметрів, сповіщень, шаблонів, візуалізацій і звітів
Запрошення, редагування та вилучення учасників організації
Доступ до білінгу, історії платежів і балансу облікового запису
Редагування налаштувань організації
Лише власники можуть керувати учасниками організації. Кількість власників в одній організації не обмежена, але зазвичай є лише один власник.
Менеджер має ті самі можливості, що й власник, окрім керування учасниками організації. Менеджер може:
Переглядати всі дані, надсилати команди на пристрої
Створювати та редагувати мережі, пристрої, параметри, сповіщення, шаблони, візуалізації й звіти
Мати доступ до білінгу, історії платежів і балансу облікового запису
Редагувати налаштування організації
Технічний менеджер подібний до менеджера, але без доступу до білінгу та налаштувань організації. Технічний менеджер може:
Переглядати всі дані, надсилати команди на пристрої
Створювати та редагувати мережі, пристрої, параметри, сповіщення, шаблони, візуалізації й звіти
Він не має доступу до білінгу чи платіжної інформації, не може керувати учасниками та не може редагувати налаштування організації.
Оператор може переглядати дані та надсилати команди запису на пристрої, але не може змінювати структуру організації. Оператор може:
Переглядати всі мережі, пристрої, параметри та звіти
Надсилати команди запису на пристрої (наприклад, змінювати уставку або перемикати реле)
Він не може створювати, редагувати чи видаляти мережі, пристрої, сповіщення чи інші об’єкти.
Переглядач має доступ лише для читання. Переглядач може:
Переглядати всі мережі, пристрої, параметри, панелі огляду та звіти
Він не може записувати на пристрої чи щось змінювати. Ця роль корисна для зацікавлених осіб, керівників або всіх, кому потрібно бачити дані без їх зміни.
Моніторингові ролі дають доступ лише до спрощеного інтерфейсу моніторингу (розділ /view/). Користувачі з цими ролями не мають доступу до повного інтерфейсу керування. Моніторингові ролі призначені для настінних дисплеїв, польових техніків з обмеженим доступом або зовнішніх переглядачів.
Моніторинговий оператор може переглядати моніторингові панелі огляду та надсилати команди запису на пристрої.
Моніторинговий переглядач має доступ лише для читання до моніторингових панелей огляду.
Моніторинговий без параметрів може переглядати моніторингові панелі огляду, але не бачить список параметрів. Цю роль можуть призначати лише адміністратори платформи; вона недоступна у стандартних формах запрошення чи редагування учасника.
Прив’язка моніторингових користувачів до конкретного перегляду
Моніторингові ролі за бажанням можна прив’язати до конкретної візуалізації або звіту про ресурси. У разі прив’язки користувача автоматично перенаправляють на цей перегляд під час входу або переходу за межі дозволених сторінок. Це зручно для виділеного екрана, який завжди показує одну панель огляду або один звіт.
Моніторингового користувача можна прив’язати або до візуалізації, або до звіту про ресурси, але не до обох одночасно.
Для моніторингових ролей за бажанням виберіть візуалізацію або звіт про ресурси для прив’язки користувача
Надішліть запрошення
Запрошена особа отримує електронний лист із посиланням. Посилання дійне 2 дні. Якщо в неї вже є обліковий запис Overvis, її попросять увійти, після чого запрошення застосують. Якщо облікового запису немає, спочатку відкриється сторінка реєстрації.
Запросити когось одразу як власника не можна — власність можна призначити лише, змінивши роль наявного учасника.
Перейдіть до Організація > Учасники, щоб побачити всіх поточних учасників і запрошення, що очікують. У кожному рядку показано ім’я учасника (або електронну адресу, якщо ім’я не задано), його роль і дії керування.
Натисніть піктограму редагування (олівець) в рядку цього учасника
Натисніть Видалити доступ
Підтвердьте дію
Вилучений користувач одразу втрачає доступ до організації та отримує сповіщення електронною поштою. Якщо в нього немає інших членств у організаціях, для його облікового запису автоматично створюється нова порожня організація.
Ви не можете вилучити себе з організації через інтерфейс керування учасниками.
Ключі API забезпечують програмний доступ до REST API Overvis. Вони належать вашому обліковому запису користувача (не конкретній організації) і успадковують усі ваші членства в організаціях та ролі.
Щоб користуватися API, спочатку автентифікуйтеся, надіславши POST-запит:
POST /v1/authenticate/
{
"apiKey": "513cf747-eb5c-4d5f-931f-d22c9872c73c",
"password": "your_password_here"
}
У відповіді містяться токен сесії і час його закінчення. Використовуйте цей токен для автентифікації наступних запитів до API. Токен діє обмежений час без активності — кожен запит до API автоматично подовжує термін дії токена.
Якщо з моменту реєстрації або зміни електронної адреси минуло понад 24 години без підтвердження, доступ до більшості функцій обмежено. Перейдіть до Налаштування користувача > Змінити електронну пошту, знову введіть свою електронну адресу — буде надіслано новий лист для підтвердження. Ви отримуєте ще одне 24-годинне вікно для підтвердження.
Я не можу відкрити білінг або налаштування організації
Лише власники та менеджери мають доступ до інформації про білінг і можуть редагувати налаштування організації. Якщо вам потрібен доступ, попросіть власника організації змінити вашу роль. Поточну роль можна переглянути в верхній панелі навігації поруч із назвою організації.
Керування учасниками (запрошення, зміна ролей і вилучення учасників) доступне лише для ролі власника. Менеджери та інші ролі не можуть керувати учасниками. Якщо потрібно когось запросити, зверніться до власника організації.
Посилання в запрошеннях дійні 2 дні. Якщо термін дії минув, попросіть власника організації надіслати нове запрошення. Старе запрошення можна видалити на сторінці учасників.
Мене вилучили з організації, і я втратив доступ до даних
Коли вас вилучають з організації, ви втрачаєте доступ до даних цієї організації. Самі дані не видаляються — інші учасники організації й надалі мають доступ. Якщо вас вилучили помилково, попросіть власника організації запросити вас знову. Якщо у вас не було інших членств у організаціях, для вашого облікового запису автоматично створено нову порожню організацію.
Ви є власником організації, в якій є інші учасники. Спочатку передайте власність іншому учасникові (змініть його роль на власника), потім або залиште організацію, або спробуйте видалити знову.
У вашої організації позитивний баланс облікового запису. Напишіть на support@overvis.com, щоб вирішити питання балансу.
Якщо моніторингового користувача прив’язано до конкретної візуалізації або звіту про ресурси, його автоматично перенаправляють на цей перегляд. Щоб змінити або прибрати прив’язку, власник організації має відредагувати налаштування учасника й оновити прив’язану візуалізацію або звіт.
Так. Ви можете бути учасником будь-якої кількості організацій із різною роллю в кожній. Для перемикання використовуйте селектор організації в верхній панелі навігації. Дані, білінг і налаштування кожної організації повністю окремі.
Так. Кількість власників не обмежена. Проте в більшості організацій один власник. Щоб зробити іншого учасника власником, поточний власник змінює його роль на сторінці учасників.
Ви не можете вилучити себе з організації через інтерфейс керування учасниками. Якщо хочете піти, спочатку призначте роль власника іншому учасникові, потім попросіть його вилучити вас.
Чим відрізняється оператор від моніторингового оператора?
Обидві ролі можуть переглядати дані та надсилати команди запису на пристрої. Різниця в інтерфейсі, до якого є доступ:
Оператор використовує повний інтерфейс керування з доступом до всіх сторінок (мережі, пристрої, параметри, звіти тощо), але не може створювати чи редагувати об’єкти.
Моніторинговий оператор має доступ лише до спрощеного інтерфейсу моніторингу (розділ /view/), де показано панелі огляду. Він не має доступу до повного інтерфейсу керування.
Так. Використовуйте перемикач мови в панелі навігації, щоб змінити мову інтерфейсу. Доступні мови: англійська, українська, польська, російська. Це налаштування зберігається в обліковому записі й застосовується під час наступного входу.
Мова сповіщень — це налаштування на рівні організації, яке керує мовою автоматичних електронних листів і SMS (сповіщення за правилами моніторингу, системні повідомлення). Воно окреме від особистої мови інтерфейсу. Власники та менеджери можуть змінити його в Організація > Налаштування.
Ключі API належать вашому обліковому запису користувача, а не конкретній організації. Після автентифікації за ключем API ви отримуєте сесію з доступом до всіх організацій, де ваш обліковий запис є учасником, з тими самими ролями й дозволами, що й у облікового запису.
Overvis Cloud використовує модель передплаченого балансу. Ваша організація має баланс у EUR, а система щодня автоматично списує з нього вартість послуг. Коли баланс стає низьким, ви отримуєте попереджувальні листи електронною поштою. Коли кошти вичерпуються, усі ваші мережі вимикаються, доки баланс не буде поповнено.
Немає ані тарифних планів, ані щомісячної підписки — ви платите лише за ті сервіси, якими фактично користуєтеся. Сторінки білінгу доступні користувачам із ролями Власник і Менеджер; користувачі з роллю Тільки читання не мають до них доступу.
Обробка мережі — фіксована щоденна ставка за кожну мережу, тобто за кожне підключення шлюзу. Стандартна ставка — €0.50/день (€15/місяць) за мережу. Промокоди або реферальні коди можуть знижувати цю ставку (див. Коди знижок). Для розгортань із 10 і більше шлюзами доступні знижки за обсяг — зверніться до відділу продажів за деталями.
Зберігання даних — кожна мережа включає базовий обсяг сховища без доплати. Додатковий обсяг тарифікується з розрахунку €0.20/місяць за 1 000 000 точок даних. Для порівняння: логування 100 параметрів кожні 60 секунд дає приблизно 150 000 точок даних на місяць, тож більшість користувачів залишається в межах включеного обсягу.
SMS сповіщення — оплачуються за кожне повідомлення в момент відправлення відповідно до країни одержувача. Типові тарифи: €0.03–0.05 за SMS у межах ЄС, залежно від країни призначення. Вартість SMS списується з балансу одразу після відправлення. Сповіщення електронною поштою безкоштовні та без обмежень.
Щоденна плата за обробку мережі списується один раз на день за попередній календарний день. Якщо мережа була увімкнена хоча б частину попереднього дня, застосовується списання.
Баланс облікового запису (EUR) — основний витратний баланс, який поповнюється карткою, банківським переказом або готівкою.
Бонусний баланс (EUR) — акційний кредит, наприклад реєстраційний бонус. Він використовується першим. Бонусний баланс не повертається.
Обидва баланси видно в боковій панелі на кожній сторінці. Натисніть область Баланс облікового запису, щоб відкрити випадаюче меню з швидкими посиланнями:
Поповнити баланс — додати кошти на обліковий запис
Звіт про баланс — переглянути списання та орієнтовні витрати
Історія платежів — минулі платежі та завантаження квитанцій
Максимальна сума поповнення залежить від поточного балансу — система обмежує сумарний баланс облікового запису верхньою межею, наприклад €1 000. Якщо баланс уже близький до цієї межі, доступна сума поповнення буде меншою, а форма поповнення карткою може тимчасово бути недоступною.
Для оплати банківським переказом або готівкою зверніться до вашого персонального менеджера, якщо він призначений, або до підтримки Overvis. Контактні дані показуються на сторінці поповнення.
Сторінка Звіт про баланс (доступна з меню балансу в боковій панелі) — головне місце для розуміння ваших витрат. Вона має два основні блоки: прогноз витрат і історію витрат.
Цей розділ показує прогноз майбутніх списань на основі поточних увімкнених мереж. Він подається у вигляді таблиці з трьома вкладками:
Перша вкладка — прогноз витрат від сьогодні до кінця поточного календарного місяця; на мітці вкладки вказано назву місяця й скільки днів залишилось (у заголовках стовпців є до кінця місяця для прогнозу на кінець місяця)
30 днів — прогноз на наступні 30 днів
365 днів — прогноз на наступні 365 днів
Для кожної мережі таблиця показує:
Стовпець
Опис
Назва мережі
Назва мережі; вимкнені мережі показуються сірим кольором
Обробка / день
Денна вартість обробки цієї мережі
Обробка / період
Загальна вартість обробки за вибраний період
Зберігання зчитувань / день
Денна вартість зберігання
Зберігання зчитувань / період
Загальна вартість зберігання за період
Разом / день
Загальна денна вартість
Разом / період
Загальна вартість за вибраний період
Унизу таблиці показується підсумковий рядок для всіх мереж.
Під прогнозом розміщена таблиця фактичних списань і зарахувань за вибраний місяць. Використовуйте випадаючий список Місяць, щоб перемикатися між місяцями (дані доступні з місяця першого списання вашої організації).
Рядки згруповані за категоріями. Натисніть на рядок категорії, щоб розгорнути й побачити окремі записи:
Поповнення — отримані платежі (картка, банківський переказ, готівка) зі зазначенням способу оплати, номера документа-квитанції та дати. Також зарахування бонусного балансу.
Система — системні нарахування (наприклад реєстраційний бонус).
Обробка мережі — щоденні списання за мережі. Можна розгорнути до окремих щоденних записів із датою виставлення рахунку та кодом знижки (якщо є).
Зберігання даних мережі — витрати на зберігання даних за мережу.
SMS сповіщення — списання за SMS, згруповані за номером телефону, з можливістю розгорнути до окремих повідомлень із позначками часу та кількістю.
Кешбек — реферальні кешбеки, за наявності (див. Коди знижок).
Інше — інші коригування.
Кожен рядок має чотири стовпці:
Стовпець
Опис
Опис
За що саме було списання або зарахування
Кількість
Кількість окремих записів у групі
Сума
Сума в EUR; зеленим показуються зарахування, червоним — списання
Бонус
Зміна бонусного балансу, якщо вона була
Унизу таблиці показуються:
Всього — чиста зміна за вибраний місяць
Баланс на початок періоду — баланс облікового запису та бонусний баланс на початку місяця
Баланс на кінець періоду — баланс облікового запису та бонусний баланс на кінці місяця
Система відстежує ваш баланс і надсилає сповіщення електронною поштою, коли залишку на балансі вистачає приблизно на 30 днів, 10 днів і 5 днів послуг за поточною денною ставкою.
Коли баланс повністю вичерпано, тобто дорівнює нулю або нижче, надсилається фінальний лист про вичерпаний баланс з прямим посиланням на сторінку поповнення.
Ви можете вказати, хто саме отримуватиме білінгові сповіщення, задавши електронну адресу для білінгу в налаштуваннях організації.
Якщо сума балансу облікового запису та бонусного балансу падає до нуля або нижче під час щоденного білінгового циклу:
Усі мережі організації вимикаються білінговою системою.
На електронну адресу, вказану у платіжній інформації, надсилається повідомлення.
Вимкнені мережі перестають опитувати пристрої — нові зчитування не збираються й сповіщення не спрацьовують.
Відправка SMS також блокується.
Історичні дані при цьому не втрачаються — вони зберігаються відповідно до налаштувань зберігання організації.
Щоб відновити роботу: поповніть баланс облікового запису. Щойно баланс знову стане додатним, знову увімкніть мережі вручну зі сторінки налаштувань кожної мережі. Система не вмикає їх автоматично.
Overvis підтримує промокоди та реферальні коди знижок, які зменшують денну ставку за обробку мережі. Код знижки застосовується до конкретної мережі й задає для неї окрему нижчу денну ціну.
Код знижки може мати:
фіксовану ставку на день;
необов’язковий термін дії;
необов’язкове обмеження за кількістю застосувань;
необов’язкову кінцеву дату реєстрації.
Коли термін дії коду закінчується, денна ставка мережі автоматично повертається до стандартної.
Деякі коди знижки включають реферальний кешбек — щоденне зарахування на баланс організації, яка запросила клієнта, за кожен день активності запрошеної мережі. Кешбек обчислюється тільки з небонусної частини денного списання. У звіті про баланс такі записи показуються в категорії Кешбек.
У налаштуваннях організації є розділ Платіжна інформація, у якому менеджери можуть вказати дані для квитанцій та рахунків:
Назва організації / контактна особа (обов’язково)
Код ПДВ (VAT) — ідентифікаційний номер ПДВ
Країна і Місто
Адреса компанії і Поштовий індекс
Телефон
Email (обов’язково) — квитанції, рахунки та білінгові сповіщення надсилаються на цю адресу
Щоб змінити ці поля, перейдіть до Налаштування організації (натисніть назву організації в боковій панелі, потім Налаштування організації) і прокрутіть сторінку до розділу Платіжна інформація.
Баланс організації, тобто баланс облікового запису плюс бонусний баланс, впав до нуля або нижче під час щоденного білінгового циклу. У такому випадку система автоматично вимикає всі мережі.
Що робити: відкрийте Звіт про баланс, перегляньте списання, які призвели до нульового балансу, поповніть баланс і вручну знову увімкніть мережі на сторінці налаштувань кожної мережі.
поточний баланс облікового запису близький до максимально допустимого. Система обмежує сумарний баланс, тож доступна сума поповнення зменшується зі зростанням балансу. Якщо баланс уже близько до межі, форма карткового поповнення може показувати, що поповнення тимчасово недоступне;
банк відхиляє транзакцію. Зверніться до банку, щоб переконатися, що картку можна використовувати для міжнародних платежів у EUR.
Що робити: спробуйте меншу суму. Якщо форма карткового поповнення недоступна, скористайтеся банківським переказом або зверніться до підтримки.
Я не бачу сторінки білінгу або баланс у боковій панелі
Щоденне списання покриває попередній календарний день. Якщо мережа була увімкнена хоча б частину вчорашнього дня, сьогодні ви все одно побачите списання.
Що робити: це нормальна поведінка. Після фінального списання нових нарахувань за цю мережу не буде.
Для SMS потрібен достатній баланс. Якщо баланс занадто низький, відправка SMS блокується.
Що робити: перевірте баланс, за потреби поповніть його й перевірте Налаштування сповіщень. За потреби перейдіть на сповіщення електронною поштою — вони безкоштовні та без обмежень.
Білінгова система запускається один раз на день і списує оплату за кожну увімкнену мережу за попередній календарний день. Точний час запуску може трохи відрізнятися, але списання завжди стосуються попереднього дня.
Чи можна отримати повернення невикористаного балансу?
Відкрийте Звіт про баланс через меню балансу в боковій панелі. У блоці історії витрат показані всі списання та зарахування, згруповані за категоріями. Натисніть на будь-яку категорію, щоб побачити деталізацію.
Ні. Коли баланс закінчується, мережі вимикаються й перестають збирати нові дані, але всі раніше записані дані залишаються збереженими відповідно до налаштувань зберігання даних вашої організації. Після поповнення балансу та повторного ввімкнення мереж збір даних поновиться.
Так. Ви можете вимкнути окремі мережі в їхніх налаштуваннях. Для вимкнених мереж щоденна плата за обробку не нараховується. Дані, конфігурації пристроїв і налаштування сповіщень залишаються незмінними. Увімкніть мережу знову будь-коли, щоб відновити роботу.
Коди знижки застосовуються окремо до кожної мережі. Відкрийте сторінку мережі, натисніть Застосувати код знижки, введіть код, перегляньте зміну ціни на сторінці підтвердження та натисніть Підтвердити. Після цього код і його вплив на ціну буде видно на сторінці мережі. Вручну застосований код можна в будь-який час вилучити на тій самій сторінці.
Чому форма поповнення показує нижчий максимальний ліміт, ніж я очікував?
Максимальна сума поповнення дорівнює налаштованому ліміту мінус ваш поточний баланс. Наприклад, якщо ліміт становить €1 000, а на балансі зараз €800, поповнити можна максимум на €200.
Вартість SMS залежить від країни номера одержувача. Сума списується з балансу в момент відправлення SMS. Усі такі витрати можна побачити у Звіті про баланс у категорії SMS сповіщення.
Overvis provides REST-like HTTP API with request payload and response encoded in JSON format.
Base API URL is https://ocp.overvis.com/api/v1/. Further documentation will list the requests as
entrypoints with paths that should be concatenated to the base API URL. E.g. API version retrieval
endpoint is /version/, that means, the full URL of the version request should be
https://ocp.overvis.com/api/v1/version/.
All API requests require Content-Type: application/json HTTP header set.
All POST requests require HTTP payload to be a UTF-8 encoded plain-text with semantically-correct
JSON content. Empty payload is not allowed for POST requests, send null if endpoint requires no
data.
All requests return HTTP status code 200 if executed correctly.
5xx status codes represent server-side unexpected errors and are automatically reported to the
developers.
4xx status codes represent errors that are client’s concern and should be dealt with on the
client side. These errors have JSON payload which look like this:
{
"errorCode": "ErrCode",
"errorMessage": "Human-readable error message in english."
Manually updates network fields. This is a low-level endpoint for updating specific fields like
name, description, or connection details without necessarily re-applying a full solution.
Endpoint
POST /net/:netId/change/
Parameters
Path Parameters
netId (number, required): The ID of the network.
Body
All fields are optional:
name (string): Network name.
description (string): Network description.
devicePasswords (string[]): Controller passwords.
controllerModbusUnitId (number): Modbus Unit ID (0-255).
sku (string): Device SKU.
solution (string): Solution type.
connectionType (string): direct, backward, or vpn.
mac (string): MAC address.
ip (string): IP address.
port (number): Port.
connectCode (string): Connect code.
maxInflightRequestsNum (number): Max parallel requests.
Authorization
Permission: manager (edit access to org objects)
Requires a valid session token in the Authorization header.
Response
status: ok.
netSlug: Current slug of the network.
Example Request
{
"name": "Updated Name",
"description": "Manual update"
}
POST /net/:netId/connection-status/ - Get Network Connection Status
Returns specified number of data points for a requested parameters on a given time range.
Endpoint
POST /readings/dispersed/
Parameters
Body
paramIds (integer[], required): List of parameter IDs.
from (string, required): Start date of the check range (ISO 8601).
till (string, required): End date of the check range (ISO 8601).
points (integer, required): Number of points to take in this date range (for each parameter).
Maximum: 1000.
Response
Result is an array of “segment” records. Each record is an array where the first item is a ISO 8601
datetime, and the second item is an array of parameter values during that segment in the order of
paramIds provided.
Returns stored data points for a requested time range for a given parameter.
Endpoint
GET /readings/get/
Parameters
Query Parameters
paramId (integer, required): ID of the parameter.
from (string, optional): Start date of the range (ISO 8601). If omitted, response will contain
last pointsLimit data points up to till date.
till (string, optional): End date of the range (ISO 8601). If omitted, end date will be the
current time.
pointsLimit (integer, optional): Limit on the number of the returned data points. Maximum and
default: 1000.
Response
Result is an array of data points. Each record is an array where the first item is a ISO 8601
datetime, and the second item is the parameter value (number or null). Data points are sorted by
dates in a descending order.
Example Request
GET /readings/get/?paramId=284&from=2020-01-01T00:00:00Z&till=2020-08-17T00:00:00Z&pointsLimit=100
Example Response
[
["2019-07-26T16:28:00Z", 7.0],
["2019-07-26T16:33:42Z", 7.0],
["2019-07-26T16:39:24Z", 7.0]
]
POST /readings/min-max-range/ - Range of Readings Values for a Given Period
Saves the data entered by the user in the visualization.
Endpoint
POST /vis/:visId/data/save/
Parameters
Path Parameters
visId (number, required): ID of the visualization.
Body
code (string, required): Key for the value.
value (string, required): Value to be saved.
Response
Returns an empty object on success.
Example Request
POST /vis/7/data/save/
{
"code": "roomName",
"value": "Room 1"
}
Example Response
{}
Overvis Cloud Documentation
Device Templates Reference
This reference covers the technical specification of the device template Excel file format used for import and export in Overvis Cloud. For a general overview of how templates work, see the Device Templates guide.
Device templates use the Microsoft Excel .xlsx format. Only .xlsx is accepted — older .xls files, CSV, and other formats are not supported.
A template workbook contains two required sheets and two optional sheets. The sheet names are exact and case-sensitive — any unrecognized sheet name causes an import error.
The Info sheet stores device-level metadata and communication defaults. Values are read from fixed cell positions (not by column headers).
Row
Column A (1) — label
Column B (2) — value
Required
1
Manufacturer:
Manufacturer name (up to 200 characters)
No
2
Model:
Template name / device model (1–200 characters)
Yes
3
Device Version:
Version string (up to 50 characters)
No
4
Category:
Category text (up to 200 characters)
No
5
(empty)
6
Read Group Size:
Integer 1–255
Yes
7
Write Function:
normal, always-6, or always-16
Yes
Description is stored in column D (4), starting from row 2. If the description is longer than 32,000 characters, it is split across multiple cells in that column (row 2, row 3, etc.). On import, all cells in column D below row 1 are concatenated.
Template name (row 2) is the primary identifier. Together with manufacturer and version, it forms a unique identity within a scope (global or per-organization). Importing a template with the same name+manufacturer+version as an existing one in your organization replaces the existing template.
Read group size controls how many consecutive Modbus registers Overvis combines into a single read request. A value of 1 reads each parameter individually. Higher values (e.g. 16) batch adjacent registers into fewer requests, which speeds up polling but requires the device to support multi-register reads across that range.
Write function determines which Modbus function code is used when writing parameter values:
Value
Meaning
normal
Overvis chooses automatically — function 06 (Write Single Register) for single-register values, function 16 (Write Multiple Registers) for multi-register values.
The Params sheet defines all device parameters. Row 1 is the header row; data starts from row 2. Columns are matched by header name (not by position), so column order does not matter.
Grouping label (up to 200 characters), e.g. Inputs, Configuration, Status.
Mnemonic
label
Short identifier (up to 20 characters), e.g. T1, P.out. The column can also be named Label.
Description
description
Longer explanation of what this parameter represents.
Units
unitName
Measurement units (up to 20 characters), e.g. °C, kW, bar, %.
Multiplier
multiplier
Scaling factor applied to the raw register value. displayed = raw × multiplier + shift. A value of 1 is treated as “no multiplier.” Not allowed for bit, string, IP address, and MAC address types.
Shift
shift
Offset added after multiplying. A value of 0 is treated as “no shift.” Same type restrictions as multiplier.
Decimal Precision
decimalPrecision
Number of decimal places to display (integer 0–20).
Min
minValue
Minimum expected value (for display and validation).
Max
maxValue
Maximum expected value (for display and validation).
Bit Position
bitPosition
For bit and bits types: which bit within the register to start from (0–15). Required for bit and bits, not allowed for other types.
Bits Num
bitsAmount
For bits type only: how many consecutive bits to extract (1–16). Required for bits, not allowed for other types including bit.
Parameter text fields can be translated into additional languages. Add translation columns by appending a space and a language code to the base column name:
Base column
Translation column examples
Name
Name uk, Name pl, Name ru
Category
Category uk, Category pl, Category ru
Description
Description uk, Description pl, Description ru
Units
Units uk, Units pl, Units ru
Supported language codes: en, uk (Ukrainian), pl (Polish), ru (Russian). English is the base language — the main column values are always English, and en translation columns are not needed.
A translation column requires the corresponding English column to have a non-empty value in the same row. You cannot translate an empty field.
The following types do not support multiplier or shift values: bit, byte-str, word-str, byte-ipaddr, word-ipaddr, byte-macaddr, word-macaddr. Setting a multiplier or shift on these types causes a validation error.
When the Type is enum, the Represent As cell defines mappings from numeric values to display text. The cell must contain multiple lines, each with fields separated by semicolons (;):
<value>;<display text>
<value>;<display text>;<description>
The description is optional. Example cell content (each line in the same cell):
0;Stopped
1;Running
2;Error;Critical fault detected
3;Maintenance;Scheduled service mode
Rules:
English mappings are required — the base Represent As column must be filled.
Each numeric value must be unique within the English mappings.
To provide enumeration mappings in other languages, add columns named Represent As XX where XX is the language code in uppercase:
Represent As UK — Ukrainian
Represent As PL — Polish
Represent As RU — Russian
Each translation column uses the same semicolon-and-newline format as the base column. The numeric values must match the English values exactly — the same set of values, in any order. Example Represent As UK cell:
When the Type is bit, the Represent As cell can contain a system representation code — a short text identifier referencing a built-in bit representation (e.g. showing On/Off or Open/Closed instead of 1/0).
The value must reference an existing system bit representation code. If the code is not recognized, import fails with an error listing the available codes.
This is distinct from enum mappings: the cell contains a plain string (no semicolons or newlines), and it is only valid for bit type parameters.
The optional Visualization sheet contains the HTML/JavaScript source code for an embeddable device visualization. Row 1 is a header; the actual content starts from row 2 in column A (1).
Long content is split across multiple cells (row 2, 3, etc.) at 32,000-character boundaries and concatenated on import.
When the template is applied to a device, the visualization source can contain {{device_id}} and {{network_id}} placeholders, which Overvis replaces with the actual IDs.
Overvis validates the template during import at multiple levels. If any validation fails, the template is not imported, and errors are reported with their sheet name, row, and cell reference.
Each parameter row is validated independently. A row with errors is skipped, but other rows are still validated (all errors are collected and reported).
Templates are always imported into the current organization (never directly to the global library). To make a template global, use the separate “Make global” action in the web interface.
If a template with the same name, version, and manufacturer already exists in the organization, the existing template and all its parameters, translations, and enumeration definitions are replaced with the imported data.
Import is atomic: if any validation error occurs, no changes are made.
Exporting a template produces an .xlsx file with the same structure described above. The exported file can be edited in any spreadsheet application and re-imported.
The export includes:
Info sheet with all device metadata.
Params sheet with all parameters, including any translation columns that have data.
Visualization sheet (only if the template has a device visualization).
Alerts sheet (only if the template has alert YAML).
Exported files use frozen header rows and auto-filters on the Params sheet for easier navigation.
Overvis visualization source code is an HTML snippet. This snippet code is not processed on the
server-side and is embedded inside the Overvis page HTML as-is. It can contain JavaScript inside
<script> tags, CSS inside <style> tags, or SVG images inside <svg> tags. It should not
contain <!...>, <html>, <head>, <body> or other header tags because they are already
present on the Overvis page.
There are several extension tags and attributes that are added by the JavaScript to the Overvis
page for simplifying visualization data binding. The following reference will list all such
additions. Visualization code is not required to use them and can directly call Overvis API
instead.
In the reference below, the following syntax: update-period-sec="{{number}}" means that the
double curly braces should be replaced by the referenced value type. In this example, the correct
usage will be something like this: update-period-sec="60".
After the visualization is loaded, it gathers all used data bindings from the source code and
starts the automatic data refresh process. Visualization data is being refreshed every 10 seconds
by default.
The next refresh cycle doesn’t start before the previous one is finished. The length of the refresh
cycle depends on how many parameters are being read from the devices and the connection quality.
So, if there are many parameter readings to be requested at once from the slow channel, the refresh
cycle may take more time than planned. To optimize the refresh cycle time, prefer loading parameter
values from the Overvis database instead of reading them from the devices directly.
Those functions are added to the global window object and accessible everywhere in the code:
Function
Description
preInitViz(cb)
This function is called after the visualization source code is embedded in the page, but before the references and aliases are being resolved. This function can add additional binds or modify visualization source code. cb is a callback function that should be invoked at the end of preInitVis.
onVizUpdate(data)
This function is invoked after any bound data is received (at least after each refresh cycle). data is an object with references as keys.
writeParamValue(ref, val, cb, refreshAll)
Send parameter value to the device. ref - parameter reference; val - value as a string; cb - a function that should be called after the writing process will be finished; refreshAll - boolean, if true - refresh all data on the visualization, if false - refresh only the changed parameter.
All referenced objects should exist in Overvis. For example, you can’t reference the network by
IP/MAC address if the network with this IP or MAC is not created under your account.
Networks can be referenced in one of the following ways:
By the slug string. Slug is a unique code assigned to each object. It can be taken from the URL of the parameter settings page in Overvis.
~{{alias name string}}
~someParam
Using alias. Alias with this name should be provided by the alias tag in visualization code.
{{device reference}}>{{address}}
12-34-56-78-90-ab>111>123
By the parameter address inside the device. Note, this parameter should exist in the device parameters list in Overvis. {{address}} can also contain additional specifications, see below.
Parameter address has the following extended syntax:
Any container tag in HTML/SVG code has an additional possible attribute:
param-value="{{paramRef}}:{{options}}"
This attribute specifies that the contents of this tag should be replaced by the value of the
parameter referenced by {{paramRef}}. By default, this value will be taken from the Overvis
database of last known parameter values.
{{options}} is a comma-separated list of flags. Currently supported flags:
r - read data directly from the device,
p{{number}} - display data with specified precision.
Also, the following attribute can be used in conjunction with param-value:
param-value-mod="{{evalExpr}}"
It applies the quick mathematical expression evalExpr where the current value will be passed as
x.
Placeholder text loading... will be replaced with the value of parameter 123 of the device 111 in the network 12-34-56-78-90-ab. Value will be taken from the database, so this parameter should be marked as tracked in the system.
<div param-value="12-34-56-78-90-ab>111>123:r" />
The value of the parameter will be read from the device on each refresh. The parameter can be untracked.
By default, the value of the parameter is taken from the Overvis database, not read from the
device. This makes visualization refresh much faster, but it has the following consequences:
Only tracked parameter values are stored in the database.
The update interval of the value depends on the update of the device background readings
(specified in the device settings) and not on the visualization refresh period.
If there is no network connection, the last known value will still be displayed.
If the parameter is untracked or has never been read yet, NOLR will be displayed instead.
If you want to perform an actual reading of the device parameter, set the :r option at the end.
In this case:
It doesn’t matter if the parameter is tracked or untracked.
The value of the parameter is read from the device after each visualization refresh cycle
(usually every 10s).
If the network connection is missing, NORV is displayed.
Several special codes are returned by the server on various exceptions. You may see them instead of
the parameter value:
NON - parameter network does not exist.
NOP - parameter does not exist.
NOLR - no last reading for the parameter in the database (parameter has never been read). That
usually means that this parameter is untracked. Mark it as tracked or use real-time value
reading.
NORV - error reading parameter value from the device. Try reading it on the device parameters
list page to see the actual error.
React on the parameter value change: on-param-value="..." attribute
This attribute toggles the property or style specified by {{property}} between {{valueOn}} and
{{valueOff}} depending if the parameter referenced by {{paramRef}} satisfies the
{{condition}}.
{{condition}} can be one of the following:
>value
<value
=value
!=value
>=value
<=value
or {evalExpr} where evalExpr in curly braces can be any boolean JS expression with current
parameter value provided as x. See examples below.
If the condition is satisfied, the property and the style by the name provided by {{property}}
will be set to {{valueOn}}. Otherwise it will be set to {{valueOff}}.
{{options}} is a comma-separated list of flags. Currently supported flags:
r - read data directly from the device. By default it is taken from Overvis database of last
known parameter values.
Set text style color to red if the parameter value is greater than 10. Otherwise - green. Value is taken from the Overvis database, so the parameter should be tracked.
Text "alert!" will be visible if the parameter value is less than 20. The value is read from the device in real-time. By default (until the value is loaded), the text is hidden.
This attribute toggles the property or style specified by {{property}} between {{valueOn}} and
{{valueOff}} depending if the network referenced by {{netRef}} has connection or not.
If the parameter {{paramRef}} has the value different from {{defaultValue}} it should be set
to {{defaultValue}}, otherwise {{valueOn}}.
Example: <button on-click="toggle-param:12-34-56-78-90-ab>1>123:0:1:g">Toggle power</button> -
toggle parameter 123 between 0 and 1, where 0 is the default value. After the toggle, full
visualization refresh is done (because of the :g option at the end).
edit-param:{{paramRef}}:{{options}}
Open the dialog window to edit and save the value of the parameter.
Add {{amount}} to the value of the parameter {{paramRef}} and save the new value. Amount can
be negative. The parameter is refreshed before being incremented and written to the device.
edit-visdata:{{key}}
Open the dialog window to edit and save the visualization string with the key {{key}}. See
visualization strings table.
{{options}} is a comma-separated list of flags. Currently supported flags:
g - after the action is completed, do a complete refresh of all visualization data. If omitted,
by default - only the affected parameters will be refreshed.
An additional tag can be used anywhere in the code:
<aliasname="{{aliasName}}"... />
Alias tag should contain name attribute which specifies the name of the alias and one of the
following attributes which specifies the alias target:
network="{{networkRef}}"
device="{{deviceRef}}"
param="{{paramRef}}"
vis="{{visualizationRef}}"
Aliases are used when the object has to be referenced several times in the code. It helps to make
the references more understandable by giving them names. Also, it allows to quickly change the
target object, for example, if the network controller was replaced and the network MAC was changed.
Aliases can be used in references by specifying alias name after ~ (tilde symbol). Also, aliases
can be used inside other aliases, e.g. network alias can be used inside the device alias.
Visualizations can store string values to the Overvis database as key-value pairs. All stored
values are loaded during the visualization start-up if use-vis-data="yes" specified in
visualization settings tag.
To edit the value, use Overvis API. Also, the value can be edited by the user through the dialog
window. To open the dialog window, add the on-click="edit-visdata:{{key}}" attribute to the
button.
The following attribute allows you to use stored strings.
Text replacement: text-replacement="..." attribute
This example shows the room name as "Main room" by default, but also allows to edit it by
clicking on the "Edit". Edit will persist between page refreshes and different accounts accessing
this visualization.
A device template can include an alert template — a YAML definition of alerts that Overvis creates automatically when the template is applied to a device. This lets you ship standard monitoring rules (temperature limits, connection loss detection, etc.) together with the parameter configuration.
When applying a template, the user controls how alerts are handled — add new alerts, replace existing ones, or skip alert creation entirely. See Applying a template — Apply options for details. After creation, the alerts are independent and can be freely customized.
Documentation bellow assumes that you are changing one of the templates owned by your organization. If you want to modify the global template, accessible to all Overvis users, you have to copy it under your account. To do this, just download the template as an Excel file and upload it to your templates.
Manually created templates can be found in the local device template library. To access it, click on the “Your templates” link under the “Templates” section in the navigation.
Find the device template you want to modify and click the gear icon on the left to access the template settings.
On the settings page, scroll down until you find the “Alarms template YAML” textbox. Put the template code inside that box. The structure of this YAML is described in a later section of this document.
Save the changes. If the alerts template interpreter will encounter any errors it will report the details below the field.
description: "This alert tracks the value of the input 1. If value is less than 5 or larger than 10 during 5 minutes, SMS will be sent to the default phone. Also, if the default email address is specified, email will be sent right after the event starts and resolves."
level: "warning"
conditions_logic: "any"
conditions:
- param: "150h"
condition: "<"
value: "5.0"
- param: "150h"
condition: ">"
value: "10.0"
actions:
- kind: "sms"
recipient: "-"
stage: "init"
timeout_minutes: 5
- kind: "email"
recipient: "-"
stage: "init"
- kind: "email"
recipient: "-"
stage: "resolved"
- name: "No connection!"
description: "This alert checks connection to the network by verifying if the tracked firmware version parameter is reading correctly. If there was no reading during 5 minutes, Voice message will be sent to the default phone number."
Each event should contain one or more conditions (specified in the “conditions” field). Conditions determine when this event starts and resolves. Each condition is described as an object with following fields:
Name
Required
Type
Description
param
yes
string
Parameter address this condition will check. Syntax is described below. Parameter with this address should be listed in the template. Also, parameter should be tracked for this condition to work.
condition
yes
string
Logical operator that will compare parameter reading and the condition value specified in the “value” field. Allowed operators: >, >=, <, <=, =, !=, err. err checks for reading errors and doesn’t require “value” to compare to.
value
yes (if condition is not err)
string/number
Value to compare parameter reading to.
param is a string in one of the following formats:
<register address><register kind>
<register address>.<bit address><register kind>
Where “register kind” is one of:
h - holding register
i - input register
d - discrete input
c - coil
Examples of the condition objects:
YAML
Condition will be enabled if…
{param: "123h", condition: ">=", value: "10.5"}
Value of the parameter with the holding register address 123 is larger or equal 10.5 (comparison takes in account parameter multiplier and parameter type transformation).
{param: "123.5i", condition: "=", value: 1}
Value of the parameter that corresponds to the bit #5 of the input register address 123 is equal to 1.
{param: "1c", condition: "err"}
Reading of a parameter with the coil address 1 resulted in an error (either no connection, or MODBUS exception during parameter reading).
Each event should have one or more actions (specified in the “actions” field). Actions determine how the system should behave during each stage of the event. Each action corresponds to the one of the four “stages”:
init - event just started and is active.
not_confirmed - event was not confirmed during specified period of time. Confirmation period is specified in the action’s timeout field.
confirmed - event was confirmed by user (by SMS or clicking on the link in the notification email).
resolved - event resolved and is not active anymore.
Each action is described as an object with the following fields:
Name
Required
Type
Description
kind
yes
string
Kind of the action. Valid values: sms, email, call.
recipient
yes
string
Recipient email address or phone number (depends on the action kind). - value (minus sign) corresponds to the default email or phone.
stage
yes
string
Stage of the event when this action will be executed. Allowed values: init, not_confirmed, confirmed, resolved (see above).
timeout_minutes
no
number
Timeout in minutes before executing this action (positive integer). If an event leaves the appropriate stage during this timeout (for example “not confirmed” event resolves or being confirmed), action is never executed.
There are two ways to attach alert YAML to a device template:
In the Excel file — add an Alerts sheet to the template workbook. Row 1 is a header; the YAML goes in column A starting from row 2. See the Device Templates Reference — Alerts sheet for details.
In the web interface — open the template settings page and enter the YAML in the “Alarms template YAML” text field. Errors are reported below the field on save.
