PDF

Telemetrieknoten

Ein Telemetrieknoten ist ein NetCrunch-Knotentyp zum Empfangen von Metriken, Status und Ereignissen von externen Systemen über REST oder OTLP. Er verankert Telemetriedaten für Cloud-, IoT- oder benutzerdefinierte Systeme und ersetzt den älteren REST-Receiver durch ein einheitliches, ereignisfähiges Design.

Übersicht

In NetCrunch muss jedes Überwachungsobjekt an einen Knoten gebunden sein. Der Telemetrieknoten wurde speziell für die Aufnahme externer Metriken, Status und Ereignisse entwickelt – ideal für Workloads und Geräte, die nicht abgefragt werden können oder außerhalb des direkten Netzwerks existieren (z. B. Cloud, Skripte, IoT, eingebettete Systeme).

Häufige Anwendungen:

  • Remote- oder eingebettete Systeme
  • Cloud-Anwendungen und APIs
  • IoT/Headless-Geräte
  • Apps/Skripte zur Übertragung von Telemetriedaten

So fügen Sie einen Telemetrieknoten hinzu

  1. Klicken Sie oben in der NetCrunch-Benutzeroberfläche auf die Schaltfläche Hinzufügen (+).
  2. Wählen Sie im Popup-Menü:
    Andere → Telemetrieknoten (die Bezeichnung kann auch als „Telemetrieempfänger“ angezeigt werden).
  3. Geben Sie den gewünschten Knotennamen ein und wählen Sie die Sichtbarkeitsoptionen.
  4. Bestätigen Sie. NetCrunch weist eine „nodeId“ zu und erstellt den Standard-Telemetriesensor („sensorId“).

Der Sensor wird immer erstellt und kann nicht entfernt, sondern nur deaktiviert werden.

Knotentypumstellung

  • Der Knotentyp REST-Empfänger ist veraltet und wurde durch Telemetrieknoten ersetzt.
  • Telemetrieknoten:
  • Unterstützt Ereigniserfassung
  • Verwendet „sensorId“ als Hauptkennung (nicht nur „nodeId“)
  • Sensoren werden automatisch hinzugefügt (können deaktiviert, aber nicht gelöscht werden)
  • Legacy-REST-Empfänger funktionieren weiterhin, werden aber ersetzt

Unterstützte Eingabeprotokolle

Protokoll Endpunkttyp Datenformat
REST (JSON) Lokales/Cloud-REST NetCrunch JSON
OTLP OTLP-Gateway OpenTelemetry (HTTP/gRPC)

Alle Daten werden an den Telemetrieknotensensor weitergeleitet (nodeId + sensorId).

REST-Endpunkte

  • Lokales REST: https://<nc-server>/api/rest/1/sensors/<sensorId>@<nodeId>/update
  • Cloud REST: https://gw.netcrunch.io/tm/v1/<serverId>@<sensorId>@<nodeId>/update

Beispiel-Nutzlast


{
"counters": { "system/cpu.load": 0.75 },
"statuses": {
"uptime": {
"value": "ok",
"data": { "statusCode": 1 },
"message": "System läuft seit 3 ​​Tagen"
}
}
}

OTLP-Gateway (OpenTelemetry)

  • Metriken: https://otlp.netcrunch.io/v1/<serverId>@<sensorId>@<nodeId>/metrics
  • Protokolle: https://otlp.netcrunch.io/v1/<serverId>@<sensorId>@<nodeId>/logs
Aspekt REST-Endpunkt OTLP-Gateway
Format NetCrunch JSON OTLP-Metriken/Protokolle
Protokoll HTTPS (JSON) HTTP/HTTPS (OTLP JSON/Binär)
URL gw.netcrunch.io otlp.netcrunch.io
Verarbeitung Direkte Aufnahme In internes Format übersetzt

Hinweise:

  • Traces werden nicht unterstützt.
  • Protokolle = inaktive Warnungen. Metriken = Zähler. Histogrammunterstützung geplant.

Endpunkte für die Ereigniserfassung: Telemetrieknoten vs. Webnachrichtensensor

Wichtig: Der Endpunkt zum Senden von Ereignissen unterscheidet sich bei Telemetrieknoten von dem klassischer Webnachrichtensensoren. Bei Verwendung des falschen Endpunkts werden Ereignisse nicht verarbeitet.

Endpunkt für Telemetrieknotenereignisse

Für Telemetrieknoten müssen Ereignisse an den Sensorendpunkt gesendet werden:

https://<nc-server>/api/rest/1/sensors/<sensorId>/event

  • Das Ereignis ist mit dem spezifischen Sensor (sensorId) verknüpft, der für den Telemetrieknoten erstellt wurde.
  • Dies ist erforderlich, damit alle Ereigniswarnungen des Telemetrieknotens funktionieren.

Web-Message-Sensor (Legacy) Ereignisendpunkt

Für ältere Web-Message-Sensoren (ohne Telemetrie) müssen Ereignisse an den Knotenendpunkt gesendet werden:

https://<nc-server>/api/rest/1/node/<nodeId>/event

  • Das Ereignis ist direkt mit dem Knoten (nodeId) verknüpft.

Warum das wichtig ist

  • Telemetrieknoten: erwartet Ereignisse von sensorId.
  • Web-Message-Sensor: erwartet Ereignisse von nodeId.

Wenn Sie Ereignisse für einen Telemetrieknoten an den Endpunkt node/<nodeId>/event senden, werden diese nicht verarbeitet.

Kurzübersicht

Knotentyp Korrekter Endpunkt
Telemetrieknoten https://<nc-server>/api/rest/1/sensors/<sensorId>/event
Web-Nachrichtensensor https://<nc-server>/api/rest/1/node/<nodeId>/event

$$Hinweis$$ Verwenden Sie für Telemetrieknoten immer den Endpunkt sensorId; nodeId nur für klassische Web-Nachrichtensensoren. $$

Daten senden – Beispiele

Cloud-REST-Update


curl -X POST https://gw.netcrunch.io/tm/v1/SRV-1@sensor42@node91/update \
-H "Content-Type: application/json" \
-d '{"counters":{"system/disk.freeMB":12800},"statuses":{"system/fan":{"value":"ok","message":"normal"}}}'

Lokales REST-Ereignis


curl -X POST https://<nc-server>/api/rest/1/sensors/sensor42/event \
-H "Content-Type: application/json" \
-d '{"message": "failed login"}'

  • Ereignisfelder: message, description, attributes (zusätzliche Parameter wie Benutzer, Uhrzeit usw.)

Ereigniswarnungen

  • Ereigniswarnungen unterstützen die Filterung von Ereignisfeldern.
  • Leerer Filter = alle Ereignisse abgleichen.

Leere Filter gleichen alle Ereignisse ab. Gilt sowohl für Telemetrieknoten- als auch für Webnachrichtensensoren.

Knotenverhalten und -überwachung

  • Der Telemetrieknoten verankert alle eingehenden Messwerte, Status und Ereignisse.
  • Unterstützt Dashboards, Warnungen und Verlaufsdaten.
  • Kann Überwachungspakete empfangen und Richtlinien – Erscheint in Topologieansichten (sofern nicht ausgeblendet)

Zusammenfassung

Telemetrieknoten bieten ein Push-basiertes Modell für die Observability – ideal für Remote-, Cloud- und IoT-Daten mit robuster REST- und OTLP-Unterstützung und direkter Ereigniserfassung. Sie vereinfachen die Integration externer oder serverloser Systeme mit NetCrunch-Monitoring.

empfängerknotenereignisendpunktnetcrunchobservabilityotlp-gatewaypush-monitoringremote-metrikenrest-apisensoraktualisierungtelemetrieknoten