pmlogger_check - Daring di Awan

PROGRAM:

NAMA

pmlogger_check, pmlogger_daily, pmlogger_merge - administrasi Performance Co-Pilot
arsip file log

RINGKASAN

$PCP_BINADM_DIR/pmlogger_check [-CNTV] [-c kontrol] [-l file log]
$PCP_BINADM_DIR/pmlogger_harian [-NorV] [-c kontrol] [-k membuang] [-l file log] [-m
alamat] [-s ukuran] [-t ingin] [-x kompres] [-X program] [-Y regex]
$PCP_BINADM_DIR/pmlogger_merge [-fNV] [masukan-nama dasar ... nama-keluaran]

DESKRIPSI

Serangkaian skrip shell dan file kontrol terkait ini dapat digunakan untuk membuat a
rezim administrasi dan manajemen yang disesuaikan untuk Performance Co-Pilot (lihat
PC Pintro(1)) arsip file log.

pmlogger_daily dimaksudkan untuk dijalankan sekali sehari, sebaiknya di pagi hari, karena
segera setelah tengah malam jika memungkinkan. Tugasnya adalah mengumpulkan dan memutar satu atau lebih set
dari arsip PCP. Setelah beberapa waktu, arsip PCP lama akan dibuang. Periode ini adalah 14
hari secara default, tetapi dapat diubah menggunakan -k pilihan. Dua nilai khusus diakui
untuk periode (membuang), yaitu 0 untuk tidak menyimpan arsip di luar yang sekarang, dan selama-lamanya
untuk mencegah arsip dibuang.

File data arsip opsional dapat dikompresi setelah beberapa waktu untuk menghemat ruang disk.
Ini sangat berguna untuk sejumlah besar pmlogger proses di bawah kendali
pmlogger_check. Secara default tidak ada kompresi yang dilakukan. NS -x opsi memungkinkan kompresi dan
menentukan jumlah hari setelah itu untuk mengompresi file data arsip, dan -X Option
menentukan program yang akan digunakan untuk kompresi - secara default ini adalah xz(1). Penggunaan -Y
opsi memungkinkan ekspresi reguler untuk ditentukan menyebabkan file dalam kumpulan file
cocok untuk kompresi yang akan dihilangkan - ini memungkinkan hanya file data yang akan dikompresi,
dan juga mencegah program mencoba mengompresnya lebih dari sekali. Standarnya
regex adalah ".(meta|index|Z|gz|bz2|zip|xz|lzma|lzo|lz4)$" - file tersebut difilter menggunakan
-v pilihan untuk Egrep(1).

Untuk mengakomodasi evolusi PMDA dan perubahan lingkungan logging produksi,
pmlogger_daily terintegrasi dengan pmlogrewrite(1) untuk memungkinkan opsional dan otomatis
penulisan ulang arsip sebelum penggabungan. Jika ada aturan penulisan ulang global yang akan diterapkan
di semua arsip yang disebutkan dalam file kontrol, lalu buat direktori
$PCP_SYSCONF_DIR/pmlogrewrite dan tempatkan apa saja pmlogrewrite(1) menulis ulang aturan dalam hal ini
direktori. Untuk menulis ulang aturan yang khusus untuk hanya satu keluarga arsip, gunakan
nama direktori dari file kontrol - mis keempat bidang - dan buat file, atau a
direktori, atau tautan simbolis bernama pmlogrewrite dalam direktori ini dan tempatkan
aturan penulisan ulang yang diperlukan dalam pmlogrewrite file atau dalam file di dalam pmlogrewrite
subdirektori. pmlogger_daily akan memilih aturan penulisan ulang dari direktori arsip jika
mereka ada, jika tidak, menulis ulang aturan dari $PCP_SYSCONF_DIR/pmlogrewrite jika direktori itu
ada, jika tidak, tidak ada penulisan ulang yang dicoba.

-r opsi baris perintah bertindak sebagai over-ride dan mencegah semua penulisan ulang arsip dengan
pmlogrewrite(1) independen dari keberadaan file atau direktori aturan penulisan ulang.

Secara default, semua arsip yang mungkin akan digabungkan. NS -o opsi mengembalikan yang lama
perilaku di mana hanya arsip kemarin yang akan dianggap sebagai kandidat gabungan.

Dalam kasus khusus di mana hanya satu arsip input yang perlu digabungkan, pmlogmv(1) adalah
digunakan untuk mengganti nama arsip, daripada menyalin arsip input menggunakan pmlogger_merge.

-M opsi dapat digunakan untuk menonaktifkan penggabungan arsip (atau penggantian nama) dan penulisan ulang (-M
menyiratkan -r). Ini paling berguna dalam kasus di mana arsip sedang secara bertahap
disalin ke repositori jarak jauh, misalnya menggunakan rsync(1). Menggabungkan, mengganti nama, dan menulis ulang semua
berisiko meningkatkan beban sinkronisasi, terutama segera setelah pmlogger_daily
telah berjalan, jadi -M mungkin berguna dalam kasus ini.

Untuk membantu men-debug atau mendiagnosis kegagalan intermiten, -t pilihan dapat digunakan.
Ini akan mengaktifkan penelusuran yang sangat verbose (-VV) dan tangkap keluaran jejak dalam file bernama
$PCP_LOG_DIR/pmlogger/harian.cap tanggal.jejak, dimana cap tanggal adalah waktu pmlogger_daily
dijalankan dalam format YYYYMMDD.HH.MM. Selain itu, ingin argumen akan memastikan bahwa
melacak file yang dibuat dengan -t akan disimpan untuk ingin hari dan kemudian dibuang.

Selain itu, jika file ``pemberitahuan'' PCP ($PCP_LOG_DIR/PEMBERITAHUAN) lebih besar dari 20480
byte, pmlogger_daily akan mengganti nama file dengan akhiran ``.old'', dan memulai yang baru
file ``pemberitahuan''. Ambang putar dapat diubah dari 20480 menjadi ukuran byte menggunakan
-s .

Penggunaan -m pilihan penyebab pmlogger_daily untuk membuat ringkasan file ``notices''
entri yang dihasilkan dalam 24 jam terakhir, dan kirimkan ringkasan itu melalui email ke kumpulan
dipisahkan oleh ruang alamat. Ringkasan harian ini disimpan dalam file
$PCP_LOG_DIR/NOTICES.harian, yang akan kosong jika tidak ada entri ``pemberitahuan'' baru yang dibuat
dalam periode 24 jam sebelumnya.

Naskah $PCP_BINADM_DIR/pmlogger_harian dapat disalin dan dimodifikasi untuk mengimplementasikan a
prosedur khusus lokasi untuk manajemen akhir minggu dan/atau akhir bulan untuk satu set PCP
arsip.

pmlogger_check dapat dijalankan setiap saat, dan dimaksudkan untuk memeriksa bahwa set yang diinginkan
pmlogger(1) proses sedang berjalan, dan jika tidak meluncurkan kembali penebang yang gagal. Penggunaan
-s opsi menyediakan fungsionalitas terbalik, memungkinkan set pmlogger proses menjadi
dimatikan dengan bersih. Penggunaan -C opsi menanyakan informasi runlevel layanan sistem
untuk pmlogger, dan menggunakannya untuk menentukan apakah akan memulai atau menghentikan proses.

-T opsi menyediakan bentuk keluaran terser untuk pmlogger_check itu yang paling cocok
untuk pmlogger ``pertanian'' di mana banyak contoh pmlogger diharapkan akan berjalan.

pmlogger_merge adalah skrip pembungkus untuk ekstrak pmlog(1) yang menggabungkan semua log arsip
cocok dengan masukan-nama dasar argumen, dan membuat arsip baru menggunakan nama-keluaran sebagai
nama dasar untuk file fisik yang merupakan log arsip. NS masukan-nama dasar
argumen mungkin berisi karakter meta dalam gaya sh(1). Jika ditentukan, -f Option
menyebabkan semua file input dihapus setelah arsip output dibuat.

pmlogger_merge digunakan oleh pmlogger_daily.

Kedua pmlogger_daily dan pmlogger_check dikendalikan oleh file kontrol logger PCP yang
menentukan pmlogger contoh yang akan dikelola. File kontrol default adalah
$PCP_PMLOGGERCONTROL_PATH, tetapi alternatif dapat ditentukan menggunakan -c pilihan. jika
direktori $PCP_PMLOGGERCONTROL_PATH.d (atau kontrol.d dari -c opsi) ada, maka
isi dari file kontrol tambahan apa pun di dalamnya akan ditambahkan ke file kontrol utama
(yang harus ada).

peringatan: Para $PCP_PMLOGGERCONTROL_PATH dan $PCP_PMLOGGERCONTROL_PATHFile .d tidak boleh
dapat ditulis oleh pengguna selain root.

File kontrol harus dikustomisasi sesuai dengan aturan berikut yang mendefinisikan untuk:
versi saat ini (1.1) dari format file kontrol.

1. Baris yang diawali dengan ``#'' adalah komentar.
2. Baris yang diawali dengan ``$'' diasumsikan sebagai penugasan ke variabel lingkungan di
gaya dari sh(1), dan semua teks setelah ``$'' akan menjadi evaluasi'ed by script
membaca file kontrol, dan variabel yang sesuai diekspor ke
lingkungan. Ini sangat berguna untuk mengatur dan mengekspor variabel ke dalam
lingkungan skrip administrasi, mis
$PMCD_CONNECT_TIMEOUT=20
3. Di sana harus menjadi baris versi di file kontrol awal formulir:
$ versi = 1.1
4. Harus ada satu baris dalam file kontrol untuk masing-masing pmlogger contoh dari
bentuk:

tuan rumah y|n y|n direktori args

5. Bidang dalam satu baris file kontrol biasanya dipisahkan oleh satu atau lebih
spasi atau tab (walaupun mengacu pada deskripsi direktori lapangan untuk beberapa
pengecualian penting).
6. Itu pertama bidang adalah nama host yang merupakan sumber metrik kinerja
untuk ini pmlogger contoh.
7. Itu kedua bidang menunjukkan jika ini adalah a primer pmlogger contoh (y) atau tidak (n).
Karena logger utama harus berjalan di host lokal, dan mungkin ada paling banyak satu
logger utama untuk host tertentu, bidang ini dapat y untuk paling banyak satu pmlogger
contoh, dalam hal ini nama host harus nama host lokal.
8. Itu ketiga bidang menunjukkan jika ini pmlogger instance harus dimulai di bawah
kendali atas kaos kaki(1) untuk terhubung ke a pmcd melalui firewall (y or n).
9. Itu keempat field adalah nama direktori. Semua file yang terkait dengan ini pmlogger
instance akan dibuat di direktori ini, dan ini akan menjadi direktori saat ini untuk
pelaksanaan program yang diperlukan dalam pemeliharaan arsip tersebut. berguna
konvensi adalah arsip logger utama untuk host lokal dengan nama host tuan rumah saya adalah
dipertahankan dalam direktori $PCP_LOG_DIR/pmlogger/tuan rumah saya (inilah defaultnya
pmlogger skrip start-up di $PCP_RC_DIR/pcp akan membuat arsip), sedangkan arsip
untuk host jarak jauh bergumam dipertahankan dalam $PCP_LOG_DIR/pmlogger/bergumam.
10. Bidang direktori mungkin berisi sintaks shell tertanam yang akan dievaluasi oleh sh(1)
untuk menghasilkan nama direktori sebenarnya yang akan digunakan. Konstruksi yang diizinkan adalah:
· Teks apa pun (termasuk spasi) yang diapit dengan $( dan ).
· Teks apa pun (termasuk spasi) yang diapit dengan ` dan ` (kutipan kembali).
· Teks apa pun (termasuk spasi) yang diapit dengan " dan " (tanda kutip ganda).
· Setiap kata yang mengandung a $ (diasumsikan untuk memperkenalkan nama variabel lingkungan).
11. Semua bidang lain ditafsirkan sebagai argumen untuk diteruskan ke pmlogger(1) dan/atau
pmnewlog(1). Paling biasanya ini adalah -c .

Contoh baris kontrol berikut menentukan pencatat utama pada host lokal (Tuhan), Dan
penebang non-utama untuk mengumpulkan dan mencatat metrik kinerja dari host goyah dan
Boing.

$versi=1.1
bozo yn $PCP_LOG_DIR/pmlogger/bozo -c config.default
wobbly nn "/store/wobbly/$(date +%Y)" -c ./wobbly.config
boing nn $PCP_LOG_DIR/pmlogger/boing -c ./pmlogger.config

Typical crontab(5) entri untuk pelaksanaan berkala pmlogger_daily dan pmlogger_check adalah
diberikan $PCP_SYSCONF_DIR/pmlogger/crontab (kecuali diinstal secara default di /etc/cron.d
sudah) dan ditunjukkan di bawah ini.

# pemrosesan harian arsip log
14 0 * * * $PCP_BINADM_DIR/pmlogger_daily
# setiap 30 menit, periksa apakah instance pmlogger sedang berjalan
25,55 * * * * $PCP_BINADM_DIR/pmlogger_check

Untuk memastikan bahwa email tidak terkirim secara tidak sengaja saat skrip ini dijalankan dari
cron(8) diagnostik selalu dikirim ke file log. Secara default, file ini adalah
$PCP_LOG_DIR/pmlogger/pmlogger_daily.log or $PCP_LOG_DIR/pmlogger/pmlogger_check.log tapi
ini dapat diubah menggunakan -l pilihan. Jika file log ini sudah ada saat skrip
dimulai, itu akan diganti namanya dengan .sebelumnya suffix (menimpa file log apa pun yang disimpan sebelumnya)
sebelum diagnostik dibuat ke file log. NS -l dan -t opsi tidak dapat digunakan
bersama-sama.

Keluaran dari cron eksekusi skrip dapat diperpanjang menggunakan -V pilihan untuk
skrip yang akan memungkinkan penelusuran verbose aktivitas mereka. Secara default skrip
menghasilkan tidak ada output kecuali beberapa kesalahan atau kondisi peringatan ditemui.

Gunakan pmlogger_check online menggunakan layanan onworks.net