Key concepts
This page defines the terms used throughout the documentation. Come back here whenever a term isn't clear.
Space (tenant)
A Space is a single customer's isolated environment, reachable through its own subdomain (e.g. acme.trackle.space). Everything that follows (templates, assets, dashboards, users) lives inside a specific Space.
Template
A Template (Asset Template) is the blueprint assets are created from: it defines which variables an asset of this type will expose, how it integrates with physical devices (Trackle, MQTT, HTTP or Seneca), which alarm rules monitor those variables, and which dashboards are available to visualize them.
Learn more in the Template chapter.
Asset
An Asset is a real instance created from a template: a specific plant, a specific machine, a specific sensor. Every asset:
- belongs to a template (which defines its structure);
- can be connected to a physical device through its External ID;
- can belong to one or more organizations/groups;
- has its own detail page with parameters, history and alarms.
Learn more in the Asset chapter.
Device (physical connection)
"Device" refers to the physical device connected to an asset (a Trackle module, an MQTT client, a Seneca device, a device calling the HTTP APIs). The connection happens through an identifier that in the interface is always called External ID.
Organizations and groups
Organizations and groups let you segment assets (for example by end customer, site, geographic area) and assign visibility permissions to users.
Dashboard
A dashboard is a composition of widgets (charts, live values, maps, etc.) that visualizes the data of one or more assets. Dashboards can be:
- template dashboards: shared by all assets of a template;
- personal dashboards: created by a single user for their own use.
Learn more in the Dashboard chapter.
Alarm rules and alarm history
Alarm rules define conditions on a template's variables (e.g. "temperature > 80°C") and are shared by all assets of that template. When a condition occurs on a specific asset, an alarm is generated and appears in that asset's alarm history. Learn more in Alarms & Alerts.
User roles
Users in a Space have one of the following roles:
| Role | Description |
|---|---|
| Admin | Full access: managing templates, alarm rules, dashboards, users, billing and settings. |
| Support | Can view templates, assets and alarm rules to assist customers, without being able to modify them. |
| Customer | End user who manages their own assets (parameters, personal dashboards) without access to global settings. |
AI Assistant
The AI assistant is a panel available on every page (and as a dedicated Home view) that answers questions about your Space and can propose actions (creating an asset, a dashboard, an alarm rule...) which are always shown for confirmation before being executed. Learn more in AI Assistant.