PDF

Czujnik Data File

Czujnik umożliwia pobieranie danych z różnych źródeł i przetwarzanie ich w celu uzyskania metryk i wartości stanu.

FTP/S, HTTP/S, SSH/Bash, SFTP, Windows/SMB

Czujnik ładuje dane z pliku lub adresu URL za pomocą jednego z predefiniowanych formatów plików (w tym niestandardowych formatów). Może powiadamiać o pobranych metrykach i wartościach statusu.

Dostępne alerty:

  • Alert dla licznika czujnika monitorującego
  • Plik nie istnieje
  • Plik istnieje
  • Plik zmodyfikowany
  • Plik jest pusty
  • Plik nie jest pusty
  • Błąd dostępu do pliku
  • Błąd uwierzytelniania
  • Błąd połączenia
  • Plik nie został zaktualizowany w określonym przedziale czasu (wiek pliku)
  • Plik aktualizowany zbyt często (wiek pliku)
  • Błąd odczytu pliku

Obsługiwane formaty plików

Natywne formaty danych

NetCrunch może jednocześnie otrzymywać liczniki i obiekty statusu. Obsługuje formaty JSON i XML, które pozwalają przekazywać zarówno liczniki, jak i statusy, a dodatkowo obsługuje uproszczony format CSV dla metryk liczników.

<NetCrunch JSON>

Jest to bardzo prosty format. Każdy licznik musi być wartością numeryczną. Obiekty statusu mogą być reprezentowane przez proste wartości string lub złożone obiekty, w tym niestandardowe dane. Dane te mogą być wyświetlane później w widżetach i oknie stanu.

{
  "counters": {
     "crm/emails-in-1h": 10.2,
     "crm/emails-out-1h": 231
  },
  "statuses":  {
       "AC"  : "On",
       "Power": "On"
  }
}

Złożone obiekty stanu mogą wyglądać tak:

{
  "statuses" :  { 
      "Disk C:" : {
                    "value" : "ok",
                    "message" : "Working fine",
                    "critical": true,
                    "data" : { 
                        "type" : "SDD", 
                        "upTimeSec" : 123431  
                     }
     }      
  }
}

Obiekt statusu może zawierać pola takie jak:

  • Wartość - wartość statusu, która może być dowolnym ciągiem, ale jeśli użyta jest jedna z wartości standardowych, NetCrunch będzie mógł użyć tej wartości do wyliczenia warunków alertowych. Pole jest wymagane, aby rozpoznać obiekt statusu, w przeciwnym razie cały obiekt będzie traktowany jako ciąg tekstowy. Standardowe wartości to: ok, błąd, ostrzeżenie, wyłączone, nieznane.

  • Nazwa - nazwa obiektu, nie musi być unikalna (opcjonalne)

  • Komunikat - może to być komunikat opisujący stan (na przykład komunikat o błędzie) (opcjonalne)
  • Otrzymany - czas kiedy status został otrzymany (opcjonalne)
  • Zachowaj - jak długo status będzie ważny, jeśli nie otrzyma nowego statusu. Po tym czasie status staje się nieznany
  • Klasa - klasa statusu. Czy określona historia statusu zostanie zapisana w bazie danych. Klasa pomaga interfejsowi zrozumieć dane związane ze statusem i odpowiednio je wyświetlić.
  • Dane - dane własne, niestandardowe. Może to być dowolny obiekt JSON, chyba że klasa wskazuje jedną z dobrze znanych klas. Musi być zgodna z formatem danych klasy.

<NetCrunch XML>

 <nc>
    <counters>
       <counter path="xobj/cnt.1">123</counter>
       <counter path="xobj/cnt.2">245</counter>
    </counters>
    <statuses>
       <status name="AC" message="Everything fine">OK</status>
       <status name="Fan">
            <value>OK</value>
            <message>OK</message>                
            <critical>true</critical>
            <data>
                <type>High speed</type>
            </data>
       </status>
    <statuses>
 </nc>

<NetCrunch CSV >

To bardzo prosty format który pozwala przekazywać prostą listę liczników.

object,counter,instance,value

dodatkowo można przekazać tylko dwie wartości, gdzie pierwsza będzie traktowana jako ścieżka licznika, a druga jako jej wartość.

counterpath,value
Przykład
      Fan Speed,123
      SensorB,Temperature,Room,22
      SensorC,Temperature,Outside,15 
      SensorD/Temperature.Rack 1,26   

Jak widać, można mieszać formaty wewnątrz jednego dokumentu.

Własne formaty danych

Możesz sprawić, że NetCrunch będzie rozumiał dowolny format za pomocą Parserów danych, które umożliwiają analizowanie danych zewnętrznych. Wynikiem jest zawsze lista liczników i obiektów stanu.

Parsery danych

customdataparser