PDF

Daten an NetCrunch senden

Lesen Sie, wie Daten an NetCrunch gesendet werden können und deren Überwachung zu erstellen ist. Sie können jede Anwendung oder jedes Skript einfach in einen NetCrunch-Agenten umwandeln.

Generischer Agent-Datensensor

Sie können ihn aus der Sensor-Liste auf jedem Knoten hinzufügen. Es gibt dafür nicht viel zu konfigurieren. Ein Name reicht, um automatisch einen erforderlichen API-Schlüssel für externe Agenten zu erstellen und damit Daten an NetCrunch senden zu können. Der API-Schlüssel besteht aus dem Namen des Sensors (ohne Leerzeichen) und der Knoten-ID-Nummer. Zum Beispiel kann es JMX@1034 sein für den JMX Agent.

Sie können mehrere Sensoren auf einzelnen Knoten für jede Anwendung, die Sie überwachen müssen, hinzufügen.

Retentionszeit

Da NetCrunch nicht weiß, wie oft Sie Daten senden werden, müssen Sie eine "Retentionszeit" für Daten angeben. Nach Ablauf werden die Daten aus dem Speicher gelöscht.

REST API

Die einfache API für den Sensor kann mit cUrl bedient werden, um eine Anfrage an NetCrunch zu senden. Ein Open Source-Projekt für fast jede Plattform ist unter: [curl.haxx.se] (http://curl.haxx.se) zu finden.

Die API besteht aus nur 5 Anfragen:

Aktualisierung

POST /api/rest/1/sensors/<api-key>/update

Die Anforderungsdaten müssen mit Inhaltstyp application/json gesendet werden.

Beispiel
 {
    "retain": 1,
    "counters": {
        "PBX/line status.0" : 1,
        "PBX/line status.1" : 0
     },
     "statuses":  {
       "AC"  : "On",
       "Power: "On"
     }
 }

Wie Sie sehen können, können Sie mehrere Status und Zähler in einer einzigen Anfrage senden.      

Zähler

GET /api/rest/1/sensors/<api-key>/counter?<parameter-list>
Beispiel

      <nc-server-addres>/api/rest/1/sensors/<api-key>/counter?Temp=65&Wind=4&@retain=5      

Zähler/Ink, Zähler/Dek

Da NetCrunch Zähler im Speicher sichert, kann der Agent ihn inkrementieren, ohne ihn wirklich zu speichern. Die Anforderung erhöht oder verringert den Zähler um einen gegebenen Wert.

Beispiel
<nc-server-addres>/api/rest/1/sensors/<api-key>/counter/inc?Door.Opened=-1

Status

GET /api/rest/1/sensors/<api-key>/status?<parameter-list>
Beispiel
 <nc-server-addres>/api/rest/1/sensors/<api-key>/counter?Door=Opened&@retain=5

Web-Nachrichten

Sie können die Ereignismeldung einfach per HTTP-Anfragen an NetCrunch senden. Das Programm akzeptiert POST- und GET-Anfragen. Im Beispielen überspringen wir den ersten Teil der URL, die Ihre NetCrunch Server Web Access URL ist. Wir empfehlen dringend, den Server so zu konfigurieren, dass er das HTTPS-Protokoll verwendet.

agentapigeneric agentgenericmonjsonmonitorrestsensor