xymongen - Dalam talian di Awan

JADUAL:

NAMA

xymongen - penjana halaman web Xymon

SINOPSIS

xymongen -?
xymongen - membantu
xymongen --versi
xymongen [pilihan] [output-direktori]
(Lihat bahagian PILIHAN untuk penerangan tentang pilihan baris arahan yang tersedia).

DESCRIPTION

xymongen menjana halaman web gambaran keseluruhan untuk monitor Xymon. Ini adalah halaman web
yang menunjukkan status keseluruhan hos anda, bukan halaman status terperinci untuk setiap ujian.

Nota: Data untuk halaman web diambil daripada xymond(8) daemon, dan kegunaan xymongen
nilai pembolehubah persekitaran XYMSRV / XYMSERVERS untuk menentukan rangkaian
alamat tempat xymond boleh dihubungi. Jika anda mempunyai lebih daripada satu pelayan disenaraikan dalam
XYMSERVERS, pastikan yang pertama ialah pelayan Xymon tempatan - ini adalah pelayan itu
xymongen akan membuat pertanyaan untuk data.

PILIHAN

xymongen mempunyai sejumlah besar pilihan baris arahan. Pilihan boleh digunakan untuk menukar
tingkah laku xymongen dan menjejaskan halaman web yang dihasilkan olehnya.

UMUM PILIHAN

--membantu atau -?
Sediakan ringkasan pilihan baris arahan yang tersedia.

--versi
Mencetak nombor versi xymongen

--docurl=URL
Pilihan ini ditamatkan, gunakan tetapan HOSTDOCURL dalam xymonserver.cfg(5)
sebaliknya.

--doccgi=URL
Pilihan ini ditamatkan, gunakan tetapan HOSTDOCURL dalam xymonserver.cfg(5)
sebaliknya.

--doc-window
Menyebabkan pautan ke dokumentasi untuk hos dan perkhidmatan dibuka dalam tetingkap baharu. The
lalai adalah untuk menunjukkan dokumentasi dalam tetingkap pelayar yang sama dengan status Xymon.

--htmlextension=.EXTENSION
Menetapkan sambungan nama fail yang digunakan untuk halaman web yang dijana oleh xymongen. Oleh
lalai, sambungan ".html" digunakan. Ambil perhatian bahawa anda perlu menentukan "titik".

--report[=COLUMNNAME]
Dengan pilihan ini, xymongen akan menghantar mesej status dengan butiran bilangannya
hos telah diproses, berapa banyak halaman yang dihasilkan, sebarang ralat yang berlaku
semasa larian, dan beberapa statistik masa. Nama lajur lalai ialah "xymongen".

--htaccess[=htaccess-filename]
Cipta fail .htaccess apabila direktori halaman web baharu dibuat. Kandungan daripada
fail .htaccess ditentukan oleh pembolehubah persekitaran XYMONHTACCESS (untuk
direktori peringkat atas dengan xymon.html dan nongreen.html); oleh
Pembolehubah XYMONPAGEHTACCESS (untuk direktori peringkat halaman); dan oleh
Pembolehubah XYMONSUBPAGEHTACCESS untuk direktori peringkat subhalaman dan subinduk. The
nama fail fail .htaccess lalai kepada ".htaccess" jika tiada nama fail diberikan dengan
pilihan ini. Pembolehubah XYMONHTACCESS disalin secara verbatim ke peringkat teratas
fail .htaccess. Pembolehubah XYMONPAGEHTACCESS mungkin mengandungi "%s" di mana nama
halaman dimasukkan. Pembolehubah XYMONSUBPAGEHTACCESS mungkin mengandungi dua "%s"
contoh: Yang pertama digantikan dengan nama halaman, yang kedua dengan
nama kecil.

--max-eventcount=N
Hadkan log peristiwa pada halaman "Semua bukan hijau" kepada N acara sahaja. Lalai: 100.

--max-eventtime=N
Hadkan log peristiwa pada halaman "Semua bukan hijau" kepada peristiwa yang berlaku dalam
N minit lepas. Lalai: 240.

--no-eventlog
Lumpuhkan log peristiwa yang biasanya dipaparkan pada halaman "Semua bukan hijau".

--maks-ackcount=N
Hadkan log pengakuan pada halaman "Semua bukan hijau" kepada N acara sahaja. Lalai:
25.

--maks-masa masuk=N
Hadkan log pengakuan pada halaman "Semua bukan hijau" kepada acks yang berlaku
dalam masa N minit yang lalu. Lalai: 240.

--tidak-acklog
Lumpuhkan log pengakuan yang biasanya dipaparkan pada halaman "Semua bukan hijau".

--cricitcallog[=Lajur log kritikal]
Ini menjana log berasaskan teks tentang perkara yang ditunjukkan pada halaman status critical.html,
dan menghantar mesej status untuk pelayan Xymon itu sendiri yang mencerminkan warna
Halaman status kritikal. Ini membolehkan anda menjejak apabila masalah telah muncul pada
halaman status kritikal. Fail log disimpan dalam $XYMONSERVERLOGS/criticalstatus.log

--loadhostsfromxymond
Daripada membaca fail hosts.cfg, xymongen akan memuatkan hosts.cfg
konfigurasi daripada daemon xymond. Ini menghapuskan keperluan untuk membaca
hosts.cfg, dan jika anda mempunyai xymond dan xymongen berjalan pada hos yang berbeza, ia juga
menghapuskan keperluan untuk menyalin fail hos.cfg antara sistem. Perhatikan bahawa
Pilihan "dispinclude" dalam hosts.cfg diabaikan apabila pilihan ini didayakan.

PAGE LAYOUT PILIHAN

Pilihan ini mempengaruhi cara halaman web yang dijana oleh xymongen muncul dalam penyemak imbas.

--halaman-terakhir
Letakkan pautan halaman dan subhalaman selepas hos.

--halaman-dahulu
Letakkan pautan halaman dan subhalaman sebelum hos (lalai).

Kedua-dua pilihan ini menentukan sama ada halaman dengan pautan ke subhalaman dan hos mempunyai
hos atau subhalaman dahulu.

--subpagecolumns=N
Menentukan bilangan lajur yang digunakan untuk pautan ke halaman dan subhalaman. lalai
ialah N=1.

--maxrows=N
Tajuk lajur pada halaman secara lalai hanya ditunjukkan pada permulaan halaman,
subhalaman atau kumpulan hos. Pilihan ini menyebabkan tajuk lajur berulang untuk
setiap N hos ditunjukkan.

--showemptygroups

--no-showemptygroups
Apabila kumpulan adalah hos dibuat, paparkan jadual dan nama hos walaupun ada
tiada ujian hadir untuk mana-mana hos yang dipersoalkan. Gunakan --no-showemptygroups untuk
bersembunyi. (Lalai: ya)

--pautan tajuk halaman
Biasanya, hanya "titik" berwarna di sebelah halaman atau subhalaman bertindak sebagai pautan ke
halaman itu sendiri. Dengan pilihan ini, tajuk halaman akan dipautkan ke halaman juga.

--pagetext-headings
Gunakan teks penerangan daripada teg "halaman" atau "subhalaman" sebagai tajuk untuk
halaman, bukannya "Halaman dihoskan secara setempat" atau tajuk standard lain.

--tiada-garis-garis-tajuk
Biasanya, tajuk halaman digariskan menggunakan teg "pembaris mendatar" HTML. ini
pilihan melumpuhkan garis bawah tajuk.

--recentgifs[=MINUTES]
Gunakan imej bernama COLOR-recent.gif untuk ujian, yang status ujian telah berubah
dalam tempoh 24 jam yang lalu. Fail GIF ini perlu dipasang dalam
direktori $XYMONHOME/www/gifs/. Secara lalai, ambang ditetapkan kepada 24 jam - jika
anda mahukannya secara berbeza, anda juga boleh menentukan had masa. Cth
"--recentgifs=3j" akan menunjukkan GIF terbaharu hanya selama 3 jam selepas perubahan status.

--isih-kumpulan-sahaja-item
Dalam arahan "kumpulan sahaja" biasa, anda boleh menentukan susunan ujian
dipaparkan, dari kiri ke kanan. Jika anda lebih suka mempunyai ujian disenaraikan dalam
susunan abjad, gunakan pilihan ini - halaman kemudian akan menjana "kumpulan sahaja"
kumpulan seperti itu menjana kumpulan biasa, dan mengisih ujian mengikut abjad.

--dialupskin=URL
Jika anda ingin menunjukkan secara visual bahawa ujian ialah ujian dail, anda boleh menggunakan alternatif
set ikon untuk hijau/merah/kuning>/etc. imej dengan menyatakan pilihan ini. The
Parameter URL yang dinyatakan di sini mengatasi tetapan biasa daripada XYMONSKIN
pembolehubah persekitaran, tetapi hanya untuk ujian dail.

--reverseskin=URL
Sama seperti "--dialupskin", tetapi untuk ujian terbalik (ujian dengan '!' di hadapan).

--tooltips=[sentiasa,tidak pernah,utama]
Menentukan halaman yang menggunakan petua alat untuk menunjukkan perihalan hos (daripada
Entri KOMEN dalam hos.cfg(5) fail). Jika ditetapkan kepada sentiasa, petua alat digunakan pada semua
muka surat. Jika ditetapkan kepada pernah, petua alat tidak pernah digunakan. Jika ditetapkan kepada utama, petua alat digunakan
pada halaman utama, tetapi bukan pada halaman "Semua bukan hijau" atau "Sistem kritikal".

COLUMN PEMILIHAN PILIHAN

Pilihan ini mempengaruhi lajur (ujian) yang disertakan dalam halaman web yang dijana oleh
xymongen.

--ignorecolumns=test[,test]
Lajur yang diberikan akan diabaikan sepenuhnya oleh xymongen apabila menjana halaman web.
Boleh digunakan untuk menjana laporan di mana anda menghapuskan beberapa ujian yang lebih bising,
seperti "msg".

--kritikal-merah-sahaja
Hanya lajur status merah akan disertakan pada halaman Kritikal. Secara lalai, yang
Halaman kritikal akan mengandungi hos dengan status merah, kuning dan jelas.

--nongreen-colors=COLOR[,COLOR]
Mentakrifkan warna yang menyebabkan ujian muncul pada halaman status "Semua bukan hijau".
WARNA ialah merah, kuning atau ungu. Lalai adalah untuk memasukkan ketiga-tiga.

--nongreen-ignorecolumns=test[,test]
Sama seperti --ignorecolumns, tetapi digunakan untuk hos pada halaman "Semua bukan hijau" sahaja.

--nongreen-ignorepurples
Tidak digunakan lagi, gunakan "--nongreen-colors" sebaliknya.

--nongreen-ignoredialups
Abaikan semua hos dail pada halaman "Semua bukan hijau", termasuk log peristiwa.

--tiada-halaman
Jangan jana halaman biasa (biasanya digunakan untuk menjana hanya halaman bukan hijau
halaman).

--tidak-bukan-hijau
Jangan jana halaman "Semua bukan hijau".

--includecolumns=test[,test]
Sentiasa sertakan lajur ini pada halaman "Semua bukan hijau" Akan menyertakan lajur tertentu
pada halaman nongreen.html, tanpa mengira warnanya. Biasanya, nongreen.html menjatuhkan a
lajur ujian, jika semua ujian berwarna hijau. Ini boleh digunakan contohnya untuk sentiasa mempunyai pautan ke
lajur arah aliran (dengan graf RRD) daripada halaman bukan hijau.html anda.

--evenignore=test[,test]
Abaikan ujian ini dalam paparan log peristiwa "Semua bukan hijau".

STATUS PENYEBARAN PILIHAN

Pilihan ini menyekat penyebaran normal status ke atas dalam hierarki halaman.
Oleh itu, anda boleh mempunyai ujian dengan status kuning atau merah, tetapi masih mempunyai keseluruhan halaman berwarna hijau.
Ia berguna untuk ujian yang tidak perlu menyebabkan penggera, tetapi di mana anda masih ingin mengetahui
status sebenar. Pilihan ini menetapkan lalai global untuk semua hos; anda boleh menggunakan NOPROPRED
dan teg NOPROPYELLOW dalam hos.cfg(5) fail untuk menggunakan had yang sama pada setiap hos
asas.

--nopropyellow=test[,test] atau --noprop=test[,test]
Lumpuhkan penyebaran status ke atas apabila KUNING. Pilihan "--noprop" ditamatkan
dan tidak boleh digunakan.

--noproppurple=test[,test]
Lumpuhkan penyebaran status ke atas apabila UNGU.

--nopropred=test[,test]
Lumpuhkan penyebaran status ke atas apabila MERAH atau KUNING.

--nopropack=test[,test]
Lumpuhkan penyebaran status ke atas apabila status telah diakui. Jika anda mahu
untuk melumpuhkan semua ujian acked daripada disebarkan, gunakan "--nopropack=*".

UNGU STATUS PILIHAN

Status ungu berlaku apabila pelaporan status ujian berhenti. Status ujian adalah sah untuk a
jumlah masa terhad - biasanya 30 minit - dan selepas masa ini, ujian menjadi
ungu.

--purplelog=FILENAME
Hasilkan fail log semua mesej status ungu.

ALTERNATE HALAMAN PILIHAN

--pageset=PAGESETNAME
Bina halaman web untuk set halaman alternatif daripada lalai. Lihat bahagian PAGESETS
di bawah.

--template=TEMPLAT
Gunakan templat ganti untuk fail pengepala dan pengaki. Biasanya digunakan bersama-sama
pilihan "--pageset"; lihat bahagian PAGESET di bawah.

ALTERNATE OUTPUT FORMATS

--wml[=test1,test2,...]
Pilihan ini menyebabkan xymongen menjana satu set fail "kad" WML yang boleh
diakses oleh peranti WAP (telefon bimbit, PDA dll.) Fail yang dijana mengandungi
hos yang mempunyai status MERAH atau KUNING pada ujian yang ditentukan. Pilihan ini boleh menentukan
ujian lalai untuk disertakan - lalai boleh ditindih atau dipinda menggunakan
Teg "WML:" atau "NK:" dalam hos.cfg(5) fail. Jika tiada ujian dinyatakan, semua ujian
akan disertakan.

--nstab=NAMA FAIL
Hasilkan fail HTML yang sesuai untuk entri bar sisi Netscape 6/Mozilla. Untuk sebenarnya
membolehkan pengguna anda mendapatkan entri bar sisi sedemikian, anda memerlukan kod Javascript ini
halaman web (cth anda boleh memasukkannya ke dalam fail $XYMONHOME/web/stdnormal_header):


<!--
fungsi addNetscapePanel() {
if ((typeof window.sidebar == "objek") &&
(typeof window.sidebar.addPanel == "fungsi"))
window.sidebar.addPanel ("Xymon",
"http://your.server.com/nstab.html","");
lagi
alert("Sidebar hanya untuk Mozilla atau Netscape 6+");
}
// ->


dan kemudian anda boleh memasukkan pautan "Tambah ini ke bar sisi" menggunakan ini sebagai templat:

Tambahkan pada Sidebar

atau jika anda lebih suka mempunyai butang "Tambah tab" Netscape standard, anda akan melakukannya
bersama


<IMG SRC="/gifs/add-button.gif" HEIGHT=45 WIDTH=100
ALT="[Tambah Bar Sisi]" STYLE="border:0">


"add-button.gif" tersedia daripada Netscape di
http://developer.netscape.com/docs/manuals/browser/sidebar/add-button.gif.

Jika FILENAME tidak bermula dengan garis miring, fail bar sisi Netscape diletakkan di dalam
direktori $XYMONHOME/www/.

--nslimit=COLOR
Warna minimum untuk disertakan dalam Bar Sisi Netscape - lalai ialah "merah", bermakna
hanya amaran kritikal disertakan. Jika anda ingin memasukkan amaran juga, gunakan
"--nslimit=kuning".

--rss Jana aliran penghantaran kandungan RSS/RDF bagi makluman Xymon anda. Format output ini
boleh dibenamkan secara dinamik dalam halaman web lain, sama seperti suapan berita langsung selalunya
dilihat di laman web. Dua fail RSS akan dijana, satu mencerminkan "Semua bukan-
hijau", halaman yang satu lagi mencerminkan halaman "Kritikal". Mereka akan berada dalam
Fail "nongreen.rss" dan "critical.rss", masing-masing. Di samping itu, fail RSS
akan dijana untuk setiap halaman dan/atau subhalaman yang menyenaraikan hos yang hadir padanya
halaman atau subhalaman.
Parameter FILENAME yang sebelum ini dibenarkan pada pilihan --rss kini sudah usang.
Untuk mendapatkan maklumat lanjut tentang suapan kandungan RSS/RDF, sila lihat
http://www.syndic8.com/.

--rssextension=.SAMBUNGAN
Menetapkan sambungan nama fail yang digunakan untuk fail RSS yang dijana oleh xymongen. Oleh
lalai, sambungan ".rss" digunakan. Ambil perhatian bahawa anda perlu menentukan "titik".

--rssversion={0.91|0.92|1.0|2.0}
Format output suapan RSS/RDF yang dikehendaki. Versi 0.91 nampaknya paling banyak
format yang biasa digunakan, dan merupakan lalai jika pilihan ini ditinggalkan.

--rsslimit=WARNA
Warna minimum untuk disertakan dalam suapan RSS - lalai ialah "merah", bermakna sahaja
amaran kritikal disertakan. Jika anda ingin menyertakan amaran juga, gunakan
"--rsslimit=kuning".

PILIHAN DIGUNAKAN BY CGI HUJUNG DEPAN

--reportopts=MULA:END:DINAMIK:GAYA
Ajak xymongen dalam mod penjanaan laporan. Ini biasanya digunakan oleh
laporan.cgi(1) Skrip CGI, tetapi juga boleh digunakan secara langsung semasa pra-menjana
laporan. Parameter START ialah masa mula untuk laporan dalam Unix time_t
format (saat sejak 1 Jan 1970 00:00 UTC); TAMAT ialah masa akhir untuk laporan;
DYNAMIC ialah 0 untuk laporan pra-bina dan 1 untuk laporan dinamik (dalam talian); STYLE ialah
"crit" untuk memasukkan hanya peristiwa kritikal (merah), "nongr" untuk memasukkan semua bukan hijau
acara, dan "semua" untuk memasukkan semua acara.

--csv=NAMA FAIL
Digunakan bersama --reportopts, ini menyebabkan xymongen menjana ketersediaan
laporan dalam bentuk fail nilai dipisahkan koma (CSV). Format ini biasa
digunakan untuk mengimport ke dalam hamparan untuk pemprosesan selanjutnya.
Fail CSV termasuk cap waktu Unix. Untuk memaparkan ini sebagai masa yang boleh dibaca manusia dalam
Excel, formulanya =C2/86400+DATEVALUE(1-jan-1970) (jika anda mempunyai cap waktu Unix
dalam sel C2) boleh digunakan. Sel hasil hendaklah diformatkan sebagai tarikh/masa
padang. Ambil perhatian bahawa cap masa berada dalam UTC, jadi anda juga mungkin perlu mengendalikan setempat
zon waktu dan DST mengeluarkan sendiri.

--csvdelim=DELIMITER
Secara lalai, koma digunakan untuk mengehadkan medan dalam output CSV. Ada yang bukan bahasa Inggeris
hamparan menggunakan pembatas yang berbeza, biasanya koma bertitik. Untuk menjana CSV
fail dengan pembatas yang betul, anda boleh menggunakan pilihan ini untuk menetapkan aksara yang digunakan
sebagai pembatas. Cth "--csvdelim=;" - ambil perhatian bahawa ini biasanya dalam dua kali ganda
petikan, untuk menghalang cangkerang Unix daripada mentafsir aksara pembatas sebagai a
pembatas baris arahan.

--snapshot=MASA
Hasilkan petikan halaman Xymon, seperti yang muncul pada TIME. MASA diberikan sebagai
saat sejak 1 Jan 1970 00:00 UTC. Biasanya digunakan melalui snapshot.cgi(1) CGI
skrip.

MENGHILANGKAN PILIHAN

--nyahpepijat
Menyebabkan xymongen membuang sejumlah besar output penyahpepijatan ke stdout, jika ada
disusun dengan -DDEBUG didayakan. Apabila melaporkan masalah dengan xymongen, sila
cuba menghasilkan semula masalah dan berikan output daripada menjalankan xymongen dengan ini
pilihan.

--masa
Buang maklumat tentang masa yang diluangkan oleh pelbagai bahagian xymongen kepada stdout. ini
berguna untuk melihat bahagian pemprosesan yang bertanggungjawab untuk masa jalan
xymongen.
Nota: Maklumat ini juga disediakan dalam output yang dihantar ke paparan Xymon
apabila menggunakan pilihan "--report".

BANGUNAN ALTERNATE HALAMAN

Dengan versi 1.4 xymongen terdapat kemungkinan untuk menjana beberapa set halaman daripada
data yang sama.
Katakan anda mempunyai dua kumpulan orang yang melihat halaman web Xymon. Kumpulan A mahu
mempunyai hos yang dikumpulkan oleh pelanggan, mereka adalah milik. Beginilah cara anda menyediakan Xymon -
set halaman lalai. Kini kumpulan B mahu mempunyai hos dikumpulkan mengikut sistem pengendalian -
mari kita panggil ia set "os". Kemudian anda akan menambah susun atur halaman ke hosts.cfg seperti ini:

ospage memenangi Microsoft Windows
ossubpage win-nt4 MS Windows NT 4
osgroup NT4 Pelayan Fail
osgroup pelayan Mel NT4
ossubpage win-xp MS Windows XP
ospage unix Unix
ossubpage unix-sun Solaris
ossubpage unix-linux Linux

Ini mentakrifkan satu set halaman dengan satu halaman peringkat teratas (halaman xymon.html), dua halaman
dipautkan daripada xymon.html (win.html dan unix.html), dan daripada misalnya halaman win.html terdapat
subhalaman win-nt4.html dan win-xp.html
Sintaks adalah sama dengan arahan "halaman" dan "subhalaman" biasa dalam hosts.cfg, tetapi
arahan itu diawali dengan nama set halaman. Jangan letakkan mana-mana hos di antara halaman
dan arahan subhalaman - cuma tambahkan semua arahan di bahagian atas fail hos.cfg.
Bagaimanakah anda menambah hos pada halaman, kemudian ? Mudah - cuma letakkan teg "OS:win-xp" pada hos
garis definisi. "OS" mestilah sama dengan awalan yang digunakan untuk nama set halaman, tetapi dalam
huruf besar. "win-xp" mesti sepadan dengan salah satu halaman atau subhalaman yang ditakrifkan dalam ini
set halaman. Cth

207.46.249.190 www.microsoft.com # OS:win-xp http://www.microsoft.com/
64.124.140.181 www.sun.com # OS:unix-sun http://www.sun.com/

Jika anda mahu hos muncul dalam kumpulan yang ditentukan pada halaman itu, anda mesti mengenal pasti
kumpulan mengikut nombor, bermula pada 1. Cth untuk meletakkan hos di dalam kumpulan "NT4 Mail servers".
contoh di atas, gunakan "OS:win-nt4,2" (kumpulan kedua pada halaman "win-nt4").
Jika anda mahu hos muncul di muka hadapan dan bukannya subhalaman, gunakan "OS:*" .

Semua ini hanya mentakrifkan susun atur set halaman baharu. Untuk menjananya, anda mesti menjalankan
xymongen sekali untuk setiap set halaman yang anda tentukan - iaitu buat skrip sambungan seperti ini:

#!/ Bin / sh

XYMONWEB="/xymon/os" $XYMONHOME/bin/xymongen \
--pageset=os --template=os \
$XYMONHOME/www/os/

Simpan ini ke $XYMONHOME/ext/os-display.sh, dan tetapkan ini untuk dijalankan sebagai sambungan Xymon;
ini bermakna menambah bahagian tambahan pada tasks.cfg untuk menjalankannya.

Ini menjana halaman. Terdapat beberapa pilihan penting yang digunakan di sini:
* XYMONWEB="/xymon/os" pembolehubah persekitaran, dan
Pilihan "$XYMONHOME/www/os/" berfungsi bersama-sama dan meletakkan
fail HTML pageset baharu dalam subdirektori luar biasa
Xymon webroot. Jika anda biasanya mengakses halaman Xymon sebagai
"http://xymon.acme.com/xymon/", anda kemudian akan mengakses
set halaman baharu sebagai "http://xymon.acme.com/xymon/os/"
NB: Direktori yang diberikan sebagai XYMONWEB mesti mengandungi simbolik
pautan ke direktori $XYMONHOME/www/html/, atau pautan ke
mesej status individu tidak akan berfungsi. Pautan yang serupa
hendaklah dibuat untuk gif/, bantuan/ dan nota/
direktori.
* "--pageset=os" memberitahu xymongen untuk menstrukturkan halaman web
menggunakan reka letak "os", bukannya reka letak lalai.
* "--template=os" memberitahu xymongen untuk menggunakan set yang berbeza
templat pengepala dan pengaki. Biasanya xymongen menggunakan
templat standard dalam $XYMONHOME/web/stdnormal_header dan
.../stdnormal_footer - dengan pilihan ini, ia sebaliknya akan digunakan
fail "os_header" dan "os_footer" daripada fail
$XYMONHOME/web/ direktori. Ini membolehkan anda menyesuaikan
pengepala dan pengaki untuk setiap set halaman. Jika anda hanya mahu
untuk menggunakan templat biasa, anda boleh meninggalkan pilihan ini.

MENGGUNAKAN XYMONGEN UNTUK LAPORAN

pelaporan xymongen dilaksanakan melalui penggantian drop-in untuk Xymon standard
skrip pelaporan (report.sh dan reportlog.sh) dipasang dalam cgi-bin pelayan web anda
direktori.

Kedua-dua skrip shell ini telah digantikan dengan dua skrip shell yang sangat kecil, itu semata-mata
sediakan pembolehubah persekitaran Xymon, dan gunakan laporan.cgi(1) or reportlog.cgi(1)
skrip dalam $XYMONHOME/bin/

Anda boleh menggunakan pilihan baris arahan xymongen apabila menjana laporan, cth untuk mengecualikan tertentu
jenis ujian (cth "--ignorecolumns=msgs") daripada laporan, untuk menentukan nama
lajur trend dan maklumat yang tidak sepatutnya ada dalam laporan atau untuk memformat laporan
berbeza (cth "--subpagecolumns=2"). Jika anda mahu pilihan tertentu digunakan apabila a
laporan dijana daripada antara muka web, letakkan pilihan ini ke dalam anda
Fail $XYMONHOME/etc/xymonserver.cfg dalam pembolehubah persekitaran XYMONGENREPOPTS.

Fail laporan yang dihasilkan oleh xymongen disimpan dalam direktori individu (satu per
laporan) di bawah direktori $XYMONHOME/www/rep/. Ini harus dibersihkan secara automatik
- apabila laporan baharu dijana, laporan lama akan dialih keluar.

Selepas memasang, cuba hasilkan laporan. Anda mungkin akan melihat bahawa pautan dalam
sudut kiri atas (ke ack.html, nongreen.html dll.) tidak lagi berfungsi. Untuk membetulkannya, tukar
fail $XYMONHOME/web/repnormal_header anda supaya pautan ini tidak merujuk kepada "&XYMONWEB" tetapi
kepada awalan URL biasa untuk halaman Xymon anda.

SLA PELAPORAN

pelaporan xymongen membolehkan penjanaan SLA sebenar (Perjanjian Tahap Perkhidmatan)
laporan, juga untuk tempoh perkhidmatan yang bukan 24x7. Ini didayakan dengan mentakrifkan a
Teg "REPORTTIME:timespec" untuk hos mentakrifkan tempoh perkhidmatan dan secara pilihan a
Teg "WARNPCT:level" untuk menentukan ketersediaan yang dipersetujui.

Nota: Lihat hos.cfg(5) untuk sintaks tepat bagi pilihan ini.

"REPORTTIME:timespec" menentukan masa dalam hari apabila perkhidmatan dijangka siap dan
berlari. Secara lalai ini adalah 24 jam sehari, sepanjang hari dalam seminggu. Jika SLA anda hanya meliputi
Isnin-Jumaat 7 pagi - 8 malam, anda mentakrifkan ini sebagai "REPORTTIME=W:0700:2000", dan penjana laporan
kemudian akan mengira kedua-dua ketersediaan 24x7 biasa tetapi juga "ketersediaan SLA" yang
hanya mengambil kira status hos semasa tempoh SLA.

Parameter DOWNTIME:timespec mempengaruhi pengiraan ketersediaan SLA. Jika gangguan
berlaku semasa masa yang ditakrifkan sebagai mungkin "WAKTU MASA", maka kegagalan dilaporkan dengan a
status "biru". (Warna yang sama digunakan jika anda "melumpuhkan" kemudian menjadi hos menggunakan Xymon
fungsi "lumpuhkan"). Masa apabila status ujian adalah "biru" tidak termasuk dalam SLA
pengiraan, tidak dalam jumlah masa di mana hos dianggap turun, mahupun dalam
jumlah masa yang dilindungi oleh laporan itu. Jadi masa "biru" berkesan diabaikan oleh
Pengiraan ketersediaan SLA, membolehkan anda merancang masa henti tanpa menjejaskan
ketersediaan SLA yang dilaporkan.

Contoh: Hos mempunyai "DOWNTIME:*:0700:0730 REPORTTIME=W:0600:2200" kerana ia dibut semula
setiap hari antara 7 pagi dan 7.30 pagi, tetapi perkhidmatan mesti tersedia dari 6 pagi hingga 10 malam. Untuk
pada hari laporan, ia turun dari 7:10 pagi hingga 7:15 pagi (but semula yang dirancang), tetapi juga
dari 9:53 malam hingga 10:15 malam. Jadi acara untuk hari itu adalah:

0700 : hijau selama 10 minit (600 saat)
0710 : biru selama 5 minit (300 saat)
0715 : hijau selama 14 jam 38 minit (52680 saat)
2153 : merah selama 22 minit (1320 saat)
2215 : hijau

Perkhidmatan ini tersedia untuk 600+52680 = 53280 saat. Ia turun (merah) selama 420 saat
(masa dari 21:53 hingga 22:00 apabila tempoh SLA tamat). Jumlah masa yang termasuk dalam
laporan ialah 15 jam (7 pagi - 10 malam) kecuali 5 minit biru = 53700 saat. Jadi SLA
ketersediaan ialah 53280/53700 = 99,22%

Teg "WARNPCT:level" disokong dalam fail hosts.cfg, untuk menetapkan ketersediaan
ambang berdasarkan hos demi hos. Ambang ini menentukan sama ada sesuatu ujian dilaporkan sebagai
hijau, kuning atau merah dalam laporan. Nilai lalai boleh ditetapkan untuk semua hos dengan melalui
pembolehubah persekitaran XYMONREPWARN, tetapi ditindih oleh teg ini. Tahap diberikan sebagai
peratusan, cth "WARNPCT:98.5"

PRE-GENERATED LAPORAN

Biasanya, xymongen menghasilkan laporan yang memaut ke halaman web yang dijana secara dinamik dengan
status terperinci sesuatu ujian (melalui skrip CGI reportlog.sh).

Adalah mungkin untuk xymongen menghasilkan laporan tanpa pautan dinamik ini, jadi
laporan boleh dieksport ke pelayan lain. Ia juga mungkin berguna untuk pra-menjana
laporan, untuk menurunkan beban dengan meminta berbilang pengguna menjana laporan yang sama.

Untuk melakukan ini, anda mesti menjalankan xymongen dengan pilihan "--reportopts" untuk memilih masa
selang masa yang dilindungi oleh laporan, gaya pelaporan (kritikal, bukan hijau atau semua peristiwa),
dan meminta agar tiada halaman dinamik dijana.

Sintaksnya ialah:

xymongen --reportopts=starttime:endtime:nodynamic:style

"masa mula" dan "masa tamat" ditentukan sebagai nilai time_t Unix, iaitu saat sejak 1 Jan
1970 00:00 GMT. Nasib baik, ini boleh dikira dengan mudah dengan utiliti tarikh GNU jika anda
gunakan pilihan output "+%s". Jika anda tidak mempunyai utiliti tarikh GNU, sama ada ambil itu
daripada www.gnu.org; atau anda boleh menggunakan utiliti "etime" untuk tujuan yang sama, iaitu
boleh didapati daripada arkib di www.deadcat.net.

"nodynamic" adalah sama ada 0 (untuk halaman dinamik, lalai) atau 1 (untuk tiada dinamik, iaitu pra-
dihasilkan, halaman).

"gaya" sama ada "crit" (termasuk peristiwa kritikal iaitu merah sahaja), "nongr" (termasuk semua
acara bukan hijau), atau "semua" (termasuk semua acara).

Pilihan xymongen lain boleh digunakan, cth "--ignorecolumns" jika anda ingin mengecualikan tertentu
ujian daripada laporan.

Anda biasanya juga perlu menentukan pembolehubah persekitaran XYMONWEB (ia mesti sepadan
URL asas untuk tempat laporan itu boleh diakses), dan direktori output
di mana fail laporan disimpan. Jika anda menentukan XYMONWEB, anda mungkin juga harus
tentukan pembolehubah persekitaran XYMONHELPSKIN dan XYMONNOTESSKIN. Ini harus menunjuk kepada
URL tempat fail bantuan dan nota Xymon anda berada; jika mereka tidak ditakrifkan, yang
pautan ke fail bantuan dan nota akan menunjuk ke dalam direktori laporan dan mungkin akan
tidak berfungsi.

Jadi seruan biasa xymongen untuk laporan statik ialah:

START=`date +%s --date="22 Jun 2003 00:00:00"`
TAMAT=`tarikh +%s --date="22 Jun 2003 23:59:59"`
XYMONWEB=/laporan/abang besar/harian/2003/06/22 \
XYMONHELPSKIN=/xymon/help \
XYMONNOTESSKIN=/xymon/nota \
xymongen --reportopts=$START:$END:1:crit \
--subpagecolumns=2 \
/var/www/docroot/reports/xymon/daily/2003/06/22

Tetapan "XYMONWEB" bermakna laporan itu akan tersedia dengan URL daripada
"http://www.server.com/reports/xymon/daily/2003/06/22". Laporan itu mengandungi dalaman
pautan yang menggunakan URL ini, jadi ia tidak boleh dialihkan ke lokasi lain dengan mudah.

Parameter terakhir ialah direktori fizikal yang sepadan pada pelayan web anda yang sepadan dengan
URL XYMONWEB. Anda sudah tentu boleh membuat fail laporan di mana-mana sahaja yang anda suka - mungkin pada
mesin lain - dan kemudian alihkannya ke pelayan web kemudian.

Perhatikan bagaimana tarikh(1) utiliti digunakan untuk mengira parameter masa mula dan masa akhir.

PERSEKITARAN PELBAGAI

PENAPIS PAPAN
Penapis digunakan untuk memilih hos / ujian yang disertakan dalam halaman web, dengan menapis
data yang diambil daripada xymond vi arahan xymondboard. Lihat xymon(1) untuk maklumat lanjut
pada sintaks penapis. Secara lalai, tiada penapisan dilakukan.

Gunakan xymongen dalam talian menggunakan perkhidmatan onworks.net