PDF

Natywne Format Data NetCrunch

Jak NetCrunch przetwarza dane telemetryczne zewnętrzne i konwertuje je na liczniki i obiekty statusu, używając natywnych formatów JSON, XML i CSV

Cel i Zakres

Natywne Format Data NetCrunch definiują, jak zewnętrzne dane są konwertowane na liczniki i obiekty statusu w NetCrunch.

Formaty te są używane konsekwentnie w różnych mechanizmach wprowadzania:

  • Węzeł Telemetryczny
  • Plik Danych (FTP/S,HTTP/S,SSH,TFTP,Windows/SMB)
  • Odbiornik
  • Zdalny Skrypt SSH
  • Czujnik Skryptu
  • Czujnik REST

Niezależnie od źródła, cel jest zawsze ten sam:

  • Normalizować dane zewnętrzne
  • Przechowywać wartości liczbowe jako liczniki
  • Przechowywać informacje o stanie jako statusy
  • Udostępniać oba do alarmowania, pulpitów, wykresów i widoków topologii

Formaty są celowo proste i niezależne od transportu, aby mogły być generowane przez skrypty, agenty, eksportery lub systemy zewnętrzne bez specyficznych SDK dla NetCrunch.

Liczniki w NetCrunch

Co to jest licznik

Licznik reprezentuje wartość liczbową w czasie taką jak użycie CPU, zużycie pamięci, długość kolejki lub wskaźnik żądań.

Wewnętrznie, NetCrunch używa modelu licznika kompatybilnego z CIM, składającego się z trzech części:

  • Obiekt
  • Licznik
  • Instancja

Model ten pochodzi ze standardów WBEM i CIM i jest szeroko znany z liczników wydajności Windows.

Format Ścieżki Licznika

Liczniki są wyświetlane i adresowane przy użyciu kanonicznego formatu:

Obiekt(instancja)\Licznik

Przykłady:

  • Processor(_Total)\% Processor Time
  • PhysicalDisk(0 C:)\Disk Reads/sec
  • Memory\Available MBytes

Dlaczego Obiekt, Licznik, Instancja Ma Znaczenie

Użycie tej struktury pozwala NetCrunch:

  • Śledzić metryki dla każdej instancji bez niejednoznaczności
  • Automatycznie agregować instancje (_Total, sumy, średnie)
  • Wyświetlać liczniki jednolicie w Windows, SNMP, telemetrii i skryptach
  • Ponownie używać tej samej logiki wizualizacji i alarmowania dla wszystkich źródeł danych

Zasady Deklaracji Licznika

Licznik jest przechowywany i trendowany tylko wtedy, gdy jeden z poniższych warunków jest prawdziwy:

  • Jest zadeklarowany przez definicję kolektora danych lub czujnika
  • Jest zdefiniowany próg lub warunek alarmowy dla niego

Liczniki, które są wysyłane, ale nie są zadeklarowane lub odniesione, są ignorowane.

Obiekty Statusu w NetCrunch

Co to jest Status

Status reprezentuje aktualny stan czegoś, a nie trend liczbowy.

Tylko ostatnia wartość statusu jest przechowywana.

Domyślne Wartości Statusu

Domyślnie, NetCrunch rozpoznaje:

  • unknown
  • ok
  • warning
  • error
  • critical

Niestandardowe Wartości Statusu

Technicznie dozwolona jest każda wartość tekstowa, ale niestandardowe wartości są trudniejsze do mapowania w pulpitach i alarmowaniu.

Metadane Statusu

Obiekt statusu może zawierać:

  • wiadomość
  • flaga krytyczna
  • dowolne strukturalne dane

Format JSON

Proste Liczniki


{
  "counters": {
    "Processor/Usage": 15,
    "Memory/Free MBytes": 2048
  }
}

Szczegółowe Liczniki


{
  "counters": [
    {
      "path": {
        "object": "Processor",
        "counter": "% Processor Time",
        "instance": "_Total"
      },
      "value": 12
    }
  ]
}

Przykład Statusu


{
  "statuses": {
    "AppStatus": {
      "value": "Error",
      "message": "Service not responding",
      "critical": true
    }
  }
}

Format XML


<nc>
    <counters>
        <counter path="Processor/Usage">15</counter>
    </counters>
</nc>

Format CSV


Processor,% Processor Time,_Total,12
PhysicalDisk,Disk Reads/sec,,50

countersdata-ingestionformatsparsersstatusestelemetry