Węzeł telemetryczny

Węzeł telemetryczny to typ węzła NetCruncha służący do odbierania metryk, statusów i zdarzeń z systemów zewnętrznych za pośrednictwem protokołu REST lub OTLP. Zakotwicza on dane telemetryczne dla chmury, Internetu Rzeczy lub systemów niestandardowych i zastępuje starszy odbiornik REST zunifikowaną, obsługującą zdarzenia konstrukcją.

Przegląd

W NetCrunchu każdy obiekt monitorujący musi być powiązany z węzłem. Węzeł telemetryczny został zaprojektowany specjalnie do pobierania zewnętrznych metryk, statusów i zdarzeń — idealny dla obciążeń i urządzeń, których nie można odpytywać lub które znajdują się poza siecią bezpośrednią (np. chmura, skrypty, Internet Rzeczy, systemy osadzone).

Typowe zastosowania:

Systemy zdalne lub wbudowane
Aplikacje chmurowe i API
Urządzenia IoT/bezgłowe
Aplikacje/skrypty przesyłające dane telemetryczne

Jak dodać węzeł telemetryczny

Kliknij przycisk Dodaj (+) u góry interfejsu użytkownika NetCruncha.
Z menu podręcznego wybierz:
Inne → Węzeł telemetryczny (etykieta może również pojawić się jako „Odbiornik telemetryczny”).
Wprowadź żądaną nazwę węzła i wybierz opcje widoczności.
Potwierdź. NetCrunch przypisze nodeId i utworzy domyślny czujnik telemetryczny (sensorId).

Czujnik jest zawsze tworzony i nie można go usunąć, można go jedynie wyłączyć.

Zmiana typu węzła

Typ węzła Odbiornik REST jest teraz przestarzały i zastąpiony przez Węzeł Telemetryczny.
Węzeł Telemetryczny:
Obsługuje przetwarzanie zdarzeń
Używa sensorId jako głównego identyfikatora (nie tylko nodeId)
Czujniki są dodawane automatycznie (można je wyłączyć, ale nie usunąć)
Starsze odbiorniki REST nadal działają, ale zostały zastąpione

Obsługiwane protokoły wejściowe

Protokół	Typ punktu końcowego	Format danych
REST (JSON)	Lokalny/Chmurowy REST	NetCrunch JSON
OTLP	Bramka OTLP	OpenTelemetry (HTTP/gRPC)

Wszystkie dane są kierowane do czujnika Węzła Telemetrycznego (nodeId + sensorId).

Punkty końcowe REST

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

Przykładowy ładunek


{
   "counters": { "system/cpu.load": 0.75 },
   "statuses": {
      "uptime": {
          "value": "ok",
          "data": { "statusCode": 1 },
          "message": "System działa od 3 dni"
      }
   }
}

Brama OTLP (OpenTelemetry)

Metryki: https://otlp.netcrunch.io/v1/<serverId>@<sensorId>@<nodeId>/metrics
Logi: https://otlp.netcrunch.io/v1/<serverId>@<sensorId>@<nodeId>/logs

Aspekt	Punkt końcowy REST	Brama OTLP
Format	NetCrunch JSON	Metryki/logi OTLP
Protokół	HTTPS (JSON)	HTTP/HTTPS (OTLP JSON/binarny)
URL	`gw.netcrunch.io`	`otlp.netcrunch.io`
Przetwarzanie	Bezpośrednie pobieranie	Przetłumaczone na format wewnętrzny

Uwagi:

Śledzenie nie jest obsługiwane.
Logi = nieaktywne alerty. Metryki = liczniki.
Planowana obsługa histogramu.

Punkty końcowe przetwarzania zdarzeń: Węzeł telemetryczny a czujnik wiadomości internetowych

Ważne: Punkt końcowy do wysyłania zdarzeń jest inny dla węzłów telemetrycznych niż dla klasycznych czujników wiadomości internetowych. Użycie niewłaściwego punktu końcowego oznacza, że zdarzenia nie zostaną przetworzone.

Punkt końcowy zdarzeń węzła telemetrycznego

W przypadku węzłów telemetrycznych zdarzenia muszą być wysyłane do punktu końcowego czujnika:

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

Zdarzenie jest powiązane z konkretnym czujnikiem (sensorId) utworzonym dla węzła telemetrycznego.
Jest to wymagane do działania wszystkich alertów zdarzeń węzła telemetrycznego.

Punkt końcowy zdarzeń czujnika wiadomości internetowych (starsza wersja)

W przypadku starszych czujników wiadomości internetowych (bez telemetrii) zdarzenia muszą być wysyłane do punktu końcowego węzła:

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

Zdarzenie jest bezpośrednio powiązane z węzłem (nodeId).

Dlaczego to ma znaczenie

Węzeł telemetryczny: oczekuje zdarzeń na podstawie sensorId.
Czujnik wiadomości internetowych: oczekuje zdarzeń na podstawie nodeId.

Jeśli wyślesz zdarzenia dla węzła telemetrycznego do punktu końcowego node/<nodeId>/event, nie zostaną one przetworzone.

Krótki przewodnik

Typ węzła	Prawidłowy punkt końcowy
Węzeł telemetryczny	`https://<nc-server>/api/rest/1/sensors/<sensorId>/event`
Czujnik wiadomości internetowych	`https://<nc-server>/api/rest/1/node/<nodeId>/event`

Zawsze używaj punktu końcowego sensorId dla węzłów telemetrycznych; używaj nodeId tylko dla klasycznych czujników wiadomości internetowych.

Wysyłanie danych – przykłady

Aktualizacja Cloud REST


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"}}}'

Lokalne zdarzenie REST


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

Pola zdarzenia: message, description, attributes (dodatkowe parametry, takie jak użytkownik, czas itp.)

Alerty dotyczące zdarzeń

Alerty dotyczące zdarzeń obsługują filtrowanie według pól zdarzeń.
Pusty filtr = pasuje do wszystkich.

Puste filtry pasują do wszystkich zdarzeń. Dotyczy zarówno czujników węzła telemetrii, jak i czujników wiadomości internetowych.

Zachowanie i monitorowanie węzła

Węzeł telemetrii zakotwicza wszystkie przychodzące metryki, statusy i zdarzenia
Obsługuje pulpity nawigacyjne, alerty i dane historyczne
Możliwość odbierania pakietów monitorowania i zasad
Pojawia się w widokach topologii (chyba że jest ukryty)

Podsumowanie

Węzły telemetryczne zapewniają model obserwowalności oparty na push — idealny dla danych zdalnych/chmurowych/IoT, z solidną obsługą REST i OTLP oraz bezpośrednim pozyskiwaniem zdarzeń. Upraszczają integrację systemów zewnętrznych lub bezserwerowych z monitorowaniem NetCrunch.

aktualizacja czujnikabrama otlpinterfejs api restmonitorowanie pushnetcrunchobserwowalnośćpunkt końcowy zdarzeniawęzeł odbiorczywęzeł telemetrycznyzdalne metryki