xymon - Online în cloud

PROGRAM:

NUME

xymon - programul de comunicare client Xymon

REZUMAT

ximon [Opțiuni] DESTINATAR mesaj

DESCRIERE

ximon(1) este programul client folosit pentru a comunica cu un server Xymon. Este frecvent
utilizat de sistemele client Xymon pentru a trimite mesaje de stare și alerte de paginare la testele locale.

În Xymon, programul xymon este folosit și în scopuri administrative, de exemplu pentru a redenumi sau
ștergeți gazde sau pentru a dezactiva gazdele care sunt oprite pentru perioade mai lungi de timp.

OPŢIUNI AND PARAMETRI

--depanare
Activați depanarea. Aceasta imprimă detalii despre modul în care conexiunea la Xymon
serverul este în curs de stabilire.

--proxy=http://PROXYSERVER:PORT PROXY/
Când trimiteți mesajele de stare prin HTTP, utilizați acest server ca proxy HTTP
de conectare direct la serverul Xymon.

--timeout=N
Specifică timpul de expirare pentru conectarea la serverul Xymon, în secunde. Implicit
este de 5 de secunde.

--raspuns
Utilitarul xymon știe în mod normal când să aștepte un răspuns de la server, așa că acesta
opțiunea nu este necesară. Cu toate acestea, va face ca orice răspuns de la server să fie
afișat.

--combina
Îmbinați textul mesajului din linia de comandă cu datele furnizate pe intrarea standard și
trimite rezultatul la serverul Xymon. Textul mesajului furnizat pe linia de comandă
devine prima linie a mesajului îmbinat.

DESTINATAR
DESTINATAR parametrul definește ce server primește mesajul. Dacă DESTINARUL este
dat ca „0.0.0.0”, apoi mesajul este trimis către toate serverele enumerate în
variabilă de mediu XYMSERVERS.

De obicei, un client va folosi „$XYMSRV” pentru DESTINATAR parametru, așa cum este acesta
definit pentru ca scripturile client să conțină automat valoarea corectă.

DESTINATAR parametrul poate fi o adresă URL pentru un server web care are xymoncgimsg.cgi
sau un script similar instalat. Aceasta trimite mesajele Xymon către serverul Xymon
folosind protocolul HTTP standard. The xymoncgimsg.cgi(8) Instrument CGI (inclus în Xymon)
trebuie să fie instalat pe serverul web pentru ca transportul HTTP să funcționeze.

MESAJ
mesaj parametrul este mesajul care trebuie trimis către serverul Xymon.
Mesajele trebuie să fie incluse între ghilimele, dar, făcând acest lucru, se pot întinde pe mai multe rânduri.
Dimensiunea maximă a unui mesaj este definită de lungimea maximă permisă a dvs
linia de comandă a shell-ului și are de obicei 8-32 KB.

Dacă trebuie să trimiteți mesaje de stare mai lungi, puteți specifica „@” ca mesaj:
xymon va citi apoi mesajul de stare din stdin-ul său.

XYMON MESAJ SINTAXĂ

Această secțiune listează cele mai frecvent utilizate mesaje în protocolul Xymon.

Fiecare mesaj trebuie să înceapă cu una dintre comenzile Xymon. Acolo unde este specificat un HOSTNAME, acesta
trebuie să aibă orice puncte din numele gazdei schimbate în virgule dacă setarea Xymon FQDN este activată
(care este implicit). Deci, gazda „www.foo.com”, de exemplu, ar raporta ca
„www,foo,com”.

stare[+LIFETIME][/group:GROUP] HOSTNAME.TESTNAME CULOARE
Aceasta trimite un mesaj de stare pentru un singur test (coloană) pe o singură gazdă.
TESTNAME este numele coloanei în care va apărea acest test; orice nume este valabil
cu excepția faptului că utilizarea punctelor în numele testului nu va funcționa. CULOAREA trebuie să fie una dintre
culori valabile: „verde”, „galben”, „roșu” sau „clar”. Culorile „albastru” și „violet”
- deși culori valide - nu trebuie trimise într-un mesaj de stare, așa cum sunt acestea
gestionat special de serverul Xymon. Ca caz special (pentru sprijinirea persoanelor în vârstă
clienți), „client” poate fi folosit ca denumire a culorii. Aceasta determină starea
mesajul care urmează să fie tratat de Xymon ca mesaj de date „client” și TESTNAME
parametrul este folosit ca „id de colector”.
„Textul suplimentar” include în mod normal un marcaj de timp local și un rezumat al testului
rezultat pe prima linie. Orice rând care urmează pe primul are formă liberă și poate
includeți orice informații care pot fi utile pentru a diagnostica problema raportată.
LIFETIME definește cât timp este valabil acest statut după ce a fost primit de către
Serverul Xymon. Valoarea implicită este de 30 de minute, dar puteți seta orice perioadă doriți. De exemplu
pentru un test personalizat care rulează o dată pe oră, veți dori să setați acest lucru la cel puțin 60
minute - în caz contrar, starea va deveni violet după 30 de minute. E o idee buna
pentru a seta TIMPUL DE VIAȚĂ la puțin mai lung decât intervalul dintre testele dvs
permiteți variații în timpul necesar pentru finalizarea testului. LIFETIME este în
minute, cu excepția cazului în care adăugați un „h” (ore), „d” (zile) sau „w” (săptămâni) imediat după
numărul, de exemplu „status+5h” pentru o stare care este valabilă timp de 5 ore.
Opțiunea GROUP este utilizată pentru a direcționa alertele de la stare către un anumit grup. Aceasta
este utilizat în prezent pentru starea generată din datele clienților Xymon, de exemplu pentru a direcționa
alerte pentru un statut „proces” către diferite persoane, în funcție de exact ce proces
este jos.

notificați HOSTNAME.TESTNAME
Acest lucru declanșează un mesaj informațional pentru a fi trimis celor care primesc alerte pentru
această combinație HOSTNAME+TESTNAME, conform regulilor definite în alerte.cfg(5)
Acesta este folosit de către enadis.cgi(1) instrument pentru a notifica oamenii despre dezactivarea gazdelor
sau activat, dar poate servi și ca modalitate generală de notificare a administratorilor de server.

date HOSTNAME.DATANAME
Mesajul „date” permite instrumentelor să trimită date despre o gazdă, fără ca aceasta să apară ca
o coloană pe paginile web Xymon. Acesta este folosit, de exemplu, pentru a raporta statistici
despre o gazdă, de exemplu date vmstat, care în sine nu reprezintă ceva care
are o identitate roșie, galbenă sau verde. Este folosit de modulele de alimentare de jos RRD, printre
alții. În Xymon, mesajele de date sunt procesate implicit numai de către xymond_rrd(8)
modul. Dacă doriți să gestionați mesajele de date folosind o aplicație externă, puteți
doriți să activați xymond_filestore(8) modul pentru mesaje de date, pentru a stoca date-
mesaje într-un format compatibil cu modul în care face demonul Big Brother.

dezactivați HOSTNAME.TESTNAME DURATION
Dezactivează un test specific pentru DURATION minute. Acest lucru va determina starea acestuia
testul să fie listat ca „albastru” pe serverul Xymon și nicio alertă pentru această gazdă/test
va fi generat. Dacă DURATA este dată ca număr urmat de s/m/h/d, este
interpretat ca fiind în secunde/minute/ore/zile respectiv. Pentru a dezactiva a
testați până când devine OK, utilizați „-1” ca DURATA. Pentru a dezactiva toate testele pentru a
gazdă, utilizați un asterisc „*” pentru TESTNAME.

activați HOSTNAME.TESTNAME
Reactivează un test care a fost dezactivat.

interogați HOSTNAME.TESTNAME
Interogați serverul Xymon pentru cea mai recentă stare raportată pentru acest test special. Dacă
starea gazdă/test este cunoscută, răspunsul este prima linie a raportului de stare
- culoarea curentă va fi primul cuvânt de pe linie. Rânduri suplimentare de text
care ar putea fi prezente pe mesajul de stare nu pot fi recuperate.
Acest lucru permite oricărui client Xymon să determine starea unui anumit test, dacă
este unul care se referă la gazda în care rulează clientul, o altă gazdă sau
poate rezultatul unui test combinat de la mai multe gazde gestionate de combostatus(1)
Acest lucru va fi de obicei util pentru scripturile de extensie client Xymon, care au nevoie
determina starea altor gazde, de exemplu, pentru a decide dacă este automată
ar trebui iniţiată acţiunea de recuperare.

config FILENAME
Preluați unul dintre fișierele de configurare Xymon de pe server. Această comandă permite
un client pentru a extrage fișiere din directorul $XYMONHOME/etc/ de pe server, permițând
pentru actualizări semi-automate ale configurației clientului. De la configurare
fișierele sunt concepute pentru a avea un fișier comun pentru configurarea tuturor gazdelor din
sistem - și acesta este de fapt modalitatea recomandată de a vă configura clienții - aceasta
facilitează păstrarea fișierelor de configurare sincronizate.

aruncați HOSTNAME
Elimină toate datele stocate despre gazda HOSTNAME. Se presupune că ai
a șters deja gazda din fișierul de configurare hosts.cfg.

aruncați HOSTNAME TESTNAME
Eliminați datele despre un singur test (coloană).

redenumiți OLDHOSTNAME NEWHOSTNAME
Redenumiți toate datele pentru o gazdă căreia i s-a schimbat numele. Ar trebui să faci asta după
schimbarea numelui de gazdă în fișierul de configurare hosts.cfg.

redenumiți HOSTNAME OLDTESTNAME NEWTESTNAME
Redenumiți datele despre un singur test (coloană).

xymondlog HOSTNAME.TESTNAME
Preluați jurnalul de stare Xymon pentru un singur test. Prima linie a răspunsului
conține o serie de câmpuri separate printr-un semn de conductă:

nume de gazdă Numele gazdei

testname Numele testului

culoare Culoare de stare (verde, galben, roșu, albastru, clar, violet)

steaguri de testare Pentru testele de rețea, steagurile care indică detalii despre test (utilizate de
ximongen).

ultima schimbare Marca temporală Unix când culoarea stării s-a schimbat ultima dată.

timp jurnal Marca temporală Unix când a fost primit mesajul de jurnal.

valabilitate Marca temporală Unix când mesajul de jurnal nu mai este valid (devine violet la
de data asta).

acktime Fie -1, fie marcaj temporal Unix când expiră o confirmare activă.

disabletime Fie -1, fie marcaj temporal Unix atunci când starea nu mai este dezactivată.

expeditor Adresa IP de la care a fost primit starea.

fursec Fie -1, fie valoarea cookie-ului utilizată pentru a confirma o alertă.

ackmsg Gol sau mesajul de confirmare trimis atunci când starea a fost confirmată.
Newline, țevi și barele oblice inverse sunt eliminate cu o bară oblică inversă, în stil C.

dismsg Gol sau mesajul trimis când starea a fost dezactivată. Newline, semne de conducte
iar barele oblice inverse sunt scăpate cu o bară oblică inversă, în stil C.

După prima linie vine jurnalul de stare complet în format text simplu.

xymondxlog HOSTNAME.TESTNAME
Preia un șir XML care conține jurnalul de stare ca și în cazul comenzii „xymondlog”.

xymondboard [CRITERII] [fields=FIELDLIST]
Preia un rezumat al stării tuturor testelor cunoscute disponibile demonului Xymon.

În mod implicit - dacă nu sunt furnizate CRITERII - returnează o linie pentru toate stările
mesajele care se găsesc în Xymon. Puteți filtra răspunsul după selecție specifică
pagină, gazdă, test, culoare sau diverse alte câmpuri. PAGEPATH, NETWORK, HOSTNAME,
Parametrii TESTNAME și *MSG sunt expresii regulate compatibile cu perl;
parametrul COLOR acceptă mai multe culori separate prin virgule; valorile *TIME
acceptați marcaje temporale ale epocii Unix. Alte variabile identificate în xymon-xmh(5) mai poate
fi folosit.

Deoarece filtrarea gazdei se face înainte de testarea filtrării, este mai eficientă (cu
seturi de date foarte mari) pentru a utiliza PAGEPATH, HOSTNAME, NETWORK și alte filtre XMH_
atunci când este posibil, înainte de a filtra global cu COLOR, *MSG, *TIME sau TESTNAME.

Puteți filtra, de exemplu, atât un nume de gazdă, cât și un nume de test.

page=PAGEPATH Includeți numai testele de la gazdele găsite pe pagina PAGEPATH din
fișierul hosts.cfg.

net=NETWORK Includeți numai teste de la gazde cu această etichetă NET:

ip=IPAdresă Includeți numai teste de la gazde cu această adresă IP. Acesta este un regex,
nu CIDR.

gazdă=HOSTNAME Includeți numai teste de la gazda HOSTNAME

test=TESTNAME Includeți numai teste cu numele testului TESTNAME

culoare=NUME CULOARE Includeți numai teste în care culoarea de stare este COLORNAME

tag=TAGNAME Includeți numai gazdele cu o anumită etichetă specificată în gazde.cfg(5)
linia. Rețineți că numai elementele cunoscute de componentele xymon sunt incluse aici; arbitrar
textul nu este inclus

XMH_string=VALUE Includeți numai gazdele cu a xymon-xmh(5) variabilă care se potrivește cu aceasta
valoare

Filtrare avansată

msg=MESAJ Includeți numai teste cu conținut complet care se potrivește cu MESSAGE. Folosiți „\s” pentru
spații de evacuare (sau alte șiruri PCRE)

ackmsg=MESAJ Includeți numai teste cu confirmare(e) MESAJ. Folosiți „\s” pentru
spații de evacuare (sau alte șiruri PCRE)

dismsg=MESAJ Includeți numai testele care au fost dezactivate cu potrivirea șirurilor
MESAJ. Utilizați „\s” pentru a scăpa de spații (sau alte șiruri PCRE). (Este cel mai eficient
pentru a asocia acest lucru cu culoare=albastru.)

Filtre de marcaj temporal

Anumite câmpuri (explicate mai jos) pot fi filtrate cu marcaje temporale Unix și cu
următoarele inegalități: >= > <= < = !=

Aceste filtre sunt: ​​lastchange, logtime, validtime, acktime, disabletime

Răspunsul este o linie pentru fiecare stare care corespunde CRITERIILOR sau toate stările
dacă nu sunt specificate criterii. Linia este compusă dintr-un număr de câmpuri, separate
printr-un semn de țeavă. Puteți selecta ce câmpuri să preluați, listându-le în
LISTA CÂMPURILOR. Următoarele câmpuri sunt disponibile:

nume de gazdă Numele gazdei

testname Numele testului

culoare Culoare de stare (verde, galben, roșu, albastru, clar, violet)

steaguri Pentru testele de rețea, steagurile care indică detalii despre test (utilizate de
ximongen).

ultima schimbare Marca temporală Unix când culoarea stării s-a schimbat ultima dată.

timp jurnal Marca temporală Unix când a fost primit mesajul de jurnal.

valabilitate Marca temporală Unix când mesajul de jurnal nu mai este valid (devine violet la
de data asta).

acktime Fie -1, fie marcaj temporal Unix când expiră o confirmare activă.

disabletime Fie -1, fie marcaj temporal Unix atunci când starea nu mai este dezactivată.

expeditor Adresa IP de la care a fost primit starea.

fursec Fie -1, fie valoarea cookie-ului utilizată pentru a confirma o alertă.

line1 Prima linie a jurnalului de stare.

ackmsg Gol (dacă nu este activă nicio confirmare) sau textul confirmării
mesaj.

dismsg Gol (dacă starea este în prezent activată) sau textul dezactivării
mesaj.

msg Textul complet al mesajului de stare curentă.

client Afișează „Y” dacă există date despre clienți disponibile, „N” dacă nu.

clntstamp Marca temporală când a fost primit ultimul mesaj client, în „epoca” Unix
format.

acklist Lista de mulțumiri curente pentru un test. Acesta este un șir de text cu
câmpuri multiple, delimitate de un caracter două puncte. Există 5 câmpuri: Timp pentru
când a fost generat confirmarea și când expiră; „nivelul ack”; utilizatorul care
a trimis ack-ul; și textul de confirmare.

flapinfo Spune dacă starea flutura. 5 câmpuri, delimitate de „/”: Un „0” dacă
starea nu este clapetă și „1” dacă clapă; marca temporală când este cea mai recentă stare
modificarea a fost înregistrată și când a fost înregistrată prima schimbare de stare; iar cei doi
culorile între care se zbate starea.

Statistici Numărul de modificări de stare care au fost înregistrate pentru această stare de la xymond
a fost început.

modificatori Listează toți modificatorii activi pentru această stare (adică actualizările trimise folosind un
comanda „modificare”).

XMH_* Etichetele XMH se referă la Xymon gazde.cfg(5) setările de configurare. Un plin
lista acestora poate fi găsită în xymon-xmh(5) pagina de manual.

Câmpurile ackmsg, dismsg și msg au anumite caractere codificate: Newline este „\n”,
TAB este „\t”, întoarcerea carușului este „\r”, un semn de țeavă este „\p”, iar bara oblică inversă este „\\”.

Dacă parametrul „câmpuri” este omis, un set implicit de
numele gazdă,numele testului,culoarea,steaguri,ultimei modificări,timpul de înregistrare,timpul valid,ora de activare,ora de dezactivare,sender,cookie,line1
este folosit.

xymondxboard
Preia un șir XML cu rezumatul tuturor jurnalelor de stare ca pentru
comanda „xymondboard”.

info gazdă [CRITERII]
Preia configurația curentă a unei gazde (adică gazde.cfg(5) definiție).
CRITERII selectează ce gazdă(e) să raporteze și este identic cu CRITERII din
comanda xymondboard.

Răspunsul este o linie pentru fiecare gazdă care corespunde CRITERIILOR sau toate gazdele dacă
nu sunt specificate criterii. Linia este compusă dintr-un număr de câmpuri, separate prin
un semn de țeavă. Primele două câmpuri vor fi întotdeauna numele de gazdă și adresa IP.
Câmpurile rămase - dacă există - sunt etichetele hosts.cfg fără o anumită ordine.

descărcați FILENAME
Descărcați un fișier din directorul de descărcare al serverului Xymon.

client[/COLLECTORID] HOSTNAME.OSTYPE [HOSTCLASS]
Folosit pentru a trimite un mesaj „client” către serverul Xymon. Mesajele clientului sunt generate
de către clientul Xymon; atunci când sunt trimise la serverul Xymon, acestea sunt comparate cu
reguli în analiză.cfg(5) fișierul de configurare și mesajele de stare sunt generate
pentru testele pe partea clientului. COLLECTORID-ul este folosit la trimiterea datelor client care
sunt completări la datele standard ale clientului. Datele vor fi concatenate cu
datele normale ale clientului.

clientlog HOSTNAME [secțiune=SECTIONNAME[,SECTIONNAME...]]
Preia mesajul actual al clientului brut trimis ultima dată de HOSTNAME. Opționalul
Filtrul „secțiune” este utilizat pentru a selecta anumite secțiuni ale datelor clientului.

ping Încercările de a contacta serverul Xymon. Dacă are succes, ID-ul versiunii serverului Xymon este
raportate.

pullclient
Acest mesaj este utilizat la preluarea datelor clientului prin mecanismul „pull” implementat
by xymonfetch(8) și msgcache(8) pentru clienții care nu se pot conecta direct la
Serverul Xymon.

listă fantomă
Raportați o listă de fantomă clienții văzuți de serverul Xymon. Fantomele sunt sisteme care
raportează date către serverul Xymon, dar nu sunt listate în fișierul hosts.cfg.

program [TIMESTAMP COMMAND]
Programează o comandă trimisă serverului Xymon pentru execuție ulterioară. De exemplu
folosit pentru a programa dezactivarea unei gazde sau a unui serviciu la un moment dat în viitor. COMANDA
este o comandă Xymon completă, cum ar fi cele enumerate mai sus. TIMESTAMP este Unix
epoca când comanda va fi executată.
Dacă nu sunt furnizați parametri, sarcinile programate în prezent sunt listate în
raspuns. Răspunsul este de o linie per comandă programată, cu job-id, the
ora la care va fi executată comanda, adresa IP de la care a fost trimisă,
și șirul complet de comandă.
Pentru a anula o comandă programată anterior, "programa anula LOCUL DE MUNCĂ" poate fi utilizat.
JOBID este un număr furnizat ca prim element din ieșirea din lista de planificare.

note FILENAME
Textul mesajului va fi stocat în $XYMONHOME/notes/FILENAME care este apoi folosit ca
hyperlinkuri de la numele de gazdă sau numele de coloane. Acest lucru necesită ca sarcina „storenotes”.
este activat în tasks.cfg (este dezactivat implicit). FILENAME nu poate conține niciunul
calea directorului - acestea sunt eliminate automat.

ID usermsg
Aceste mesaje vor fi transmise direct modulelor care ascultă pe canalul „utilizator”.
a demonului Xymon. Acesta este destinat comunicării personalizate între partea clientului
module și serverul Xymon.

modificați HOSTNAME.TESTNAME CULOARE SURSA CAUZĂ
Modificați culoarea unui anumit statut, fără a genera o stare completă
mesaj. Aceasta este pentru procesoarele backend (de exemplu, graficele RRD) care pot suprascrie
culoarea unui statut pe baza unor criterii determinate în afara fluxului normal al a
stare. De exemplu, starea normală „conexiune” poate părea verde, deoarece doar verifică
dacă o gazdă poate fi trimisă sau nu prin ping; handlerul RRD poate folosi apoi o „modificare”
comandă pentru a suprascrie acesta este timpul real de răspuns la ping depășește un anumit prag.
(Consultați setarea de configurare „DS” în analiză.cfg(5) pentru cum se face asta). SURSĂ
este o anumită identificare a modulului care generează mesajul „modificare” – viitor
modificările trebuie să utilizeze aceeași sursă. Pot exista mai multe surse care se modifică
aceeași stare (statusul cel mai grav devine apoi culoarea reală a
stare). CAUZĂ este un șir de text cu o linie care explică motivul pentru suprascrie
culoare de stare normală - va fi afișată pe pagina web de stare.

EXEMPLU

Trimiteți un mesaj de stare normală către serverul Xymon, utilizând protocolul standard Xymon pe TCP
portul 1984:
$ $XYMON $XYMSRV "starea www,foo,com.http verde `date` Web OK"

Trimiteți același mesaj de stare, dar folosind protocolul HTTP prin xymoncgimsg.cgi al serverului web
scenariu:
$ $XYMON http://bb.foo.com/cgi-bin/xymoncgimsg.cgi „starea www,foo,com.http verde
`data` Web OK"

Utilizați mesajul „interogare” pentru a determina culoarea testului „www” și reporniți Apache dacă este
roșu:

$ WWW=`$XYMON $XYMSRV „interogare www,foo,com.www” | awk '{print $1}''
$ if [ "$WWW" = "roșu" ]; apoi /etc/init.d/apache restart; fi

Utilizați mesajul „config” pentru a actualiza un fișier local mytest.cfg (dar numai dacă primim un răspuns):

$ $XYMON $XYMSRV „config mytest.cfg” >/tmp/mytest.cfg.new
$ if [ -s /tmp/mytest.cfg.new ]; atunci
mv /tmp/mytest.cfg.new $XYMONHOME/etc/mytest.cfg
fi

Trimiteți un mesaj de stare foarte mare care a fost construit în fișierul „statusmsg.txt”. In schimb
de a-l furniza pe linia de comandă, transmiteți-l prin stdin la comanda xymon:

$ cat statusmsg.txt | $XYMON $XYMSRV „@”

Utilizați xymon online folosind serviciile onworks.net