rrdfetch - Online di Cloud

PROGRAM:

NAMA

rrdfetch - Mengambil data dari RRD.

RINGKASAN

rrdtool mengambil nama file CF [--resolusi|-r resolusi] [--Mulailah|-s awal] [--akhir|-e akhir]
[--sejajarkan-mulai|-a] [--daemon|-d alamat]

DESKRIPSI

The mengambil fungsi biasanya digunakan secara internal oleh fungsi grafik untuk mendapatkan data dari
RRDs. mengambil akan menganalisis RRD dan mencoba untuk mengambil data dalam resolusi yang diminta.
Data yang diambil dicetak ke stdout. *TIDAK DIKENAL* data sering diwakili oleh string
"NaN" tergantung pada fungsi printf OS Anda.

nama file
nama dari RRD Anda ingin mengambil data dari.

CF fungsi konsolidasi yang diterapkan pada data yang ingin Anda ambil
(RATA-RATA,MIN,MAX,TERAKHIR)

--resolusi|-r resolusi (default adalah resolusi tertinggi)
interval yang Anda inginkan untuk memiliki nilai (detik per nilai). Sufiks opsional
dapat digunakan (misalnya "5m" bukan 300 detik). ambil akan mencoba untuk mencocokkan Anda
permintaan, tetapi itu akan mengembalikan data bahkan jika tidak ada kecocokan mutlak yang mungkin. Lihat
"INTERVAL RESOLUSI".

--Mulailah|-s awal (default akhir-1 hari)
dimulainya deret waktu. Diperlukan waktu dalam detik sejak zaman (1970-01-01).
Angka negatif relatif terhadap waktu saat ini. Secara default, satu hari senilai
data akan diambil. Lihat juga bagian SPESIFIKASI WAKTU GAYA untuk detailnya
penjelasan tentang cara menentukan waktu mulai.

--akhir|-e akhir (default sekarang)
akhir deret waktu dalam detik sejak epoch. Lihat juga WAKTU GAYA
Bagian SPESIFIKASI untuk penjelasan rinci tentang cara menentukan waktu akhir.

--sejajarkan-mulai|-a
Secara otomatis menyesuaikan waktu mulai ke bawah agar selaras dengan resolusi. NS
waktu akhir disesuaikan dengan jumlah yang sama. Ini menghindari kebutuhan eksternal
perhitungan yang dijelaskan dalam INTERVAL RESOLUSI, meskipun jika RRA tertentu diinginkan
ini tidak akan memastikan awal dan akhir berada dalam batas-batasnya.

--daemon|-d alamat
Alamat daemon rrdcached. Jika ditentukan, perintah "flush" dikirim ke
server sebelum membaca file RRD. Ini memungkinkan rrdtool untuk mengembalikan data baru bahkan
jika daemon dikonfigurasikan ke nilai cache untuk waktu yang lama. Untuk daftar
format yang diterima, lihat -l opsi dalam manual rrdcached.

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

Harap dicatat bahwa karena alasan keamanan utas, waktu yang ditentukan dengan -s dan -e
tidak dapat menggunakan bentuk kompleks yang dijelaskan dalam "SPESIFIKASI WAKTU GAYA". Satu-satunya
argumen yang diterima adalah "bilangan bulat sederhana". Nilai positif diartikan sebagai
detik sejak zaman, nilai negatif (dan nol) ditafsirkan sebagai relatif terhadap
sekarang. Jadi "1272535035" mengacu pada "09:57:15 (UCT), 29 April 2010" dan "-3600" berarti
"satu jam yang lalu".

RESOLUSI SELANG
Untuk mendapatkan RRDtool untuk mengambil apa pun selain RRA resolusi terbaik kedua itu
waktu mulai dan berakhir harus ditentukan pada batas yang merupakan kelipatan dari yang diinginkan
resolusi. Perhatikan contoh berikut:

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

RRD ini mengumpulkan data setiap 10 detik dan menyimpan rata-ratanya selama 5 menit, 15
menit, 1 jam, dan 1 hari, serta maksimum selama 1 jam dan 1 hari.

Pertimbangkan sekarang bahwa Anda ingin mengambil data rata-rata 15 menit untuk satu jam terakhir. Anda
mungkin mencoba

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

Namun, ini hampir selalu menghasilkan deret waktu yang JANGAN dalam 15 menit RRA.
Oleh karena itu, RRA resolusi tertinggi, yaitu rata-rata 5 menit, akan dipilih yang di
kasus ini bukan yang Anda inginkan.

Oleh karena itu, pastikan bahwa

1. waktu mulai dan waktu berakhir adalah kelipatan 900 ("15m")

2. waktu mulai dan waktu berakhir berada dalam RRA yang diinginkan

Jadi, jika waktu sekarang disebut "t", lakukan

waktu berakhir == int(t/900)*900,
waktu mulai == waktu berakhir - 1 jam,
resolusi == 900.

Menggunakan bash Shell, ini bisa terlihat seperti:

WAKTU=$(tanggal +%s)
RRDRES=900
rrdtool fetch subdata.rrd RATA-RATA -r $RRDRES \
-e $(($TIME/$RRDRES*$RRDRES)) -s e-1j

Atau di Perl:

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

Atau menggunakan --sejajarkan-mulai bendera:

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

AT-GAYA WAKTU SPESIFIKASI
Selain tradisional Detik sejak masa, RRDtool juga memahami waktu gaya
spesifikasi. Spesifikasinya disebut "at-style" setelah perintah Unix at(1) itu
memiliki cara yang cukup rumit untuk menentukan waktu untuk menjalankan pekerjaan Anda pada tanggal dan waktu tertentu.
Spesifikasi at-style terdiri dari dua bagian: the WAKTU REFERENSI spesifikasi dan
WAKTU OFFSET spesifikasi.

WAKTU REFERENSI SPESIFIKASI
Spesifikasi referensi waktu digunakan, yah, untuk menetapkan momen referensi dalam waktu
(di mana offset waktu kemudian diterapkan). Saat hadir, itu harus didahulukan, kapan
dihilangkan, defaultnya adalah sekarang. Pada bagian sendiri, referensi waktu terdiri dari a waktu hari
referensi (yang harus didahulukan, jika ada) dan a hari referensi.

The waktu hari dapat ditentukan sebagai HH: MM, HH.MM, atau hanya HH. Anda dapat menambahkannya dengan am or
pm atau menggunakan jam 24 jam. Beberapa waktu khusus dalam sehari juga dipahami, termasuk
tengah malam (00: 00), tengah hari (12:00) dan Inggris minum teh (16: 00).

The hari dapat ditentukan sebagai nama-bulan hari-bulan dan opsional 2- atau 4-digit tahun
nomor (misalnya 8 Maret 1999). Atau, Anda dapat menggunakan nama-hari-minggu (misalnya Senin), atau
salah satu kata: kemarin, hari ini, besok. Anda juga dapat menentukan hari sebagai tanggal penuh
dalam beberapa format numerik, termasuk BB/DD/[YY]YY, DD.MM.[YY]YY, atau YYYYMMDD.

NOTE1: ini berbeda dari aslinya at(1) perilaku, di mana tanggal satu nomor adalah
ditafsirkan sebagai MMDD[YY]YY.

NOTE2: jika Anda menentukan hari dengan cara ini, file waktu hari WAJIB juga.

Akhirnya, Anda dapat menggunakan kata-kata sekarang, awal, akhir or masa sebagai referensi waktu Anda. Sekarang mengacu
ke momen saat ini (dan juga merupakan referensi waktu default). Start (akhir) dapat digunakan untuk
tentukan waktu relatif terhadap waktu mulai (akhir) untuk alat-alat yang menggunakan kategori ini
(ambil, rrdgraph) dan masa menunjukkan *IX zaman (*IX stempel waktu 0 = 1970-01-01
00:00:00 WIB). masa berguna untuk membedakan antara nilai stempel waktu dan beberapa bentuk
spesifikasi tanggal/waktu disingkat, karena memungkinkan seseorang untuk menggunakan offset waktu
spesifikasi menggunakan unit, mis. masa+19711205s jelas menunjukkan stempel waktu 19711205
dan bukan 1971-12-05 00:00:00 UTC.

Nama bulan dan hari dalam seminggu dapat digunakan dalam bentuk yang disingkat secara alami (misalnya, Des
untuk Desember, Minggu untuk Minggu, dll.). Kata-kata sekarang, awal, akhir dapat disingkat n, s,
e.

WAKTU OFFSET SPESIFIKASI
Spesifikasi offset waktu digunakan untuk menambah/mengurangi interval waktu tertentu ke/dari
momen referensi waktu. Terdiri dari menandatangani (+ or -) dan jumlah. Waktu berikutnya
unit dapat digunakan untuk menentukan jumlah: tahun, bulan, minggu, hari-hari, jam, menit, atau
detik. Satuan ini dapat digunakan dalam bentuk tunggal atau jamak, dan disingkat secara alami atau
ke satu huruf (misalnya +3 hari, -1 minggu, -3 tahun). Beberapa unit waktu dapat digabungkan (misalnya,
-5mon1w2d) atau digabungkan (misalnya, -5h45min = -5h-45min = -6h+15min = -7h+1h30m-15min,
dll)

NOTE3: Jika Anda menentukan offset waktu dalam hari, minggu, bulan, atau tahun, Anda akan diakhiri dengan
offset waktu yang dapat bervariasi tergantung pada referensi waktu Anda, karena semua unit waktu itu
tidak memiliki nilai interval waktu tunggal yang terdefinisi dengan baik (1 tahun berisi 365 atau 366 hari,
1 bulan adalah 28 hingga 31 hari, dan bahkan 1 hari mungkin tidak sama dengan 24 jam dua kali setahun,
saat penyesuaian jam terkait DST berlangsung). Untuk mengatasi hal ini, ketika Anda menggunakan hari,
minggu, bulan, atau tahun sebagai unit offset waktu Anda, tanggal referensi waktu Anda disesuaikan
sesuai tanpa terlalu banyak upaya lebih lanjut untuk memastikan apa pun tentang hal itu (dengan harapan bahwa
waktu mk(3) akan mengurus ini nanti). Hal ini dapat menyebabkan beberapa kejutan (atau bahkan
tidak valid!) hasil, misalnya '31 Mei -1bulan' = '31 April' (tidak berarti) = '1 Mei' (setelah
waktu mk(3) normalisasi); di zona waktu EET '3:30am 29 Mar 1999 -1 hari' menghasilkan '3:30
28 Mar 1999' (Minggu) yang merupakan kombinasi waktu/tanggal yang tidak valid (karena pukul 3 pagi -> 4 pagi DST
penyesuaian jam maju, lihat contoh di bawah).

Sebaliknya, jam, menit, dan detik adalah interval waktu yang ditentukan dengan baik, dan ini adalah
dijamin untuk selalu menghasilkan offset waktu persis seperti yang ditentukan (misalnya untuk zona waktu EET,
'8:00 27 Mar 1999 +2 hari' = '8:00 29 Mar 1999', tetapi karena ada 1 jam DST maju
penyesuaian jam yang terjadi sekitar 3:00 28 Mar 1999, interval waktu sebenarnya antara
8:00 27 Maret 1999 dan 8:00 29 Maret 1999 sama dengan 47 jam; di samping itu,
'8:00 Mar 27 1999 +48 hours' = '9:00 Mar 29 1999', as expected)

NOTE4: Singkatan satu huruf untuk keduanya bulan dan menit is m. untuk mendisambiguasi
mereka, parser mencoba membaca pikiran Anda :) dengan menerapkan dua heuristik berikut:

1. Jika m digunakan dalam konteks (yaitu tepat setelah) tahun, bulan, minggu, atau hari itu
diasumsikan berarti bulan, sedangkan dalam konteks jam, menit, dan detik artinya
menit. (misalnya, dalam -1y6m atau +3w1m m ditafsirkan sebagai bulan, sedangkan di -3j20m atau +5s2m
m pengurai memutuskan untuk menit).

2. Di luar konteks (yaitu tepat setelah + or - tanda) arti dari m diduga dari
nomor itu langsung mengikuti. Saat ini, jika nilai absolut angka di bawah 25 itu
diasumsikan bahwa m cara bulan, jika tidak maka diperlakukan sebagai menit. (misalnya, -25m == -25
menit, sedangkan +24m == +24 bulan)

Terakhir CATATAN: Spesifikasi waktu tidak peka huruf besar/kecil. Spasi dapat disisipkan secara bebas atau
dihilangkan sama sekali. Namun, ada kasus ketika spasi diperlukan (misalnya,
'Kamis tengah malam'). Dalam hal ini Anda harus mengutip seluruh frasa untuk mencegahnya
dibongkar oleh shell Anda atau gunakan '_' (garis bawah) atau ',' (koma) yang juga dihitung sebagai
spasi putih (misalnya, tengah malam_Kamis atau tengah malam,Kamis).

WAKTU SPESIFIKASI CONTOH
Oktober 12 -- 12 Oktober tahun ini

-1 bulan or -1m -- waktu saat ini, hanya sebulan sebelumnya (dapat menghasilkan kejutan, lihat CATATAN3
atas).

tengah hari kemarin -3 jam -- kemarin pagi; juga dapat ditentukan sebagai 9-1hari.

23:59 31.12.1999 -- 1 menit menuju tahun 2000.

12/31/99 11: 59pm -- 1 menit menuju tahun 2000 bagi kaum imperialis.

12am 01/01/01 -- awal milenium baru

akhir-3minggu or e-3w -- 3 minggu sebelum waktu berakhir (dapat digunakan sebagai spesifikasi waktu mulai).

mulai + 6 jam or s+6j -- 6 jam setelah waktu mulai (dapat digunakan sebagai spesifikasi waktu akhir).

931225537 -- 18:45 5 Juli 1999 (ya, detik sejak 1970 juga berlaku).

19970703 12:45 -- 12:45 3 Juli 1997 (favorit saya, dan bahkan mendapat nomor ISO
(8601)).

LINGKUNGAN VARIABEL

Variabel lingkungan berikut dapat digunakan untuk mengubah perilaku "rrdtool fetch":

RRDCACHED_ADDRESS
Jika variabel lingkungan ini disetel, itu akan memiliki efek yang sama seperti menentukan
opsi "--daemon" pada baris perintah. Jika keduanya ada, argumen baris perintah
diutamakan.

Gunakan rrdfetch online menggunakan layanan onworks.net