 |
This is a machine translation based on the English version of the article. It might or might not have already been subject to text preparation. If you find errors, please file a GitHub issue that states the paragraph that has to be improved. |
1. Introduzione
In Checkmk puoi memorizzare note personalizzate per tutti gli host e i servizi in modo individuale e specifico, oppure per interi gruppi. Queste note sono visualizzate in colonne separate chiamate Custom services notes e Custom host notes. Per impostazione predefinita, queste colonne sono già visualizzate nelle visualizzazioni dettagliate degli host (Status of Host myhost) e dei servizi (Service myservice, myhost). Poiché si tratta di colonne standard, possono essere inserite anche in molte altre visualizzazioni di Checkmk.
2. Creare le note
Le note possono essere create direttamente nella directory di configurazione della tua istanza Checkmk. Per farlo, crea prima la directory notes in ~/etc/check_mk/.
OMD[mysite]:~$ mkdir ~/etc/check_mk/notes2.1. Note per gli host
Per creare note per gli host, crea la directory hosts all'interno della directory notes.
OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/hostsSe ora vuoi creare una nota per un host specifico, crea un file il cui nome corrisponda esattamente al nome di quell'host in Checkmk. Usa l'editor che preferisci o il reindirizzamento della shell, come nell'esempio seguente:
OMD[mysite]:~$ echo "My custom host note for myhost" > ~/etc/check_mk/notes/hosts/myhostSituata nella parte inferiore della visualizzazione di Status of Host, questa nota avrà il seguente aspetto:
Se vuoi che un singolo file di questo tipo si riferisca e venga visualizzato su più host contemporaneamente, puoi utilizzare modelli di shell come l'asterisco, il punto interrogativo e anche le classi di caratteri. Per fare ciò, il nome del file nella rispettiva directory deve contenere questi caratteri. Quindi un file chiamato '*' nella directory ~/etc/check_notes/hosts/ si riferirà a tutti gli host. Il contenuto del file '*' verrà quindi visualizzato su ogni singolo host del tuo sito.
Importante: i nomi di questi file devono essere racchiusi tra virgolette singole.
Se, per qualche motivo, vuoi visualizzare una nota specifica su tutti gli host il cui nome termina con t, allora crea un file chiamato '*t'.
OMD[mysite]:~$ echo "The name auf this host ends with t" > ~/etc/check_mk/notes/hosts/'*t'Se più di un file corrisponde al nome di un host, il campo Custom host notes mostrerà anche tutte le note corrispondenti. Le diverse note sono separate da una linea orizzontale:
2.2. Note di servizio
Per poter creare note di questo tipo anche per i servizi, è necessaria la directory services all'interno di ~/etc/check_mk/notes/.
OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/servicesA differenza di quanto avviene per gli host, in questa directory non puoi iniziare subito a creare i file per le note: è necessario un altro livello del servizio che definisca per quali host deve essere visualizzata una nota di servizio.
Quindi, crea una directory che designi un host o, seguendo lo schema mostrato sopra, più host.
Quindi una directory chiamata '*' si riferirà a tutti gli host.
OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/'*'In una directory che corrisponde esattamente al nome di un host, puoi creare note solo per i servizi di quell'host.
OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/myhostQuindi, se vuoi creare note per i servizi di tutti gli host che iniziano con my, dovrai creare una directory denominata 'my*'.
OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/'my*'Anche in questo caso, assicurati di racchiudere i nomi delle directory tra virgolette singole.
Una volta creato il livello dell'host in base alle tue esigenze, puoi creare nuovamente dei file, analogamente alle note sull'host, che questa volta devono corrispondere all'indirizzo Service description. Allo stesso modo, puoi lavorare con asterischi, punti interrogativi e classi di caratteri.
L'esempio seguente crea una nota per il servizio Check_MK su ciascuno degli host del tuo sito.
OMD[mysite]:~$ echo "Note about service Check_MK for all hosts" > ~/etc/check_mk/notes/services/'*'/Check_MK3. Macro che possono essere utilizzate
All'interno delle note puoi utilizzare delle macro, che verranno poi sostituite in modo appropriato nella visualizzazione. In questo caso è possibile utilizzare le seguenti macro:
|
Nome host |
|
Nome host in lettere minuscole |
|
Nome host in lettere maiuscole |
|
Nome host con la prima lettera maiuscola e il resto in minuscolo |
|
Indirizzo IP dell'host su cui viene monitorato il servizio. |
|
Descrizione del servizio (solo per le note sul servizio) |
|
ID dell'istanza Checkmk |
|
Prefisso URL del sito |
|
Output del plug-in di controllo (solo per le note sull'host) |
|
Output del plug-in di controllo (solo per le note sul servizio) |
Ad esempio, puoi utilizzare un unico file per fare riferimento a diverse voci del tuo wiki interno, ognuna delle quali corrisponderà sempre all'host attualmente aperto.
Additional information about <a href="http://mywiki.local/page.php?host=$HOSTNAME$" target="_blank">this host in our wiki</a>