xymongen - Online di Cloud

PROGRAM:

NAMA

xymongen - generator halaman web Xymon

RINGKASAN

xymongen -?
xymongen --membantu
xymongen --Versi: kapan
xymongen [pilihan] [direktori keluaran]
(Lihat bagian OPSI untuk deskripsi opsi baris perintah yang tersedia).

DESKRIPSI

xymongen menghasilkan halaman web ikhtisar untuk monitor Xymon. Ini adalah halaman webnya
yang menunjukkan status keseluruhan host Anda, bukan halaman status terperinci untuk setiap pengujian.

Catatan: Data untuk halaman web diambil dari xymond(8) daemon, dan xymongen menggunakan
nilai variabel lingkungan XYMSRV / XYMSERVERS untuk menentukan jaringan
alamat dimana xymond bisa dihubungi. Jika Anda memiliki lebih dari satu server yang terdaftar di
XYMSERVERS, pastikan yang pertama adalah server Xymon lokal - ini yang
xymongen akan meminta data.

PILIHAN

xymongen memiliki sejumlah besar opsi baris perintah. Opsi dapat digunakan untuk mengubah
perilaku xymongen dan mempengaruhi halaman web yang dihasilkan olehnya.

UMUM PILIHAN

--membantu atau -?
Berikan ringkasan opsi baris perintah yang tersedia.

--Versi: kapan
Mencetak nomor versi xymongen

--docurl=URL
Opsi ini tidak digunakan lagi, gunakan pengaturan HOSTDOCURL di xymonserver.cfg(5)
sebagai gantinya.

--docgi=URL
Opsi ini tidak digunakan lagi, gunakan pengaturan HOSTDOCURL di xymonserver.cfg(5)
sebagai gantinya.

--doc-jendela
Menyebabkan tautan ke dokumentasi untuk host dan layanan terbuka di jendela baru. Itu
defaultnya adalah menampilkan dokumentasi di jendela browser yang sama dengan status Xymon.

--htmlextension=.EKSTENSI
Menyetel ekstensi nama file yang digunakan untuk halaman web yang dibuat oleh xymongen. Oleh
default, ekstensi ".html" digunakan. Perhatikan bahwa Anda perlu menentukan "titik".

--laporan[=NAMA KOLOM]
Dengan opsi ini, xymongen akan mengirim pesan status dengan rincian berapa banyak
host diproses, berapa banyak halaman yang dihasilkan, kesalahan apa pun yang terjadi
selama menjalankan, dan beberapa statistik waktu. Nama kolom default adalah "xymongen".

--htaccess[=htaccess-nama file]
Buat file .htaccess saat direktori halaman web baru dibuat. Isi dari
file .htaccess ditentukan oleh variabel lingkungan XYMONHTACCESS (untuk
direktori tingkat atas dengan xymon.html dan nongreen.html); oleh
variabel XYMONPAGEHTACCESS (untuk direktori tingkat halaman); dan oleh
Variabel XYMONSUBPAGEHTACCESS untuk direktori tingkat subhalaman dan sub-induk. Itu
nama file dari file .htaccess default ke ".htaccess" jika tidak ada nama file yang diberikan dengan
pilihan ini. Variabel XYMONHTACCESS disalin kata demi kata ke tingkat atas
file .htaccess. Variabel XYMONPAGEHTACCESS mungkin berisi "%s" di mana nama
halaman dimasukkan. Variabel XYMONSUBPAGEHTACCESS mungkin berisi dua "%s"
contoh: Yang pertama diganti dengan nama halaman, yang kedua dengan
nama subhalaman.

--max-jumlah kejadian=N
Batasi eventlog pada halaman "Semua non-hijau" hanya untuk N event. Standar: 100.

--max-eventtime=N
Batasi log peristiwa di halaman "Semua non-hijau" untuk peristiwa yang terjadi di dalam
melewati N menit. Standar: 240.

--tidak ada log peristiwa
Nonaktifkan eventlog yang biasanya ditampilkan di halaman "Semua non-hijau"

--maks-ackcount=N
Batasi log pengakuan pada halaman "Semua non-hijau" hanya untuk N peristiwa. Bawaan:
25.

--max-acktime=N
Batasi log pengakuan pada halaman "Semua non-hijau" untuk serangan yang terjadi
dalam N menit terakhir. Standar: 240.

--tidak-aclog
Nonaktifkan log pengakuan yang biasanya ditampilkan di halaman "Semua non-hijau".

--cricitcallog[=Kolom log kritis]
Ini menghasilkan log berbasis teks dari apa yang ditampilkan pada halaman status critical.html,
dan mengirim pesan status untuk server Xymon itu sendiri yang mencerminkan warna
Halaman status kritis. Ini memungkinkan Anda untuk melacak ketika masalah muncul di
halaman status kritis. File log disimpan di $XYMONSERVERLOGS/criticalstatus.log

--loadhostsfromxymond
Alih-alih membaca file hosts.cfg, xymongen akan memuat hosts.cfg
konfigurasi dari daemon xymond. Ini menghilangkan kebutuhan untuk membaca
host.cfg, dan jika Anda menjalankan xymond dan xymongen di host yang berbeda, itu juga
menghilangkan kebutuhan untuk menyalin file hosts.cfg antar sistem. Perhatikan bahwa
Opsi "dispinclude" di hosts.cfg diabaikan saat opsi ini diaktifkan.

HALAMAN LAYOUT PILIHAN

Pilihan ini mempengaruhi bagaimana halaman web yang dihasilkan oleh xymongen muncul di browser.

--halaman-terakhir
Letakkan tautan halaman dan subhalaman setelah host.

--halaman-pertama
Letakkan tautan halaman dan subhalaman sebelum host (default).

Kedua opsi ini memutuskan apakah halaman dengan tautan ke subhalaman dan host memiliki
host atau subhalaman terlebih dahulu.

--subhalamankolom=N
Menentukan jumlah kolom yang digunakan untuk link ke halaman dan subhalaman. Standarnya
adalah N=1.

--baris maksimal=N
Judul kolom pada halaman secara default hanya ditampilkan di awal halaman,
subhalaman atau grup host. Opsi ini menyebabkan judul kolom berulang untuk
setiap N host ditampilkan.

--menunjukkan grup kosong

--no-showemptygroups
Saat grup dibuat host, tampilkan tabel dan nama host meskipun ada
tidak ada tes untuk host mana pun yang dimaksud. Gunakan --no-showemptygroups untuk
bersembunyi. (Bawaan: ya)

--pagetitle-tautan
Biasanya, hanya "titik" berwarna di sebelah halaman atau subhalaman yang bertindak sebagai tautan ke
halaman itu sendiri. Dengan opsi ini, judul halaman akan tertaut ke halaman juga.

--judul teks halaman
Gunakan teks deskripsi dari tag "halaman" atau "subhalaman" sebagai judul untuk
halaman, alih-alih "Halaman yang dihosting secara lokal" atau judul standar lainnya.

--tanpa-garis bawah-judul
Biasanya, judul halaman digarisbawahi menggunakan tag HTML "penggaris horizontal". Ini
opsi menonaktifkan menggarisbawahi judul.

--recentgif[=MENIT]
Gunakan gambar bernama COLOR-recent.gif untuk pengujian, di mana status pengujian telah berubah
dalam 24 jam terakhir. File GIF ini perlu diinstal di
direktori $XYMONHOME/www/gifs/. Secara default, ambang batas diatur ke 24 jam - jika
Anda menginginkannya secara berbeda, Anda dapat menentukan batas waktu juga. Misalnya
"--recentgifs=3h" akan menampilkan GIF terbaru hanya 3 jam setelah perubahan status.

--sort-group-only-item
Dalam arahan "khusus grup" normal, Anda dapat menentukan urutan pengujian
ditampilkan, dari kiri ke kanan. Jika Anda lebih suka memiliki tes yang tercantum di
urutan abjad, gunakan opsi ini - halaman kemudian akan menghasilkan "khusus grup"
grup seperti itu menghasilkan grup normal, dan mengurutkan tes berdasarkan abjad.

--dialupskin=URL
Jika Anda ingin menunjukkan secara visual bahwa tes adalah tes dialup, Anda dapat menggunakan alternatif
set ikon untuk warna hijau/merah/kuning>/dll. gambar dengan menentukan opsi ini. Itu
Parameter URL yang ditentukan di sini menggantikan pengaturan normal dari XYMONSKIN
variabel lingkungan, tetapi hanya untuk tes dialup.

--kulit terbalik=URL
Sama seperti "--dialupkin", tetapi untuk pengujian terbalik (pengujian dengan tanda '!' di depan).

--tooltips=[selalu, tidak pernah, utama]
Menentukan halaman mana yang menggunakan tooltips untuk menampilkan deskripsi host (dari
KOMENTAR entri di host.cfg(5) mengajukan). Jika diatur ke selalu, tooltips digunakan pada semua
halaman. Jika diatur ke tak pernah, tooltips tidak pernah digunakan. Jika diatur ke utama, tooltips digunakan
pada halaman utama, tetapi tidak pada halaman "Semua non-hijau" atau "Sistem kritis".

KOLOM SELEKSI PILIHAN

Opsi ini memengaruhi kolom (pengujian) mana yang disertakan dalam halaman web yang dihasilkan oleh
xymongen.

--ignorecolumns=tes[,tes]
Kolom yang diberikan akan diabaikan sepenuhnya oleh xymongen saat membuat halaman web.
Dapat digunakan untuk menghasilkan laporan di mana Anda menghilangkan beberapa tes yang lebih berisik,
seperti "pesan".

--kritis-merah-saja
Hanya kolom status merah yang akan disertakan pada halaman Kritis. Secara default,
Halaman kritis akan berisi host dengan status merah, kuning dan jelas.

--nongreen-colors=WARNA[,WARNA]
Menentukan warna mana yang menyebabkan pengujian muncul di halaman status "Semua non-hijau".
WARNA merah, kuning atau ungu. Standarnya adalah menyertakan ketiganya.

--nongreen-ignorecolumns=tes[,tes]
Sama seperti --ignorecolumns, tetapi hanya berlaku untuk host di halaman "Semua non-hijau".

--nonhijau-abaikanungu
Tidak digunakan lagi, gunakan "--nongreen-colors" sebagai gantinya.

--nongreen-ignoredialup
Abaikan semua host dialup pada halaman "Semua non-hijau", termasuk eventlog.

--tanpa-halaman
Jangan buat halaman normal (biasanya hanya digunakan untuk menghasilkan halaman non-hijau
halaman).

--tanpa-nonhijau
Jangan buat halaman "Semua yang tidak berwarna hijau".

--includecolumns=tes[,tes]
Selalu sertakan kolom ini di halaman "Semua non-hijau" Akan menyertakan kolom tertentu
pada halaman nongreen.html, apa pun warnanya. Biasanya, nongreen.html turun
kolom tes, jika semua tes berwarna hijau. Ini dapat digunakan misalnya untuk selalu memiliki tautan ke
kolom tren (dengan grafik RRD) dari halaman nongreen.html Anda.

--eventigore=test[,test]
Abaikan pengujian ini di tampilan log peristiwa "Semua non-hijau".

STATUS PERAMBATAN PILIHAN

Opsi ini menekan penyebaran normal status ke atas dalam hierarki halaman.
Dengan demikian, Anda dapat memiliki tes dengan status kuning atau merah, tetapi masih memiliki seluruh halaman hijau.
Ini berguna untuk pengujian yang tidak perlu menimbulkan alarm, tetapi di mana Anda masih ingin mengetahuinya
status sebenarnya. Opsi ini menetapkan default global untuk semua host; Anda dapat menggunakan NOPROPRED
dan tag NOPROPYELLOW di host.cfg(5) file untuk menerapkan batasan serupa pada per-host
dasar.

--nopropyellow=test[,test] atau --noprop=test[,test]
Nonaktifkan propagasi status ke atas saat KUNING. Opsi "--noprop" tidak digunakan lagi
dan tidak boleh digunakan.

--noproppurple=tes[,tes]
Nonaktifkan propagasi status ke atas saat UNGU.

--nopropred=tes[,tes]
Nonaktifkan propagasi status ke atas saat MERAH atau KUNING.

--nopropack=tes[,tes]
Nonaktifkan propagasi status ke atas ketika status telah diakui. jika kamu mau
untuk menonaktifkan semua tes acked agar tidak disebarkan, gunakan "--nopropack=*".

PURPLE STATUS PILIHAN

Status ungu terjadi saat pelaporan status pengujian berhenti. Status tes berlaku untuk a
waktu terbatas - biasanya 30 menit - dan setelah waktu ini, tes menjadi
ungu.

--purplelog=NAME FILE
Hasilkan file log dari semua pesan status ungu.

BERGANTIAN SET HALAMAN PILIHAN

--pageset=NAMA HALAMAN
Buat halaman web untuk kumpulan halaman alternatif daripada default. Lihat bagian PAGESETS
di bawah.

--template=TEMPLAT
Gunakan template alternatif untuk file header dan footer. Biasanya digunakan bersama-sama
opsi "--pageset"; lihat bagian PAGESETS di bawah ini.

BERGANTIAN KELUARAN FORMAT

--wml[=uji1,uji2,...]
Opsi ini menyebabkan xymongen menghasilkan satu set file "kartu" WML yang dapat
diakses oleh perangkat WAP (ponsel, PDA, dll.) File yang dihasilkan berisi:
host yang memiliki status MERAH atau KUNING pada pengujian yang ditentukan. Opsi ini dapat menentukan
tes default untuk disertakan - default dapat diganti atau diubah menggunakan
Tag "WML:" atau "NK:" di host.cfg(5) mengajukan. Jika tidak ada tes yang ditentukan, semua tes
akan disertakan.

--nstab=NAMA FILE
Buat file HTML yang cocok untuk entri sidebar Netscape 6/Mozilla. Untuk sebenarnya
memungkinkan pengguna Anda untuk mendapatkan entri bilah sisi seperti itu, Anda memerlukan kode Javascript ini di
halaman web (mis. Anda dapat memasukkannya ke dalam file $XYMONHOME/web/stdnormal_header):


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


dan kemudian Anda dapat menyertakan tautan "Tambahkan ini ke bilah sisi" menggunakan ini sebagai templat:

Tambahkan ke Bilah Sisi

atau jika Anda lebih suka memiliki tombol "Tambah tab" Netscape standar, Anda akan melakukannya
dengan


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


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

Jika FILENAME tidak dimulai dengan garis miring, file sidebar Netscape ditempatkan di
direktori $XYMONHOME/www/.

--nslimit=WARNA
Warna minimum untuk disertakan dalam Bilah Sisi Netscape - defaultnya adalah "merah", artinya
hanya peringatan penting yang disertakan. Jika Anda ingin menyertakan peringatan juga, gunakan
"--nslimit=kuning".

--rss Menghasilkan aliran pengiriman konten RSS/RDF dari peringatan Xymon Anda. Format keluaran ini
dapat disematkan secara dinamis di halaman web lain, seperti umpan berita langsung sering
terlihat di situs web. Dua file RSS akan dihasilkan, satu mencerminkan "Semua non-
hijau", yang lain mencerminkan halaman "Kritis". Mereka akan berada di
file "nongreen.rss" dan "critical.rss", masing-masing. Selain itu, file RSS
akan dihasilkan untuk setiap halaman dan/atau subhalaman yang mencantumkan host yang ada di sana
halaman atau subhalaman.
Parameter FILENAME yang sebelumnya diizinkan pada opsi --rss sekarang sudah usang.
Untuk informasi lebih lanjut tentang umpan konten RSS/RDF, silakan lihat
http://www.syndic8.com/.

--rssextension=.EKSTENSI
Menyetel ekstensi nama file yang digunakan untuk file RSS yang dihasilkan oleh xymongen. Oleh
default, ekstensi ".rss" digunakan. Perhatikan bahwa Anda perlu menentukan "titik".

--rssversion={0.91|0.92|1.0|2.0}
Format keluaran yang diinginkan dari umpan RSS/RDF. Versi 0.91 tampaknya yang paling
format yang umum digunakan, dan merupakan default jika opsi ini dihilangkan.

--rsslimit=WARNA
Warna minimum untuk disertakan dalam umpan RSS - defaultnya adalah "merah", artinya saja
peringatan kritis disertakan. Jika Anda ingin menyertakan peringatan juga, gunakan
"--rsslimit=kuning".

PILIHAN BEKAS BY CGI AKHIR DEPAN

--reportopts=MULAI:AKHIR:DINAMIS:GAYA
Panggil xymongen dalam mode pembuatan laporan. Ini biasanya digunakan oleh
laporan.cgi(1) Skrip CGI, tetapi juga dapat digunakan secara langsung saat pra-pembuatan
laporan. Parameter START adalah waktu mulai untuk laporan di Unix time_t
format (detik sejak 1 Januari 1970 00:00 UTC); AKHIR adalah waktu berakhirnya laporan;
DINAMIS adalah 0 untuk laporan yang dibuat sebelumnya dan 1 untuk laporan dinamis (on-line); GAYA adalah
"crit" untuk hanya menyertakan peristiwa penting (merah), "nongr" untuk menyertakan semua non-hijau
peristiwa, dan "semua" untuk memasukkan semua peristiwa.

--csv=NAMAFILE
Digunakan bersama dengan --reportopts, ini menyebabkan xymongen menghasilkan ketersediaan
laporan dalam bentuk file comma-separated values ​​(CSV). Format ini biasanya
digunakan untuk mengimpor ke dalam spreadsheet untuk diproses lebih lanjut.
File CSV menyertakan cap waktu Unix. Untuk menampilkan ini sebagai waktu yang dapat dibaca manusia di
Excel, rumusnya =C2/86400+NILAI TANGGAL(1-jan-1970) (jika Anda memiliki stempel waktu Unix
di sel C2) dapat digunakan. Sel hasil harus diformat sebagai tanggal/waktu
bidang. Perhatikan bahwa stempel waktu ada di UTC, jadi Anda mungkin juga perlu menangani lokal
zona waktu dan masalah DST sendiri.

--csvdelim=DELIMITER
Secara default, koma digunakan untuk membatasi bidang dalam output CSV. Beberapa non-bahasa Inggris
spreadsheet menggunakan pembatas yang berbeda, biasanya titik koma. Untuk menghasilkan CSV
file dengan pembatas yang tepat, Anda dapat menggunakan opsi ini untuk mengatur karakter yang digunakan
sebagai pembatas. Misal "--csvdelim=;" - perhatikan bahwa ini biasanya harus dua kali lipat
tanda kutip, untuk mencegah shell Unix menafsirkan karakter pembatas sebagai
pembatas baris perintah.

--snapshot=WAKTU
Hasilkan snapshot halaman Xymon, seperti yang muncul di TIME. WAKTU diberikan sebagai
detik sejak 1 Januari 1970 00:00 UTC. Biasanya digunakan melalui snapshot.cgi(1) CGI
Script.

DEBUGING PILIHAN

--debug
Menyebabkan xymongen membuang sejumlah besar keluaran debug ke stdout, jika itu
dikompilasi dengan -DDEBUG diaktifkan. Saat melaporkan masalah dengan xymongen, tolong
coba mereproduksi masalah dan berikan output dari menjalankan xymongen dengan ini
.

--waktu
Buang informasi tentang waktu yang dihabiskan oleh berbagai bagian xymongen ke stdout. Ini
berguna untuk melihat bagian mana dari pemrosesan yang bertanggung jawab atas run-time dari
xymongen.
Catatan: Informasi ini juga disediakan dalam output yang dikirim ke tampilan Xymon
saat menggunakan opsi "--report".

BANGUNAN BERGANTIAN SET HALAMAN

Dengan xymongen versi 1.4, ada kemungkinan untuk menghasilkan beberapa set halaman dari
data yang sama.
Misalkan Anda memiliki dua kelompok orang yang melihat halaman web Xymon. Grup A ingin
memiliki host yang dikelompokkan oleh klien, milik mereka. Beginilah cara Anda mengatur Xymon -
kumpulan halaman default. Sekarang grup B ingin agar host dikelompokkan berdasarkan sistem operasi -
mari kita menyebutnya set "os". Kemudian Anda akan menambahkan tata letak halaman ke hosts.cfg seperti ini:

ospage menangkan Microsoft Windows
ossubhalaman win-nt4 MS Windows NT 4
osgroup NT4 File server
osgroup NT4 Mail server
ossubhalaman win-xp MS Windows XP
ospage unix Unix
ossubhalaman unix-sun Solaris
ossubhalaman unix-linux Linux

Ini mendefinisikan satu set halaman dengan satu halaman tingkat atas (halaman xymon.html), dua halaman
ditautkan dari xymon.html (win.html dan unix.html), dan dari misalnya halaman win.html ada
subhalaman win-nt4.html dan win-xp.html
Sintaksnya identik dengan direktif "halaman" dan "subhalaman" normal di hosts.cfg, tetapi
direktif diawali dengan nama pageset. Jangan letakkan host apa pun di antara halaman
dan arahan subhalaman - cukup tambahkan semua arahan di bagian atas file hosts.cfg.
Bagaimana Anda menambahkan host ke halaman, lalu ? Sederhana - cukup beri tag "OS:win-xp" di host
garis definisi. "OS" harus sama dengan awalan yang digunakan untuk nama kumpulan halaman, tetapi dalam
huruf besar. "win-xp" harus cocok dengan salah satu halaman atau subhalaman yang ditentukan dalam ini
kumpulan halaman Misalnya

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 ingin tuan rumah muncul di dalam grup yang ditentukan pada halaman itu, Anda harus mengidentifikasi
mengelompokkan berdasarkan nomor, mulai dari 1. Misalnya, memasukkan host ke dalam grup "Server surat NT4" di
contoh di atas, gunakan "OS:win-nt4,2" (grup kedua di halaman "win-nt4").
Jika Anda ingin host muncul di halaman depan alih-alih subhalaman, gunakan "OS:*" .

Semua ini hanya mendefinisikan tata letak kumpulan halaman baru. Untuk menghasilkannya, Anda harus menjalankan
xymongen sekali untuk setiap pageset yang Anda tentukan - yaitu buat skrip ekstensi 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 atur ini untuk dijalankan sebagai ekstensi Xymon;
ini berarti menambahkan bagian tambahan ke task.cfg untuk menjalankannya.

Ini menghasilkan halaman. Ada beberapa opsi penting yang digunakan di sini:
* XYMONWEB="/xymon/os" variabel lingkungan, dan
Opsi "$XYMONHOME/www/os/" bekerja bersama, dan menempatkan
file HTML pageset baru dalam subdirektori dari yang normal
Akar web Xymon. Jika Anda biasanya mengakses halaman Xymon sebagai
"http://xymon.acme.com/xymon/", Anda kemudian akan mengakses
kumpulan halaman baru sebagai "http://xymon.acme.com/xymon/os/"
NB: Direktori yang diberikan sebagai XYMONWEB harus mengandung simbol
tautan ke direktori $XYMONHOME/www/html/, atau tautan ke
pesan status individu tidak akan berfungsi. Tautan serupa
harus dibuat untuk gif/, bantuan/ dan catatan/
direktori.
* "--pageset=os" memberitahu xymongen untuk menyusun halaman web
menggunakan tata letak "os", alih-alih tata letak default.
* "--template=os" memberitahu xymongen untuk menggunakan set yang berbeda dari
header- dan footer-template. Biasanya xymongen menggunakan
templat standar di $XYMONHOME/web/stdnormal_header dan
.../stdnormal_footer - dengan opsi ini, ia akan menggunakan
file "os_header" dan "os_footer" dari
direktori $XYMONHOME/web/. Ini memungkinkan Anda untuk menyesuaikan
header dan footer untuk setiap pageset. Jika Anda hanya ingin
untuk menggunakan template normal, Anda dapat menghilangkan opsi ini.

MENGGUNAKAN XYMONGEN UNTUK LAPORAN

pelaporan xymongen diimplementasikan melalui penggantian drop-in untuk standar Xymon
skrip pelaporan (report.sh dan reportlog.sh) diinstal di server web Anda cgi-bin
direktori.

Kedua skrip shell ini telah diganti dengan dua skrip shell yang sangat kecil, yang hanya
atur variabel lingkungan Xymon, dan aktifkan laporan.cgi(1) or laporanlog.cgi(1)
skrip di $XYMONHOME/bin/

Anda dapat menggunakan opsi baris perintah xymongen saat membuat laporan, misalnya untuk mengecualikan
jenis tes (misalnya "--ignorecolumns=msgs") dari laporan, untuk menentukan nama
tren- dan info- kolom yang tidak boleh ada dalam laporan, atau untuk memformat laporan
berbeda (misalnya "--subpagecolumns=2"). Jika Anda ingin opsi tertentu digunakan saat a
laporan dibuat dari antarmuka web, masukkan opsi ini ke dalam
$XYMONHOME/etc/xymonserver.cfg dalam variabel lingkungan XYMONGENREPOPTS.

File laporan yang dihasilkan oleh xymongen disimpan dalam direktori individual (satu per
report) di bawah direktori $XYMONHOME/www/rep/. Ini harus dibersihkan secara otomatis
- saat laporan baru dibuat, yang lama dihapus.

Setelah menginstal, coba buat laporan. Anda mungkin akan melihat bahwa tautan di
pojok kiri atas (ke ack.html, nongreen.html, dll.) tidak lagi berfungsi. Untuk memperbaikinya, ubah
file $XYMONHOME/web/repnormal_header Anda sehingga tautan ini tidak merujuk ke "&XYMONWEB" tetapi
ke awalan URL normal untuk halaman Xymon Anda.

SLA PELAPORAN

pelaporan xymongen memungkinkan pembuatan SLA (Perjanjian Tingkat Layanan) yang sebenarnya
laporan, juga untuk periode layanan yang tidak 24x7. Ini diaktifkan dengan mendefinisikan a
Tag "REPORTTIME:timespec" untuk host untuk menentukan periode layanan, dan secara opsional a
Tag "WARNPCT:level" untuk menentukan ketersediaan yang disepakati.

Catatan: Lihat host.cfg(5) untuk sintaks yang tepat dari opsi ini.

"REPORTTIME:timespec" menentukan waktu saat layanan diharapkan aktif dan
berlari. Secara default ini adalah 24 jam sehari, sepanjang hari dalam seminggu. Jika SLA Anda hanya mencakup
Senin-Jumat 7 - 8, Anda mendefinisikan ini sebagai "REPORTTIME=W:0700:2000", dan pembuat laporan
kemudian akan menghitung ketersediaan 24x7 normal tetapi juga "ketersediaan SLA" yang
hanya mempertimbangkan status host selama periode SLA.

Parameter DOWNTIME:timespec mempengaruhi perhitungan ketersediaan SLA. Jika padam
terjadi selama waktu yang ditentukan sebagai kemungkinan "DOWNTIME", maka kegagalan dilaporkan dengan a
status "biru". (Warna yang sama digunakan jika Anda "menonaktifkan" lalu host menggunakan Xymon
fungsi "nonaktifkan"). Waktu ketika status pengujian "biru" tidak termasuk dalam SLA
perhitungan, baik dalam jumlah waktu di mana tuan rumah dianggap turun, maupun dalam
total waktu yang dicakup oleh laporan. Jadi waktu "biru" secara efektif diabaikan oleh
Perhitungan ketersediaan SLA, memungkinkan Anda untuk merencanakan waktu henti tanpa mempengaruhi
ketersediaan SLA yang dilaporkan.

Contoh: Host memiliki "DOWNTIME:*:0700:0730 REPORTTIME=W:0600:2200" karena di-boot ulang
setiap hari antara pukul 7 hingga 7.30, tetapi layanan harus tersedia dari pukul 6 hingga 10. Untuk
hari laporan, itu turun dari 7:10 sampai 7:15 (reboot yang direncanakan), tetapi juga
dari 9:53 sampai 10:15. Jadi acara hari ini adalah:

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

Layanan ini tersedia selama 600+52680 = 53280 detik. Itu turun (merah) selama 420 detik
(waktu dari 21:53 sampai 22:00 ketika periode SLA berakhir). Total waktu yang termasuk dalam
laporan adalah 15 jam (7 pagi - 10 malam) kecuali 5 menit biru = 53700 detik. Jadi SLA
ketersediaan adalah 53280/53700 = 99,22%

Tag "WARNPCT:level" didukung di file hosts.cfg, untuk mengatur ketersediaan
ambang batas berdasarkan host-by-host. Ambang batas ini menentukan apakah tes dilaporkan sebagai
hijau, kuning atau merah dalam laporan. Nilai default dapat diatur untuk semua host dengan via
variabel lingkungan XYMONREPWARN, tetapi ditimpa oleh tag ini. Tingkat diberikan sebagai
persentase, misalnya "WARNPCT:98.5"

DIBUAT SEBELUMNYA LAPORAN

Biasanya, xymongen menghasilkan laporan yang menautkan ke halaman web yang dibuat secara dinamis dengan
status terperinci dari pengujian (melalui skrip CGI reportlog.sh).

Dimungkinkan untuk membuat xymongen menghasilkan laporan tanpa tautan dinamis ini, jadi
laporan dapat diekspor ke server lain. Mungkin juga berguna untuk membuat terlebih dahulu
laporan, untuk menurunkan beban dengan meminta beberapa pengguna membuat laporan yang sama.

Untuk melakukan ini, Anda harus menjalankan xymongen dengan opsi "--reportopts" untuk memilih waktu
interval yang dicakup laporan, gaya pelaporan (kritis, non-hijau, atau semua peristiwa),
dan meminta agar tidak ada halaman dinamis yang dibuat.

Sintaksnya adalah:

xymongen --reportopts=waktu mulai: waktu akhir: nodinamis: gaya

"waktu mulai" dan "waktu berakhir" ditetapkan sebagai nilai waktu_t Unix, yaitu detik sejak 1 Januari
1970 00:00 GMT. Untungnya, ini dapat dengan mudah dihitung dengan utilitas tanggal GNU jika Anda
gunakan opsi keluaran "+%s". Jika Anda tidak memiliki utilitas tanggal GNU, ambillah itu
dari www.gnu.org; atau Anda dapat menggunakan utilitas "etime" untuk tujuan yang sama, yaitu
tersedia dari arsip di www.deadcat.net.

"nodynamic" adalah 0 (untuk halaman dinamis, default) atau 1 (untuk tidak dinamis, yaitu pra-
dihasilkan, halaman).

"style" bisa berupa "crit" (termasuk critical yaitu event merah saja), "nongr" (termasuk semua
acara non-hijau), atau "semua" (termasuk semua acara).

Opsi xymongen lainnya dapat digunakan, misalnya "--ignorecolumns" jika Anda ingin mengecualikan tertentu
tes dari laporan.

Anda biasanya juga perlu menentukan variabel lingkungan XYMONWEB (harus cocok
URL dasar dari mana laporan akan dapat diakses), dan direktori keluaran
tempat file laporan disimpan. Jika Anda menentukan XYMONWEB, Anda mungkin juga harus
mendefinisikan variabel lingkungan XYMONHELPSKIN dan XYMONNOTESSKIN. Ini harus menunjuk ke
URL tempat file bantuan dan catatan Xymon Anda berada; jika tidak terdefinisi, maka
tautan ke file bantuan dan catatan akan mengarah ke dalam direktori laporan dan mungkin akan
tidak bekerja.

Jadi pemanggilan khas xymongen untuk laporan statis adalah:

START=`tanggal +%s --date="22 Jun 2003 00:00:00"`
END=`date +%s --date="22 Jun 2003 23:59:59"`
XYMONWEB=/laporan/kakak/harian/2003/06/22 \
XYMONHELPSKIN=/xymon/bantuan \
XYMONNOTESSKIN=/xymon/catatan \
xymongen --reportopts=$MULAI:$END:1:kritik \
--subhalamankolom=2 \
/var/www/docroot/reports/xymon/daily/2003/06/22

Pengaturan "XYMONWEB" berarti bahwa laporan akan tersedia dengan URL
"http://www.server.com/reports/xymon/daily/2003/06/22". Laporan itu berisi internal
link yang menggunakan URL ini, sehingga tidak mudah dipindahkan ke lokasi lain.

Parameter terakhir adalah direktori fisik yang sesuai di server web Anda yang cocok dengan
XYMON WEB URL. Anda tentu saja dapat membuat file laporan di mana pun Anda suka - mungkin di
komputer lain - lalu pindahkan ke server web nanti.

Perhatikan bagaimana tanggal(1) utilitas digunakan untuk menghitung parameter waktu mulai dan waktu akhir.

LINGKUNGAN VARIABEL

FILTER PAPAN
Filter digunakan untuk memilih host / pengujian apa yang disertakan dalam halaman web, dengan memfilter
data diambil dari xymond melalui perintah xymondboard. Melihat xymon(1) untuk rincian
pada sintaks filter. Secara default, tidak ada penyaringan yang dilakukan.

Gunakan xymongen online menggunakan layanan onworks.net