xymongen — online w chmurze

PROGRAM:

IMIĘ

xymongen - generator stron internetowych Xymon

STRESZCZENIE

ksymongen -?
ksymongen --help
ksymongen --wersja
ksymongen [opcje] [katalog wyjściowy]
(Zobacz sekcję OPCJE, aby zapoznać się z opisem dostępnych opcji wiersza poleceń).

OPIS

ksymongen generuje przeglądowe strony internetowe dla monitora Xymon. To są strony internetowe
które pokazują ogólny stan hostów, a nie strony ze szczegółowym stanem każdego testu.

Uwaga: Dane dla stron internetowych są pobierane z Xymond(8) demon i xymongen używa
wartości zmiennych środowiskowych XYMSRV / XYMSERVERS w celu określenia sieci
adres, pod którym można dotrzeć do xymond. Jeśli masz więcej niż jeden serwer wymieniony w
XYMSERVERS, upewnij się, że pierwszy to lokalny serwer Xymon - to jest ten, który
xymongen zapyta o dane.

OPCJE

xymongen ma dużą liczbę opcji wiersza poleceń. Opcje mogą być używane do zmiany
zachowanie xymongen i wpływać na generowane przez niego strony internetowe.

GENERAŁ OPCJE

--pomoc czy -?
Podaj podsumowanie dostępnych opcji wiersza polecenia.

--wersja
Drukuje numer wersji xymongen

--docurl=adres URL
Ta opcja jest przestarzała, użyj ustawienia HOSTDOCURL w xymonserver.cfg(5)
zamiast.

--doccgi=URL
Ta opcja jest przestarzała, użyj ustawienia HOSTDOCURL w xymonserver.cfg(5)
zamiast.

--okno-doc
Powoduje, że łącza do dokumentacji hostów i usług otwierają się w nowym oknie. The
domyślnie jest wyświetlana dokumentacja w tym samym oknie przeglądarki co status Xymon.

--htmlextension=.ROZSZERZENIE
Ustawia rozszerzenie nazwy pliku używane dla stron internetowych generowanych przez xymongen. Przez
domyślnie używane jest rozszerzenie „.html”. Pamiętaj, że musisz określić „kropkę”.

--report[=NAZWA KOLUMNY]
Dzięki tej opcji xymongen wyśle ​​wiadomość o stanie ze szczegółowymi informacjami o liczbie
hosty zostały przetworzone, ile stron zostało wygenerowanych, jakie wystąpiły błędy
podczas biegu i niektóre statystyki dotyczące czasu. Domyślna nazwa kolumny to „xymongen”.

--htaccess[=htaccess-nazwa-pliku]
Twórz pliki .htaccess podczas tworzenia nowych katalogów stron internetowych. Zawartość
pliki .htaccess są określane przez zmienną środowiskową XYMONHTACCESS (for
katalog najwyższego poziomu z xymon.html i nongreen.html); przez
zmienna XYMONPAGEHTACCESS (dla katalogów na poziomie strony); i przez
Zmienna XYMONSUBPAGEHTACCESS dla katalogów na poziomie podstrony i podrzędnego. The
nazwa pliku plików .htaccess domyślnie to ".htaccess", jeśli nie podano nazwy pliku
ta opcja. Zmienna XYMONHTACCESS jest kopiowana dosłownie na najwyższy poziom
plik .htaccess. Zmienna XYMONPAGEHTACCESS może zawierać „%s” w miejscu nazwy
strony jest wstawiony. Zmienna XYMONSUBPAGEHTACCESS może zawierać dwa „%s”
instancje: pierwsza jest zastępowana nazwą strony, druga nazwą
nazwa podstrony.

--max-liczba-zdarzeń=N
Ogranicz dziennik zdarzeń na stronie „Wszystkie inne niż zielone” tylko do N zdarzeń. Domyślnie: 100.

--max-czas-zdarzenia=N
Ogranicz dziennik zdarzeń na stronie „Wszystkie inne niż zielone” do zdarzeń, które miały miejsce w ciągu
ostatnich N minut. Domyślnie: 240.

--no-dziennik zdarzeń
Wyłącz dziennik zdarzeń normalnie wyświetlany na stronie „Wszystkie inne niż zielone”.

--max-konto=N
Ogranicz rejestr potwierdzeń na stronie „Wszystkie inne niż zielone” tylko do N zdarzeń. Domyślny:
25.

--max-czas oczekiwania=N
Ogranicz dziennik potwierdzeń na stronie „Wszystkie inne niż zielone” do potwierdzeń, które miały miejsce
w ciągu ostatnich N minut. Domyślnie: 240.

--brak potwierdzenia
Wyłącz dziennik potwierdzeń normalnie wyświetlany na stronie „Wszystkie inne niż zielone”.

--cricitcallog[=Kolumna dziennika krytycznego]
Spowoduje to wygenerowanie dziennika tekstowego tego, co jest wyświetlane na stronie stanu Critical.html,
i wysyła komunikat o stanie dla samego serwera Xymon odzwierciedlający kolor pliku
Strona stanu krytycznego. Dzięki temu możesz śledzić, kiedy pojawiły się problemy na urządzeniu
strona stanu krytycznego. Plik dziennika jest przechowywany w $XYMONSERVERLOGS/criticalstatus.log

--loadhostszxymond
Zamiast czytać plik hosts.cfg, xymongen załaduje plik hosts.cfg
konfiguracja z demona xymond. Eliminuje to konieczność czytania
hosts.cfg, a jeśli masz xymond i xymongen działające na różnych hostach, to również
eliminuje konieczność kopiowania pliku hosts.cfg między systemami. Zauważ, że
Opcja „dispinclude” w pliku hosts.cfg jest ignorowana, gdy ta opcja jest włączona.

STRONA UKŁAD OPCJE

Te opcje wpływają na sposób wyświetlania stron internetowych generowanych przez xymongen w przeglądarce.

--strony-ostatnie
Umieść linki do stron i podstron po hostach.

--strony-pierwsze
Umieść linki do stron i podstron przed hostami (domyślnie).

Te dwie opcje decydują o tym, czy strona z linkami do podstron i hostów ma
najpierw hosty lub podstrony.

--subpagecolumns=N
Określa liczbę kolumn używanych dla linków do stron i podstron. Domyślny
wynosi N=1.

--maxrows=N
Nagłówki kolumn na stronie są domyślnie wyświetlane tylko na początku strony,
podstrona lub grupa hostów. Ta opcja powoduje powtarzanie nagłówków kolumn
każdy pokazany N hostów.

--showemtygroups

--no-showemtygroups
Gdy tworzone są grupy hostów, wyświetl tabelę i nazwy hostów, nawet jeśli takie istnieją
nie ma żadnych testów dla żadnego z omawianych gospodarzy. Użyj --no-showemptygroups, aby
ukrywać. (Domyślnie: tak)

--pagetitle-links
Zwykle tylko kolorowe „kropki” obok strony lub podstrony działają jako linki do
sama strona. Dzięki tej opcji tytuł strony będzie również zawierał link do strony.

--nagłówki tekstu strony
Użyj tekstu opisu z tagów „strona” lub „podstrona” jako nagłówka dla
zamiast „Strony hostowane lokalnie” lub innego standardowego nagłówka.

--bez-podkreślenia-nagłówków
Zwykle nagłówki stron są podkreślane za pomocą znacznika HTML „poziomej linijki”. Ten
opcja wyłącza podkreślanie nagłówków.

--recentgifs[=MINUTY]
Użyj obrazów o nazwie COLOR-recent.gif do testów, w których zmienił się status testu
w ciągu ostatnich 24 godzin. Te pliki GIF muszą być zainstalowane w
Katalog $XYMONHOME/www/gifs/. Domyślnie próg jest ustawiony na 24 godziny - jeśli
chcesz inaczej, możesz też określić limit czasowy. Np
„--recentgifs=3h” pokaże najnowsze pliki GIF tylko przez 3 godziny po zmianie statusu.

--sort-grupa-tylko-przedmioty
W zwykłej dyrektywie „tylko dla grup” można określić kolejność wykonywania testów
są wyświetlane, od lewej do prawej. Jeśli wolisz mieć testy wymienione w
kolejność alfabetyczna, skorzystaj z tej opcji - strona wygeneruje wtedy "tylko dla grup"
groups, tak jak generuje normalne grupy, i sortuje testy alfabetycznie.

--dialupskin=URL
Jeśli chcesz wizualnie pokazać, że test jest testem połączenia telefonicznego, możesz użyć alternatywy
zestaw ikon dla zielonego/czerwonego/żółtego>/etc. obrazy, określając tę ​​opcję. The
Określony tutaj parametr adresu URL zastępuje normalne ustawienie z XYMONSKIN
zmienną środowiskową, ale tylko do testów połączeń telefonicznych.

--reverseskin=adres URL
To samo co „--dialupskin”, ale dla testów odwrotnych (testy z „!” na początku).

--tooltips=[zawsze,nigdy,główny]
Określa, które strony używają podpowiedzi do wyświetlania opisu hosta (z pliku
wpis KOMENTARZ w hosty.cfg(5) plik). Jeśli ustawione na zawsze, podpowiedzi są używane na wszystkich
strony. Jeśli ustawione na nigdy, podpowiedzi nigdy nie są używane. Jeśli ustawione na główny, używane są podpowiedzi
na stronach głównych, ale nie na stronach „Wszystkie inne niż ekologiczne” lub „Systemy krytyczne”.

KOLUMNA WYBÓR OPCJE

Te opcje wpływają na to, które kolumny (testy) są uwzględniane na stronach internetowych generowanych przez
ksymongen.

--ignorecolumns=test[,test]
Podane kolumny będą całkowicie ignorowane przez xymongen podczas generowania stron internetowych.
Może być używany do generowania raportów, w których eliminuje się niektóre z bardziej hałaśliwych testów,
jak „Wiadomości”.

--krytyczne-czerwone-tylko
Na stronie Krytyczne zostaną uwzględnione tylko czerwone kolumny stanu. Domyślnie
Strona krytyczna będzie zawierała hosty ze statusem czerwonym, żółtym i czystym.

--nongreen-colors=KOLOR[,KOLOR]
Określa, które kolory powodują pojawienie się testu na stronie stanu „Wszystkie inne niż zielone”.
KOLOR jest czerwony, żółty lub fioletowy. Domyślnie uwzględniane są wszystkie trzy.

--nongreen-ignorecolumns=test[,test]
To samo co --ignorecolumns, ale dotyczy tylko hostów na stronie „Wszystkie inne niż zielone”.

--niezielony-ignorefioletowy
Przestarzałe, zamiast tego użyj „--nongreen-colors”.

--nongreen-ignoredialups
Zignoruj ​​wszystkie hosty połączeń telefonicznych na stronie „Wszystkie inne niż zielone”, w tym dziennik zdarzeń.

--brak-stron
Nie generuj normalnych stron (zwykle używanych do generowania tylko nie-zielonych
strona).

--nie-nie-zielone
Nie generuj strony „Wszystkie inne niż zielone”.

--includecolumns=test[,test]
Zawsze dołączaj te kolumny na stronie „Wszystkie inne niż zielone” Zawiera określone kolumny
na stronie nongreen.html, niezależnie od jej koloru. Zwykle plik nongreen.html upuszcza plik a
kolumna testowa, jeśli wszystkie testy są zielone. Można to wykorzystać np. aby zawsze mieć link do
kolumna trendów (z wykresami RRD) ze strony nongreen.html.

--eventignore=test[,test]
Zignoruj ​​te testy w dzienniku zdarzeń „Wszystkie inne niż zielone”.

STATUS PROPAGACJA OPCJE

Te opcje eliminują normalne propagowanie statusu w górę w hierarchii stron.
W ten sposób możesz mieć test ze statusem żółtym lub czerwonym, ale nadal mieć całą stronę zieloną.
Jest to przydatne w przypadku testów, które nie muszą powodować alarmu, ale nadal chcesz je poznać
aktualny stan. Te opcje ustawiają globalne wartości domyślne dla wszystkich hostów; możesz użyć NOPROPRED
i znaczniki NOPROPYELLOW w pliku hosty.cfg(5) plik, aby zastosować podobne limity dla poszczególnych hostów
Podstawa.

--nopropyellow=test[,test] lub --noprop=test[,test]
Wyłącz propagację stanu w górę, gdy jest ŻÓŁTY. Opcja „--noprop” jest przestarzała
i nie powinien być używany.

--noproppurple=test[,test]
Wyłącz propagację statusu w górę, gdy FIOLETOWY.

--nopropred=test[,test]
Wyłącz propagację stanu w górę, gdy jest CZERWONY lub ŻÓŁTY.

--nopropack=test[,test]
Wyłącz propagację statusu w górę, gdy status został potwierdzony. Jeśli chcesz
aby wyłączyć propagowanie wszystkich potwierdzonych testów, użyj „--nopropack=*”.

FIOLETOWY STATUS OPCJE

Fioletowe stany pojawiają się, gdy zgłaszanie stanu testu zostaje zatrzymane. Status testu jest ważny dla a
ograniczona ilość czasu - zwykle 30 minut - i po tym czasie następuje test
purpurowy.

--purplelog=NAZWA PLIKU
Wygeneruj plik dziennika zawierający wszystkie fioletowe komunikaty o stanie.

ALTERNATE ZESTAW STRON OPCJE

--pageset=NAZWAZESTAWUSTRON
Twórz strony internetowe dla alternatywnego zestawu stron niż domyślny. Zobacz sekcję ZESTAWY Stron
poniżej.

--template=SZABLON
Użyj alternatywnego szablonu dla plików nagłówka i stopki. Zwykle używane razem
opcja „--pageset”; zobacz sekcję ZESTAWY Stron poniżej.

ALTERNATE WYDAJNOŚĆ FORMATY

--wml[=test1,test2,...]
Ta opcja powoduje, że xymongen generuje zestaw plików „kart” WML, które mogą być
dostęp przez urządzenie WAP (telefon komórkowy, PDA itp.) Wygenerowane pliki zawierają
hosty, które mają status CZERWONY lub ŻÓŁTY w określonych testach. Ta opcja może zdefiniować
domyślne testy do uwzględnienia — wartości domyślne można zastąpić lub zmienić za pomocą
Znaczniki „WML:” lub „NK:” w pliku hosty.cfg(5) plik. Jeśli nie określono żadnych testów, wszystkie testy
będzie dołączone.

--nstab=NAZWA PLIKU
Wygeneruj plik HTML odpowiedni dla wpisu paska bocznego Netscape 6/Mozilla. Właściwie
umożliwić swoim użytkownikom uzyskanie takiego wpisu na pasku bocznym, potrzebujesz tego kodu Javascript
strona internetowa (np. możesz umieścić ją w pliku $XYMONHOME/web/stdnormal_header):


<!--
funkcja addNetscapePanel() {
if ((typeof window.sidebar == "obiekt") &&
(typeof window.sidebar.addPanel == "funkcja"))
window.sidebar.addPanel ("Xymon",
"http://your.server.com/nstab.html","");
więcej
alert("Pasek boczny tylko dla Mozilli lub Netscape 6+");
}
// ->


a następnie możesz dołączyć link „Dodaj to do paska bocznego”, używając tego jako szablonu:

Dodaj do paska bocznego

lub jeśli wolisz mieć standardowy przycisk Netscape „Dodaj kartę”, zrobiłbyś to
w


<IMG SRC="/gifs/add-button.gif" WYSOKOŚĆ=45 SZEROKOŚĆ=100
ALT="[Dodaj pasek boczny]" STYLE="ramka:0">


Plik „add-button.gif” jest dostępny w witrynie Netscape pod adresem
http://developer.netscape.com/docs/manuals/browser/sidebar/add-button.gif.

Jeśli NAZWA PLIKU nie zaczyna się od ukośnika, plik paska bocznego Netscape jest umieszczany w
Katalog $XYMONHOME/www/.

--nslimit=KOLOR
Minimalny kolor do uwzględnienia w pasku bocznym Netscape — domyślnie jest to „czerwony”, co oznacza
uwzględniane są tylko alerty krytyczne. Jeśli chcesz dołączyć również ostrzeżenia, użyj
"--nslimit=żółty".

--rss Generuj strumień dostarczania treści RSS/RDF dla alertów Xymon. Ten format wyjściowy
mogą być dynamicznie osadzane na innych stronach internetowych, podobnie jak często kanały informacyjne na żywo
widać na stronach internetowych. Zostaną wygenerowane dwa pliki RSS, jeden odzwierciedlający „Wszystkie nie-
zielona”, druga odzwierciedla stronę „Krytyczne”. Będą w
odpowiednio pliki „nongreen.rss” i „critical.rss”. Dodatkowo plik RSS
zostanie wygenerowany dla każdej strony i/lub podstrony z listą hostów na niej obecnych
strona lub podstrona.
Parametr NAZWA PLIKU, który wcześniej był dozwolony w opcji --rss, jest teraz nieaktualny.
Aby uzyskać więcej informacji na temat źródeł treści RSS/RDF, zobacz
http://www.syndic8.com/.

--rssextension=.ROZSZERZENIE
Ustawia rozszerzenie nazwy pliku używane dla plików RSS generowanych przez xymongen. Przez
domyślnie używane jest rozszerzenie „.rss”. Pamiętaj, że musisz określić „kropkę”.

--rssversion={0.91|0.92|1.0|2.0}
Żądany format wyjściowy kanału RSS/RDF. Wersja 0.91 wydaje się być najbardziej
powszechnie używanym formacie i jest domyślnym formatem, jeśli ta opcja zostanie pominięta.

--rsslimit=KOLOR
Minimalny kolor do uwzględnienia w kanale RSS — domyślnie jest to „czerwony”, co oznacza tylko
uwzględniane są alerty krytyczne. Jeśli chcesz dołączyć również ostrzeżenia, użyj
"--rsslimit=żółty".

OPCJE UŻYWANE BY CGI POCZĄTEK KOŃCA

--reportopts=START:END:DYNAMICZNY:STYL
Wywołaj xymongen w trybie generowania raportów. Jest to zwykle używane przez
raport.cgi(1) Skrypt CGI, ale może być również używany bezpośrednio podczas wstępnego generowania
raporty. Parametr START to czas rozpoczęcia raportu w systemie Unix time_t
format (sekundy od 1 stycznia 1970 00:00 UTC); END to czas zakończenia raportu;
DYNAMICZNY to 0 dla raportu gotowego i 1 dla raportu dynamicznego (on-line); STYL jest
„crit”, aby uwzględnić tylko zdarzenia krytyczne (czerwone), „nongr”, aby uwzględnić wszystkie zdarzenia inne niż zielone
zdarzenia i „wszystko”, aby uwzględnić wszystkie zdarzenia.

--csv=NAZWA PLIKU
Używane razem z --reportopts powoduje, że xymongen generuje dostępność
raport w postaci pliku z wartościami rozdzielanymi przecinkami (CSV). Ten format jest powszechnie stosowany
służy do importowania do arkuszy kalkulacyjnych w celu dalszego przetwarzania.
Plik CSV zawiera znaczniki czasu systemu Unix. Aby wyświetlić je jako czasy czytelne dla człowieka w
Excel, formuła =C2/86400+DATA.WARTOŚĆ(1-sty-1970) (jeśli masz znacznik czasu Unix
w komórce C2). Komórka wynikowa powinna być sformatowana jako data/godzina
pole. Pamiętaj, że sygnatury czasowe są w UTC, więc może być również konieczna obsługa lokalna
strefę czasową i problemy z czasem letnim.

--csvdelim=DELIMITER
Domyślnie do oddzielania pól w pliku wyjściowym CSV używany jest przecinek. Niektóre nieanglojęzyczne
arkusze kalkulacyjne używają innego ogranicznika, zwykle średnika. Aby wygenerować plik CSV
plik z właściwym ogranicznikiem, możesz użyć tej opcji, aby ustawić używany znak
jako ogranicznik. Np. "--csvdelim=;" - zauważ, że zwykle powinno to być podwójnie
cudzysłowów, aby uniemożliwić powłoce systemu Unix interpretację znaku ogranicznika jako a
ogranicznik wiersza poleceń.

--migawka=CZAS
Wygeneruj migawkę stron Xymon, tak jak pojawiły się w CZASIE. CZAS podano jako
sekundy od 1 stycznia 1970 00:00 UTC. Zwykle używany przez snapshot.cgi(1) CGI
skrypt.

DEBUGOWANIE OPCJE

--odpluskwić
Powoduje, że xymongen zrzuca duże ilości danych wyjściowych debugowania na standardowe wyjście, jeśli tak było
skompilowane z włączoną opcją -DDEBUG. Zgłaszając problem z xymongen, proszę
spróbuj odtworzyć problem i podaj dane wyjściowe z uruchomionego xymongen z tym
opcja.

--wyczucie czasu
Zrzuć informacje o czasie spędzonym przez różne części xymongen na stdout. Ten
jest przydatne, aby zobaczyć, która część przetwarzania jest odpowiedzialna za czas działania
ksymongen.
Uwaga: Ta informacja jest również zawarta w danych wyjściowych wysyłanych do wyświetlacza Xymon
podczas korzystania z opcji „--report”.

BUDYNEK ALTERNATE ZESTAWY Stron

Wraz z wersją 1.4 xymongen pojawia się możliwość generowania wielu zestawów stron z
te same dane.
Załóżmy, że masz dwie grupy osób oglądających strony internetowe Xymon. Grupa A chce
pogrupuj hosty według klienta, do którego należą. Oto jak masz skonfigurowany Xymon -
domyślny zestaw stron. Teraz grupa B chce pogrupować hosty według systemu operacyjnego -
nazwijmy to zbiorem „os”. Następnie dodałbyś układ strony do pliku hosts.cfg w następujący sposób:

ospage wygrywa Microsoft Windows
ospodstrona win-nt4 MS Windows NT 4
osgroup Serwery plików NT4
Serwery pocztowe osgroup NT4
ossubpage win-xp MS Windows XP
ospage unix Unix
ossubpage unix-sun Solaris
ospodstrona unix-linux Linux

Definiuje zestaw stron z jedną stroną najwyższego poziomu (strona xymon.html), dwiema stronami
podlinkowane z xymon.html (win.html i unix.html) oraz ze strony np. win.html
podstrony win-nt4.html i win-xp.html
Składnia jest identyczna z normalnymi dyrektywami „page” i „subpage” w hosts.cfg, ale
dyrektywa jest poprzedzona nazwą zestawu stron. Nie umieszczaj żadnych hostów pomiędzy stroną
i dyrektywy podstrony - po prostu dodaj wszystkie dyrektywy na górze pliku hosts.cfg.
Jak więc dodać hosty do stron? Proste - po prostu umieść tag „OS: win-xp” na hoście
linia definicji. „System operacyjny” musi być taki sam jak przedrostek używany w nazwach zestawów stron, ale w
duże litery. „win-xp” musi pasować do jednej ze zdefiniowanych w nim stron lub podstron
zestaw stron. Np

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

Jeśli chcesz, aby host pojawił się w grupie zdefiniowanej na tej stronie, musisz zidentyfikować
grupuj według numeru, zaczynając od 1. Np. aby umieścić hosta w grupie „Serwery pocztowe NT4”.
w powyższym przykładzie użyj „OS:win-nt4,2” (druga grupa na stronie „win-nt4”).
Jeśli chcesz, aby host wyświetlał się na stronie głównej zamiast na podstronie, użyj "OS:*" .

Wszystko to po prostu definiuje układ nowego zestawu stron. Aby go wygenerować, musisz uruchomić
xymongen raz dla każdego zdefiniowanego zestawu stron - tj. utwórz skrypt rozszerzenia w następujący sposób:

#!/ Bin / sh

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

Zapisz to w $XYMONHOME/ext/os-display.sh i skonfiguruj, aby działał jako rozszerzenie Xymon;
oznacza to dodanie dodatkowej sekcji do pliku task.cfg, aby go uruchomić.

Spowoduje to wygenerowanie stron. Zastosowano tutaj kilka ważnych opcji:
* Zmienna środowiskowa XYMONWEB="/xymon/os" i
Opcja „$XYMONHOME/www/os/” współpracuje ze sobą i umieszcza plik
nowe pliki HTML zestawu stron w podkatalogu poza normalnym
Webroot Xymon. Jeśli normalnie uzyskujesz dostęp do stron Xymon jako
"http://xymon.acme.com/xymon/", wtedy uzyskasz dostęp
nowy zestaw stron jako „http://xymon.acme.com/xymon/os/"
NB: Katalog podany jako XYMONWEB musi zawierać symboliczny
link do katalogu $XYMONHOME/www/html/ lub linki do
indywidualne komunikaty o stanie nie będą działać. Podobne linki
należy zrobić dla gifów/, pomocy/ i notatek/
katalogi.
* „--pageset=os” mówi xymongen o uporządkowaniu stron internetowych
używając układu „os” zamiast układu domyślnego.
* „--template=os” mówi xymongen, aby używał innego zestawu
szablony nagłówków i stopek. Zwykle xymongen używa
standardowy szablon w $XYMONHOME/web/stdnormal_header i
.../stdnormal_footer - z tą opcją zamiast tego użyje
pliki „os_header” i „os_footer” z pliku
Katalog $XYMONHOME/web/. To pozwala na dostosowanie
nagłówki i stopki dla każdego zestawu stron. Jeśli tylko chcesz
aby użyć normalnego szablonu, możesz pominąć tę opcję.

ZA POMOCĄ XYMONGEN DLA RAPORTY

Raportowanie xymongen jest wdrażane poprzez bezpośrednie zamienniki standardowego Xymona
skrypty raportowania (report.sh i reportlog.sh) zainstalowane na twoich serwerach cgi-bin
katalogiem.

Te dwa skrypty powłoki zostały zastąpione dwoma bardzo małymi skryptami powłoki
skonfiguruj zmienne środowiskowe Xymon i wywołaj raport.cgi(1) or raportlog.cgi(1)
skrypty w $XYMONHOME/bin/

Możesz użyć opcji linii poleceń xymongen podczas generowania raportów, np. w celu wykluczenia niektórych
rodzaje testów (np. "--ignorecolumns=msgs") z raportów, aby określić nazwę
trendów i kolumn informacyjnych, które nie powinny znajdować się w raporcie, lub sformatować raport
inaczej (np. "--subpagecolumns=2"). Jeśli chcesz, aby określone opcje były używane, gdy a
raport jest generowany z interfejsu internetowego, umieść te opcje w swoim
$XYMONHOME/etc/xymonserver.cfg w zmiennej środowiskowej XYMONGENREPOPTS.

Pliki raportów generowane przez xymongen są przechowywane w poszczególnych katalogach (jeden na każdy
report) poniżej katalogu $XYMONHOME/www/rep/. Powinny one zostać automatycznie wyczyszczone
- w miarę generowania nowych raportów stare są usuwane.

Po zainstalowaniu spróbuj wygenerować raport. Prawdopodobnie zobaczysz, że linki w pliku
lewy górny róg (do ack.html, nongreen.html itp.) już nie działa. Aby to naprawić, zmień
twój plik $ XYMONHOME/web/repnormal_header, więc te linki nie odnoszą się do „& XYMONWEB”, ale
do normalnego prefiksu adresu URL dla stron Xymon.

SLA RAPORTOWANIE

raportowanie xymongen pozwala na wygenerowanie prawdziwego SLA (Service Level Agreement)
raportów, również za okresy serwisowe, które nie są całodobowe. Jest to możliwe poprzez zdefiniowanie a
Znacznik „REPORTTIME:timespec” dla hostów w celu zdefiniowania okresu usługi i opcjonalnie a
Znacznik „WARNPCT:level” do określenia uzgodnionej dostępności.

Uwaga: patrz hosty.cfg(5) dla dokładnej składni tych opcji.

„REPORTTIME:timespec” określa porę dnia, kiedy usługa ma być dostępna
działanie. Domyślnie jest to 24 godziny na dobę, we wszystkie dni tygodnia. Jeśli umowa SLA obejmuje tylko
od poniedziałku do piątku od 7:8 do 0700:2000, określasz to jako „REPORTTIME=W:XNUMX:XNUMX”, a generator raportów
następnie obliczy zarówno normalną dostępność 24x7, jak i „dostępność SLA”, która
bierze pod uwagę tylko status hosta w okresie SLA.

Parametr DOWNTIME:timespec wpływa na obliczenie dostępności SLA. Jeśli awaria
wystąpi w czasie określonym jako możliwy „PRZESTÓJ”, wówczas awaria zgłaszana jest z literą a
status „niebieski”. (Ten sam kolor jest używany, jeśli „wyłączasz”, a następnie hostujesz za pomocą Xymon
funkcja „wyłącz”). Czas, w którym stan testu jest „niebieski”, nie jest uwzględniony w umowie SLA
kalkulacja, ani w ilości czasu, w którym gospodarz jest uważany za w dół, ani w
całkowity czas, którego dotyczy raport. Tak więc "niebieski" czas jest skutecznie ignorowany przez
Kalkulacja dostępności SLA, pozwalająca na zaplanowanie przestojów bez wpływu na wydajność
zgłaszana dostępność SLA.

Przykład: Host ma „DOWNTIME:*:0700:0730 REPORTTIME=W:0600:2200”, ponieważ został ponownie uruchomiony
codziennie między 7:7.30 a 6:10, ale usługa musi być dostępna od XNUMX:XNUMX do XNUMX:XNUMX. Dla
w dniu raportu był wyłączony z 7:10 do 7:15 (planowany restart), ale także
od 9:53 do 10:15. Tak więc wydarzenia dnia to:

0700 : zielony przez 10 minut (600 sekund)
0710 : niebieski przez 5 minut (300 sekund)
0715 : zielony przez 14 godzin 38 minut (52680 sekund)
2153 : czerwony przez 22 minuty (1320 sekund)
2215 : zielony

Usługa jest dostępna przez 600+52680 = 53280 sekund. Jest wyłączony (czerwony) przez 420 sekund
(czas od 21:53 do 22:00, kiedy kończy się okres SLA). Całkowity czas zawarty w
raport to 15 godzin (7:10 - 5:53700) z wyjątkiem XNUMX minut niebieski = XNUMX sekund. Więc umowa SLA
dostępność to 53280/53700 = 99,22%

Znacznik „WARNPCT:level” jest obsługiwany w pliku hosts.cfg w celu ustawienia dostępności
próg na zasadzie host-by-host. Ten próg określa, czy test jest raportowany jako
w raportach zielony, żółty lub czerwony. Wartość domyślną można ustawić dla wszystkich hostów za pomocą via
zmienną środowiskową XYMONREPWARN, ale nadpisaną przez ten znacznik. Poziom jest podany jako
procent, np. „WARNPCT:98.5”

WSTĘPNIE WYGENEROWANE RAPORTY

Zwykle xymongen tworzy raporty, które zawierają linki do dynamicznie generowanych stron internetowych z rozszerzeniem
szczegółowy status testu (poprzez skrypt CGI reportlog.sh).

Możliwe jest, aby xymongen wygenerował raport bez tych dynamicznych linków, więc
raport można wyeksportować na inny serwer. Przydatne może być również wstępne wygenerowanie pliku
raporty, aby zmniejszyć obciążenie poprzez generowanie tych samych raportów przez wielu użytkowników.

Aby to zrobić, musisz uruchomić xymongen z opcją „--reportopts”, aby wybrać czas
interwał, który obejmuje raport, styl raportowania (krytyczne, nie-zielone lub wszystkie zdarzenia),
i zażądać, aby żadne strony dynamiczne nie były generowane.

Składnia jest następująca:

xymongen --reportopts=czas rozpoczęcia:czas zakończenia:nodynamiczny:styl

„starttime” i „endtime” są określone jako wartości unixowe time_t, tj. sekundy od 1 stycznia
1970 00:00 GMT. Na szczęście można to łatwo obliczyć za pomocą narzędzia daty GNU, jeśli tak
użyj opcji wyjściowej „+%s”. Jeśli nie masz narzędzia daty GNU, wybierz je
z www.gnu.org; lub możesz użyć narzędzia „etime” w tym samym celu, czyli
dostępne w archiwum na stronie www.deadcat.net.

„nodynamic” to albo 0 (domyślnie dla stron dynamicznych) albo 1 (dla stron bez dynamicznych, tj.
wygenerowane, strony).

„style” to albo „crit” (obejmuje krytyczne, tj. tylko czerwone zdarzenia), „nongr” (obejmuje wszystkie
zdarzenia inne niż zielone) lub „wszystkie” (w tym wszystkie zdarzenia).

Można użyć innych opcji xymongen, np. "--ignorecolumns", jeśli chcesz wykluczyć pewne
testy z raportu.

Zwykle będziesz także musiał określić zmienną środowiskową XYMONWEB (musi być zgodna
podstawowy adres URL, z którego raport będzie udostępniany) oraz katalog wyjściowy
gdzie zapisywane są pliki raportów. Jeśli określisz XYMONWEB, prawdopodobnie powinieneś również
zdefiniuj zmienne środowiskowe XYMONHELPSKIN i XYMONNOTESSKIN. Te powinny wskazywać
adres URL, pod którym znajdują się pliki pomocy i notatki Xymon; jeśli nie są zdefiniowane,
linki do plików pomocy i notatek będą wskazywać wewnątrz katalogu raportów i prawdopodobnie będą
nie działa.

Tak więc typowym wywołaniem xymongen dla raportu statycznego byłoby:

START=`data +%s --date="22 czerwca 2003 00:00:00"`
END=`date +%s --date="22 czerwca 2003 23:59:59"`
XYMONWEB=/reports/bigbrother/daily/2003/06/22 \
XYMONHELPSKIN=/xymon/pomoc \
XYMONNOTESSKIN=/xymon/notatki \
xymongen --reportopts=$START:$END:1:crit \
--kolumny podstrony=2 \
/var/www/docroot/reports/xymon/daily/2003/06/22

Ustawienie „XYMONWEB” oznacza, że ​​raport będzie dostępny pod adresem URL
"http://www.server.com/reports/xymon/daily/2003/06/22". Raport zawiera wewnętrzne
linki korzystające z tego adresu URL, więc nie można go łatwo przenieść w inne miejsce.

Ostatnim parametrem jest odpowiedni katalog fizyczny na twoim serwerze internetowym pasujący do
URL XYMONWEB. Możesz oczywiście utworzyć pliki raportów w dowolnym miejscu - na przykład w
inną maszynę - a następnie przenieść je później na serwer WWW.

Uwaga, jak dane(1) narzędzie służy do obliczania parametrów czasu rozpoczęcia i zakończenia.

ŚRODOWISKO ZMIENNE

FILTR PŁYTY
Filtr używany do wybierania, które hosty / testy mają być zawarte na stronach internetowych, poprzez filtrowanie
dane pobrane z xymond za pomocą komendy xymondboard. Widzieć ksymon(1) dla szczegółów
w składni filtra. Domyślnie żadne filtrowanie nie jest wykonywane.

Korzystaj z xymongen online, korzystając z usług onworks.net