rrdcached - Dalam talian dalam Awan

JADUAL:

NAMA

rrdcached - Daemon caching data untuk rrdtool

SINOPSIS

rrdcached [-a alloc_size] [-b base_dir [-B]] [-F] [-f timeout] [-G kumpulan]] [-g]
[-j journal_dir] [-L] [-l alamat] [-m mod] [-O] [-P kebenaran] [-p pid_file] [-R]
[-s kumpulan] [-t tulis_benang] [-U pengguna]] [-w timeout] [-z kelewatan]

DESCRIPTION

rrdcached ialah daemon yang menerima kemas kini kepada fail RRD sedia ada, mengumpulnya dan,
jika cukup telah diterima atau masa yang ditetapkan telah berlalu, tulis kemas kini kepada RRD
fail. A flush arahan boleh digunakan untuk memaksa penulisan nilai ke cakera, supaya grafik
kemudahan dan seumpamanya boleh berfungsi dengan data terkini.

Daemon telah ditulis dengan setup yang besar dalam fikiran. Persediaan tersebut biasanya berlaku kepada IO berkaitan
masalah lambat laun atas sebab yang di luar skop dokumen ini. Semak
wiki di laman utama RRDtool untuk butiran. Semak juga "PERTIMBANGAN KESELAMATAN" di bawah
sebelum menggunakan daemon ini! Penerangan terperinci tentang cara daemon beroperasi boleh didapati
dalam bahagian "CARA IA BERFUNGSI" di bawah.

PILIHAN

-l alamat
Memberitahu daemon untuk mengikat alamat dan menerima sambungan TCP masuk mengenainya
soket. Jika alamat bermula dengan "unix:", semua yang mengikuti awalan itu ialah
ditafsirkan sebagai laluan ke soket domain UNIX. Jika tidak, alamat atau nama nod
diselesaikan menggunakan "getaddrinfo()".

Untuk soket rangkaian, port boleh ditentukan dengan menggunakan borang "[alamat]:pelabuhan". Jika
alamatnya ialah alamat IPv4 atau nama domain yang layak sepenuhnya (iaitu alamat
mengandungi sekurang-kurangnya satu titik (".")), kurungan segi empat sama boleh diabaikan, mengakibatkan
(lebih ringkas)"alamat:pelabuhan" corak. Port lalai ialah 42217. Jika anda menentukan rangkaian
soket, adalah wajib untuk membaca bahagian "PERTIMBANGAN KESELAMATAN".

Format berikut diterima. Sila ambil perhatian bahawa alamat domain UNIX
soket kemestian mulakan dengan garis miring dalam kes kedua!

unix:
/

[ ]:
:

Memandangkan port tanpa hos (cth "-l :42217") daemon akan mendengar pada port itu pada
semua antara muka rangkaian. Gunakan "-L" untuk mengelakkan keperluan untuk menyediakan port jika secara eksplisit
port lalai dikehendaki.

Jika tidak -l pilihan tidak dinyatakan alamat lalai, "unix:/tmp/rrdcached.sock", akan
digunakan. Pelbagai -l pilihan mungkin disediakan.

-L Memberitahu daemon untuk mengikat port TCP lalai pada semua antara muka yang tersedia. Ia adalah
bersamaan dengan "-l ''" tanpa kekeliruan parameter rentetan kosong.

-s nama kumpulan|gid
Tetapkan kebenaran kumpulan soket domain UNIX. Pilihan menerima sama ada angka
id kumpulan atau nama kumpulan. Kumpulan itu kemudiannya akan mempunyai kedua-dua kebenaran membaca dan menulis (the
soket akan mempunyai kebenaran fail 0760) untuk soket dan, oleh itu, boleh menghantar
arahan kepada daemon. Ini mungkin berguna dalam kes di mana anda tidak boleh menjalankan semua dengan mudah
Proses RRD dengan keistimewaan pengguna yang sama (cth graf menjana skrip CGI yang
biasanya dijalankan dalam konteks kebenaran pelayan web).

Pilihan ini mempengaruhi berikutan Alamat soket UNIX (yang berikut -l pilihan) atau
soket lalai (jika tidak -l pilihan telah ditentukan), iaitu, anda boleh menentukan
tetapan berbeza untuk soket berbeza.

Lalainya bukan untuk menukar pemilikan atau kebenaran soket dan, oleh itu, gunakan
lalai sistem.

-m mod
Tetapkan kebenaran fail soket domain UNIX. Pilihan menerima nombor perlapanan
mewakili corak bit untuk mod (lihat Chmod(1) untuk butiran).

Sila ambil perhatian bahawa tidak semua sistem menghormati tetapan ini. Di Linux, kebenaran baca/tulis
diperlukan untuk menyambung ke soket UNIX. Walau bagaimanapun, banyak sistem terbitan BSD mengabaikan
kebenaran untuk soket UNIX. Lihat unix(7) untuk butiran.

Pilihan ini mempengaruhi berikutan Alamat soket UNIX (yang berikut -l pilihan) atau
soket lalai (jika tidak -l pilihan telah ditentukan), iaitu, anda boleh menentukan
tetapan berbeza untuk soket berbeza.

Lalainya bukan untuk menukar pemilikan atau kebenaran soket dan, oleh itu, gunakan
lalai sistem.

-P arahan[,arahan[,...]]
Menentukan arahan yang diterima melalui kedua-dua rangkaian dan soket UNIX. Ini membenarkan
pentadbir bagi RRDCacheD untuk mengawal tindakan yang diterima daripada pelbagai sumber.

Hujah-hujah yang diberikan kepada -P pilihan ialah senarai arahan yang dipisahkan koma. Untuk
contoh, untuk membenarkan arahan "FLUSH" dan "PENDING" seseorang boleh menentukan:

rrdcached -P FLUSH,PENDING $MORE_ARGUMENTS

. -P pilihan mempengaruhi berikutan alamat soket (yang berikut -l pilihan) atau
soket lalai (jika tidak -l pilihan telah ditentukan). Dalam contoh berikut, sahaja
soket rangkaian IPv4 (alamat 10.0.0.1) akan dihadkan kepada "FLUSH" dan
Perintah "PENDING":

rrdcached -l unix:/some/path -P FLUSH,TUNDA -l 10.0.0.1

Senarai lengkap arahan yang tersedia boleh didapati di bahagian "Arahan Sah"
di bawah. Terdapat dua pengecualian khas kecil:

· Arahan "HELP" dan "QUIT" sentiasa dibenarkan.

· Jika arahan "BATCH" diterima, . arahan akan diterima secara automatik,
juga.

Sila baca juga "PERTIMBANGAN KESELAMATAN" di bawah.

-w timeout
Data ditulis ke cakera setiap timeout detik. Akhiran pilihan boleh digunakan (cth
"5m" bukannya 300 saat). Jika pilihan ini tidak dinyatakan selang lalai bagi
300 saat akan digunakan.

-z kelewatan
Jika dinyatakan, rrdcached akan menangguhkan penulisan setiap RRD untuk beberapa saat rawak
dalam julat [0,kelewatan). Ini akan mengelakkan terlalu banyak penulisan beratur secara serentak.
Nilai ini tidak boleh lebih besar daripada nilai yang dinyatakan dalam -w. Akhiran pilihan
boleh digunakan (cth "3m" bukannya 180 saat). Secara lalai, tiada kelewatan.

-f timeout
Setiap timeout saat keseluruhan cache dicari untuk nilai lama yang ditulis
cakera. Ini hanya melibatkan fail yang kemas kini telah berhenti, jadi tetapkan ini kepada a
nilai tinggi, seperti 3600 saat, boleh diterima dalam kebanyakan kes. Akhiran pilihan boleh
digunakan (cth "1j" bukannya 3600 saat). Tamat masa ini lalai kepada 3600 saat.

-p fail
Menetapkan nama dan lokasi fail PID. Jika tidak dinyatakan, lalai,
"$localstatedir/run/rrdcached.pid" akan digunakan.

-t tulis_benang
Menentukan bilangan utas yang digunakan untuk menulis fail RRD. Lalai ialah 4.
Meningkatkan bilangan ini akan membolehkan rrdcached mempunyai lebih banyak permintaan I/O serentak
ke dalam kernel. Ini mungkin membenarkan kernel untuk menyusun semula penulisan cakera, menghasilkan
pemprosesan cakera yang lebih baik.

-j dir
Tulis kemas kini pada jurnal dalam dir. Sekiranya berlaku ranap sistem atau program, ini
akan membenarkan daemon menulis sebarang kemas kini yang belum selesai pada masa ranap sistem.

Pada permulaan, daemon akan menyemak fail jurnal dalam direktori ini. Jika dijumpai, semua
kemas kini di dalamnya akan dibaca ke dalam ingatan sebelum daemon mula menerima yang baru
sambungan.

Jurnal akan diputar dengan frekuensi yang sama seperti pemasa siram yang diberikan oleh -f.

Apabila jurnal didayakan, daemon akan menggunakan prosedur penutupan pantas. Sebaliknya
daripada membuang semua fail ke cakera, ia akan memastikan jurnal ditulis dengan betul dan
keluar dengan segera. Walaupun fail data RRD tidak dikemas kini sepenuhnya, tidak
maklumat hilang; semua kemas kini yang belum selesai akan ditayangkan semula dari jurnal pada masa akan datang
daemon bermula.

Untuk melumpuhkan penutupan pantas, gunakan -F pilihan.

-F SENTIASA siram semua kemas kini kepada fail data RRD apabila daemon dimatikan,
tanpa mengira tetapan jurnal.

-g Berlari di latar depan. Daemon tidak akan garpu ().

-b dir
Daemon akan bertukar menjadi direktori tertentu pada permulaan. Semua fail dihantar ke
daemon, yang ditentukan oleh a relatif laluan, akan ditafsirkan sebagai relatif kepada
direktori ini. Jika tidak diberikan lalai, "/ tmp", akan digunakan.

+--------------------------------------+---------------------- +
! Barisan arahan! Fail dikemas kini!
+--------------------------------------+---------------------- +
! foo.rrd ! /tmp/foo.rrd !
! foo/bar.rrd ! /tmp/foo/bar.rrd !
! /var/lib/rrd/foo.rrd ! /var/lib/rrd/foo.rrd !
+--------------------------------------+---------------------- +
Laluan yang diberikan pada baris arahan dan laluan sebenarnya
dikemas kini oleh daemon, dengan mengandaikan direktori asas
"/ tmp".

AMARAN : Laluan ke dan termasuk direktori asas MUST TIDAK BE pautan simbolik.
Dengan kata lain, jika direktori asas ditentukan sebagai:

-b /base/dir/somewhere

... kemudian NONE daripada yang berikut hendaklah pautan simbolik:

/asas
/base/dir
/base/dir/somewhere

-B Hanya izinkan menulis ke dalam direktori asas yang dinyatakan dalam -b (dan mana-mana sub-direktori).
Ini tidak TIDAK mengesan pautan simbolik. Laluan yang mengandungi "../" juga akan disekat.

-R Benarkan penciptaan subdirektori rekursif dalam direktori asas yang dinyatakan dalam -b (dan mana-mana
sub-direktori). Hanya boleh digunakan apabila -B juga ditetapkan.

-a alloc_size
Peruntukkan penunjuk nilai dalam ketulan alloc_size. Ini boleh meningkatkan penggunaan CPU pada
mesin dengan pelaksanaan "realloc()" yang perlahan, sebagai pertukaran untuk memori yang lebih tinggi sedikit
penggunaan. Lalai ialah 1. Jangan tetapkan ini lebih daripada -w nilai dibahagikan dengan
saiz langkah RRD purata anda.

-O Halang arahan CREATE daripada menulis ganti fail sedia ada, walaupun apabila ia diarahkan
untuk berbuat demikian. Ini adalah untuk keselamatan tambahan.

-G -kumpulan
Apabila berjalan sebagai daemon dan dipanggil daripada akaun istimewa, tetapkan semula keistimewaan kumpulan
kepada mereka yang kumpulan. Kumpulan itu boleh ditentukan sebagai nama atau sebagai ID kumpulan. daemon
akan keluar dengan diagnostik jika ia tidak berjaya beralih kepada yang ditentukan
kumpulan.

-U -pengguna
Apabila berjalan sebagai daemon dan dipanggil daripada akaun istimewa, tetapkan semula keistimewaan pengguna kepada
dari yang pengguna. Pengguna boleh ditentukan sebagai nama atau sebagai ID pengguna. Daemon akan
keluar dengan diagnostik jika ia tidak berjaya beralih kepada pengguna yang ditentukan.

TERJEJAS RRDTOOL PERINTAH

Perintah berikut boleh dimaklumkan tentang rrdcached menggunakan hujah baris arahan
--daemon atau pembolehubah persekitaran RRDCACHED_ADDRESS:

· pembuangan

· ambil

· siram

· graf

· grafv

· maklumat

· pertama

· terakhir

· kemaskini terakhir

· kemas kini

· xport

· mencipta

. maklumat arahan boleh menghantar nilai kepada daemon dan bukannya menulisnya ke cakera
sendiri. Semua arahan lain boleh menghantar a SIRAM arahan (lihat di bawah) kepada daemon sebelum ini
mengakses fail, jadi ia berfungsi dengan data terkini walaupun tamat masa cache adalah besar.

RALAT PELAPORAN

Daemon melaporkan ralat dalam salah satu daripada dua cara: Semasa permulaan, mesej ralat dicetak
kepada "STDERR". Salah satu langkah semasa memulakan adalah untuk beralih ke latar belakang dan menutup
"STDERR" - selepas ini menulis terus kepada pengguna tidak lagi boleh dilakukan. Apabila ini telah
berlaku, daemon akan menghantar mesej log kepada daemon pengelogan sistem menggunakan syslog(3).
Kemudahan yang digunakan ialah "LOG_DAEMON".

BAGAIMANA IT WORKS

Apabila menerima kemas kini, rrdcached tidak menulis ke cakera tetapi mencari entri untuk itu
fail dalam pokok dalamannya. Jika tidak dijumpai, entri dibuat termasuk masa semasa
(dipanggil "Pertama" dalam rajah di bawah). Kali ini adalah tidak masa yang ditentukan pada arahan
talian tetapi masa yang dianggap oleh sistem pengendalian sebagai "sekarang". Nilai dan masa
nilai (dipanggil "Masa" dalam rajah di bawah) dilampirkan pada nod pokok.

Apabila menambahkan nilai pada nod pokok, ia diperiksa sama ada sudah tiba masanya untuk menulis nilai
ke cakera. Nilai ditulis pada cakera jika "now() - First >= timeout", dengan "timeout" ialah
tamat masa yang ditentukan menggunakan -w pilihan, lihat "PILIHAN". Jika nilai "cukup lama" mereka
akan dimasukkan ke dalam baris gilir "kemas kini", i. e. mereka akan dilampirkan pada senarai terpaut
ditunjukkan di bawah. Kerana nod pokok dan elemen senarai terpaut adalah data yang sama
struktur dalam ingatan, sebarang kemas kini pada fail yang telah dimasukkan ke dalam baris gilir akan ditulis
dengan menulis seterusnya ke fail RRD juga.

"Benang kemas kini" yang berasingan sentiasa menyah gilir elemen pertama dalam baris gilir kemas kini dan
menulis semua nilainya ke fail yang sesuai. Jadi selagi baris gilir kemas kini tidak kosong
fail ditulis pada kadar yang paling tinggi.

Memandangkan tamat masa fail disemak hanya apabila nilai baharu ditambahkan pada fail, "mati"
fail, i. e. fail yang tidak dikemas kini lagi, tidak akan ditulis ke cakera.
Oleh itu, dari semasa ke semasa, dikawal oleh -f pilihan, seluruh pokok itu berjalan dan
semua nilai "lama" dimasukkan ke dalam baris gilir. Memandangkan ini hanya menjejaskan fail "mati" dan berjalan di atas pokok
adalah agak mahal, anda harus menetapkan "selang siram" kepada nilai yang agak tinggi.
Lalai ialah 3600 saat (satu jam).

Kelemahan nilai caching ialah nilai tersebut tidak akan dipaparkan dalam graf yang dijana daripada
fail RRD. Untuk mengatasi ini, daemon menyediakan "arahan flush" untuk flush khusus
fail. Ini bermakna bahawa fail dimasukkan pada kepala baris gilir kemas kini atau berpindah ke sana
jika ia sudah beratur. Perintah flush akan kembali hanya selepas fail belum selesai
kemas kini telah ditulis ke cakera.

+------+ +------+ +------+
! kepala! ! akar ! ! ekor!
+---+--+ +---+--+ +---+--+
! /\ !
! / \ !
! /\ /\ !
! /\/\ \ `----------------- ... ---------, !
V / `-------, ! V
+---+----+---+ +------+-----+ +---+----+---+
! Fail: foo ! ! Fail: bar ! ! Fail: qux !
! Pertama: 101! ! Pertama: 119! ! Pertama: 180!
! Seterusnya:&bar -+--->! Seterusnya:&... -+---> ... --->! Seterusnya:NULL !
| Sebelum:NULL !<---+-Sebelumnya:&foo !<--- ... ----+-Sebelumnya: &... !
+===========+ +===========+ +===========+
! Masa: 100! ! Masa: 120! ! Masa: 180!
! Nilai: 10 ! ! Nilai: 0.1 ! ! Nilai: 2,2 !
+------------+ +------------+ +------------+
! Masa: 110! ! Masa: 130! ! Masa: 190!
! Nilai: 26 ! ! Nilai: 0.1 ! ! Nilai: 7,3 !
+------------+ +------------+ +------------+
::::::
+------------+ +------------+ +------------+
! Masa: 230! ! Masa: 250! ! Masa: 310!
! Nilai: 42 ! ! Nilai: 0.2 ! ! Nilai: 1,2 !
+------------+ +------------+ +------------+

Rajah di atas menunjukkan:

· Fail/nilai disimpan dalam pokok (seimbang).

· Nod pokok dan entri dalam baris gilir kemas kini adalah struktur data yang sama.

· Waktu tempatan ("Pertama") dan masa yang dinyatakan dalam kemas kini ("Masa") mungkin berbeza.

· Nilai tamat masa dimasukkan pada "ekor".

· Nilai yang disiram secara eksplisit dimasukkan pada "kepala".

· Batuan seni ASCII.

KESELAMATAN KONSIDERASI

Pengesahan
Jika pemasangan rrdtool anda dibina tanpa libwrap, tiada bentuk pengesahan
untuk pelanggan yang menyambung ke daemon rrdcache!

Jika pemasangan rrdtool anda dibina dengan libwrap maka anda boleh menggunakan hosts_access to
hadkan akses pelanggan kepada daemon rrdcache (rrdcached). Untuk maklumat lanjut tentang cara
gunakan hosts_access untuk menyekat akses kepada daemon rrdcache yang anda patut baca
akses_hos(5) halaman manual.

Ia masih sangat disyorkan untuk memasang penapis paket atau mekanisme yang serupa untuk mencegah
sambungan yang tidak dibenarkan. Melainkan anda mempunyai VLAN atau VPN khusus untuk ini, menggunakan rangkaian
soket mungkin idea yang tidak baik!

kebenaran
Terdapat kebenaran per-soket yang minimum.

Pemberian kuasa pada masa ini dilakukan secara per-soket. Ini bermakna setiap soket mempunyai senarai
daripada perintah yang akan diterima dan ia akan terima. Ia hanya akan menerima arahan tersebut
disenaraikan secara eksplisit tetapi ia akan (pada masa ini) menerima arahan ini daripada sesiapa yang mencapai
soket.

Jika soket rangkaian hendak digunakan, adalah perlu untuk menyekat yang diterima
arahan kepada yang diperlukan oleh pelanggan luar. Jika, sebagai contoh, pelanggan luar mahu
lukis graf data yang dicache, ia hanya dibenarkan menggunakan arahan "FLUSH".

Keizinan tidak berfungsi apabila rrcached diaktifkan soket oleh systemd.

Penyulitan
Tiada penyulitan.

Sekali lagi, ini mungkin ditambah pada masa hadapan, tetapi buat masa ini adalah tugas anda untuk mengekalkan anda
data peribadi peribadi. Pasang VPN atau terowong yang disulitkan jika anda mempunyai statistik
sulit!

Kewarasan memeriksa
Tiada pemeriksaan kewarasan.

Daemon akan menulis secara membuta tuli pada mana-mana fail yang diberitahu, jadi anda harus membuat a
pengguna berasingan hanya untuk daemon ini. Juga ia tidak melakukan apa-apa pemeriksaan kewarasan, jadi jika ia mendapat
diberitahu untuk menulis nilai untuk satu masa yang jauh pada masa hadapan, fail anda akan rosak baik!

Kesimpulan
· Keselamatan adalah tugas pentadbir.

· Kami mengesyorkan untuk membenarkan akses tulis melalui soket domain UNIX sahaja.

· Anda telah diberi amaran.

PROTOKOL

Daemon berkomunikasi dengan pelanggan menggunakan protokol ASCII berasaskan talian yang mudah
dibaca dan mudah ditaip. Ini memudahkan skrip untuk melaksanakan protokol dan
mungkin untuk pengguna menggunakan telnet untuk menyambung kepada daemon dan menguji bahan "dengan tangan".

Protokol adalah berasaskan baris, ini bermakna setiap rekod terdiri daripada satu atau lebih baris. A
baris ditamatkan oleh aksara suapan baris 0x0A, biasanya ditulis sebagai "\n". Di dalam
contoh di bawah, watak ini akan ditulis sebagai " " ("suapan talian").

Selepas sambungan telah diwujudkan, pelanggan dijangka menghantar "perintah". A
arahan terdiri daripada kata kunci arahan, mungkin beberapa hujah, dan penamatan
watak baris baharu. Untuk senarai arahan, lihat "Arahan Sah" di bawah.

Contoh:

FLUSH /tmp/foo.rrd

Daemon menjawab dengan baris yang terdiri daripada kod status dan mesej status pendek,
dipisahkan oleh satu atau lebih aksara ruang. Kod status negatif menandakan ralat, a
kod status positif atau kejayaan isyarat sifar. Jika kod status lebih besar daripada sifar, ia
menunjukkan bilangan baris yang mengikuti baris status.

Contoh:

0 Kejayaan

2 Dua baris mengikuti
Ini adalah baris pertama
Dan ini adalah baris kedua

Sah arahan
Arahan berikut difahami oleh daemon:

SIRAM nama fail
Menyebabkan daemon meletakkan nama fail kepada kepala baris gilir kemas kini (mungkin mengalihkannya
di sana jika nod sudah berada dalam baris gilir). Jawapan akan dihantar selepas nod mempunyai
telah ditolak giliran.

FLUSHALL
Menyebabkan daemon mula mengalirkan SEMUA nilai yang belum selesai ke cakera. Ini kembali
serta-merta, walaupun penulisan mungkin mengambil masa yang lama.

YANG BELUM SELESAI nama fail
Menunjukkan sebarang kemas kini "menunggu" untuk fail, mengikut urutan. Kemas kini yang ditunjukkan belum lagi
ditulis ke fail RRD asas.

AMBIL nama fail CF [permulaan [akhir] [ds ...]]
Memanggil "rrd_fetch" dengan argumen yang ditentukan dan mengembalikan hasilnya dalam bentuk teks. Jika
perlu, fail dibuang ke cakera terlebih dahulu. Fungsi sisi klien "rrdc_fetch"
(diisytiharkan dalam "rrd_client.h") menghuraikan output dan berkelakuan sama seperti "rrd_fetch_r" untuk
penyepaduan mudah pertanyaan jauh. ds mentakrifkan lajur untuk dibuang - jika tiada
diberi maka semua dikembalikan

FETCHBIN nama fail CF [permulaan [akhir] [ds ...]]
Memanggil "rrd_fetch" dengan argumen yang ditentukan dan mengembalikan hasilnya dalam teks/perduaan
bentuk untuk mengelakkan overhed un/marshalling yang tidak perlu. Jika perlu, fail itu disiram
ke cakera dahulu. Fungsi sisi klien "rrdc_fetch" (diisytiharkan dalam "rrd_client.h")
menghuraikan output dan berkelakuan sama seperti "rrd_fetch_r" untuk penyepaduan mudah jauh
pertanyaan. ds mentakrifkan lajur untuk dibuang - jika tiada yang diberikan maka semuanya dikembalikan

LUPA nama fail
Membuang nama fail daripada cache. Sebarang kemas kini yang belum selesai AKAN BE LOSAL.

BERATUR
Menunjukkan fail yang berada pada baris gilir output. Mengembalikan sifar atau lebih baris dalam
format berikut, di mana ialah bilangan nilai yang akan ditulis untuk
:



BANTU [arahan]
Mengembalikan mesej penggunaan ringkas. Jika tiada arahan diberikan, atau arahan is BANTU, senarai
arahan yang disokong oleh daemon dikembalikan. Jika tidak penerangan ringkas, mungkin
mengandungi penunjuk ke halaman manual, dikembalikan. Jelas sekali, ini dimaksudkan untuk
penggunaan interaktif dan format arahan dan ringkasan penggunaan
dikembalikan tidak ditakrifkan dengan baik.

STATS
Mengembalikan senarai metrik yang boleh digunakan untuk mengukur prestasi daemon dan
semak statusnya. Untuk penerangan tentang nilai yang dikembalikan, lihat "Nilai Prestasi"
di bawah.

Format di mana nilai dikembalikan adalah serupa dengan banyak berasaskan baris lain
protokol: Setiap nilai dicetak pada baris yang berasingan, setiap satu terdiri daripada nama
nilai, titik bertindih, satu atau lebih ruang dan nilai sebenar.

Contoh:

9 Statistik mengikuti
Panjang Beratur: 0
Kemas Kini Diterima: 30
Flushes Diterima: 2
Kemas KiniDitulis: 13
Set DataDitulis: 390
Nombor Nod Pokok: 13
Kedalaman Pokok: 4
JournalBytes: 190
Putar Jurnal: 0

Ping
PING-PONG, ini sangat berguna apabila menggunakan kumpulan sambungan antara pelanggan pengguna dan
RRDCACHED.

Contoh:

0 PONG

UPDATE nama fail nilai [nilai ...]
Menambah lebih banyak data pada nama fail. Ini adalah yang operasi daemon direka untuknya, jadi
menerangkan mekanisme sekali lagi adalah tidak perlu. Baca "BAGAIMANA IA BERFUNGSI" di atas untuk a
penerangan terperinci.

Ambil perhatian bahawa rrdcached hanya menerima cap masa mutlak dalam nilai kemas kini. Kemas kini
rentetan seperti "N:1:2:3" ditukar secara automatik kepada masa mutlak oleh klien RRD
perpustakaan sebelum dihantar ke rrdcached.

MENULIS nama fail
Perintah ini ditulis ke jurnal selepas fail berjaya ditulis
cakera. Ia digunakan semasa ulang tayang jurnal untuk menentukan kemas kini yang telah dibuat
digunakan. Ia adalah hanyalah sah dalam jurnal; ia tidak diterima daripada perintah yang lain
Saluran.

PERTAMA nama fail [rranum]
Kembalikan cap masa untuk CDP pertama dalam RRA yang ditentukan. Lalai ialah menggunakan RRA
sifar jika tiada yang dinyatakan.

LAST nama fail
Kembalikan cap masa untuk kemas kini terakhir kepada RRD yang ditentukan. Ambil perhatian bahawa cache adalah
tidak disiram sebelum menyemak, kerana pelanggan dijangka meminta ini secara berasingan jika
ia diperlukan.

INFO nama fail
Kembalikan maklumat konfigurasi untuk RRD yang ditentukan. Ambil perhatian bahawa cache adalah tidak
disiram sebelum menyemak, kerana pelanggan dijangka meminta ini secara berasingan jika ada
diperlukan.

Maklumat dikembalikan, satu item setiap baris, dengan format:

saya saya saya

CREATE nama fail [-s saiz langkah] [-b masa permulaan] [-O] DSdefinisi ... Definisi RRA ...
Ini akan mencipta fail RRD mengikut parameter yang dibekalkan, dengan syarat
parameter adalah sah, dan (jika pilihan -O diberikan atau jika rrdcached telah dimulakan
dengan bendera -O) yang ditentukan nama fail belum wujud.

BATCH
Perintah ini memulakan beban pukal berbilang arahan. Ini direka untuk
pemasangan dengan kadar kemas kini yang sangat tinggi, kerana ia membenarkan lebih daripada satu arahan
untuk dikeluarkan setiap baca () and tulis ().

Semua arahan dilaksanakan seperti yang akan dilakukan jika diberikan secara individu, kecuali untuk
output kepada pengguna. Mesej yang menunjukkan kejayaan dihalang, dan mesej ralat
ditangguhkan sehingga pelanggan selesai.

Pemprosesan arahan selesai apabila klien menghantar titik (".") pada barisnya sendiri.
Selepas pelanggan selesai, pelayan bertindak balas dengan kiraan ralat dan senarai
mesej ralat (jika ada). Setiap mesej ralat menunjukkan nombor arahan kepada
yang sepadan, dan mesej ralat itu sendiri. Perintah pengguna pertama selepas
BATCH adalah arahan nombor satu.

pelanggan: BATCH
pelayan: 0 Teruskan. Tamat dengan titik '.' pada talian sendiri.
pelanggan: KEMASKINI x.rrd 1223661439:1:2:3 <--- arahan #1
pelanggan: KEMASKINI y.rrd 1223661440:3:4:5 <--- arahan #2
klien: dan seterusnya...
pelanggan: .
pelayan: 2 Ralat
pelayan: 1 mesej untuk arahan 1
pelayan: 12 mesej untuk arahan 12

BERHENTI
Putuskan sambungan daripada rrdcached.

prestasi Nilai-nilai
Kaunter berikut dikembalikan oleh STATS arahan:

Panjang Beratur (tidak ditandatangani 64bit integer)
Bilangan nod sedang dalam baris gilir dalam baris gilir kemas kini.

Kemas Kini Diterima (tidak ditandatangani 64bit integer)
Bilangan perintah UPDATE yang diterima.

FlushesDiterima (tidak ditandatangani 64bit integer)
Bilangan arahan FLUSH yang diterima.

Kemas KiniDitulis (tidak ditandatangani 64bit integer)
Jumlah bilangan kemas kini, i. e. memanggil "rrd_update_r", sejak daemon dimulakan.

DataSetsWritten (tidak ditandatangani 64bit integer)
Jumlah bilangan "set data" yang ditulis pada cakera sejak daemon dimulakan. Satu set data
ialah satu atau lebih nilai yang dihantar kepada UPDATE perintah. Contohnya: "1223661439:123:456"
ialah satu set data dengan dua nilai. Istilah "set data" digunakan untuk mengelakkan kekeliruan
sama ada nilai individu atau kumpulan nilai dikira.

Nombor Pokok Nombor (tidak ditandatangani 64bit integer)
Bilangan nod dalam cache.

Kedalaman Pokok (tidak ditandatangani 64bit integer)
Kedalaman pokok yang digunakan untuk carian kunci pantas.

JournalBytes (tidak ditandatangani 64bit integer)
Jumlah bilangan bait yang ditulis pada jurnal sejak permulaan.

JournalRotate (tidak ditandatangani 64bit integer)
Bilangan kali jurnal telah digilirkan sejak permulaan.

ISYARAT

TANDATANGAN dan SIGTERM
Daemon keluar seperti biasa apabila menerima salah satu daripada isyarat ini. Kemas kini belum selesai adalah
dikendalikan mengikut -j and -F pilihan.

SIGUSR1
Daemon keluar SELEPAS membuang semua kemas kini ke cakera. Ini mungkin mengambil sedikit masa.

SIGUSR2
Daemon keluar serta-merta, tanpa membuang kemas kini ke cakera. Kemas kini belum selesai
akan ditayangkan semula daripada jurnal apabila daemon dimulakan semula. AMARAN : if
jurnal (-j) is TIDAK didayakan, mana-mana menunggu update AKAN BE LOSAL.

Gunakan rrdcached dalam talian menggunakan perkhidmatan onworks.net