rrdfetch - Dalam Talian di Awan

JADUAL:

NAMA

rrdfetch - Ambil data daripada RRD.

SINOPSIS

rrdtool ambil nama fail CF [--resolusi|-r resolusi] [--mula|-s permulaan] [--akhir|-e akhir]
[--align-start|-a] [--daemon|-d alamat]

DESCRIPTION

. ambil fungsi biasanya digunakan secara dalaman oleh fungsi graf untuk mendapatkan data daripada
DRRs. ambil akan menganalisis DRR dan cuba dapatkan semula data dalam resolusi yang diminta.
Data yang diambil dicetak ke stdout. *TIDAK DIKENAL* data selalunya diwakili oleh rentetan
"NaN" bergantung pada fungsi printf OS anda.

nama fail
nama DRR anda ingin mengambil data daripada.

CF fungsi penyatuan yang digunakan pada data yang ingin anda ambil
(PURATA, MIN, MAKS, TERAKHIR)

--resolusi|-r resolusi (lalai ialah resolusi tertinggi)
selang yang anda mahu nilai mempunyai (saat setiap nilai). Akhiran pilihan
boleh digunakan (cth "5m" bukannya 300 saat). rrdfetch akan cuba memadankan anda
permintaan, tetapi ia akan mengembalikan data walaupun tiada padanan mutlak yang mungkin. Lihat
"SELANG PENYELESAIAN".

--mula|-s permulaan (1 hari akhir lalai)
permulaan siri masa. Masa dalam saat sejak zaman (1970-01-01) diperlukan.
Nombor negatif adalah relatif kepada masa semasa. Secara lalai, nilai satu hari
data akan diambil. Lihat juga bahagian SPESIFIKASI MASA BERGAYA untuk butiran terperinci
penerangan tentang cara untuk menentukan masa mula.

--akhir|-e akhir (lalai sekarang)
penghujung siri masa dalam beberapa saat sejak zaman. Lihat juga MASA BERGAYA
Bahagian SPESIFIKASI untuk penerangan terperinci tentang cara menentukan masa akhir.

--align-start|-a
Laraskan masa mula secara automatik ke bawah untuk diselaraskan dengan resolusi. The
masa akhir diselaraskan dengan jumlah yang sama. Ini mengelakkan keperluan untuk luaran
pengiraan diterangkan dalam SELANG RESOLUSI, walaupun jika RRA tertentu dikehendaki
ini tidak akan memastikan permulaan dan akhir berada dalam batasnya.

--daemon|-d alamat
Alamat daemon rrdcached. Jika dinyatakan, arahan "flush" dihantar ke
pelayan sebelum membaca fail RRD. Ini membenarkan rrdtool untuk mengembalikan data baharu walaupun
jika daemon dikonfigurasikan untuk menyimpan nilai untuk masa yang lama. Untuk senarai
format yang diterima, lihat -l pilihan dalam manual rrdcached.

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

Sila ambil perhatian bahawa atas sebab keselamatan benang, masa yang ditentukan dengan -s and -e
tidak boleh menggunakan borang kompleks yang diterangkan dalam "SPESIFIKASI MASA STYLE". Satu-satunya
hujah yang diterima ialah "integer mudah". Nilai positif ditafsirkan sebagai
saat sejak zaman, nilai negatif (dan sifar) ditafsirkan sebagai relatif kepada
kini. Jadi "1272535035" merujuk kepada "09:57:15 (UCT), 29 April 2010" dan "-3600" bermaksud
"sejam yang lalu".

RESOLUSI INTERVAL
Untuk mendapatkan RRDtool untuk mengambil apa-apa selain daripada RRA resolusi terbaik kedua-dua yang
masa mula dan tamat mesti dinyatakan pada sempadan yang merupakan gandaan daripada yang dikehendaki
resolusi. Pertimbangkan contoh berikut:

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

RRD ini mengumpul data setiap 10 saat dan menyimpan puratanya selama 5 minit, 15
minit, 1 jam, dan 1 hari, serta maksimum selama 1 jam dan 1 hari.

Pertimbangkan sekarang bahawa anda ingin mengambil data purata 15 minit untuk sejam terakhir. awak
boleh cuba

rrdtool ambil subdata.rrd PURATA -r 15m -s -1j

Walau bagaimanapun, ini hampir selalu akan menghasilkan siri masa iaitu TIDAK dalam 15 minit RRA.
Oleh itu, RRA resolusi tertinggi, iaitu purata 5 minit, akan dipilih yang dalam
kes ini bukan yang anda mahukan.

Oleh itu, pastikan itu

1. kedua-dua masa mula dan tamat ialah gandaan 900 ("15m")

2. kedua-dua masa mula dan tamat adalah dalam RRA yang dikehendaki

Jadi, jika masa sekarang dipanggil "t", lakukan

masa tamat == int(t/900)*900,
masa mula == masa tamat - 1 jam,
resolusi == 900.

Menggunakan shell bash, ini mungkin kelihatan seperti:

MASA=$(tarikh +%s)
RRDRES=900
rrdtool ambil subdata.rrd PURATA -r $RRDRES \
-e $(($TIME/$RRDRES*$RRDRES)) -s e-1j

Atau dalam Perl:

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

Atau menggunakan --align-start bendera:

rrdtool ambil subdata.rrd PURATA -a -r 15m -s -1j

BERGAYA MASA SPESIFIKASI
Selain daripada yang tradisional Seconds sejak zaman, RRDtool juga memahami masa gaya
spesifikasi. Spesifikasi dipanggil "gaya-gaya" selepas arahan Unix at(1) itu
mempunyai cara yang sederhana kompleks untuk menentukan masa untuk menjalankan tugas anda pada tarikh dan masa tertentu.
Spesifikasi at-style terdiri daripada dua bahagian: the MASA RUJUKAN spesifikasi dan
MASA OFFSET spesifikasi.

MASA RUJUKAN SPESIFIKASI
Spesifikasi rujukan masa digunakan, dengan baik, untuk mewujudkan momen rujukan dalam masa
(yang kemudiannya offset masa digunakan). Apabila hadir, ia harus didahulukan, apabila
ditinggalkan, ia lalai kepada kini. Pada bahagiannya sendiri, rujukan masa terdiri daripada a masa dalam sehari
rujukan (yang sepatutnya didahulukan, jika ada) dan a hari rujukan.

. masa dalam sehari boleh dinyatakan sebagai HH: MM, HH.MM, atau hanya HH. Anda boleh mengimbuhkannya dengan am or
pm atau gunakan jam 24 jam. Beberapa waktu istimewa dalam sehari juga difahami, termasuk
tengah malam (00: 00), tengah hari (12:00) dan British teatime (16: 00).

. hari boleh dinyatakan sebagai nama bulan hari-dalam-bulan dan pilihan 2- atau 4-digit tahun
nombor (cth 8 Mac 1999). Sebagai alternatif, anda boleh menggunakan nama hari-dalam-minggu (cth Isnin), atau
salah satu perkataan: semalam, hari ini, esok. Anda juga boleh menentukan hari sebagai tarikh penuh
dalam beberapa format berangka, termasuk MM/DD/[YY]YY, DD.MM.[YY]YY, Atau YYYYMMDD.

NOTE1: ini berbeza dari yang asal at(1) tingkah laku, di mana tarikh nombor tunggal adalah
ditafsirkan sebagai MMDD[YY]YY.

NOTE2: jika anda nyatakan hari dengan cara ini, yang masa dalam sehari adalah DIPERLUKAN juga.

Akhirnya, anda boleh menggunakan perkataan kini, permulaan, akhir or zaman sebagai rujukan masa anda. Sekarang merujuk
kepada momen semasa (dan juga merupakan rujukan masa lalai). Start (akhir) boleh digunakan untuk
tentukan masa relatif kepada masa mula (akhir) untuk alatan yang menggunakan kategori ini
(rrdfetch, rrdgraph) dan zaman menunjukkan zaman *IX (*cap masa IX 0 = 1970-01-01
00:00:00 UTC). zaman berguna untuk menyahkekaburan antara nilai cap masa dan beberapa bentuk
spesifikasi tarikh/masa yang disingkatkan, kerana ia membolehkan seseorang menggunakan offset masa
spesifikasi menggunakan unit, cth. zaman+19711205s dengan jelas menandakan cap masa 19711205
dan bukan 1971-12-05 00:00:00 UTC.

Nama bulan dan hari dalam minggu boleh digunakan dalam bentuk yang disingkatkan secara semula jadi (cth, Dis
untuk Disember, Matahari untuk Ahad, dll.). Kata-kata kini, permulaan, akhir boleh disingkatkan sebagai n, s,
e.

MASA OFFSET SPESIFIKASI
Spesifikasi mengimbangi masa digunakan untuk menambah/menolak selang masa tertentu ke/daripada
detik rujukan masa. Ia terdiri daripada a menandatangani (+ or -) dan a jumlah. Masa berikutnya
unit boleh digunakan untuk menentukan jumlah: tahun, bulan, minggu, hari, jam, minit, Atau
saat. Unit ini boleh digunakan dalam bentuk tunggal atau jamak, dan disingkatkan secara semula jadi atau
kepada satu huruf (cth +3hari, -1wk, -3y). Beberapa unit masa boleh digabungkan (cth,
-5bln1w2d) atau bercantum (cth, -5j45min = -5j-45min = -6j+15min = -7j+1j30m-15min,
dll)

NOTE3: Jika anda menentukan masa mengimbangi dalam hari, minggu, bulan atau tahun, anda akan berakhir dengan
offset masa yang mungkin berbeza bergantung pada rujukan masa anda, kerana semua unit masa tersebut
tidak mempunyai nilai selang masa tunggal yang jelas (1 tahun mengandungi sama ada 365 atau 366 hari,
1 bulan adalah 28 hingga 31 hari, dan walaupun 1 hari mungkin tidak sama dengan 24 jam dua kali setahun,
apabila pelarasan jam berkaitan DST berlaku). Untuk mengatasinya, apabila anda menggunakan hari,
minggu, bulan atau tahun sebagai unit mengimbangi masa anda tarikh rujukan masa anda dilaraskan
sewajarnya tanpa terlalu banyak usaha lanjut untuk memastikan apa-apa mengenainya (dengan harapan bahawa
mktime(3) akan uruskan nanti). Ini mungkin membawa kepada sesuatu yang mengejutkan (atau malah
keputusan tidak sah!), cth. '31 Mei -1 bulan' = '31 Apr' (tidak bermakna) = '1 Mei' (selepas
mktime(3) normalisasi); dalam zon waktu EET '3:30 pagi 29 Mac 1999 -1 hari' menghasilkan '3:30 pagi
28 Mac 1999' (Ahad) yang merupakan gabungan masa/tarikh yang tidak sah (kerana 3 pagi -> 4 pagi DST
pelarasan jam ke hadapan, lihat contoh di bawah).

Sebaliknya, jam, minit dan saat adalah selang masa yang ditakrifkan dengan baik, dan ini adalah
dijamin sentiasa menghasilkan offset masa tepat seperti yang ditentukan (cth untuk zon waktu EET,
'8:00 Mac 27 1999 +2 hari' = '8:00 Mac 29 1999', tetapi kerana terdapat 1 jam DST ke hadapan
pelarasan jam yang berlaku sekitar 3:00 Mac 28 1999, selang masa sebenar antara
8:00 Mac 27 1999 dan 8:00 Mac 29 1999 bersamaan dengan 47 jam; selain itu,
'8:00 Mar 27 1999 +48 hours' = '9:00 Mar 29 1999', as expected)

NOTE4: Singkatan huruf tunggal untuk kedua-duanya bulan and minit is m. Untuk menyahkekaburan
mereka, penghurai cuba membaca fikiran anda :) dengan menggunakan dua heuristik berikut:

1. Jika m digunakan dalam konteks (iaitu sejurus selepas) tahun, bulan, minggu atau hari
diandaikan bermaksud bulan, manakala dalam konteks jam, minit dan saat ia bermakna
minit. (cth, dalam -1y6m atau +3w1m m ditafsirkan sebagai bulan, manakala dalam -3j20m atau +5s2m
m penghurai memutuskan untuk minit).

2. Di luar konteks (iaitu sejurus selepas + or - tanda) maksud m diduga daripada
nombor yang diikutinya secara langsung. Pada masa ini, jika nilai mutlak nombor adalah di bawah 25 ia
diandaikan bahawa m cara bulan, jika tidak ia dianggap sebagai minit. (cth, -25m == -25
minit, manakala +24m == +24 bulan)

Final NOTA: Spesifikasi masa adalah tidak peka huruf besar-besaran. Ruang putih boleh dimasukkan secara bebas atau
ditinggalkan sama sekali. Walau bagaimanapun, terdapat kes apabila ruang putih diperlukan (cth,
'tengah malam Kha'). Dalam kes ini, anda harus sama ada memetik keseluruhan frasa untuk mengelakkannya
dipisahkan oleh cangkerang anda atau gunakan '_' (garis bawah) atau ',' (koma) yang juga dikira sebagai
ruang kosong (cth, tengah malam_Kha atau tengah malam, Khamis).

MASA SPESIFIKASI CONTOH
oktober 12 -- 12 Oktober tahun ini

-1 bulan or -1m -- masa semasa hari, hanya sebulan sebelum (mungkin menghasilkan kejutan, lihat NOTA3
di atas).

tengah hari semalam -3 jam -- pagi semalam; juga boleh dinyatakan sebagai 9 pagi-1 hari.

23:59 31.12.1999 -- 1 minit ke tahun 2000.

12/31/99 11: 59pm -- 1 minit hingga tahun 2000 untuk imperialis.

12am 01/01/01 -- permulaan alaf baru

akhir-3minggu or e-3w -- 3 minggu sebelum masa tamat (boleh digunakan sebagai spesifikasi masa mula).

mula+6jam or s+6j -- 6 jam selepas masa mula (boleh digunakan sebagai spesifikasi masa tamat).

931225537 -- 18:45 5 Julai 1999 (ya, saat sejak 1970 juga sah).

19970703 12:45 -- 12:45 3 Julai 1997 (kegemaran saya, malah ia mendapat nombor ISO
(8601)).

PERSEKITARAN PELBAGAI

Pembolehubah persekitaran berikut boleh digunakan untuk menukar tingkah laku "rrdtool fetch":

RRDCACHED_ADDRESS
Jika pembolehubah persekitaran ini ditetapkan, ia akan mempunyai kesan yang sama seperti menentukan
Pilihan "--daemon" pada baris arahan. Jika kedua-duanya hadir, hujah baris arahan
diutamakan.

Gunakan rrdfetch dalam talian menggunakan perkhidmatan onworks.net