New: the AI firewall watches the whole platform and explains each incident in plain words. See how it works

Core concepts

The building blocks of Hermetry and how they connect: organisations, devices and profiles, readings, sites, boards, alarms, rules and flows.

This page explains the main parts of Hermetry and how they work together. Each part has its own section in these docs; the links take you there.

The picture in one paragraph

Your organisation lives in one region. Its devices send telemetry (time-stamped readings) and keep attributes (values that are not time series). Every device follows a device profile, which says how it connects, which keys it sends and which alarm rules apply to it. You place devices on sites and other assets, show them on boards (dashboards) and SCADA drawings, and react to what they send with alarms, the Rules card and flows. Programs reach the same data through the REST API, webhooks and AI assistants (MCP).

Organisation, members and region

ConceptWhat it isRead more
OrganisationYour company’s own space in Hermetry, with its members, devices and data. Some messages call it a tenant or a workspace.Organisations and tenants
Member and roleA person in the organisation. The role (and the groups and access policies) decide what they may see and do.Users and roles
RegionThe deployment your organisation lives in: EU, US or Türkiye. Your data stays there.Regions and data residency
PlanWhat your organisation may use and how much: devices, messages, retention and modules.Plans and the IoT add-on

Devices and how they connect

ConceptWhat it isRead more
DeviceAnything that sends data to Hermetry or receives commands from it: a sensor, a meter, a router, a camera.Devices
Device profileThe template of a kind of device: how it connects, its keys, limits, alarm rules, commands and firmware settings. Change the profile and every device that uses it follows.Device profiles
CredentialsHow a device proves who it is: an access token (MQTT username or HTTP bearer token) or a device certificate.Device credentials
ConnectionMQTT over TLS, the device HTTP API, LoRaWAN through Hermetry’s network server, or SNMP polling and field protocols through a gateway.Choose how to connect
Gateway and child deviceA gateway reports for other devices (child devices) that do not connect themselves.Gateways and devices behind a gateway
Licensed deviceA gateway or router sold for Hermetry, claimed with its serial and claim code and managed remotely.Licensed devices

Data a device sends and keeps

ConceptWhat it isRead more
TelemetryTime-stamped readings, such as a temperature every minute. Kept for the retention your plan allows, with minute, hour and day summaries for long time ranges.How readings are stored
Telemetry keyThe name of one reading, such as temperature. Every key is a separate series.Telemetry keys
AttributeA named value on a device that is not a time series. Client attributes come from the device, shared attributes are set in Hermetry and sent to the device, server attributes are only for the platform and people.Attributes
CommandA request sent to a device, such as a reboot or a set-point, with a state from Queued to Successful.Sending commands to devices
Firmware updateA new firmware sent to devices over the air, in waves.Firmware updates (OTA)

Places: sites and assets

ConceptWhat it isRead more
AssetA place or thing in your site tree: a site, building, floor, room, area, line, machine or a kind of your own.Asset hierarchy
SiteThe top asset of a location. Its status rolls up from everything placed under it.Site status
PlacementWhere a device is in the tree. Boards and rules use it to find “the devices of this place”.Placing devices

Seeing the data

ConceptWhat it isRead more
Board (dashboard)Pages of cards: charts, values, tables, maps and controls, with parameters so one board serves every site.Dashboards
Card (widget)One element on a board. Your organisation can also keep widgets of its own.Widgets
SCADA drawing and 3D viewA plant screen made of industrial symbols, bound to live readings, in 2D or 3D.SCADA

Reacting to the data

ConceptWhat it isRead more
AlarmA record that a condition on a device is abnormal, with a severity, a status (open, acknowledged, resolved) and a timeline. One active alarm per device and type.Alarms
Alarm ruleA rule on a device profile that opens and clears alarms from readings, or when a device goes offline.Alarm rules on device profiles
Rules cardA dashboard card with simple “when, only if, then” rules for the devices of a place.The rules engine
FlowA program of connected blocks that reacts to device messages, schedules or webhooks. Every device message enters the root flow, which stores the data and runs the alarm rules.Flows
NotificationA message to people: the bell, e-mail, SMS, browser push or a chat platform.Notifications

Connecting other systems

ConceptWhat it isRead more
API keyA credential for programs calling the REST API, with chosen permissions, an expiry and optional allowed networks.Authentication
WebhookAn HTTPS call Hermetry sends to your system when an event happens, or a URL that starts a flow.Webhooks
AI assistant (MCP)An AI assistant you connect to your organisation; it works with your rights and nothing more.AI assistants and MCP

Starting points