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 salvare note personalizzate per tutti gli host e i servizi, sia singolarmente che per interi gruppi. Queste note vengono mostrate in colonne separate chiamate "Custom services notes" e "Custom host notes". Di default, queste colonne sono già visibili nelle visualizzazioni dettagliate degli host (Status of Host myhost) e dei servizi (Service myservice, myhost). Dato che sono colonne standard, puoi inserirle anche in tante altre visualizzazioni di Checkmk.
2. Creare note
Puoi creare le note direttamente nella directory di configurazione del tuo sito Checkmk.
Per farlo, prima crea la directory notes in ~/etc/check_mk/.
2.1. Note sull'host
Per creare le note per gli host, crea la directory hosts all'interno della directory notes.
Se 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:
Situata nella parte inferiore della visualizzazione "Status of Host", questa nota avrà questo aspetto:

Se vuoi che un singolo file di questo tipo faccia riferimento e venga visualizzato su più host contemporaneamente, puoi usare modelli di shell come l'asterisco, il punto interrogativo e anche classi di caratteri.
Per farlo, il nome del file nella rispettiva directory deve contenere effettivamente questi caratteri.
Quindi un file chiamato '*' nella directory ~/etc/check_notes/hosts/ farebbe riferimento a tutti gli host.
Il contenuto del file '*' verrebbe quindi visualizzato su ogni singolo host della tua istanza.
Importante: i nomi di questi file devono essere racchiusi tra virgolette singole.
Se, per qualche motivo, vuoi mostrare una nota specifica su tutti gli host il cui nome finisce con t, crea un file chiamato '*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 il servizio
Per poter creare tali note anche per i servizi, è necessaria la directory "services" all'interno di "~/etc/check_mk/notes/".
A differenza degli host, non puoi iniziare subito in questa directory con i file per le tue note. Qui hai bisogno di un altro livello di directory, che definisce per quali host deve essere visualizzata una nota di servizio.
Quindi, crea una directory che indichi un host o, seguendo gli schemi mostrati sopra, più host.
Quindi una directory denominata '*' farebbe nuovamente riferimento a tutti gli host.
In una directory che corrisponde esattamente al nome host, puoi creare note solo per i servizi di quell'host.
Quindi, se vuoi creare note per i servizi su tutti gli host che iniziano con my, dovrai creare una directory chiamata 'my*'.
Anche in questo caso, assicurati di racchiudere i nomi delle directory tra virgolette singole.
Una volta creato il livello host in base alle tue esigenze, puoi, analogamente alle note host, creare nuovamente dei file, che questa volta devono corrispondere al Service description desiderato. 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 della tua istanza.
3. Macro che puoi usare
Nelle note puoi usare delle macro, che poi verranno sostituite come serve nella visualizzazione. Qui puoi usare queste macro:
|
Nome host |
|
Nome host in minuscolo |
|
Nome host in maiuscolo |
|
Nome host con la prima lettera maiuscola e il resto in minuscolo |
|
L'indirizzo IP dell'host su cui viene effettuato il monitoraggio. |
|
Descrizione del servizio (solo per le note di servizio) |
|
ID dell'istanza Checkmk |
|
Prefisso URL dell'istanza |
|
Output del plug-in di controllo (solo per le note sull'host) |
|
Output del plug-in di controllo (solo per le note di servizio) |
Per esempio, potresti usare un unico file per fare riferimento a diverse voci nel 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>