13.3.2 PVSR plugin

A plugin tartalmaz egy PVSR adatforrást, egy riasztás és egy eszköz specifikus táblázatos panelt, valamint több általános dashboard-ot. A plugin REST API-n keresztül kommunikál a PVSR szerverrel.

Telepítés és engedélyezés:

A plugin-t a Grafana felhasználói plugin-eket tartalmazó könyvtárába kell másolni (például /var/lib/grafana/plugins). Mivel a PVSR plugin nincsen digitálisan aláírva a Grafan cég által, ezért az engedélyezéséhez a Grafana konfigurációs file-jában (/etc/grafana/grafana.ini) szerepeltetni kell az allow_loading_unsigned_plugins felsorolásban. Példa:

[root@grafana-dev grafana]# /usr/bin/grep -i plugin /etc/grafana/grafana.ini

# Directory where grafana will automatically scan and look for plugins

plugins = /var/lib/grafana/plugins

[plugins]

allow_loading_unsigned_plugins = netvisor-pvsr-datasource

Utána újra kell indítani a Grafana szervert. Végül a webes felületen a „Configuration -> Plugins” menüpontból ki kell keresni a PVSR plugint és a „Config” fül alatt engedélyezni kell. Az engedélyezés akkor sikeres, ha megjelenik egy zöld pipa és az „Enabled” felirat. Itt lehet letiltani és frissíteni is a plugint.

Követelmény: Grafana 8

13.3.2.1 Adatforrás

PVSR adatforrás úgy lett kialakítva, hogy a Grafana szerver kommunikál közvetlnetül a PVSR szerverrel. Az egyes konfigurációs opciók az alábbiak:

·       Name: tetszőleges lehet

·       Default: ha ki van pipálva, akkor ez lesz az alapértelmezett adatforrás

·       Type: PVSR Datasource

·       PVSR URL: a PVSR szerver címét kell megadni, ahogyan a Grafana szerverről látszódik (meg kell adni, hogy http vagy https)

·       PVSR user login name / PVSR user password: milyen felhasználói névvel és jelszóval csatlakozzon a PVSR szerverhez

·       Use object cache: gyorsabb megjelenítés biztosít kliens oldali PVSR objektum cache-eléssel

Adatforrás használata:

A PVSR adatforrás többféle lekérdezési módot (query mode) támogat, mindegyiket különböző szűrési feltételekkel.

·       Chart
Méréseket lehet vele lekérdezni. A dashboard-on beállított időintervallumban lévő értékeket adja vissza.

Szűrők:

·       Panel Type:

§  TimeSeries: a mérési pontok „szám-dátum” formátumúak,

§  TimeSeries (PVSR colors): hasonló az előzőhöz, de szín információkat is átad a PVSR

§  Last values (…): csak a legutolsó mérési adatokat tartalmazza a válasz, opcionálisan dátum információval és állíthat horizontális vagy vertikális ábrázolással. Egy adatpont megjelenítésére képes panelekhez kell használni.

·       Equipment: az eszköz PVSR-beli nevét kell megadni. Paraméterezhető.

·       Measurement: A megadott eszközhöz tartozó mérések közül lehet választani.

·       Values: A méréshez tartozó mért paramétereket lehet kiválasztani. Ha az „All Measurements” van kiválasztva, akkor minden paraméter mérése megjelenik

·       Label Name: melyik PVSR paraméter jelenjen meg a válaszban az egyes elemek nevénél

·       Equipment Statuses

Eszközöket és riasztások darabszámát tartalmazza súlyosság szerint csoportosítva.

Szűrők:

·       Equipment Filter: a keresett eszköz neve. A „%” használható karakter helyettesítőként („joker character”).

·       Threshold Type Filter: a threshold típus neve alapján lehet szűrni. A „%” használható karakter helyettesítőként („joker character”).

·       Report Table

Előre számított PVSR riport adatokat jelenít meg

·       Report View: a megjeleníteni kívánt PVSR riport nézet tábla

·       Max Items: maximum hány elemet tartalmazzon a táblázat

·       Site Name: szűrni lehet a site neve alapján

·       Equipment Name: szűrni lehet az eszköz neve alapján

·       Alert Table

Az aktuális vagy nem régen lezáródott riasztásokat adja vissza táblázatos formában. A táblázat oszlopai: Priority, Level, Name, Begin, Acknowledged by, Id, IsEvent. A PVSR plugin riasztás specifikus paneljében a Priority, Id és IsEvent oszlopok rejtve vannak. Ezek mellett megjelenhetnek threshold felhasználói attribútumok

Szűrők:

·       Alert level: a risztás szintje alapján szűr

·       Alert Window: csak az aktuális riasztások jelenjenek meg vagy a közelmúltban lezáródottak is

·       Max Items: maximum ennyi riasztást ad át a PVSR

·       Equipment Name: a megadott eszköz riasztásait jeleníti meg. Paraméterezhető.

·       Begin Time Filter: csak azok a riasztások jelennek meg, amelyek a Grafana dashboard időbeállítása szerinti időszakban keletkeztek

·       UDAs: tartalmazzon-e a táblázat threshold felhasználó által definiált attribútumokat

·       Threshold Type Filter: a threshold típus neve alapján lehet szűrni. A „%” használható karakter helyettesítőként („joker character”).

·       Threshold Filter: A megjeleníteni kívánt threshold nevére lehet szűrni. A „%” használható karakter helyettesítőként („joker character”).

·       Equipments Table

A PVSR-ben lévő eszközök adatait adja vissza táblázatos formában. A táblázat három állandó oszlopa: Name, Site, CollectorTypeName. Kollektor típusra való szűrés után több, a kollektor típusától függő oszlop is megjelenhet.

Szűrők:

·       Collector Type: kollektor típusára lehet szűrni.

·       Max Items: a táblázatban megjelenítendő eszközök maximális számát lehet megadni. Alapértelmezetten 100.

·       Site Filter: A megadott site alatt lévő eszközökre szűr. Ha üres vagy „all”, akkor nincs site-alapú szűrés. A „%” használható karakter helyettesítőként („joker character”).

·       Equipment Filter: A megadott eszközre szűr. Ha üres vagy „all”, akkor nincsen szköz név alapú szűrés. A „%” használható karakter helyettesítőként („joker character”). Paraméterezhető.

·       Server Status

A PVSR szerver modulok állapotát lehet vele megjeleníteni. Csak PVSR adminisztrátorok használhatják ezt az opciót

Szűrők:

·       Non Clearable Server Event Ageout: mennyi idő után tekintse lezártnak az olyan PVSR szerver eseményeket, amelyeknek nincsen lezáró párja