Metriken verstehen

Was sind Metriken?

Metriken sind strukturierte Datenpunkte, die Devices während der Produktion an CoCoCo senden. Du gibst den aktuellen Zustand deiner Maschinen wieder: welcher Job läuft, wie schnell, wie viele Bogen gedruckt sind, welche Fehler aufgetreten sind.

CoCoCo speichert und verarbeitet Metriken, damit du sie in Workflows nutzen, in Dashboards anzeigen und über GraphQL abfragen kannst.

So funktionieren Metriken

1. Ein Device sendet eine Metrik über sein konfiguriertes Protokoll (MQTT, HTTP etc.) an CoCoCo
2. CoCoCo nimmt die Metrik entgegen und speichert sie, zugeordnet zum Device und zum aktiven Job
3. Workflow-Trigger können auf neue Metriken reagieren, etwa einen Job markieren, wenn die Fehleranzahl einen Schwellwert überschreitet

Metriken über MQTT senden

Ein Device publiziert Metriken auf das relative Topic s/metrics. Der Broker schreibt es auf das absolute, tenant-bezogene Topic t/{tenant}/s/metrics um — du publizierst auf s/metrics, und die Plattform ergänzt den Tenant für dich. Es gibt kein d/{id}/...-Topic; was dorthin publiziert wird, wird stillschweigend verworfen.

Die Payload ist ein Batch aus einem oder mehreren Punkten:

{
  "points": [
    {
      "name": "door_open",
      "value": 1,
      "kind": "STATUS",
      "unit": "BOOLEAN",
      "tags": { "location": "front" },
      "timestamp": "2026-02-08T12:00:00Z"
    }
  ]
}

• name — maschinenlesbarer Metrik-Bezeichner; die Metrik wird beim ersten Auftreten automatisch anhand des Namens pro (Tenant, Device) angelegt.
• value — muss eine endliche Zahl sein.
• kind — optional (GAUGE, COUNTER, STATUS, RATE); nur beim automatischen Anlegen verwendet. Standard ist GAUGE.
• unit — optional; nur beim automatischen Anlegen verwendet. Standard ist NONE.
• tags — optionale Schlüssel-Wert-Labels für den Punkt.
• timestamp — optionaler ISO-8601-Zeitstempel; Standard ist die Serverzeit.

Enum-Werte sind auf der Leitung GROSSGESCHRIEBEN — sende kind: "STATUS" und unit: "BOOLEAN", nicht in Kleinbuchstaben.

Weitere Kanäle: der Live-Job-Fortschritt geht an das separate Topic s/progress (umgeschrieben zu t/{tenant}/s/progress). Beachte, dass OpenInfras $rpc/metrics/ingest zu einer anderen Anwendung gehört und nicht der hier beschriebene CoCoCo-Metrik-Pfad ist.

Metriken anzeigen

1. Wechsle zu Menu → IOT → Metrics
2. Wähle ein Device aus der Liste
3. Schau sich die jüngsten Metrik-Werte in der Tabelle an

Metriken in Workflows nutzen

Metriken können Workflow Executions auslösen. Nutze einen Device Metric Trigger Node und konfiguriere die Bedingungen, zum Beispiel:

• sheets_printed > 1000 löst einen Qualitätscheck aus
• status == "error" benachrichtigt den Produktionsleiter
• job_id changed startet das Tracking eines neuen Jobs