xymon - Online di Cloud

PROGRAM:

NAMA

xymon - program komunikasi klien Xymon

RINGKASAN

xymon [pilihan] PENERIMA pesan

DESKRIPSI

xymon(1) adalah program klien yang digunakan untuk berkomunikasi dengan server Xymon. Itu sering
digunakan oleh sistem klien Xymon untuk mengirim pesan status dan peringatan pager pada pengujian lokal.

Di Xymon, program xymon juga digunakan untuk keperluan administratif, misalnya untuk mengganti nama atau
menghapus host, atau menonaktifkan host yang tidak aktif untuk jangka waktu yang lebih lama.

PILIHAN DAN PARAMETER

--debug
Aktifkan debug. Ini mencetak detail tentang bagaimana koneksi ke Xymon
server sedang dibuat.

--proksi=http://PROXYSERVER:PROKSIPORT/
Saat mengirim pesan status melalui HTTP, gunakan server ini sebagai proxy HTTP
menghubungkan langsung ke server Xymon.

--waktu habis=N
Menentukan batas waktu untuk menghubungkan ke server Xymon, dalam hitungan detik. Standarnya
adalah 5 detik.

--tanggapan
Utilitas xymon biasanya tahu kapan harus mengharapkan respons dari server, jadi ini
pilihan tidak diperlukan. Namun, itu akan menyebabkan respons apa pun dari server menjadi
ditampilkan.

--menggabungkan
Gabungkan teks pesan baris perintah dengan data yang disediakan pada input standar, dan
kirim hasilnya ke server Xymon. Teks pesan yang disediakan di baris perintah
menjadi baris pertama dari pesan yang digabungkan.

PENERIMA
Grafik PENERIMA parameter menentukan server mana yang menerima pesan. Jika PENERIMA adalah
diberikan sebagai "0.0.0.0", maka pesan dikirim ke semua server yang terdaftar di
variabel lingkungan XYMSERVERS.

Biasanya, klien akan menggunakan "$XYMSRV" untuk PENERIMA parameter, seperti ini
ditetapkan agar skrip klien secara otomatis berisi nilai yang benar.

Grafik PENERIMA parameter dapat berupa URL untuk server web yang memiliki xymoncgimsg.cgi
atau skrip serupa diinstal. Ini menyalurkan pesan Xymon ke server Xymon
menggunakan protokol HTTP standar. NS xymoncgimsg.cgi(8) Alat CGI (termasuk dalam Xymon)
harus diinstal pada server web agar transport HTTP berfungsi.

PESAN
Grafik pesan parameter adalah pesan yang akan dikirim ke server Xymon.
Pesan harus diapit dalam tanda kutip, tetapi dengan demikian pesan dapat menjangkau beberapa baris.
Ukuran maksimum pesan ditentukan oleh panjang maksimum yang diizinkan dari pesan Anda
baris perintah shell, dan biasanya berukuran 8-32 KB.

Jika Anda perlu mengirim pesan status yang lebih panjang, Anda dapat menentukan "@" sebagai pesan:
xymon kemudian akan membaca pesan status dari stdin-nya.

XYMON PESAN SINTAKSIS

Bagian ini berisi daftar pesan yang paling umum digunakan dalam protokol Xymon.

Setiap pesan harus dimulai dengan salah satu perintah Xymon. Di mana HOSTNAME ditentukan, itu
harus ada titik di nama host yang diubah menjadi koma jika pengaturan Xymon FQDN diaktifkan
(yang merupakan default). Jadi tuan rumah "www.foo.com", misalnya, akan melaporkan sebagai
"www, foo, com".

status[+LIFETIME][/group:GROUP] HOSTNAME.TESTNAME COLOR
Ini mengirimkan pesan status untuk pengujian tunggal (kolom) pada satu host.
TESTNAME adalah nama kolom tempat tes ini akan muncul; nama apa pun valid
kecuali bahwa menggunakan titik-titik di nama tes tidak akan berfungsi. WARNA harus menjadi salah satu dari
warna yang valid: "hijau", "kuning", "merah" atau "bening". Warna "biru" dan "ungu"
- meskipun warna yang valid - tidak boleh dikirim dalam pesan status, karena ini
ditangani secara khusus oleh server Xymon. Sebagai kasus khusus (untuk mendukung yang lebih tua
klien), "klien" dapat digunakan sebagai nama warna. Hal ini menyebabkan status
pesan yang akan ditangani oleh Xymon sebagai pesan data "klien", dan TESTNAME
parameter digunakan sebagai "id kolektor".
"Teks tambahan" biasanya menyertakan stempel waktu lokal dan ringkasan tes
hasil pada baris pertama. Setiap baris setelah yang pertama adalah bentuk bebas, dan dapat
menyertakan informasi apa pun yang mungkin berguna untuk mendiagnosis masalah yang dilaporkan.
LIFETIME menentukan berapa lama status ini berlaku setelah diterima oleh
Server Xymon. Standarnya adalah 30 menit, tetapi Anda dapat mengatur periode apa pun yang Anda suka. Misalnya
untuk tes khusus yang berjalan satu jam sekali, Anda harus mengatur ini setidaknya 60
menit - jika tidak, statusnya akan berubah menjadi ungu setelah 30 menit. Ini adalah ide yang bagus
untuk mengatur SEUMUR HIDUP menjadi sedikit lebih lama dari interval antara pengujian Anda, untuk
memungkinkan variasi waktu yang diperlukan untuk menyelesaikan tes Anda. LIFETIME ada di
menit, kecuali jika Anda menambahkan "h" (jam), "d" (hari) atau "w" (minggu) segera setelah
nomor, misalnya "status+5h" untuk status yang berlaku selama 5 jam.
Opsi GROUP digunakan untuk mengarahkan peringatan dari status ke grup tertentu. Dia
saat ini digunakan untuk status yang dihasilkan dari data klien Xymon, misalnya untuk mengarahkan
peringatan untuk status "procs" ke orang yang berbeda, tergantung pada proses yang tepat
sedang turun.

beri tahu HOSTNAME.TESTNAME
Ini memicu pesan informasi untuk dikirim kepada mereka yang menerima peringatan untuk
kombinasi HOSTNAME+TESTNAME ini, menurut aturan yang ditentukan dalam peringatan.cfg(5)
Ini digunakan oleh enadis.cgi(1) alat untuk memberi tahu orang-orang tentang host yang dinonaktifkan
atau diaktifkan, tetapi juga dapat berfungsi sebagai cara umum untuk memberi tahu administrator server.

data HOSTNAME.DATANAME
Pesan "data" memungkinkan alat untuk mengirim data tentang sebuah host, tanpa muncul sebagai
kolom di halaman web Xymon. Ini digunakan, misalnya, untuk melaporkan statistik
tentang sebuah host, misalnya data vmstat, yang tidak dengan sendirinya mewakili sesuatu yang
memiliki identitas merah, kuning atau hijau. Ini digunakan oleh modul pengumpan bawah RRD, di antaranya:
yang lain. Di Xymon, pesan data secara default hanya diproses oleh xymond_rrd(8)
modul. Jika Anda ingin menangani pesan data menggunakan aplikasi eksternal, Anda dapat
ingin mengaktifkan xymond_filestore(8) modul untuk data-pesan, untuk menyimpan data-
pesan dalam format yang kompatibel dengan cara daemon Big Brother.

nonaktifkan HOSTNAME.TESTNAME DURATION
Menonaktifkan tes tertentu selama DURATION menit. Ini akan menyebabkan status ini
tes terdaftar sebagai "biru" di server Xymon, dan tidak ada peringatan untuk host/tes ini
akan dihasilkan. Jika DURATION diberikan sebagai angka yang diikuti oleh s/m/h/d, itu adalah
ditafsirkan sebagai dalam detik/menit/jam/hari masing-masing. Untuk menonaktifkan a
tes sampai menjadi OK, gunakan "-1" sebagai DURASI. Untuk menonaktifkan semua tes untuk a
host, gunakan tanda bintang "*" untuk TESTNAME.

aktifkan HOSTNAME.TESTNAME
Mengaktifkan kembali tes yang telah dinonaktifkan.

kueri HOSTNAME.TESTNAME
Query server Xymon untuk status terbaru yang dilaporkan untuk tes khusus ini. Jika
status host/pengujian diketahui, responsnya adalah baris pertama dari laporan status
- warna saat ini akan menjadi kata pertama di telepon. Baris teks tambahan
yang mungkin ada pada pesan status tidak dapat diambil.
Ini memungkinkan klien Xymon untuk menentukan status pengujian tertentu, apakah
itu adalah salah satu yang berkaitan dengan host tempat klien berjalan, beberapa host lain, atau
mungkin hasil tes gabungan dari beberapa host yang dikelola oleh status kombo(1)
Ini biasanya akan berguna untuk skrip ekstensi klien Xymon, yang perlu:
menentukan status host lain, misalnya, untuk memutuskan apakah otomatis
tindakan pemulihan harus dimulai.

konfigurasi FILENAME
Ambil salah satu file konfigurasi Xymon dari server. Perintah ini memungkinkan
klien untuk menarik file dari direktori $XYMONHOME/etc/ di server, memungkinkan
untuk pembaruan semi-otomatis dari konfigurasi klien. Sejak konfigurasi
file dirancang untuk memiliki file umum untuk konfigurasi semua host di
sistem - dan ini sebenarnya adalah cara yang disarankan untuk mengonfigurasi klien Anda - ini
membuatnya lebih mudah untuk menyinkronkan file konfigurasi.

jatuhkan HOSTNAME
Menghapus semua data yang disimpan tentang host HOSTNAME. Diasumsikan bahwa Anda memiliki
sudah menghapus host dari file konfigurasi hosts.cfg.

jatuhkan HOSTNAME TESTNAME
Hapus data tentang satu pengujian (kolom).

ganti nama OLDHOSTNAME NEWHOSTNAME
Ganti nama semua data untuk host yang namanya telah diubah. Anda harus melakukan ini setelah
mengubah nama host di file konfigurasi hosts.cfg.

ganti nama HOSTNAME OLDTESTNAME NEWTESTNAME
Ganti nama data tentang satu tes (kolom).

xymondlog HOSTNAME.TESTNAME
Ambil log status Xymon untuk satu pengujian. Baris pertama tanggapan
berisi serangkaian bidang yang dipisahkan oleh tanda pipa:

hostname Nama tuan rumah

nama tes Nama tesnya

warna Warna status (hijau, kuning, merah, biru, bening, ungu)

bendera uji Untuk pengujian jaringan, tanda yang menunjukkan detail tentang pengujian (digunakan oleh
xymongen).

perubahan terakhir Stempel waktu Unix saat warna status terakhir diubah.

waktu masuk Stempel waktu Unix saat pesan log diterima.

waktu berlaku Stempel waktu Unix saat pesan log tidak lagi valid (berwarna ungu saat
kali ini).

waktu kembali Baik -1 atau stempel waktu Unix saat pengakuan aktif kedaluwarsa.

waktu nonaktif Baik -1 atau stempel waktu Unix saat status tidak lagi dinonaktifkan.

pengirim Alamat IP tempat status diterima.

kue Baik -1 atau nilai cookie yang digunakan untuk mengakui peringatan.

pemberitahuan Kosong atau pesan pengakuan dikirim saat status telah diakui.
Baris baru, tanda pipa, dan garis miring terbalik dihilangkan dengan garis miring terbalik, gaya-C.

menghilangkan pesan Kosong atau pesan terkirim saat status dinonaktifkan. Baris baru, tanda pipa
dan garis miring terbalik dihilangkan dengan garis miring terbalik, gaya-C.

Setelah baris pertama muncul log status lengkap dalam format teks biasa.

xymondxlog HOSTNAME.TESTNAME
Mengambil string XML yang berisi log status seperti dengan perintah "xymondlog".

xymondboard [KRITERIA] [fields=FIELDLIST]
Mengambil ringkasan status semua tes yang diketahui tersedia untuk daemon Xymon.

Secara default - jika tidak ada KRITERIA yang diberikan - ia mengembalikan satu baris untuk semua status
pesan yang ditemukan di Xymon. Anda dapat memfilter respons berdasarkan pilihan tertentu
halaman, host, tes, warna atau berbagai bidang lainnya. PAGEPATH, JARINGAN, NAMA HOST,
TESTNAME, dan parameter *MSG ditafsirkan ekspresi reguler yang kompatibel dengan Perl;
parameter COLOR menerima beberapa warna yang dipisahkan dengan koma; *nilai WAKTU
menerima cap waktu zaman unix. Variabel lain yang diidentifikasi dalam xymon-xmh(5) boleh juga
digunakan.

Karena filtrasi host dilakukan sebelum filtrasi uji, ini lebih efisien (dengan
kumpulan data yang sangat besar) untuk menggunakan PAGEPATH, HOSTNAME, NETWORK, dan filter XMH_ lainnya
bila memungkinkan, sebelum memfilter secara global dengan COLOR, *MSG, *TIME, atau TESTNAME.

Anda dapat memfilter, misalnya, nama host dan nama tes.

halaman=PAGEPATH Sertakan hanya pengujian dari host yang ditemukan di halaman PAGEPATH di
file host.cfg.

bersih = JARINGAN Sertakan hanya pengujian dari host dengan NET ini: tag

aku p = IPAlamat Hanya menyertakan pengujian dari host dengan alamat IP ini. Ini adalah ekspresi reguler,
bukan CIDR.

tuan rumah = NAMA HOST Sertakan hanya pengujian dari host HOSTNAME

tes=NAMA UJI Sertakan hanya tes dengan nama tes TESTNAME

warna = NAMA WARNA Hanya sertakan pengujian dengan warna status COLORNAME

tag= NAMA TAG Sertakan hanya host dengan tag tertentu yang ditentukan dalam host.cfg(5)
garis. Perhatikan bahwa hanya item yang diketahui oleh komponen xymon yang disertakan di sini; sewenang-wenang
teks tidak termasuk

XMH_string=NILAI Sertakan hanya host dengan a xymon-xmh(5) variabel yang cocok dengan ini
nilai

Penyaringan Tingkat Lanjut

pesan = PESAN Sertakan hanya pengujian dengan MESSAGE pencocokan konten lengkap. Gunakan "\s" untuk
escape space (atau string PCRE lainnya)

ackmsg=PESAN Sertakan hanya pengujian dengan MESSAGE pengakuan. Gunakan "\s" untuk
escape space (atau string PCRE lainnya)

dismsg=PESAN Sertakan hanya pengujian yang telah dinonaktifkan dengan pencocokan string
PESAN. Gunakan "\s" untuk keluar dari spasi (atau string PCRE lainnya). (Ini paling efisien
untuk memasangkan ini dengan warna = biru.)

Filter stempel waktu

Bidang tertentu (dijelaskan di bawah) dapat difilter dengan cap waktu unix dan dengan
pertidaksamaan berikut: >= > <= < = !=

Filter ini adalah: lastchange, logtime, validtime, acktime, disabletime

Responnya adalah satu baris untuk setiap status yang cocok dengan KRITERIA, atau semua status
jika tidak ada kriteria yang ditentukan. Garis terdiri dari sejumlah bidang, dipisahkan
dengan tanda pipa. Anda dapat memilih bidang mana yang akan diambil dengan mencantumkannya di
DAFTAR LAPANGAN. Bidang-bidang berikut tersedia:

hostname Nama tuan rumah

nama tes Nama tesnya

warna Warna status (hijau, kuning, merah, biru, bening, ungu)

bendera Untuk pengujian jaringan, tanda yang menunjukkan detail tentang pengujian (digunakan oleh
xymongen).

perubahan terakhir Stempel waktu Unix saat warna status terakhir diubah.

waktu masuk Stempel waktu Unix saat pesan log diterima.

waktu berlaku Stempel waktu Unix saat pesan log tidak lagi valid (berwarna ungu saat
kali ini).

waktu kembali Baik -1 atau stempel waktu Unix saat pengakuan aktif kedaluwarsa.

waktu nonaktif Baik -1 atau stempel waktu Unix saat status tidak lagi dinonaktifkan.

pengirim Alamat IP tempat status diterima.

kue Baik -1 atau nilai cookie yang digunakan untuk mengakui peringatan.

baris1 Baris pertama dari log status.

pemberitahuan Kosong (jika tidak ada pengakuan aktif), atau teks pengakuan
pesan.

menghilangkan pesan Kosong (jika status saat ini diaktifkan), atau teks penonaktifan
pesan.

msg Teks lengkap dari pesan status saat ini.

klien Menunjukkan "Y" jika ada data klien yang tersedia, "N" jika tidak.

stempel clnt Stempel waktu saat pesan klien terakhir diterima, di "Epoch" Unix
Format.

daftar ack Daftar pengakuan saat ini untuk tes. Ini adalah string teks dengan
beberapa bidang, dibatasi oleh karakter titik dua. Ada 5 bidang: Stempel waktu untuk
kapan ack dibuat dan kapan kedaluwarsa; "tingkat ack"; pengguna yang
mengirim ack; dan teks pengakuan.

info tutup Memberitahu jika statusnya mengepak. 5 bidang, dibatasi oleh "/": A "0" jika
status tidak mengepak dan "1" jika mengepak; stempel waktu kapan status terbaru
perubahan dicatat dan kapan perubahan status pertama dicatat; dan keduanya
warna yang statusnya mengepak di antara.

statistik Jumlah perubahan status yang telah dicatat untuk status ini sejak xymond
sudah dimulai.

pengubah Mencantumkan semua pengubah aktif untuk status ini (yaitu pembaruan yang dikirim menggunakan a
perintah "ubah").

XMH_* Tag XMH mengacu pada Xymon host.cfg(5) pengaturan konfigurasi. Penuh
daftar ini dapat ditemukan di xymon-xmh(5) halaman manual.

Bidang ackmsg, dismsg dan msg memiliki karakter tertentu yang dikodekan: Baris baru adalah "\n",
TAB adalah "\t", carriage return adalah "\r", tanda pipa adalah "\p", dan garis miring terbalik adalah "\\".

Jika parameter "bidang" dihilangkan, satu set default dari
hostname,testname,warna,flag,lastchange,logtime,validtime,acktime,disabletime,sender,cookie,line1
digunakan.

papan xymondx
Mengambil string XML dengan ringkasan semua log status seperti untuk
perintah "xymondboard".

info host [KRITERIA]
Mengambil konfigurasi host saat ini (mis host.cfg(5) definisi).
KRITERIA memilih host mana yang akan dilaporkan, dan identik dengan KRITERIA di
perintah xymondboard.

Responnya adalah satu baris untuk setiap host yang cocok dengan KRITERIA, atau semua host jika
tidak ada kriteria yang ditentukan. Garis terdiri dari sejumlah bidang, dipisahkan oleh
tanda pipa. Dua bidang pertama akan selalu menjadi nama host dan alamat IP.
Bidang yang tersisa - jika ada - adalah tag hosts.cfg tanpa urutan tertentu.

unduh FILENAME
Unduh file dari direktori unduhan server Xymon.

klien[/COLLECTORID] NAMA HOST.OSTYPE [HOSTCLASS]
Digunakan untuk mengirim pesan "klien" ke server Xymon. Pesan klien dibuat
oleh klien Xymon; ketika dikirim ke server Xymon mereka dicocokkan dengan
aturan di analisis.cfg(5) file konfigurasi, dan pesan status dihasilkan
untuk tes sisi klien. COLLECTORID digunakan saat mengirim data klien yang
adalah tambahan untuk data klien standar. Data akan digabungkan dengan
data klien biasa.

clientlog HOSTNAME [bagian=SECTIONNAME[,SECTIONNAME...]]
Mengambil pesan klien mentah saat ini yang terakhir dikirim oleh HOSTNAME. opsional
Filter "bagian" digunakan untuk memilih bagian tertentu dari data klien.

ping Mencoba menghubungi server Xymon. Jika berhasil, ID versi server Xymon adalah
dilaporkan.

klien penarik
Pesan ini digunakan saat mengambil data klien melalui mekanisme "tarik" yang diterapkan
by pengambilan xymon(8) dan cache pesan(8) untuk klien yang tidak dapat terhubung langsung ke
Server Xymon.

daftar hantu
Laporkan daftar hantu klien dilihat oleh server Xymon. Hantu adalah sistem yang
melaporkan data ke server Xymon, tetapi tidak terdaftar di file hosts.cfg.

jadwal [PERINTAH TIMESTAMP]
Menjadwalkan perintah yang dikirim ke server Xymon untuk dieksekusi di lain waktu. Misalnya
digunakan untuk menjadwalkan penonaktifan host atau layanan di masa mendatang. MEMERINTAH
adalah perintah Xymon lengkap seperti yang tercantum di atas. TIMESTAMP adalah Unix
epoch waktu ketika perintah akan dieksekusi.
Jika tidak ada parameter yang diberikan, tugas yang dijadwalkan saat ini akan dicantumkan di:
tanggapan. Responsnya adalah satu baris per perintah terjadwal, dengan job-id, the
waktu ketika perintah akan dieksekusi, alamat IP dari mana ini dikirim,
dan string perintah lengkap.
Untuk membatalkan perintah yang dijadwalkan sebelumnya, "Jadwal membatalkan PEKERJAAN" dapat digunakan.
JOBID adalah nomor yang disediakan sebagai item pertama dalam output dari daftar jadwal.

catatan FILENAME
Teks pesan akan disimpan di $XYMONHOME/notes/FILENAME yang kemudian digunakan sebagai
hyperlink dari nama host atau nama kolom. Ini membutuhkan tugas "storenotes"
diaktifkan di task.cfg (dinonaktifkan secara default). FILENAME tidak boleh berisi apapun
jalur direktori - ini dihapus secara otomatis.

ID pesan pengguna
Pesan-pesan ini akan diteruskan langsung ke modul yang mendengarkan di saluran "pengguna"
dari daemon Xymon. Ini dimaksudkan untuk komunikasi khusus antara sisi klien
modul dan server Xymon.

memodifikasi HOSTNAME.TESTNAME SUMBER WARNA PENYEBAB
Ubah warna status tertentu, tanpa membuat status lengkap
pesan. Ini untuk prosesor backend (misalnya grafik RRD) yang dapat menimpa
warna status berdasarkan beberapa kriteria yang ditentukan di luar aliran normal a
status. Misalnya status "sambungan" normal mungkin tampak hijau karena hanya memeriksa
tentang apakah sebuah host dapat di-ping atau tidak; penangan RRD kemudian dapat menggunakan "modifikasi"
perintah untuk menimpa ini adalah waktu respons ping yang sebenarnya melebihi ambang batas yang diberikan.
(Lihat pengaturan konfigurasi "DS" di analisis.cfg(5) untuk bagaimana melakukan ini). SUMBER
adalah beberapa identifikasi modul yang menghasilkan pesan "modifikasi" - masa depan
modifikasi harus menggunakan sumber yang sama. Mungkin ada beberapa sumber yang memodifikasi
status yang sama (status yang paling parah kemudian menjadi warna sebenarnya dari
status). CAUSE adalah string teks satu baris yang menjelaskan alasan untuk menimpa
warna status normal - itu akan ditampilkan di halaman web status.

CONTOH

Kirim pesan status normal ke server Xymon, menggunakan protokol Xymon standar pada TCP
pelabuhan 1984:
$ $XYMON $XYMSRV "status www,foo,com.http green `date` Web OK"

Kirim pesan status yang sama, tetapi menggunakan protokol HTTP melalui xymoncgimsg.cgi server web
naskah:
$$XYMON http://bb.foo.com/cgi-bin/xymoncgimsg.cgi "status www,foo,com.http green
`tanggal` Web OK"

Gunakan pesan "query" untuk menentukan warna tes "www", dan restart Apache jika ya
merah:

$ WWW=`$XYMON $XYMSRV "kueri www,foo,com.www" | awk '{cetak $1}'`
$ jika [ "$WWW" = "merah" ]; lalu /etc/init.d/apache restart; fi

Gunakan pesan "config" untuk memperbarui file mytest.cfg lokal (tetapi hanya jika kami mendapat respons):

$ $XYMON $XYMSRV "config mytest.cfg" >/tmp/mytest.cfg.new
$ jika [ -s /tmp/mytest.cfg.new ]; kemudian
mv /tmp/mytest.cfg.baru $XYMONHOME/etc/mytest.cfg
fi

Kirim pesan status yang sangat besar yang telah dibangun di file "statusmsg.txt". Sebagai gantinya
menyediakannya di baris perintah, berikan melalui stdin ke perintah xymon:

$ cat statusmsg.txt | $XYMON $XYMSRV "@"

Gunakan xymon online menggunakan layanan onworks.net