Skip to main content

Tenant, Space, Point, Signal

Naming

As a simple model, think about as:

TypeDescription
TenantOrganization
SpaceFolder
PointA signal sender
SignalData package with timestamp

Hierarchy

Spaces can have subspaces, but there is only one level of points and signals. They relate to each orther as this:

Space, point, signal hierarchy

Filtering

To get the desired signals, you can filter on space, point and signaltype, as well as combinations of them. Space, point, signal filtering

Signal

A signal represent a single measurement or data at a certain time.

{
"id": "234f234234cg25hg23v523gvh23",
"pointId": "234f234234cg25hg23v523gvh23",
"type": "air temperature",
"unit": "CELSIUS_DEGREES",
"value": "18.26",
"timestamp": "2021-16-11T13:46:45.548+00:00",
}

Point

A point represents the origin of one or more signals. Often it represents a physical device, but it could also represent something like a combination of devices, an analysis result or similar.

{
"id": "234f234234cg25hg23v523gvh23",
"externalId" : "123",
"name": "temp_sensor_53",
"metadata": { "key" : "value"},
"spaceId": "234f234234cg25hg23v523gvh23",
}

Space

A space can have subspaces and holds zero or more points. You can think of spaces as a folder structure to help organize your points.

{
"id": "234f234234cg25hg23v523gvh23",
"name": "garage",
"parentId": "234f234234cg25hg23v523gvh23",
"metadata": {"key" : "value"},
}

Tenant

Dimension Four is a multi-tenant SaaS service. Each tenant has its own set of spaces, points, signals, etc. A business typically has one tenant, but larger organizations can have many, e.g. one for each region.