Step-by-step: connecting a machine

This guide shows step-by-step how to connect a machine: from the configuration of the device to the first measured values in the chart and the first process in the process analysis. As an example, it uses a milling center with the name Milling Center 04 and the technical ID demo-mc-04. Replace these values with the names of your machine.

Overview

Step Task Result

Step	Task	Result
1	Plan the identifiers	Technical ID and measuring point names
2	Configure the device	Measuring points, device type and device
3	Get a technical client	Client ID, secret and the permission `measurements:write`
4, 5	Send data	`202 Accepted` from the machine data API
6	Check the result	Values in the measurement chart, processes in the process analysis
7	Watch the data	Rules, events and email notifications

Plan the identifiers

Technical ID and measuring point names

Configure the device

Measuring points, device type and device

Get a technical client

Client ID, secret and the permission measurements:write

4, 5

Send data

202 Accepted from the machine data API

Check the result

Values in the measurement chart, processes in the process analysis

Watch the data

Rules, events and email notifications

Step 1: Plan the identifiers

The Smart Operations Toolkit assigns incoming data by name. Decide which names the machine or connector sends:

Identifier Example Used as

Identifier	Example	Used as
Technical ID of the device	`demo-mc-04`	`reference.identifier` in every message, *Technical ID* of the device
Names of the measured values	`temperature`, `rotation-speed`, `coolant-pressure`	`name` of a time series, *Name* of the measuring points
Names of the process curves	`time`, `torque`	`name` of a process series, *Name* of the measuring points (for the axes in the process analysis)

Technical ID of the device

demo-mc-04

reference.identifier in every message, Technical ID of the device

Names of the measured values

temperature, rotation-speed, coolant-pressure

name of a time series, Name of the measuring points

Names of the process curves

time, torque

name of a process series, Name of the measuring points (for the axes in the process analysis)

Use stable technical IDs that do not change when a machine is moved or renamed. The display name of the device can be changed at any time.

Step 2: Configure the device

In the menu, click Configuration and create in this order:

Measuring points for all values that the machine sends. See Measuring points.
A device type with these measuring points. See Device types.
The device with the technical ID, the device type and the facility. See Devices.

Alternatively, ask the agent:

Create the measuring points temperature (°C), rotation-speed (rpm) and coolant-pressure (bar), a device type Milling Center MC-500 with these measuring points, and the device Milling Center 04 with the technical ID demo-mc-04 in the facility Line 1.

For automated set-up, use the master data API.

Step 3: Get a technical client

Ask your administrator for a technical client with the permission measurements:write and request an access token. See Authentication.

Step 4: Send measured values

curl -X POST "https://<sot-host>/data-ingest/api/v1/tenants/<tenant>/ingest" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-Message-Type: measurement" \
  -H "X-Api-Version: 1.0" \
  -d '{
    "reference": { "identifier": "demo-mc-04", "type": 0 },
    "measurementTimeSeries": [
      {
        "name": "temperature",
        "firstSampleTimestamp": "2026-10-16T10:00:00Z",
        "timeOffsets": [0, 1000, 2000],
        "values": [47.2, 47.5, 48.1],
        "measurementUnit": "°C"
      }
    ]
  }'

The service answers with 202 Accepted.

See Sending measured values for the complete message format.

Step 5: Send process data

If the machine produces parts and records process curves, send one message per process with X-Message-Type: process. See Sending process data.

Step 6: Check the result

In the menu, click Devices and open Milling Center 04.
Check the Measurement Chart. Select a time range that contains the timestamps you sent.
Check the Process Analysis for process data.

Problem Solution

Problem	Solution
`401 Unauthorized`	The token is missing or expired. Request a new token.
`403 Forbidden`	The client does not have `measurements:write`, or the tenant in the URL does not match the token.
`400` with `ERR_SCHEMA_VALIDATION`	The message does not match the format. The `message` field names the invalid field.
`202`, but no values in the chart	Check that `reference.identifier` matches the technical ID and that `name` matches a measuring point of the device exactly (case-sensitive). Check the time range of the chart.
Values appear with a delay	Messages are processed asynchronously. Wait a few seconds and refresh.

401 Unauthorized

The token is missing or expired. Request a new token.

403 Forbidden

The client does not have measurements:write, or the tenant in the URL does not match the token.

400 with ERR_SCHEMA_VALIDATION

The message does not match the format. The message field names the invalid field.

202, but no values in the chart

Check that reference.identifier matches the technical ID and that name matches a measuring point of the device exactly (case-sensitive). Check the time range of the chart.

Values appear with a delay

Messages are processed asynchronously. Wait a few seconds and refresh.

Step 7: Watch the data

Create rules for the new device, for example with the agent: Create an upper bound rule for temperature on Milling Center 04: warning above 80, error above 90. See Monitoring with rules.
Events of the rules are shown in the device details and can be sent as email notifications. See Email notifications.

Schritt für Schritt: Maschine anbinden

Diese Anleitung zeigt Schritt für Schritt, wie eine Maschine angebunden wird: von der Konfiguration des Geräts bis zu den ersten Messwerten im Diagramm und zum ersten Prozess in der Prozessanalyse. Als Beispiel dient ein Fräszentrum mit dem Namen Milling Center 04 und der technischen ID demo-mc-04. Diese Werte durch die Namen der eigenen Maschine ersetzen.

Überblick

Schritt Aufgabe Ergebnis

Schritt	Aufgabe	Ergebnis
1	Bezeichner planen	Technische ID und Namen der Messpunkte
2	Gerät konfigurieren	Messpunkte, Gerätetyp und Gerät
3	Technischen Client anfordern	Client-ID, Client-Secret und die Berechtigung `measurements:write`
4, 5	Daten senden	`202 Accepted` von der Maschinendaten-API
6	Ergebnis prüfen	Werte im Messwerte Diagramm, Prozesse in der Prozessanalyse
7	Daten überwachen	Regeln, Ereignisse und E-Mail-Benachrichtigungen

Bezeichner planen

Technische ID und Namen der Messpunkte

Gerät konfigurieren

Messpunkte, Gerätetyp und Gerät

Technischen Client anfordern

Client-ID, Client-Secret und die Berechtigung measurements:write

4, 5

Daten senden

202 Accepted von der Maschinendaten-API

Ergebnis prüfen

Werte im Messwerte Diagramm, Prozesse in der Prozessanalyse

Daten überwachen

Regeln, Ereignisse und E-Mail-Benachrichtigungen

Schritt 1: Bezeichner planen

Das Smart Operations Toolkit ordnet eingehende Daten über Namen zu. Festlegen, welche Namen die Maschine oder der Konnektor sendet:

Bezeichner Beispiel Verwendet als

Bezeichner	Beispiel	Verwendet als
Technische ID des Geräts	`demo-mc-04`	`reference.identifier` in jeder Nachricht, *Technische ID* (*Technical ID*) des Geräts
Namen der Messwerte	`temperature`, `rotation-speed`, `coolant-pressure`	`name` einer Zeitreihe, *Name* der Messpunkte
Namen der Prozesskurven	`time`, `torque`	`name` einer Prozessreihe, *Name* der Messpunkte (für die Achsen in der Prozessanalyse)

Technische ID des Geräts

demo-mc-04

reference.identifier in jeder Nachricht, Technische ID (Technical ID) des Geräts

Namen der Messwerte

temperature, rotation-speed, coolant-pressure

name einer Zeitreihe, Name der Messpunkte

Namen der Prozesskurven

time, torque

name einer Prozessreihe, Name der Messpunkte (für die Achsen in der Prozessanalyse)

Stabile technische IDs verwenden, die sich nicht ändern, wenn eine Maschine umgesetzt oder umbenannt wird. Der Anzeigename des Geräts lässt sich jederzeit ändern.

Schritt 2: Gerät konfigurieren

Im Menü auf Konfiguration (Configuration) klicken und in dieser Reihenfolge anlegen:

Messpunkte für alle Werte, die die Maschine sendet. Siehe Messpunkte.
Einen Gerätetyp mit diesen Messpunkten. Siehe Gerätetypen.
Das Gerät mit technischer ID, Gerätetyp und Anlage. Siehe Geräte.

Alternativ den Agenten beauftragen:

Lege die Messpunkte temperature (°C), rotation-speed (rpm) und coolant-pressure (bar) an, einen Gerätetyp Milling Center MC-500 mit diesen Messpunkten und das Gerät Milling Center 04 mit der technischen ID demo-mc-04 in der Anlage Line 1.

Für eine automatisierte Einrichtung die Stammdaten-API verwenden.

Schritt 3: Technischen Client anfordern

Beim Administrator einen technischen Client mit der Berechtigung measurements:write anfordern und ein Zugriffstoken abrufen. Siehe Authentifizierung.

Schritt 4: Messwerte senden

curl -X POST "https://<sot-host>/data-ingest/api/v1/tenants/<tenant>/ingest" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-Message-Type: measurement" \
  -H "X-Api-Version: 1.0" \
  -d '{
    "reference": { "identifier": "demo-mc-04", "type": 0 },
    "measurementTimeSeries": [
      {
        "name": "temperature",
        "firstSampleTimestamp": "2026-10-16T10:00:00Z",
        "timeOffsets": [0, 1000, 2000],
        "values": [47.2, 47.5, 48.1],
        "measurementUnit": "°C"
      }
    ]
  }'

Der Dienst antwortet mit 202 Accepted.

Das vollständige Nachrichtenformat beschreibt Messwerte senden.

Schritt 5: Prozessdaten senden

Wenn die Maschine Teile fertigt und Prozesskurven aufzeichnet, je Prozess eine Nachricht mit X-Message-Type: process senden. Siehe Prozessdaten senden.

Schritt 6: Ergebnis prüfen

Im Menü auf Geräte (Devices) klicken und Milling Center 04 öffnen.
Das Messwerte Diagramm (Measurement Chart) prüfen. Einen Zeitraum wählen, der die gesendeten Zeitstempel enthält.
Die Prozessanalyse (Process Analysis) auf Prozessdaten prüfen.

Problem Lösung

Problem	Lösung
`401 Unauthorized`	Das Token fehlt oder ist abgelaufen. Ein neues Token anfordern.
`403 Forbidden`	Der Client hat die Berechtigung `measurements:write` nicht, oder der Tenant in der URL passt nicht zum Token.
`400` mit `ERR_SCHEMA_VALIDATION`	Die Nachricht entspricht nicht dem Format. Das Feld `message` nennt das ungültige Feld.
`202`, aber keine Werte im Diagramm	Prüfen, ob `reference.identifier` mit der technischen ID und `name` exakt mit einem Messpunkt des Geräts übereinstimmt (Groß- und Kleinschreibung beachten). Den Zeitraum des Diagramms prüfen.
Werte erscheinen verzögert	Die Verarbeitung der Nachrichten erfolgt asynchron. Einige Sekunden warten und die Ansicht aktualisieren.

401 Unauthorized

Das Token fehlt oder ist abgelaufen. Ein neues Token anfordern.

403 Forbidden

Der Client hat die Berechtigung measurements:write nicht, oder der Tenant in der URL passt nicht zum Token.

400 mit ERR_SCHEMA_VALIDATION

Die Nachricht entspricht nicht dem Format. Das Feld message nennt das ungültige Feld.

202, aber keine Werte im Diagramm

Prüfen, ob reference.identifier mit der technischen ID und name exakt mit einem Messpunkt des Geräts übereinstimmt (Groß- und Kleinschreibung beachten). Den Zeitraum des Diagramms prüfen.

Werte erscheinen verzögert

Die Verarbeitung der Nachrichten erfolgt asynchron. Einige Sekunden warten und die Ansicht aktualisieren.

Schritt 7: Daten überwachen

Regeln für das neue Gerät anlegen, zum Beispiel mit dem Agenten: Lege für Milling Center 04 eine Regel „Obere Grenze“ für temperature an: Warnung über 80, Fehler über 90. Siehe Überwachung mit Regeln.
Ereignisse der Regeln erscheinen in den Gerätedetails und lassen sich als E-Mail-Benachrichtigungen versenden. Siehe E-Mail-Benachrichtigungen.

Diese Seite bearbeiten Edit this page