xymon - Online nel cloud

PROGRAMMA:

NOME

xymon - Programma di comunicazione client Xymon

SINOSSI

ssimo [opzioni] DESTINATARIO messaggio

DESCRIZIONE

ssimo(1) è il programma client utilizzato per comunicare con un server Xymon. È frequente
utilizzato dai sistemi client Xymon per inviare messaggi di stato e avvisi di cercapersone sui test locali.

In Xymon, il programma xymon viene utilizzato anche per scopi amministrativi, ad esempio per rinominare o
eliminare gli host o disabilitare gli host inattivi per periodi di tempo più lunghi.

VERSIONI E PARAMETRI

- debug
Abilita il debug. Questo stampa i dettagli su come la connessione a Xymon
è in corso la creazione del server.

--procura=http://PROXYSERVER:PORTA PROXY/
Quando si inviano i messaggi di stato tramite HTTP, utilizzare invece questo server come proxy HTTP
di connettersi direttamente al server Xymon.

--timeout=N
Specifica il timeout per la connessione al server Xymon, in secondi. Il predefinito
è di 5 secondi.

--risposta
L'utilità xymon normalmente sa quando aspettarsi una risposta dal server, quindi questo
l'opzione non è richiesta. Tuttavia, qualsiasi risposta dal server sarà
visualizzato.

--unisci
Unisci il testo del messaggio della riga di comando con i dati forniti sull'input standard e
inviare il risultato al server Xymon. Il testo del messaggio fornito sulla riga di comando
diventa la prima riga del messaggio unito.

DESTINATARIO
I DESTINATARIO Il parametro definisce quale server riceve il messaggio. Se DESTINATARIO è
dato come "0.0.0.0", allora il messaggio viene inviato a tutti i server elencati nella
Variabile di ambiente XYMSERVERS.

Di solito, un cliente utilizzerà "$XYMSRV" per il DESTINATARIO parametro, poiché questo è
definito affinché gli script client contengano automaticamente il valore corretto.

I DESTINATARIO il parametro può essere un URL per un server web che ha xymoncgimsg.cgi
o script simile installato. Questo incanala i messaggi Xymon sul server Xymon
utilizzando il protocollo HTTP standard. Il xymoncgimsg.cgi(8) Strumento CGI (incluso in Xymon)
deve essere installato sul server web affinché il trasporto HTTP funzioni.

MESSAGGIO
I messaggio parametro è il messaggio da inviare al server Xymon.
I messaggi devono essere racchiusi tra virgolette, ma così facendo possono estendersi su più righe.
La dimensione massima di un messaggio è definita dalla lunghezza massima consentita del tuo
riga di comando della shell ed è tipicamente 8-32 KB.

Se devi inviare messaggi di stato più lunghi, puoi specificare "@" come messaggio:
xymon leggerà quindi il messaggio di stato dal suo stdin.

XYMON MESSAGGIO SINTASSI

Questa sezione elenca i messaggi più comunemente usati nel protocollo Xymon.

Ogni messaggio deve iniziare con uno dei comandi Xymon. Dove è specificato un HOSTNAME, è
deve avere tutti i punti nel nome host modificati in virgole se l'impostazione Xymon FQDN è abilitata
(che è l'impostazione predefinita). Quindi l'host "www.foo.com", ad esempio, riporterebbe come
"www, pippo, com".

status[+LIFETIME][/group:GROUP] HOSTNAME.TESTNAME COLOR
Questo invia un messaggio di stato per un singolo test (colonna) su un singolo host.
TESTNAME è il nome della colonna in cui verrà visualizzato questo test; qualsiasi nome è valido
tranne che l'uso di punti nel nome del test non funzionerà. COLORE deve essere uno dei
colori validi: "verde", "giallo", "rosso" o "trasparente". I colori "blu" e "viola"
- sebbene i colori siano validi - non devono essere inviati in un messaggio di stato, poiché questi sono
gestito appositamente dal server Xymon. Come caso speciale (per supportare i vecchi
client), "client" può essere utilizzato come nome del colore. Questo causa lo stato
messaggio che deve essere gestito da Xymon come messaggio di dati "client" e TESTNAME
il parametro viene utilizzato come "id collettore".
Il "testo aggiuntivo" normalmente include un timestamp locale e un riepilogo del test
risultato sulla prima riga. Tutte le righe che seguono la prima sono in forma libera e possono
includere tutte le informazioni che possono essere utili per diagnosticare il problema segnalato.
Il LIFETIME definisce per quanto tempo questo stato è valido dopo essere stato ricevuto dal
Server Xymon. L'impostazione predefinita è 30 minuti, ma puoi impostare qualsiasi periodo desideri. Per esempio
per un test personalizzato che viene eseguito una volta all'ora, ti consigliamo di impostarlo su almeno 60
minuti - altrimenti lo stato diventerà viola dopo 30 minuti. È una buona idea
per impostare LIFETIME leggermente più lungo dell'intervallo tra i test, per
consentire variazioni nel tempo necessario per completare il test. La VITA è in
minuti, a meno che non si aggiungano "h" (ore), "d" (giorni) o "w" (settimane) subito dopo
il numero, ad es. "stato+5h" per uno stato valido per 5 ore.
L'opzione GRUPPO viene utilizzata per indirizzare gli avvisi dallo stato a un gruppo specifico. Esso
è attualmente utilizzato per lo stato generato dai dati dei client Xymon, ad esempio per dirigere
avvisi per uno stato "proc" a persone diverse, a seconda esattamente di quale processo
è giù.

notifica HOSTNAME.TESTNAME
Ciò attiva un messaggio informativo da inviare a coloro che ricevono avvisi per
questa combinazione HOSTNAME+TESTNAME, secondo le regole definite in avvisi.cfg(5)
Questo è usato dal enadis.cgi(1) strumento per informare le persone sulla disattivazione degli host
o abilitato, ma può anche servire come modo generale per informare gli amministratori del server.

dati HOSTNAME.DATANAME
Il messaggio "dati" consente agli strumenti di inviare dati su un host, senza che appaia come
una colonna nelle pagine web di Xymon. Questo è usato, ad esempio, per riportare le statistiche
su un host, ad esempio i dati vmstat, che di per sé non rappresentano qualcosa che
ha un'identità rossa, gialla o verde. Viene utilizzato dai moduli bottom feeder RRD, tra
altri. In Xymon, i messaggi di dati vengono elaborati per impostazione predefinita solo dal xymond_rrd(8)
modulo. Se vuoi gestire i messaggi di dati utilizzando un'applicazione esterna, puoi
desidera abilitare il xymond_filestore(8) modulo per dati-messaggi, per memorizzare dati-
messaggi in un formato compatibile con il funzionamento del demone del Grande Fratello.

disabilita HOSTNAME.TESTNAME DURATION
Disabilita un test specifico per DURATION minuti. Questo causerà lo stato di questo
test per essere elencato come "blu" sul server Xymon e nessun avviso per questo host/test
sarà generato. Se DURATION è dato come un numero seguito da s/m/h/d, è
interpretati rispettivamente in secondi/minuti/ore/giorni. Per disabilitare un
prova finché non diventa OK, usa "-1" come DURATA. Per disabilitare tutti i test per a
host, usa un asterisco "*" per TESTNAME.

abilita HOSTNAME.TESTNAME
Riattiva un test che era stato disabilitato.

interroga HOSTNAME.TESTNAME
Interroga il server Xymon per l'ultimo stato segnalato per questo particolare test. Se
lo stato dell'host/test è noto, la risposta è la prima riga del rapporto di stato
- il colore corrente sarà la prima parola sulla riga. Ulteriori righe di testo
che potrebbe essere presente nel messaggio di stato non può essere recuperato.
Ciò consente a qualsiasi client Xymon di determinare lo stato di un particolare test, se
è uno relativo all'host in cui è in esecuzione il client, a qualche altro host o
forse il risultato di un test combinato da più host gestiti da combostato(1)
Questo sarà in genere utile per gli script di estensione del client Xymon, che devono
determinare lo stato di altri host, ad esempio, per decidere se un'operazione automatica
dovrebbe essere avviata un'azione di recupero.

config NOMEFILE
Recupera uno dei file di configurazione di Xymon dal server. Questo comando permette
un client per estrarre i file dalla directory $XYMONHOME/etc/ sul server, permettendo
per gli aggiornamenti semiautomatici della configurazione del client. Poiché la configurazione
sono progettati per avere un file comune per la configurazione di tutti gli host nel
system - e questo è in effetti il ​​modo consigliato per configurare i tuoi client - questo
rende più facile mantenere sincronizzati i file di configurazione.

rilascia HOSTNAME
Rimuove tutti i dati memorizzati sull'host HOSTNAME. Si presume che tu abbia
già eliminato l'host dal file di configurazione hosts.cfg.

rilascia HOSTNAME TESTNAME
Rimuovere i dati su un singolo test (colonna).

rinomina VECCHIO NOME HOST NUOVO NOME HOST
Rinominare tutti i dati per un host il cui nome è stato modificato. Dovresti farlo dopo
modificando il nome host nel file di configurazione hosts.cfg.

rename HOSTNAME VECCHIO NOME TEST NUOVO NOME TEST
Rinominare i dati su un singolo test (colonna).

xymondlog NOMEHOST.NOMETEST
Recupera il registro di stato di Xymon per un singolo test. La prima riga della risposta
contiene una serie di campi separati da un segno di pipe:

hostname Il nome dell'ospite

nomeprova Il nome del test

colore Colore di stato (verde, giallo, rosso, blu, trasparente, viola)

flag di prova Per i test di rete, i flag che indicano i dettagli sul test (usati da
ximogeno).

ultima modifica Unix timestamp quando il colore di stato è cambiato l'ultima volta.

logtime Unix timestamp quando è stato ricevuto il messaggio di registro.

tempo valido Unix timestamp quando il messaggio di registro non è più valido (diventa viola a
questa volta).

orario di ricevimento O -1 o timestamp Unix quando scade un riconoscimento attivo.

disabilita ora O -1 o timestamp Unix quando lo stato non è più disabilitato.

trasmettitore Indirizzo IP da cui è stato ricevuto lo stato.

biscotto O -1 o il valore del cookie utilizzato per riconoscere un avviso.

msg di conferma Vuoto o il messaggio di riconoscimento inviato quando lo stato è stato riconosciuto.
Newline, pipe-signs e backslash sono sfuggiti con una barra rovesciata, in stile C.

Dismsg Vuoto o il messaggio inviato quando lo stato era disabilitato. Newline, segnaletica per tubi
e le barre rovesciate vengono evitate con una barra rovesciata, in stile C.

Dopo la prima riga viene visualizzato il registro di stato completo in formato testo.

xymondxlog NOMEHOST.NOMETEST
Recupera una stringa XML contenente il registro di stato come con il comando "xymondlog".

xymondboard [CRITERI] [campi=ELENCO CAMPI]
Recupera un riepilogo dello stato di tutti i test conosciuti disponibili per il demone Xymon.

Per impostazione predefinita, se non vengono forniti CRITERI, restituisce una riga per tutti gli stati
messaggi che si trovano in Xymon. Puoi filtrare la risposta per selezione specifica
pagina, host, test, colore o vari altri campi. PAGEPATH, NETWORK, HOSTNAME,
I parametri TESTNAME e *MSG sono interpretati come espressioni regolari compatibili con perl;
il parametro COLOR accetta più colori separati da virgole; i *valori TIME
accettare timestamp epoca unix. Altre variabili identificate in xymon-xmh(5) può anche
essere usato.

Poiché la filtrazione dell'ospite viene eseguita prima della filtrazione di prova, è più efficiente (con
set di dati molto grandi) per utilizzare PAGEPATH, HOSTNAME, NETWORK e altri filtri XMH_
quando possibile, prima di filtrare globalmente con COLOR, *MSG, *TIME o TESTNAME.

Puoi filtrare, ad esempio, sia un nome host che un nome test.

pagina=PERCORSO PAGINA Includere solo i test degli host trovati nella pagina PAGEPATH nel
file hosts.cfg.

rete=RETE Includere solo i test degli host con questo tag NET:

IP=IPIndirizzo Include solo i test degli host con questo indirizzo IP. Questa è una regex,
non CIDR.

host=NOMEHOST Includi solo i test dell'host HOSTNAME

test=NOMETEST Includi solo i test con il nome test NOMETEST

color=NOMECOLORE Includi solo i test in cui il colore di stato è COLORNAME

tag=NOMETAG Includi solo host con un determinato tag specificato nel host.cfg(5)
linea. Nota che solo gli elementi noti ai componenti xymon sono inclusi qui; arbitrario
il testo non è incluso

XMH_string=VALORE Includi solo host con a xymon-xmh(5) variabile corrispondente a questo
APPREZZIAMO

Filtro avanzato

msg=MESSAGGIO Includi solo i test con contenuto completo corrispondente a MESSAGGIO. Usa "\s" per
spazi di escape (o altre stringhe PCRE)

ackmsg=MESSAGGIO Includere solo i test con MESSAGGIO di riconoscimento. Usa "\s" per
spazi di escape (o altre stringhe PCRE)

dismsg=MESSAGGIO Includi solo i test che sono stati disabilitati con stringhe corrispondenti
MESSAGGIO. Usa "\s" per sfuggire agli spazi (o ad altre stringhe PCRE). (È più efficiente
per accoppiarlo con color=blue.)

Filtri timestamp

Alcuni campi (spiegati di seguito) possono essere filtrati con timestamp unix e con il
seguenti disuguaglianze: >= > <= < = !=

Questi filtri sono: lastchange, logtime, validtime, acktime, disabletime

La risposta è una riga per ogni stato che corrisponde ai CRITERI, o per tutti gli stati
se non viene specificato alcun criterio. La riga è composta da un numero di campi, separati
da un segno di pipa. Puoi selezionare quali campi recuperare elencandoli nel
ELENCO CAMPO. Sono disponibili i seguenti campi:

hostname Il nome dell'ospite

nomeprova Il nome del test

colore Colore di stato (verde, giallo, rosso, blu, trasparente, viola)

bandiere Per i test di rete, i flag che indicano i dettagli sul test (usati da
ximogeno).

ultima modifica Unix timestamp quando il colore di stato è cambiato l'ultima volta.

logtime Unix timestamp quando è stato ricevuto il messaggio di registro.

tempo valido Unix timestamp quando il messaggio di registro non è più valido (diventa viola a
questa volta).

orario di ricevimento O -1 o timestamp Unix quando scade un riconoscimento attivo.

disabilita ora O -1 o timestamp Unix quando lo stato non è più disabilitato.

trasmettitore Indirizzo IP da cui è stato ricevuto lo stato.

biscotto O -1 o il valore del cookie utilizzato per riconoscere un avviso.

line1 Prima riga del registro di stato.

msg di conferma Vuoto (se nessun riconoscimento è attivo), o il testo del riconoscimento
messaggio.

Dismsg Vuoto (se lo stato è attualmente abilitato), oppure il testo della disabilitazione
messaggio.

msg Il testo completo del messaggio di stato corrente.

cliente Mostra "Y" se sono disponibili dati del cliente, "N" in caso contrario.

clntstamp Timestamp quando è stato ricevuto l'ultimo messaggio client, in Unix "epoch"
formato.

lista di selezione Elenco dei riconoscimenti attuali per un test. Questa è una stringa di testo con
più campi, delimitati da due punti. Ci sono 5 campi: Timestamp per
quando l'ac è stato generato e quando scade; il "livello di conferma"; l'utente che
inviato l'ac; e il testo di riconoscimento.

lemboinfo Indica se lo stato è fluttuante. 5 campi, delimitati da "/": Uno "0" se il
lo stato non sta sbattendo e "1" se sta sbattendo; timestamp quando l'ultimo stato
il cambiamento è stato registrato e quando è stato registrato il primo cambiamento di stato; e i due
colori tra i quali oscilla lo stato.

stats Numero di cambiamenti di stato che sono stati registrati per questo stato da xymond
era iniziato.

modificatori Elenca tutti i modificatori attivi per questo stato (cioè gli aggiornamenti inviati usando a
comando "modifica").

XMH_* I tag XMH si riferiscono allo Xymon host.cfg(5) impostazioni di configurazione. Un pieno
l'elenco di questi può essere trovato in xymon-xmh(5) pagina man.

I campi ackmsg, dismsg e msg hanno determinati caratteri codificati: Newline è "\n",
TAB è "\t", il ritorno a capo è "\r", un segno di barra verticale è "\p" e una barra rovesciata è "\\".

Se il parametro "fields" viene omesso, un set predefinito di
hostname,testname,colore,flags,lastchange,logtime,validtime,acktime,disabletime,sender,cookie,line1
viene utilizzato.

xymondxboard
Recupera una stringa XML con il riepilogo di tutti i registri di stato come per il
comando "xymondboard".

hostinfo [CRITERI]
Recupera la configurazione corrente di un host (cioè il host.cfg(5) definizione).
CRITERI seleziona quale/i host/i segnalare ed è identico ai CRITERI nel
comando xymondboard.

La risposta è una riga per ogni host che corrisponde ai CRITERI, o tutti gli host se
non è specificato alcun criterio. La riga è composta da un numero di campi, separati da
un segno di pipa. I primi due campi saranno sempre il nome host e l'indirizzo IP.
I campi rimanenti, se presenti, sono i tag hosts.cfg senza un ordine particolare.

scarica NOMEFILE
Scarica un file dalla directory di download del server Xymon.

cliente[/COLLECTORID] NOMEHOST.OSTYPE [HOSTCLASS]
Utilizzato per inviare un messaggio "client" al server Xymon. I messaggi dei clienti vengono generati
dal client Xymon; quando vengono inviati al server Xymon vengono confrontati con il
regole nel analisi.cfg(5) file di configurazione e vengono generati messaggi di stato
per i test lato client. Il COLLECTORID viene utilizzato quando si inviano dati client che
sono aggiunte ai dati standard del cliente. I dati verranno concatenati con il
normali dati del cliente.

clientlog HOSTNAME [sezione=SECTIONNAME[,SECTIONNAME...]]
Recupera l'ultimo messaggio client non elaborato corrente inviato da HOSTNAME. L'opzionale
Il filtro "sezione" viene utilizzato per selezionare sezioni specifiche dei dati del cliente.

ping Tenta di contattare il server Xymon. In caso di successo, l'ID della versione del server Xymon è
segnalati.

pullclient
Questo messaggio viene utilizzato durante il recupero dei dati del cliente tramite il meccanismo "pull" implementato
by xymonfetch(8) ed msgcache(8) per i clienti che non possono connettersi direttamente al
Server Xymon.

lista di fantasmi
Segnala un elenco di fantasma client visti dal server Xymon. I fantasmi sono sistemi che
riportano i dati al server Xymon, ma non sono elencati nel file hosts.cfg.

programma [COMANDO TIMESTAMP]
Pianifica un comando inviato al server Xymon per l'esecuzione in un secondo momento. Per esempio
utilizzato per pianificare la disattivazione di un host o di un servizio in futuro. COMANDO
è un comando Xymon completo come quelli elencati sopra. TIMESTAMP è Unix
epoch tempo in cui il comando verrà eseguito.
Se non vengono forniti parametri, le attività attualmente pianificate sono elencate nel
risposta. La risposta è una riga per comando pianificato, con il job-id, il
l'ora in cui verrà eseguito il comando, l'indirizzo IP da cui è stato inviato,
e la stringa di comando completa.
Per annullare un comando precedentemente programmato, "orario annullare LAVORO" può essere utilizzato.
JOBID è un numero fornito come primo elemento nell'output dall'elenco di pianificazione.

note NOMEFILE
Il testo del messaggio verrà archiviato in $XYMONHOME/notes/FILENAME che viene quindi utilizzato come
collegamenti ipertestuali da nomi host o nomi di colonne. Ciò richiede che l'attività "storenotes"
è abilitato in task.cfg (è disabilitato per impostazione predefinita). FILENAME non può contenere nessuno
percorso della directory - questi vengono rimossi automaticamente.

ID messaggio utente
Questi messaggi verranno ritrasmessi direttamente ai moduli in ascolto sul canale "utente"
del demone Xymon. Questo è inteso per la comunicazione personalizzata tra lato client
moduli e il server Xymon.

modificare HOSTNAME.TESTNAME COLORE SORGENTE CAUSA
Modificare il colore di uno stato specifico, senza generare uno stato completo
Messaggio. Questo è per i processori di backend (ad esempio i grafici RRD) che possono sovrascrivere il
colore di uno stato in base ad alcuni criteri determinati al di fuori del normale flusso di a
stato. Ad esempio, il normale stato "conn" può sembrare verde poiché si limita a controllare
se un host può essere sottoposto a ping o meno; il gestore RRD può quindi utilizzare un "modifica"
comando per sovrascrivere questo è il tempo di risposta del ping effettivo che supera una determinata soglia.
(Vedi l'impostazione di configurazione "DS" in analisi.cfg(5) per come farlo). FONTE
è qualche identificazione del modulo che genera il messaggio "modifica" - futuro
le modifiche devono utilizzare la stessa fonte. Potrebbero esserci diverse fonti che modificano
lo stesso stato (lo stato più grave diventa quindi il colore effettivo del
stato). CAUSE è una stringa di testo di una riga che spiega il motivo dell'override di
colore di stato normale: verrà visualizzato nella pagina Web di stato.

ESEMPIO

Invia un normale messaggio di stato al server Xymon, utilizzando il protocollo Xymon standard su TCP
porto 1984:
$ $XYMON $XYMSRV "stato www,pippo,com.http verde `data` Web OK"

Invia lo stesso messaggio di stato, ma utilizzando il protocollo HTTP tramite il server web xymoncgimsg.cgi
sceneggiatura:
$ $XYMON http://bb.foo.com/cgi-bin/xymoncgimsg.cgi "stato www,pippo,com.http verde
`data` Web OK"

Usa il messaggio "query" per determinare il colore del test "www" e riavvia Apache se lo è
rosso:

$ WWW=`$XYMON $XYMSRV "query www,pippo,com.www" | awk '{print $1}'`
$ if [ "$WWW" = "rosso" ]; quindi /etc/init.d/apache restart; fi

Usa il messaggio "config" per aggiornare un file mytest.cfg locale (ma solo se otteniamo una risposta):

$ $XYMON $XYMSRV "config miotest.cfg" >/tmp/mytest.cfg.new
$ if [ -s /tmp/mytest.cfg.new ]; poi
mv /tmp/miotest.cfg.new $XYMONHOME/etc/miotest.cfg
fi

Invia un messaggio di stato molto grande che è stato creato nel file "statusmsg.txt". Anziché
di fornirlo sulla riga di comando, passalo tramite stdin al comando xymon:

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

Usa xymon online utilizzando i servizi onworks.net