14.1.3 ASCII mérés szerverek

ASCII mérések esetében a specifikumot a PVSR számára előállítandó adatfile jelenti. Az adatfile-nak négy része van: eszköz információ, mérés információ, uptime adatok és mért adatok. Mindegyik sor pontosvesszővel elválasztott mezőkből áll. A pontosvesszőket az értékekben \; -ként kell szerepeltetni. A többsoros további paraméterek esetében használható a ###NEW_LINE### karaktersorozat a sortörés ábrázolására, mivel minden egyes rekordnak egy sorban kell szerepelnie. Ha egy alap paraméternek nincsen értéke, akkor is szerepelnie kell a file-ban, üres elemként.

A file nevének formátuma: coll.<unix time>.<mérési ciklus másodpercben>.data. Ha a file előállt, akkor akár nulla mérettel is, de létre kell hozni egy coll.<unix time>.<mérési ciklus másodpercben>.data.ready file-t is. A file-okat a szerver tmp/COLL.<szerver ID> könyvtárban kell létrehozni.

Az egyes adatfile részek közül csupán a mért adatok részt kötelező megadni. Az első kettő az automatikus discovery használata esetén érdekes (COLLECTOR… paraméterek a CONFIG_INI.pm file-ban), mivel az eszközöket és a méréseket ez alapján veszi fel az alkalmazás (a rendszer az eszköz azonosító kulcsa alapján keresi az eszközöket az adatbázisban).

A felvétel előfeltétele az, hogy ne létezzen másik ilyen nevű eszköz, illetve hogy az eszközön ne létezzen másik ilyen nevű mérés. A másik előfeltétel az, hogy az összes kötelező, de alapértékkel nem rendelkező további paraméternek értéket kell adni.

14.1.3.1 Eszköz információ

Az eszköz információs sorok az EQ mezővel kezdődnek. Az ezek után álló elemek (a kötelezőek vastagítottan):

• Eszköz azonosító kulcsa: nem feltétlenül az eszköz neve, a felületen Gyűjtő azonosító további paraméterként jelenik meg
• Eszköz neve
• Eszköz leírása
• Hány napig tartsa meg a mért értékeket
• Adatgyűjtő altípus (jelenleg nem használt)
• Érték párok:
• További paraméter azonosítója
• További paraméter értéke

14.1.3.2 Mérés információ

A mérés információs sorok M mezővel kezdődnek. Az ezek után álló elemek (a kötelezőek vastagítottan):

• Eszköz azonosító kulcsa
• Mérés azonosító kulcsa (index a felületen)
• Mérés definíció típus(ok): ha több szerepel, akkor azokat a | jellel kell elválasztani
• Mérés neve
• Mérési ciklus másodpercben
• Érték párok:
• További paraméter azonosítója
• További paraméter értéke

14.1.3.3 Uptime adatok

Az uptime adatok az UPT mezővel kezdődnek. Az itt megadott értékek egyrészt megjelennek az eszköznél tárolt uptime mezőben, másrészt felhasználhatók a mérés definícióknál az UPTIME változóként. Mindegyik mező kötelező:

• Eszköz azonosító kulcsa
• Uptime értéke másodpercben

14.1.3.4 Mért adatok

A mért adat sorok V mezővel kezdődnek Az OUT kivételével mindegyik mező kötelező:

• Eszköz azonosító kulcsa
• Mérés azonosító kulcsa (index a felületen)
• Érték hármasok:
• Mérés definíció típus
• IN érték
• OUT érték

14.1.3.5 Minta file

A file neve coll.1116444300.300.data, a tartalma:

#EQ;coll_key;name;<descr>;<rrd>;<collector_subtype><;param_name1;param_value1;param_name2;param_value2;...>

EQ;ascii_eq_1;Elsõ ascii eszköz;Ez itt egy pontosvesszõ:\;;30;;ASCII_0001_EQ_TEXT1;Szöveg 1

EQ;ascii_eq_2;Második ascii \; eszköz;Ez itt egy pontosvesszõ:;;30;;ASCII_0003_EQ_S1;MASODIK;ASCII_0001_EQ_TEXT1;Szöveg 1###NEW_LINE###Második sor

EQ;ascii_eq_3;Eszköz 3;;30;;ASCII_0001_EQ_TEXT1;Semmi;ILYEN_param_NINCSEN

#UPT;coll_key;uptime_in_sec

UPT;ascii_eq_1;0

UPT;ascii_eq_2;0

UPT;ascii_eq_3;0

#M;coll_key;index;mtype1|mtype2|mptype3;descr;iis<;param_name1;param_value1;param_name2;param_value2;...>

M;ascii_eq_1;INDEX1;#A1|#A3;Elsõ mérés;300;ASCII_0000_M_T1;szo\;veg

M;ascii_eq_1;INDEX2;#A1|#A3;Második mérés;300;ASCII_0000_M_T1;szo\;veg

M;ascii_eq_1;INDEX3;#A2;Harmadik mérés;300

M;ascii_eq_1;INDEX3;#A3;Negyedik mérés;300

M;ascii_eq_2;INDEX1;#A1|#A3;Elsõ mérés;300;ASCII_0000_M_T1;szo\;veg

M;ascii_eq_2;INDEX2;#A1|#A3;Második mérés;300;ASCII_0000_M_T1;szo\;veg

M;ascii_eq_2;INDEX3;#A2;Harmadik mérés;300

M;ascii_eq_2;INDEX4;#A8;Sikertelen mérés;300

M;ascii_eq_3;INDEX1;#A1|#A3;Elsõ mérés;300;ASCII_0000_M_T1;szo\;veg

M;ascii_eq_3;INDEX2;#A1|#A3;Második mérés;300;ASCII_0000_M_T1;szo\;veg

M;ascii_eq_3;INDEX3;#A2;Harmadik mérés;300;ASCII_0000_M_T1;szo\;veg

M;ascii_eq_3;INDEX4;#A8;Sikertelen mérés;300;ASCII_0000_M_T1;szo\;veg

#V;coll_key;index;mtype1;in1;out1<;mtype2;in2;out2;...>

V;ascii_eq_1;INDEX1;#A1;2;;#A3;3;4

V;ascii_eq_1;INDEX2;#A1;5;;#A3;6;7

V;ascii_eq_1;INDEX3;#A2;8;

V;ascii_eq_2;INDEX1;#A1;9;;#A3;10;10

V;ascii_eq_2;INDEX2;#A1;11;;#A3;12;12

V;ascii_eq_2;INDEX3;#A2;13;

V;ascii_eq_2;INDEX4;#A8;14;15

V;ascii_eq_3;INDEX1;#A1;9;;#A3;10;10

V;ascii_eq_3;INDEX2;#A1;11;;#A3;12;12

V;ascii_eq_3;INDEX3;#A2;13;

V;ascii_eq_3;INDEX4;#A8;14;15

Mint látható, a file tartalmazhat #-kal kezdődő megjegyzés sorokat is.