rrdgraph_libdbi - Online în cloud

PROGRAM:

NUME

rrdgraph_libdbi - preluarea datelor pentru reprezentarea grafică în graficul rrdtool prin libdbi

REZUMAT

= sql// sofer>/ = /...
[/rrdminstepsize= ][/rrdfillmissing= dispărut n secunde>]//
/ coloana>/ valoare coloană>[/derivare]/ clauză 1>/.../ clauză n>

DESCRIERE

Acest pseudo-rrd-filename definește o sursă de date sql:

sql//
magic cookie-prefix pentru o sursă de date de tip libdbi

<libdbi șofer>
ce driver libdbi să folosească (de exemplu: mysql)

=
definește parametrii necesari pentru a se conecta la baza de date cu driverul libdbi dat
(Aceste drivere depind de libdbi - pentru detalii vă rugăm să consultați documentația driverului libdbi!)

/rrdminstepsize=<minimum pas dimensiune>
definește numărul minim de lungime a pasului utilizat pentru grafic (implicit: 300 de secunde)

/rrdfillmissing=<umple dispărut secunde>
definește numărul de secunde de completat cu ultima valoare pentru a evita casetele NaN din cauza fluctuației de inserare a datelor (implicit: 0 secunde)


definește tabelul din care să preia setul de rezultate.

Dacă este nevoie de a prelua date din mai multe tabele, aceste tabele pot fi definite prin separarea numelor de tabel cu un „+”

codificarea de tip hex prin %xx sunt traduse la valoarea reală, utilizați %% pentru a utiliza %

<[*]unixtimestamp coloana>
definește coloana lui E masa E care conține marcajul de timp Unix
- dacă acesta este un câmp DATETIME în baza de date, atunci prefixul cu „*”

codificarea de tip hex prin %xx sunt traduse la valoarea reală, utilizați %% pentru a utiliza %

<date valoare coloana>
definește coloana lui E masa E care conține coloana cu valori, care ar trebui reprezentată grafic

codificarea de tip hex prin %xx sunt traduse la valoarea reală, utilizați %% pentru a utiliza %

/deriva
definește ca valoarea datelor utilizată să fie delta celor 2 valori consecutive (pentru a simula surse de date de tip COUNTER sau DERIVE)

/ clauza(e)>
definește una (sau mai multe) clauze în care sunt unite cu AND pentru a filtra intrările din masa

codificarea de tip hex prin %xx sunt traduse la valoarea reală, utilizați %% pentru a utiliza %

valorile returnate numele-coloană, care pot fi folosite ca nume-ds, sunt:

minute, avg, max, conta și sigma
sunt returnate pentru a fi utilizate ca nume ds în definiția dvs. DS.
Motivul utilizării acestui lucru este că, dacă funcția de consolidare este utilizată pentru min/avg și max, atunci motorul este folosit de mai multe ori.
Și acest lucru are ca rezultat aceleași instrucțiuni SQL utilizate de mai multe ori

EXEMPLE

Iată un exemplu de tabel într-o bază de date MySQL:

Informații de conectare DB
dbhost=127.0.0.1
utilizator=rrd
parola=secret
dbname=rrd

aici tabelul:
CREATE TABLE RRDValue (
RRDKeyID bigint(20) NU NUL,
UnixTimeStamp int(11) NU NUL,
valoare dublă implicită NOT NULL,
CHEIE PRIMARĂ (RRDKeyID, UnixTimeStamp)
);

iar RRDKeyID pentru care vrem să facem grafic este: 1141942900757789274

Pseudo nume de fișier rrd pentru a accesa acesta este:
„sql//mysql/host=127.0.0.1/dbname=rrd/username=rrd/parola=secret//RRDValue/UnixTimeStamp
/value/RRDKeyID=1141464142203608274"

Pentru a ilustra acest lucru, aici o comandă pentru a crea un grafic care conține valorile reale.

DS_BASE="sql//mysql/host=127.0.0.1/dbname=rrd/username=rrd/password=passwd//RRDValue/UnixTimeStamp/value/RRDKeyID=1141942900757789274"
rrdtool graph test.png --imgformat=PNG --start=-1day --end=+3hours --width=1000 --height=600 \
„DEF:min=$DS_BASE:min:AVERAGE” \
„LINE1:min#FF0000:valoare” \
„DEF:avg=$DS_BASE:avg:AVERAGE” \
„LINE1:avg#00FF00:medie” \
„DEF:max=$DS_BASE:max:AVERAGE” \
„LINE1:max#FF0000:max” \
„DEF:sigma=$DS_BASE:sigma:AVERAGE” \
„CDEF:upper=avg,4,sigma,*,+” \
„LINE1:upper#0000FF:+4 sigma” \
„CDEF:lower=avg,4,sigma,*,-” \
„LINE1:lower#0000FF:-4 sigma”

NOTE

* Desigur, puteți utiliza și orice alt tip de driver pe care libdbi îl acceptă - de exemplu, postgres,
...

* Din modul în care este îmbinată sursa de date, ar trebui să fie posibilă, de asemenea, să se facă alături
mese diferite
(separați tabelele cu "," în tabel și adăugați în clauzele WHERE îmbinările egale cu tabelul.
Acest lucru nu a fost testat!!!)

* De asemenea, ar trebui să fie relativ simplu de adăugat la baza de date folosind aceeași sursă de date
șir.
Acest lucru nu a fost implementat...

* Funcțiile de agregare sunt ignorate și sunt folosite mai multe coloane de date
pentru a evita interogarea aceluiași SQL de mai multe ori când sunt minim, mediu și maxim
necesar pentru graficare...

* pentru eficiența DB ar trebui să vă gândiți să aveți 2 tabele, unul care conține valori istorice
iar celălalt conţinând cele mai recente date.
Acest al doilea tabel ar trebui să fie păstrat mic pentru a permite cea mai mică cantitate de blocare SQL
declarații.
Cu mysql puteți folosi chiar și myisam table-type pentru primul și InnoDB pentru al doilea.
Acest lucru este deosebit de interesant, deoarece cu tabelele cu +100M de rânduri myisam este mult mai mic
apoi InnoDB.

* Pentru a depana instrucțiunile SQL, setați variabila de mediu RRDDEBUGSQL și SQL-ul real
declarațiile și sincronizarea este tipărită în stderr.

Performanţă probleme de implementate cu MySQL backend

LibDBI are o mare problemă de performanță atunci când preluați date de pe un server MySQL. Performanţă
impactul se bazează exponențial pe numărul de valori pe care le preluați din baza de date. Pentru
de exemplu, ar dura mai mult de 2 secunde pentru a reprezenta grafic 5DS pe 150 de ore de date cu a
precizie de 5 minute (față de 100 ms când datele provin dintr-un fișier RRD). Acest bug a fost
remediat pe cea mai recentă versiune a LibDBI (nu este lansat încă). În acel moment, ar trebui
compilați libdbi și libdbi-drivers din depozitul CVS pentru a o remedia. Puteți găsi mai multe
informații despre acest fir de discuții libdbi-users:
http://sourceforge.net/mailarchive/message.php?msg_id=30320894

Utilizați rrdgraph_libdbi online folosind serviciile onworks.net