rrdfetch - Online în cloud

PROGRAM:

NUME

rrdfetch - Preluați date dintr-un RRD.

REZUMAT

rrdtool aduc nume de fișier CF [--rezoluţie|-r rezoluţie] [--start|-s Începe] [--Sfârșit|-e capăt]
[--align-start|-a] [--daemon|-d adresa]

DESCRIERE

aduc funcția este utilizată în mod normal intern de funcția grafic pentru a obține date de la
DRRs. aduc va analiza DRR și încercați să preluați datele din rezoluția solicitată.
Datele preluate sunt tipărite în stdout. *NECUNOSCUT* datele sunt adesea reprezentate de șir
„NaN” în funcție de funcția printf a sistemului de operare.

nume de fișier
numele DRR doriți să preluați datele de la.

CF funcția de consolidare care se aplică datelor pe care doriți să le preluați
(MEDIE, MIN, MAX, ULTIMUL)

--rezoluţie|-r rezoluţie (implicit este cea mai mare rezoluție)
intervalul pe care doriți să îl aibă valorile (secunde pe valoare). Un sufix opțional
poate fi folosit (de exemplu, „5m” în loc de 300 de secunde). rrdfetch va încerca să se potrivească cu dvs
cerere, dar va returna date chiar dacă nu este posibilă o potrivire absolută. Vedea
„Intervalul de rezoluție”.

--start|-s Începe (implicit sfârşitul unei zile)
începutul seriei temporale. Este necesar un timp în secunde de la epocă (1970-01-01).
Numerele negative sunt relative la ora curentă. În mod implicit, merită o zi
datele vor fi preluate. Consultați și secțiunea AT-STYLE TIME SPECIFICATION pentru mai multe detalii
explicații despre modalitățile de a specifica ora de începere.

--Sfârșit|-e capăt (implicit acum)
sfârșitul seriei temporale în secunde de la epocă. Vezi și AT-STYLE TIME
Secțiunea SPECIFICAȚII pentru o explicație detaliată a modului de specificare a orei de încheiere.

--align-start|-a
Reglați automat ora de pornire în jos pentru a fi aliniată cu rezoluția. The
ora de încheiere este ajustată cu aceeași sumă. Acest lucru evită nevoia de extern
calculele descrise în INTERVALUL DE REZOLUȚIE, deși dacă se dorește un anumit RRA
acest lucru nu va asigura că începutul și sfârșitul se încadrează în limitele sale.

--daemon|-d adresa
Adresa demonului rrdcached. Dacă este specificat, o comandă de „încărcare” este trimisă către
server înainte de a citi fișierele RRD. Asta permite rrdtool chiar și pentru a returna date proaspete
dacă demonul este configurat pentru a stoca în cache valori pentru o perioadă lungă de timp. Pentru o listă de
formate acceptate, vezi -l opțiunea din manualul rrdcached.

rrdtool fetch --daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd MEDIE

Vă rugăm să rețineți că, din motive de siguranță a firelor, timpul specificat cu -s si -e
nu poate utiliza formularele complexe descrise în „SPECIFICAREA TEMPULUI AT-STYLE”. Singurul
argumentele acceptate sunt „numere întregi simple”. Valorile pozitive sunt interpretate ca
secunde de la epocă, valorile negative (și zero) sunt interpretate ca fiind relativ la
acum. Deci „1272535035” se referă la „09:57:15 (UCT), 29 aprilie 2010” și „-3600” înseamnă
„acum o oră”.

REZOLUȚIE INTERVAL
Pentru a face ca RRDtool să preia orice altceva decât cea mai bună rezoluție RRA atât il
ora de început și de sfârșit trebuie să fie specificate pe limite care sunt multipli ai celui dorit
rezoluţie. Luați în considerare următorul exemplu:

rrdtool create subdata.rrd -s 10 \
DS:ds0:GAUGE:5m:0:U \
RRA:AVERAGE:0.5:5m:300h \
RRA:AVERAGE:0.5:15m:300h \
RRA:AVERAGE:0.5:1h:50d \
RRA:MAX:0.5:1h:50d \
RRA:AVERAGE:0.5:1d:600d \
RRA:MAX:0.5:1d:600d

Acest RRD colectează date la fiecare 10 secunde și își stochează mediile pe 5 minute, 15
minute, 1 oră și 1 zi, precum și maximele pentru 1 oră și 1 zi.

Luați în considerare acum că doriți să preluați datele medii de 15 minute pentru ultima oră. Tu
ar putea incerca

rrdtool fetch subdata.rrd MEDIE -r 15m -s -1h

Cu toate acestea, acest lucru va avea ca rezultat aproape întotdeauna o serie temporală care este NU în 15 minute RRA.
Prin urmare, se va alege cea mai mare rezoluție RRA, adică medii de 5 minute, care în
acest caz nu este ceea ce vrei tu.

Prin urmare, asigurați-vă că

1. atât ora de început, cât și cea de sfârșit sunt multiplu de 900 ("15m")

2. atât ora de începere, cât și cea de încheiere sunt în RRA dorit

Deci, dacă timpul acum se numește „t”, faceți

ora de încheiere == int(t/900)*900,
ora de începere == ora de încheiere - 1 oră,
rezoluție == 900.

Folosind shell-ul bash, acesta ar putea arăta:

TIME=$(data +%s)
RRDRES=900
rrdtool fetch subdata.rrd AVERAGE -r $RRDRES \
-e $(($TIME/$RRDRES*$RRDRES)) -s e-1h

Sau în Perl:

perl -e '$ctime = timp; $rrdres = 900; \
sistem „rrdtool fetch subdata.rrd AVERAGE \
-r $rrdres -e @{[int($ctime/$rrdres)*$rrdres]} -s e-1h"'

Sau folosind --align-start steag:

rrdtool aduce subdate.rrd AVERAGE -a -r 15m -s -1h

AT-STYLE TIMP SPECIFICAȚIE
În afară de tradițional secunde întrucât epocă, RRDtool înțelege și timpul at-style
specificație. Specificația se numește „at-style” după comanda Unix at(1) că
are modalități moderat complexe de a specifica timpul pentru a vă executa lucrarea la o anumită dată și oră.
Specificația at-style constă din două părți: the TIMP REFERINȚE caietul de sarcini și
TIMP OFFSET specificație.

TIMP REFERINȚE SPECIFICAȚIE
Specificația de referință de timp este folosită, ei bine, pentru a stabili un moment de referință în timp
(la care se aplică apoi decalajul de timp). Când este prezent, ar trebui să fie primul, când
omis, este implicit acum. La rândul său, referința temporală constă în a ora din zi
referință (care ar trebui să apară pe primul loc, dacă este prezentă) și a zi referinţă.

ora din zi poate fi specificat ca HH: MM, HH.MM, sau doar HH. Îl puteți sufix cu am or
pm sau folosiți ceasul de 24 de ore. Sunt înțelese și unele momente speciale ale zilei, inclusiv
miezul nopţii (00: 00), amiază (12:00) și britanic ora ceaiului (16: 00).

zi poate fi specificat ca luna-nume ziua-lunii și opțional un 2 sau 4 cifre an
număr (ex. 8 martie 1999). Alternativ, puteți utiliza numele-zi-a-săptămânii (de ex. luni), sau
unul din cuvinte: ieri, astăzi, mâine. De asemenea, puteți specifica zi ca o dată plină
în mai multe formate numerice, inclusiv LL/ZZ/[AA]AA, ZZ.LL.[AA]AA, AAAAMMDD.

NOTE1: acesta este diferit de originalul at(1) comportament, unde este o dată cu un singur număr
interpretat ca MMZZ[AA]AA.

NOTE2: dacă specificați zi în acest fel, ora din zi este de asemenea NECESARĂ.

În cele din urmă, puteți folosi cuvintele acum, Începe, capăt or epocă ca referință de timp. Acum se referă
la momentul curent (și este, de asemenea, referința de timp implicită). acasă (capăt) poate fi folosit pentru
specificați o oră relativă la ora de început (sfârșit) pentru acele instrumente care utilizează aceste categorii
(rrdfetch, rrdgraph) și epocă indică epoca *IX (marca temporală *IX 0 = 1970-01-01
00:00:00 UTC). epocă este util pentru a dezambigua între o valoare de marcaj temporal și unele forme de
specificații prescurtate pentru dată/ora, deoarece permite utilizarea decalajului de timp
specificații folosind unități, de ex. epocă+19711205s indică fără ambiguitate marcajul de timp 19711205
și nu 1971-12-05 00:00:00 UTC.

Numele lunii și zilei săptămânii pot fi folosite în forma lor abreviată natural (de exemplu, Dec
pentru decembrie, soare pentru duminica etc.). Cuvintele acum, Începe, capăt poate fi prescurtat ca n, s,
e.

TIMP OFFSET SPECIFICAȚIE
Specificația de decalaj de timp este utilizată pentru a adăuga/scădea anumite intervale de timp la/de la
moment de referință temporală. Este format dintr-un semna (+ or -) si un sumă. Data următoare
unitățile pot fi utilizate pentru a specifica sumă: ani, luni, săptămâni, zile, ore, minute,
secunde. Aceste unități pot fi utilizate în formă de singular sau plural și abreviate în mod natural sau
într-o singură literă (de exemplu, +3zile, -1 săptămână, -3a). Se pot combina mai multe unități de timp (de ex.
-5mon1w2d) sau concatenat (de exemplu, -5h45min = -5h-45min = -6h+15min = -7h+1h30m-15min,
etc)

NOTE3: Dacă specificați decalajul de timp în zile, săptămâni, luni sau ani, veți încheia cu
decalaj de timp care poate varia în funcție de referința dvs. de timp, deoarece toate acele unități de timp
nu au o valoare unică a intervalului de timp bine definit (1 an conține fie 365, fie 366 de zile,
O lună durează între 1 și 28 de zile și chiar și o zi poate să nu fie egală cu 31 de ore de două ori pe an,
când au loc ajustări ale ceasului legate de ora de oră). Pentru a face față acestui lucru, când folosiți zile,
săptămâni, luni sau ani, în funcție de unitățile de decalaj a timpului, data de referință de timp este ajustată
în consecință, fără prea mult efort suplimentar pentru a asigura ceva în legătură cu aceasta (în speranța că
mktime(3) se va ocupa de asta mai târziu). Acest lucru poate duce la unele surprize (sau chiar
invalid!), de exemplu, „31 mai -1 lună” = „31 apr” (fără sens) = „1 mai” (după
mktime(3) normalizare); în fusul orar EET „3:30 a.m. 29 martie 1999 -1 zi” produce „3:30 a.m.
28 martie 1999” (duminică), care este o combinație de oră/data nevalidă (din cauza orelor 3:4 -> XNUMX:XNUMX DST
reglarea ceasului înainte, vezi exemplul de mai jos).

În schimb, ore, minute și secunde sunt intervale de timp bine definite și acestea sunt
garantat pentru a produce întotdeauna decalaje de timp exact așa cum este specificat (de exemplu, pentru fusul orar EET,
„8:00 Mar 27 1999 +2 zile” = „8:00 Mar 29 1999”, dar deoarece există 1 oră DST înainte
reglarea ceasului care are loc în jurul orei 3:00 pe 28 martie 1999, intervalul de timp real dintre
8:00 Mar 27 1999 și 8:00 Mar 29 1999 este egal cu 47 de ore; pe de altă parte,
'8:00 Mar 27 1999 +48 hours' = '9:00 Mar 29 1999', as expected)

NOTE4: Abrevierea cu o singură literă pentru ambele luni si minute is m. Pentru a dezambigua
ele, analizatorul încearcă să vă citească gândurile :) aplicând următoarele două euristici:

1. Dacă m este folosit în contextul (adică imediat după) ani, luni, săptămâni sau zile
presupus a însemna luni, în timp ce în contextul orelor, minutelor și secundelor înseamnă
minute. (de exemplu, în -1y6m sau +3w1m m este interpretat ca luni, în timp ce în -3h20m sau +5s2m
m analizatorul decide pentru minute).

2. În afara contextului (adică imediat după + or - semn) sensul de m este ghicit din
numărul pe care îl urmează direct. În prezent, dacă valoarea absolută a numărului este sub 25, acesta
se presupune că m mijloace luni, altfel este tratat ca minute. (de exemplu, -25m == -25
minute, în timp ce +24m == +24 luni)

Final NOTE: Specificarea timpului nu face distincție între majuscule și minuscule. Spațiile albe pot fi introduse liber sau
omis cu totul. Există, totuși, cazuri când sunt necesare spații albe (de exemplu,
„miezul nopții joi”). În acest caz, ar trebui fie să citați întreaga frază pentru a preveni
a fi dezamăgit de shell-ul tău sau folosește „_” (subliniere) sau „,” (virgulă), care contează și ca
spații albe (de exemplu, midnight_Thu sau midnight, Thu).

TIMP SPECIFICAȚIE EXEMPLE
octombrie 12 -- 12 octombrie anul acesta

-1 lună or -1m -- ora curentă a zilei, cu doar o lună înainte (poate aduce surprize, vezi NOTA 3
de mai sus).

amiază ieri -3 ore -- ieri dimineata; poate fi specificat și ca 9:1-XNUMX zi.

23:59 31.12.1999 -- 1 minut până în anul 2000.

12/31/99 11: 59pm -- 1 minut până în anul 2000 pentru imperialiști.

12am 01/01/01 -- începutul noului mileniu

sfârşitul 3 săptămâni or e-3w -- 3 săptămâni înainte de ora de încheiere (poate fi folosit ca specificație pentru ora de începere).

start + 6 ore or s+6h -- 6 ore după ora de începere (poate fi folosit ca specificație pentru ora de încheiere).

931225537 -- 18:45 5 iulie 1999 (da, sunt valabile și secundele din 1970).

19970703 12:45 -- 12:45 3 iulie 1997 (preferatul meu și chiar are un număr ISO
(8601)).

MEDIUL VARIABILE

Următoarele variabile de mediu pot fi utilizate pentru a schimba comportamentul „rrdtool fetch”:

RRDCACHED_ADDRESS
Dacă această variabilă de mediu este setată, va avea același efect ca și specificarea
Opțiunea „--daemon” pe linia de comandă. Dacă ambele sunt prezente, argumentul liniei de comandă
are prioritate.

Utilizați rrdfetch online folosind serviciile onworks.net