pmlogger - Dalam talian di Awan

JADUAL:

NAMA

pmlogger - buat log arkib untuk metrik prestasi

SINOPSIS

pmlogger [-c fail konfigurasi] [-h tuan rumah] [-K spec] [-l fail log] [-L] [-m ambil perhatian] [-n pmnsfile]
[-o] [-p pid] [-P] [-r] [-s saiz hujung] [-t selang] [-T masa tamat] [-u] [-U nama pengguna] [-v
mengecil] [-V versi] [-x fd] [-y] arkib

DESCRIPTION

pmlogger mencipta log arkib nilai metrik prestasi yang mungkin ``dimainkan semula''
oleh Performance Co-Pilot yang lain (lihat PCPIntro(1)) alatan. Log ini menjadi asas kepada
Paradigma VCR dan perkhidmatan analisis prestasi retrospektif yang biasa digunakan pada kit alat PCP.

Hujah wajib arkib ialah nama asas untuk fail fizikal yang membentuk an
log arkib.

. -V pilihan menentukan versi untuk arkib yang dijana. Secara lalai a
arkib versi 2 dijana, dan satu-satunya nilai yang disokong pada masa ini versi adalah 2.

Melainkan diarahkan kepada hos lain oleh -h pilihan atau apabila terus menggunakan PMDA melalui -o
pilihan, pmlogger akan menghubungi Daemon Pemungut Metrik Prestasi (PMCD) di tempatan
hos dan gunakan itu sebagai sumber nilai metrik yang akan dilog.

Untuk menyokong fleksibiliti dan kawalan yang diperlukan ke atas perkara yang dilog dan bila, pmlogger
mengekalkan keadaan pengelogan dua peringkat bebas untuk setiap kejadian setiap prestasi
metrik. Pada peringkat pertama (wajib), pembalakan dibenarkan on (dengan yang berkaitan
selang antara sampel), atau off or mungkin. Dalam kes kedua, yang kedua (nasihat)
pembalakan peringkat dibenarkan on (dengan selang yang berkaitan antara sampel), atau off.

Tahap mandatori membenarkan spesifikasi universal bahawa sesetengah metrik mesti dilog, atau
kemestian tidak dilog. Keadaan lalai untuk semua keadaan semua metrik apabila pmlogger
bermula adalah wajib mungkin dan nasihat dimatikan.

Penggunaan pmlc(1) untuk menyoal siasat dan menukar keadaan pembalakan sekali pmlogger adalah berlari.

Jika keadaan metrik adalah wajib (dihidupkan atau dimatikan) dan permintaan dibuat untuk menukarnya kepada
wajib mungkin, negeri baru wajib mungkin dan nasihat. Jika keadaan metrik
sudah menjadi nasihat (dihidupkan atau dimatikan) dan permintaan dibuat untuk menukarnya kepada mandatori mungkin, yang
keadaan semasa dikekalkan.

Ia tidak mungkin untuk pmlogger untuk log contoh tertentu metrik dan semua kejadian
metrik yang sama secara serentak. Jika kejadian tertentu sedang dilog dan permintaan untuk log
semua kejadian dibuat, maka semua kejadian metrik akan dilog mengikut
permintaan baharu, menggantikan sebarang permintaan pengelogan terdahulu untuk metrik. Permintaan untuk log semua
tika metrik akan menggantikan sebarang permintaan sebelumnya untuk log semua kejadian. Permintaan
untuk log contoh tertentu metrik apabila semua kejadian sudah dilog adalah
menolak. Untuk melakukan ini, anda mesti mematikan pengelogan untuk semua tika metrik terlebih dahulu. Dalam
setiap kes, kesahihan permintaan disemak terlebih dahulu; contohnya permintaan untuk menukar a
keadaan pengelogan metrik untuk memberi nasihat tentang masa ia wajib dimatikan adalah tidak pernah
dibenarkan (perlu tukar negeri kepada wajib mungkin dahulu).

Secara pilihan, setiap sistem berjalan pmcd(1) juga boleh dikonfigurasikan untuk menjalankan ``utama''
pmlogger contoh. ini pmlogger contoh dilancarkan oleh $PCP_RC_DIR/pmlogger, Dan
dipengaruhi oleh fail $PCP_SYSCONF_DIR/pmlogger/control,
$PCP_SYSCONF_DIR/pmlogger/control.d (gunakan chkconfig(8) atau khusus platform yang serupa
arahan untuk mengaktifkan atau melumpuhkan yang utama pmlogger contoh),
$PCP_SYSCONFIG_DIR/pmlogger (tetapan pembolehubah persekitaran untuk utama pmlogger)
$PCP_SYSCONF_DIR/pmlogger/pmlogger.options (pilihan baris arahan dihantar ke primary
pmlogger) dan $PCP_VAR_LIB/config/pmlogger/config.default (inisial lalai
fail konfigurasi untuk utama pmlogger).

sekolah rendah pmlogger contoh dikenal pasti oleh -P pilihan. Mungkin ada paling banyak satu
``utama'' pmlogger contoh pada setiap sistem. Yang utama pmlogger contoh (jika ada) mesti
dijalankan pada hos yang sama dengan pmcd(1) yang ia bersambung (jika ada), jadi -h and -P
pilihan adalah saling eksklusif.

Pengelogan beberapa metrik adalah mungkin walaupun tanpa ketiadaan tempatan pmcd(1), menggunakan
mod operasi "konteks tempatan". Ini diaktifkan menggunakan -o pilihan, dan punca
pmlogger untuk menggunakan PMDA DSO tempatan dan bukannya berkomunikasi dengan pmcd(1). Bila
beroperasi menggunakan konteks tempatan, the -K pilihan boleh digunakan untuk mengawal DSO PMDA yang
harus dibuat mudah diakses. The spec hujah mematuhi sintaks yang diterangkan dalam
__pmSpecLocalPMDA(3). Lebih daripada satu -K pilihan boleh digunakan.

Apabila dilancarkan sebagai contoh bukan utama, pmlogger akan keluar serta merta jika
fail konfigurasi menyebabkan tiada pengelogan metrik dijadualkan. The -L pilihan mengatasi ini
tingkah laku, dan menyebabkan bukan utama pmlogger contoh kepada ``berlama-lama'', mungkin belum selesai
beberapa konfigurasi semula dinamik masa hadapan dan perubahan keadaan melalui pmlc(1). pmlogger juga akan
berlama-lama tanpa -L pilihan yang digunakan jika semua metrik yang akan dilog dilog sebagai sekali
hanya metrik. Apabila satu-satunya metrik telah dilog, mesej amaran akan menjadi
dijana menyatakan bahawa baris gilir acara kosong dan tiada lagi acara akan dijadualkan.

Secara lalai semua diagnostik dan ralat daripada pmlogger ditulis pada fail pmlogger.log
dalam direktori di mana pmlogger dilancarkan. The -l pilihan boleh digunakan untuk mengatasi
tingkah laku lalai. Jika fail log tidak boleh dibuat atau tidak boleh ditulis, output ditulis
kepada ralat piawai sebaliknya.

Jika dinyatakan, -s arahan pilihan pmlogger untuk ditamatkan selepas saiz tertentu masuk
rekod, bait atau unit masa telah terkumpul. Jika saiz hujung ialah integer kemudian saiz hujung
rekod akan ditulis pada log. Jika saiz hujung ialah integer yang diakhiri dengan b or bait kemudian
saiz hujung bait data arkib akan dihapuskan (perhatikan, bagaimanapun, bahawa log arkib
sempadan rekod tidak akan dipecahkan dan oleh itu had ini mungkin melepasi sedikit). Lain-lain
unit saiz fail yang berdaya maju termasuk: K, Kb, Kbyte, Kilobyte untuk kilobait dan M, Mb, Mbyte,
megabait untuk megabait dan G, Gb, Gbyte, Gigabyte untuk gigabait. Unit-unit ini mungkin
pilihan diakhiri dengan an s dan mungkin kes bercampur. Sebagai alternatif saiz hujung mungkin menjadi
integer atau nombor titik terapung yang diakhiri menggunakan unit masa seperti yang diterangkan dalam PCPIntro(1)
bagi selang hujah (kepada PCP standard -t pilihan baris arahan).
Beberapa contoh format yang berbeza:
-s 100
-s 100 bait
-s 100K
-s 100Mb
-s 10Gbait
-s 10mins
-s 1.5hours
Lalai adalah untuk pmlogger untuk berlari selamanya.

. -r pilihan menyebabkan saiz rekod fizikal bagi setiap kumpulan metrik dan
sumbangan kumpulan yang dijangkakan kepada saiz arkib PCP selama satu hari penuh
koleksi untuk dilaporkan dalam fail log. Maklumat ini dilaporkan buat kali pertama
setiap kumpulan berjaya ditulis ke arkib.

. -U pilihan menentukan akaun pengguna untuk dijalankan pmlogger. Lalai ialah
akaun pengguna semasa untuk kegunaan interaktif. Apabila dijalankan sebagai daemon, "pcp" yang tidak mempunyai hak istimewa
akaun digunakan dalam versi semasa PCP, tetapi dalam versi lama akaun superuser
("root") telah digunakan secara lalai.

Fail log berpotensi menjadi set data berbilang volum, dan -v punca pilihan pmlogger kepada
mulakan volum baharu selepas saiz tertentu dalam rekod, bait atau unit masa telah
terkumpul untuk isipadu semasa. Format spesifikasi saiz ini adalah sama dengan
bahawa daripada -s pilihan (lihat di atas). Lalai adalah untuk pmlogger untuk mencipta satu volum
log. Suis volum tambahan juga boleh dipaksa secara tak segerak dengan sama ada menggunakan pmlc(1)
atau menghantar pmlogger isyarat SIGHUP (lihat di bawah). Ambil perhatian, jika suis kelantangan yang dijadualkan berada
operasi disebabkan oleh -v pilihan, maka pembilangnya akan ditetapkan semula selepas tak segerak
suis.

Bebas daripada mana-mana -v pilihan, setiap volum arkib adalah terhad kepada tidak lebih daripada 2^31
bait, jadi pmlogger akan membuat volum baharu secara automatik untuk arkib sebelum ini
had tercapai.

Biasanya pmlogger beroperasi pada Ruang Nama Metrik Prestasi (PMNS) yang diedarkan,
namun sekiranya -n pilihan ditentukan PMNS tempatan alternatif dimuatkan daripada fail
pmnsfile.

Dalam keadaan normal, pmlogger akan berjalan selama-lamanya (kecuali a -s pilihan atau a
isyarat penamatan). The -T pilihan boleh digunakan untuk mengehadkan masa pelaksanaan menggunakan
format masa seperti yang ditetapkan oleh PCPIntro(1). Masa ditafsirkan dalam zon waktu
pelayan PMCD, melainkan jika -y pilihan diberikan, dalam hal ini zon waktu pada ini
hos logger digunakan.
Beberapa contoh format yang berbeza:
-T 10mins
-T '@ 11:30'
Daripada ini dapat dilihat bahawa -T 10mins and -s 10mins melakukan tindakan yang sama.

Sebagai alternatif, pmlogger masa jalan mungkin dihadkan kepada jangka hayat proses lain dengan menggunakan
yang -p or --PID pilihan untuk mencalonkan PID proses kepentingan. Dalam kes ini
pmlogger akan keluar apabila proses lain tidak lagi wujud.

Bila pmlogger menerima isyarat SIGHUP, volum semasa log ditutup, dan baharu
kelantangan dibuka. Mekanisme ini (atau mekanisme alternatif melalui pmlc(1)) boleh digunakan
untuk menguruskan pertumbuhan fail log - sebaik sahaja volum log ditutup, fail itu mungkin
diarkibkan tanpa kesan buruk ke atas operasi berterusan pmlogger. Lihat juga -v
pilihan di atas.

Dari segi sejarah, penimbal untuk log semasa mungkin dibuang ke cakera menggunakan flush
arahan dari pmlc(1), atau dengan menghantar pmlogger isyarat SIGUSR1 atau dengan menggunakan -u pilihan.
Versi semasa pmlogger dan juga libpcp rutin yang menjadi asas pmlogger
tanpa syarat menggunakan tulis tanpa buffer dan satu fwrite(3) untuk setiap rekod logik
ditulis, maka ``flushing'' tidak memaksa sebarang data tambahan ditulis pada fail
sistem. The -u pilihan, pengendalian SIGUSR1 dan pmlc(1) flush perintah dikekalkan
untuk keserasian ke belakang.

Apabila dilancarkan dengan -x pilihan, pmlogger akan menerima permintaan kawalan tak segerak pada
deskriptor fail fd. Pilihan ini hanya dijangka digunakan secara dalaman oleh PCP
aplikasi yang menyokong ``mod rekod langsung''.

. -m pilihan membenarkan rentetan ambil perhatian untuk dilampirkan pada fail peta untuk contoh ini
pmlogger dalam $PCP_TMP_DIR/pmlogger direktori. Ini pada masa ini digunakan secara dalaman untuk
dokumenkan deskriptor fail (fd) apabila -x pilihan digunakan, atau untuk menunjukkan bahawa ini
pmlogger contoh telah dimulakan di bawah kawalan pmlogger_check(1).

CONFIGURATION FAIL SISTEM

Fail konfigurasi boleh ditentukan dengan -c pilihan. Jika tidak, konfigurasi
spesifikasi dibaca daripada input standard.

If fail konfigurasi tidak wujud, maka carian dibuat dalam direktori
$PCP_VAR_LIB/config/pmlogger untuk fail dengan nama yang sama, dan jika didapati fail itu digunakan,
cth jika config.mumble tidak wujud dalam direktori semasa dan fail
$PCP_VAR_LIB/config/pmlogger/config.mumble memang wujud, maka -c config.mumble and -c
$PCP_VAR_LIB/config/pmlogger/config.mumble setaraf.

Sintaks untuk fail konfigurasi adalah seperti berikut.

1. Perkataan dipisahkan oleh ruang putih (ruang, tab atau baris baharu).

2. Simbol ``#'' (cincang) memperkenalkan ulasan, dan semua teks sehingga baris baharu seterusnya ialah
diabaikan.

3. Kata kunci (ditunjukkan dalam berani di bawah) mesti muncul secara literal (iaitu dalam huruf kecil).

4. Setiap spesifikasi bermula dengan kata kunci pilihan log, diikuti oleh salah satu daripada
negeri wajib on, wajib off, wajib mungkin, nasihat on or nasihat off.

5. Untuk on menyatakan, selang pengelogan mesti diikuti menggunakan sintaks ``sekali'', atau
``lalai'', atau ``setiap N unit masa'', atau ringkasnya ``N unit masa'' - N adalah tidak bertanda tangan
integer, dan unit masa adalah salah satu kata kunci msec, milisaat, sec, kedua, minit,
minit, jam atau bentuk jamak salah satu di atas.
Had dalaman memerlukan selang lebih kecil daripada (anggaran) 74
Jam. Nilai selang sifar adalah sinonim untuk sekali. Selang waktu lalai
bermaksud menggunakan selang pengelogan lalai selama 60 saat; nilai lalai ini mungkin
ditukar menjadi selang dengan -t pilihan baris perintah.

. selang hujah mengikut sintaks yang diterangkan dalam PCPIntro(1), dan dalam
bentuk termudah mungkin integer tidak bertanda (unit tersirat dalam kes ini ialah
saat).

6. Mengikut keadaan dan spesifikasi selang yang mungkin muncul ``{'', diikuti dengan a
senarai satu atau lebih spesifikasi metrik dan penutup ``}''. Senarainya berwarna putih
ruang (atau koma) dipisahkan. Jika terdapat hanya satu spesifikasi metrik dalam senarai,
pendakap gigi adalah pilihan.

7. Spesifikasi metrik terdiri daripada nama metrik secara pilihan diikuti dengan set
nama contoh. Nama metrik mengikut konvensyen penamaan PCP standard, lihat
pmns(5), dan jika nama metrik ialah nod bukan daun dalam PMNS (lihat pmns(5)), kemudian
pmlogger akan menurunkan PMNS secara rekursif dan menggunakan spesifikasi pembalakan kepada semua
nama metrik keturunan yang merupakan nod daun dalam PMNS. Set nama contoh
ialah ``['', diikuti dengan senarai satu atau lebih ruang (atau koma) nama yang dipisahkan,
nombor atau rentetan, dan penutup ``]''. Elemen dalam senarai yang merupakan nombor ialah
diandaikan sebagai pengecam tika dalaman, elemen lain diandaikan
pengecam tika luaran - lihat pmGetInDom(3) untuk maklumat lanjut.

Jika tiada kejadian diberikan, maka spesifikasi pengelogan digunakan pada semua kejadian
daripada metrik yang berkaitan.

8. Mungkin terdapat bilangan spesifikasi pembalakan yang sewenang-wenangnya.

9. Mengikut semua spesifikasi pengelogan, mungkin terdapat kawalan akses pilihan
bahagian, yang diperkenalkan oleh token literal [akses]. Selepas itu datang kawalan akses
peraturan yang membenarkan atau tidak membenarkan operasi daripada hos atau kumpulan hos tertentu.

Operasi boleh digunakan untuk menyoal siasat atau mengawal sesuatu larian pmlogger menggunakan pmlc(1)
dan jatuh ke dalam kelas berikut:

bertanya menyoal siasat status pmlogger dan metrik yang dilog
nasihat Tukar pengelogan nasihat.
wajib Tukar pembalakan wajib.
semua Semua di atas.

Peraturan kawalan akses adalah dalam bentuk ``membenarkan senarai hos : senarai operasi ;'' dan
``tidak membenarkan senarai hos : senarai operasi ;''.

. senarai hos mengikut sintaks dan semantik untuk mekanisme kawalan capaian yang digunakan
oleh PMCD dan didokumenkan sepenuhnya dalam pmcd(1). An senarai operasi adalah dipisahkan koma
senarai operasi nasihat, wajib, bertanya and semua.

A hilang [akses] seksyen membenarkan semua akses dan setara dengan membenarkan * : semua;.

Konfigurasi (sama ada daripada input standard atau fail konfigurasi) pada mulanya diimbas oleh
pmcpp(1) dengan pilihan -rs and -I $PCP_VAR_LIB/config/pmlogger. Ini memanjangkan
sintaks fail konfigurasi dengan termasuk pemprosesan fail (%termasuk), lokasi biasa untuk
cari termasuk fail ($PCP_VAR_LIB/config/pmlogger), takrifan makro (%define),
pengembangan makro (%nama and %{nama}) dan kemasukan bersyarat bagi baris (%ifdef nama ...
%lain ... %endif and %ifndef nama ... %lain ... %endif).

CONTOH

Untuk setiap utiliti PCP, terdapat sampel pmlogger fail konfigurasi yang boleh digunakan untuk
buat log arkib yang sesuai untuk dimainkan semula dengan alat itu (iaitu termasuk semua
metrik prestasi yang digunakan oleh alat). Untuk alat bernama foo fail konfigurasi ini ialah
terletak di $PCP_VAR_LIB/config/pmlogger/config.foo.

Berikut ialah fail konfigurasi lalai yang mudah untuk asas pmlogger contoh, dan
menunjukkan kebanyakan keupayaan bahasa spesifikasi konfigurasi.

log wajib pada sekali { hinv.ncpu hinv.ndisk }
log wajib pada setiap 10 minit {
cakera.semua.tulis
cakera.semua.baca
network.interface.in.packets [ "et0" ]
network.interface.out.packets [ "et0" ]
nfs.server.reqs [ "lookup" "getattr" "read" "write" ]
}

log nasihat pada setiap 30 minit {
persekitaran.temp
pmcd.pdu_in.total
pmcd.pdu_out.total
}

%include "makros.default"

%ifdef %disk_detail
log wajib pada %disk_detail_freq {
cakera.dev
}
%endif

[akses]
tidak dibenarkan * : semua kecuali bertanya;
benarkan localhost : wajib, nasihat;

Gunakan pmlogger dalam talian menggunakan perkhidmatan onworks.net