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
Il compito più importante quando si configura uno strumento di monitoraggio è gestire i sistemi da monitorare, ovvero gli host. Non si tratta solo di assicurarsi che siano inseriti con i dati anagrafici corretti (ad es. nome host, indirizzo IP). Anche le impostazioni per il monitoraggio (ad es. notifiche, soglie, ecc.) richiedono una manutenzione regolare.
Checkmk è stato progettato fin dall'inizio per ambienti con un numero molto elevato di host e ha un approccio specifico per rendere la configurazione di tali ambienti gestibile per l'utente. I principi fondamentali di Checkmk sono:
Una gerarchia di cartelle in cui sono memorizzati gli host.
Tag host e una configurazione rule-based derivata dai tag.
Rilevamento automatico dei servizi da sottoporre a monitoraggio.
In generale, si è rivelato utile pensare prima a un sistema di ordinamento e poi riempirlo di contenuti. Per scoprire le possibilità che Checkmk offre per mettere ordine tra i tuoi host, consulta l'articolo sulla strutturazione degli host.
2. Cartelle ed ereditarietà
Chiunque lavori con i computer conosce il principio dei file e delle cartelle. Checkmk utilizza un principio analogo per l'amministrazione degli host, che di fatto assumono il ruolo dei file. Poiché le cartelle possono a loro volta essere contenute in altre cartelle, il risultato appare come una struttura ad albero.
2.1. Gerarchia delle cartelle
L'utente è completamente libero nella progettazione della propria struttura ad albero. È possibile qualsiasi forma di differenziazione. Tuttavia, ci sono tre criteri comuni per la struttura dell'albero degli host:
Ubicazione (ad es. Monaco di Baviera rispetto a Shanghai)
Tipo di host (ad es. switch contro bilanciatore di carico)
Struttura organizzativa (ad es. database contro gruppi di rete)
I criteri possono ovviamente essere combinati, ad esempio suddividendo per ubicazione al primo livello dell'albero e poi per tipo di host al secondo.
Se ti piace la semplicità, dovresti mettere gli host solo nelle "foglie" dell'albero (anche se Checkmk permette di inserire host nelle cartelle intermedie). L'esempio seguente mostra una semplice struttura ad albero per tipo di host: Gli host A, B e C sono inseriti nella cartella Server, mentre D, E e F sono inseriti nella cartella Rete:

2.2. Ereditare gli attributi
Se costruisci l'albero in modo intelligente, puoi usarlo per ereditare gli attributi in modo significativo. Questo è particolarmente utile per quegli attributi comuni a grandi gruppi di host, come la comunità SNMP o i tag host che usi per determinare se l'host debba essere monitorato da un agente Checkmk o da SNMP.
L'esempio seguente mostra l'ereditarietà dei gruppi di tag "Criticality" (con i valori prod e test) e "Checkmk agent / API integrations" (con i valori tcp e no-agent).
Il tag ausiliario "tcp" viene impostato automaticamente quando si seleziona l'agente Checkmk e/o un'integrazione API, mentre "no-agent" è l'opzione da scegliere quando si effettua il monitoraggio tramite SNMP.

Gli attributi definiti più in basso nell'albero hanno sempre la precedenza.
Quindi i valori definiti direttamente sull'host sovrascrivono qualsiasi cosa proveniente dalle cartelle.
Nell'esempio sopra, questo porta a prod e tcp per l'host A, prod e no-agent per D, e test e no-agent per l'host F a causa dell'attributo assegnato esplicitamente.
Un grande vantaggio di questo schema rispetto all'approccio "copia e incolla" ampiamente utilizzato dai sistemi di configurazione orientati al database è che qualsiasi attributo specificato verrà ricevuto dagli host aggiunti in futuro. Questo semplifica il lavoro a te e ai tuoi colleghi: basta trascinare un nuovo host nella cartella appropriata e tutti gli attributi predefiniti saranno automaticamente corretti.
2.3. Creazione di cartelle
Come creare le cartelle è spiegato nella Guida per principianti.
3. Creazione e edizione degli host nel menu di configurazione
Per gestire cartelle e host, vai su Setup > Hosts > Hosts:

Qui, nella visualizzazione predefinita, puoi vedere una panoramica delle cartelle e, sotto di esse, in forma tabellare, gli host già presenti nella cartella corrente.
Creando un nuovo host con il pulsante di azione "
" (Crea nuovo host), "Add host" (Modifica host), "
" (Clona host) o "
" (Modifica) di un host esistente, verrai reindirizzato alla pagina "Properties of host" (Dettagli host).
Qui è riportato l'elenco degli attributi dell'host.
Questi attributi sono raggruppati in diverse sezioni, le più importanti delle quali ti presentiamo qui.
3.1. Il nome host
Il campo Hostname viene utilizzato ovunque all’interno di Checkmk per identificare in modo univoco l’host. Quando possibile, dovresti utilizzare il nome DNS dell’host. Se il nome DNS è troppo lungo, è possibile assegnare in un secondo momento un nome alias più facile da riconoscere. Tieni presente, tuttavia, che Checkmk consente una lunghezza massima di 240 caratteri per il nome host.

In linea di principio è possibile modificare il nome host anche in un secondo momento, ma poiché il nome host viene utilizzato in molti punti all'interno di Checkmk, le modifiche successive risultano più complesse e richiedono più tempo quando, al momento della modifica, sono già stati accumulati dati di monitoraggio.
3.2. Alias e indirizzo IP
Puoi assegnare un nome alternativo e descrittivo all'host in Alias , che verrà visualizzato in molti punti della GUI e nei rapporti. Se non assegni un alias, verrà utilizzato il nome host.

Non è necessario specificare un indirizzo IP. Sono disponibili quattro opzioni per configurare l'indirizzo IP, che determinano anche quando il nome viene risolto:
| Opzione | Procedura | Quando eseguire la risoluzione del nome? |
|---|---|---|
1. |
Non specifichi un indirizzo IP. Il nome host deve essere risolvibile tramite DNS. |
|
2. |
Si inserisce un indirizzo IPv4 — nella consueta notazione con punti. |
Mai |
3. |
Invece di un indirizzo IP, inserisci un nome host (alternativo) risolvibile tramite DNS. |
Quando esegui i check |
4. |
Usa il set di regole "Hosts with dynamic DNS lookup" per specificare gli host per un DNS dinamico. Il risultato è analogo all'opzione 3, tranne per il fatto che ora viene utilizzato il campo "Hostname" per la query DNS. |
Quando si eseguono i check |
Con la prima opzione Checkmk utilizza un file di cache per evitare richieste DNS ripetute durante l'attivazione delle modifiche. Questa cache è molto importante per velocizzare il processo e garantisce anche che tu possa attivare una configurazione modificata anche se il DNS fallisce nel tentativo.
Il problema è che Checkmk non rileva immediatamente la modifica di un indirizzo IP nel DNS.
Ecco perché nelle proprietà dell'host c'è una voce di menu "Host > Update DNS cache".
Questo cancellerà l'intera cache DNS e forzerà una nuova risoluzione la prossima volta che le modifiche verranno attivate.
Il file corrispondente si trova nella tua istanza sotto ~/var/check_mk/ipaddresses.cache.
L'eliminazione di questo file ha lo stesso effetto dell'esecuzione di Update (site) DNS cache.
Checkmk supporta anche il monitoraggio tramite IPv6, anche in dual stack.
L'ordine di risoluzione qui è determinato dalle impostazioni del sistema operativo (/etc/gai.conf).
Nei campi Additional IPv4 addresses e Additional IPv6 addresses sono ammessi solo indirizzi IP in notazione con punto o due punti, quindi non sono consentiti nomi DNS alternativi.
Per alcune applicazioni è necessario impostare IP address family su No IP. Questo vale per gli host interrogati tramite un special agent e per la modalità push dell'agente Checkmk. Puoi leggere ulteriori informazioni al riguardo nella sezione seguente dedicata agli agenti di monitoraggio.
3.3. Agenti di monitoraggio
Con l'Monitoring agentsi decidi da quali sorgenti dati utilizzare per il monitoraggio. L'impostazione predefinita prevede l'uso dell'agente Checkmk. Sono disponibili anche numerose opzioni di monitoraggio alternative o aggiuntive.

In particolare, la prima voce dell'Checkmk agent / API integrationse decide quali dati utilizzare e quali scartare quando sono presenti più sorgenti dati.
API integrations if configured, else Checkmk agent |
I dati di monitoraggio vengono forniti dalle integrazioni API, ovvero da special agents o tramite piggyback da altri host. Se sono configurati special agents, vengono eseguiti tutti. Se non sono configurate integrazioni API, si accede all'output dell'agente Checkmk. Questo è il valore predefinito. |
Configured API integrations and Checkmk agent |
Ci si aspetta l'output da un agente Checkmk. Verranno utilizzati anche i dati forniti dalle integrazioni API, se configurate. |
Configured API integrations, no Checkmk agent |
Per il monitoraggio verranno utilizzati solo i dati forniti dalle integrazioni API. |
No API integrations, no Checkmk agent |
Con questa impostazione l'host verrà monitorato tramite SNMP o senza agente solo con attivi checks. Le regole per gli attivi checks sono disponibili in Setup > Hosts > HTTP, TCP, Email, … Se non definisci almeno un attivo check, Checkmk creerà automaticamente un servizio PING. |
Selezionando "Configured API integrations, no Checkmk agent" si garantisce che entrambi i servizi "Check_MK" e "Check_MK Discovery" abbiano sempre lo stato "OK". Se non hai inserito un indirizzo IP per l'host, questo assumerà lo stato "DOWN" poiché non è possibile eseguire il ping. In questo caso devi utilizzare la regola "Setup > Hosts > Host monitoring rules > Host check command" per determinare come verificare se l'host deve essere valutato come "UP". |
Con l'opzione Checkmk agent connection mode decidi se l'agente Checkmk deve funzionare in modalità pull o in modalità push.
Questa opzione è disponibile solo in
Checkmk Ultimate, poiché la modalità push è supportata solo in questa edizione.
A proposito, questa opzione è disponibile anche in
Checkmk Ultimate nelle proprietà di una cartella e viene utilizzata lì per consentire la creazione automatica degli host tramite la registrazione automatica.
Se qui selezioni "Push - Checkmk agent contacts the server", imposta inoltre "IP address family" su "No IP" nella box "Network address".
Questo impedisce che l'accessibilità dell'host venga checkata tramite Smart Ping.
In tutte le altre edizioni, l'agente funziona in modalità pull.
Usa la seguente impostazione SNMP per configurare il monitoraggio tramite SNMP.
Dopo aver abilitato SNMP e selezionato la versione SNMP, appare il campo SNMP credentials, che ti permette di specificare la comunità SNMP.
Tuttavia, dato che di solito è la stessa per molti host, è più consigliabile memorizzare questa impostazione nella cartella.
Se non specifichi nulla, viene automaticamente assunto public.
L'ultimo campo Piggyback si riferisce all'uso dei dati piggyback, che vengono trasportati da altri host e assegnati come output dell'agente a questo host. Tieni presente che l'impostazione effettuata qui deve corrispondere alle impostazioni della prima opzione Checkmk agent / API integrations, altrimenti l'assenza dei dati di monitoraggio previsti potrebbe non essere rilevata. Per questo motivo, una voce è esplicitamente Always use and expect piggyback data.
3.4. Attributi personalizzati
Nella box "Custom attributes" puoi visualizzare qualsiasi campo di testo liberamente codificato che hai creato in precedenza come attributo personalizzato. Per impostazione predefinita, qui sono presenti "Labels" e i due gruppi di tag host predefiniti "Criticality" e "Networking Segment":

Puoi definire attributi personalizzati utilizzando Setup > Hosts > Custom host attributes.

Gli attributi personalizzati possono essere, ad esempio, un contatto in loco, un numero di filiale, informazioni sull'hardware, numeri di inventario o coordinate geografiche. I valori degli attributi personalizzati dovrebbero servire principalmente ad aiutare gli utenti a tenere traccia delle informazioni, ma possono anche essere utilizzati nelle regole e nei filtri quando, ad esempio, le etichette o i tag host sono troppo rigidi.
Gli attributi personalizzati possono essere assegnati a qualsiasi box nelle proprietà di un host selezionando "Topic" (tema).
3.5. Scheda di gestione della gestione
Il termine "scheda di gestione" indica schede plug-in separate o funzionalità BIOS estese (come Baseboard Management Controller/BMC, Management Engine/ME, Lights Out Management/LOM) per il monitoraggio e la gestione dell'hardware oltre al sistema operativo installato. Oltre alle funzioni di controllo e manutenzione remota (ad es. per il deployment dei sistemi operativi), tale hardware è solitamente dotato anche di un'interfaccia IPMI o SNMP, tramite la quale è possibile effettuare la visualizzazione dei valori relativi alla "salute" (ad es. temperature e velocità delle ventole).
Inserisci qui l'indirizzo IP e il metodo di accesso se l'host da monitorare dispone di una scheda di gestione:

Le schede di gestione non saranno più supportate come proprietà dell'host in una futura versione di Checkmk. Ti consigliamo quindi di creare le schede di gestione come host SNMP separati o, se disponibili, di effettuare il monitoraggio con special agents. |
3.6. Creazione / Blocco
Mentre la maggior parte dei dettagli descritti finora può essere modificata, la box "Creation / Locking" contiene dettagli che al momento hanno solo scopo informativo.

L'ora di creazione (Created at) e il creatore (Created by) sono determinati da Checkmk. Ci sono tre opzioni principali per il nome del creatore:
Nome utente, ad es. cmkadmin: l'host è stato creato manualmente da un utente, ad es. in Setup.
Nome utente automazione (nell'immagine sopra automation): l'host è stato creato da un utente automazione, ad esempio utilizzando l'API REST.
Scansione di rete: l'host è stato trovato durante una scansione automatica della rete.
Se l'host è stato creato da un utente automazione, verrà bloccato dall'istanza corrispondente (Locked by). Queste informazioni possono essere utilizzate anche durante la ricerca di host in Setup.
Locked attributes non può più essere modificato nelle proprietà dell'host.
3.7. Salvataggio e proseguimento
Quando crei o cloni un host, dopo aver impostato le proprietà, il passo logico successivo è Save & run service discovery. Questo ti porterà alla scoperta del servizio, che spiegheremo nel prossimo capitolo.
Al contrario, "Save & run connection tests" ti porta al test di connessione. Questo ti permette di verificare innanzitutto se stai ricevendo dati dall'host con le impostazioni che hai specificato, sia tramite un agente che tramite qualsiasi altra configurazione precedente. Per i dettagli sul test di connessione, consulta l'articolo sugli agenti di monitoraggio.
3.8. Azioni massive
A volte potresti voler eseguire operazioni come eliminare, spostare, modificare o eseguire la scoperta del servizio per più host contemporaneamente. Checkmk dispone delle cosiddette "azioni massive" proprio per questo scopo.
Puoi trovare queste azioni nella pagina del menu "Hosts" di una cartella aperta, nella sezione "On selected hosts":

Le azioni si riferiscono sempre agli host che si trovano direttamente nella cartella visualizzata e che sono stati selezionati da te. Le caselle di controllo nella prima colonna dell'elenco degli host servono a questo scopo. Se clicchi sulla croce nel titolo della colonna, tutti gli host verranno selezionati; cliccandoci di nuovo, verranno deselezionati.
Ecco alcune note sulle azioni disponibili:
-
Edit attributes: Modifica uno o più attributi degli host. L'attributo viene così inserito esplicitamente negli host.
Attenzione: c'è una differenza tra un host che eredita un attributo da una cartella e uno che lo ha impostato esplicitamente, come con questa azione. Perché? Nel secondo caso, modificare gli attributi nella cartella non avrà alcun effetto, poiché i valori impostati direttamente sull'host avranno sempre la precedenza. Per questo motivo, c'è anche l'azione seguente.
Run bulk service discovery: Esegue una scoperta del servizio per più host contemporaneamente.
Move to other folder: Sposta gli host in un'altra cartella. Dopo aver selezionato questa voce, le cartelle esistenti vengono suggerite come possibili destinazioni.
Detect network parent hosts: Fai creare i genitori tramite una scansione.
-
Remove explicit attribute settings: Rimuove gli attributi espliciti dagli host e ripristina l'ereditarietà. Otterresti lo stesso risultato selezionando ogni host singolarmente e deselezionando le box relative agli attributi in questione.
In generale, è consigliabile utilizzare il minor numero possibile di attributi espliciti. Se tutto viene ereditato correttamente attraverso le cartelle, questo evita errori e rende più comodo aggiungere nuovi host.
Remove TLS registration: Rimuove la registrazione per la comunicazione crittografata tramite Transport Layer Security (TLS). Puoi trovare ulteriori informazioni su questo tema negli articoli sull'agente Linux e sull'agente Windows.
Delete hosts: Elimina gli host — dopo aver confermato la richiesta.
4. Rimozione automatica degli host
Puoi far rimuovere automaticamente gli host che non esistono più dall'ambiente di configurazione e dall'ambiente di monitoraggio. Con la rimozione automatica viene eliminata anche la relazione di fiducia reciproca (mTLS), il che significa che, in caso di ricomparsa di un host, la procedura di registrazione dovrà essere eseguita nuovamente.
Il criterio utilizzato per decidere se un host è effettivamente ancora presente è lo stato del servizio Check_MK. Questo servizio è responsabile dello stato dell'agente di monitoraggio in esecuzione sull'host durante il funzionamento. Se non c'è più una connessione all'agente — e quindi nessun dato di monitoraggio attuale — il servizio switcherà allo stato CRIT.
Gli host il cui servizio Check_MK è rimasto in stato CRIT per un determinato periodo di tempo possono essere rimossi automaticamente. Questo si fa con l'Automatic host removal rule,, che trovi alla voce Setup > Hosts > Host monitoring rules. La regola è semplice. Devi solo definire il periodo di tempo durante il quale il servizio Check_MK deve rimanere nello stato CRIT prima che l'host associato venga rimosso:

Per rimuovere gli host non solo dal Setup ma anche dal monitoraggio, le modifiche vengono attivate automaticamente. Tieni presente che durante l'attivazione automatica verranno attivate anche tutte le altre modifiche in sospeso.
Questa regola è disponibile in tutte le edizioni di Checkmk.
Tuttavia, si adatta particolarmente bene come controparte dell’opzione di creazione automatica degli host, inclusa nell’ambito delle funzioni di Checkmk Ultimate.
Se vuoi che gli host creati automaticamente vengano rimossi automaticamente,
puoi limitare la condizione della regola agli host con l’etichetta dell’host “ |
Tieni presente che la gestione dinamica degli host offre anche l'opzione di rimuovere automaticamente gli host. Entrambe le opzioni per la gestione del ciclo di vita funzionano indipendentemente l'una dall'altra, ovvero un host verrà rimosso se viene soddisfatta una delle due condizioni.
5. Configurazione dei servizi
Il passo successivo alla creazione di un host è configurare i servizi da monitorare su di esso. Puoi trovare tutti i dettagli relativi al rilevamento automatico e alla configurazione dei servizi nell'articolo Comprendere e configurare i servizi. Qui descriveremo solo i punti più importanti.
Puoi accedere all'elenco dei servizi configurati di un host nei seguenti modi:
In Setup, tramite l'elenco degli host:
Seleziona "Setup > Hosts > Hosts." Nell'elenco degli host, clicca su "
".In Setup, tramite le proprietà di un host:
Seleziona "Setup > Hosts > Hosts." Nell'elenco degli host, clicca sull'host desiderato. Nella pagina "Properties of host", seleziona "Host > Save & run service discovery." Se invece selezioni "Host > Run service discovery" dal menu, verrai reindirizzato all'elenco dei servizi, ma senza salvare le proprietà dell'host.Nel monitoraggio, tramite l'elenco dei servizi di un host:
Seleziona il menu "Host" e, nella sezione "Setup", seleziona la voce "Run service discovery". Un piccolo simbolo a forma di ingranaggio accanto all'icona indica che questa voce di menu porta a una pagina nella configurazione. Questo ti porterà direttamente alla configurazione del servizio.
Qualunque metodo tu scelga, il risultato dovrebbe essere simile a questo:

Le azioni più importanti sono disponibili nella barra delle azioni, mentre le altre si trovano nel menu "Actions". Alcune note sulle azioni possibili:
Il pulsante "Accept all" è solitamente l'azione migliore per un nuovo host. Questa è anche la scelta giusta per gli host esistenti in cui si trovano servizi che al momento non vengono monitorati. Questi si trovano nella sezione "Undecided services (currently not monitored) section". "Accept all" aggiunge i servizi mancanti, rimuove quelli scomparsi e accetta eventuali etichette dell'host trovate.
Il pulsante "Rescan" assicura che vengano recuperati dati aggiornati e completi dal dispositivo di destinazione. Per consentire un caricamento più veloce della pagina, Checkmk utilizza file memorizzati nella cache che vengono registrati durante il normale monitoraggio. Per i dispositivi SNMP, il pulsante avvia quindi una ricerca attiva di nuovi plug-in di controllo e potrebbe anche trovare servizi aggiuntivi.
Il pulsante "Monitor undecided services" trasferisce i servizi corrispondenti al monitoraggio, ma senza trasferire le etichette dell'host.
Remove vanished services Rimuove i servizi che non esistono più. Questo è utile per i servizi che ricordano uno stato attuale al momento della scoperta (ad esempio, lo stato attuale delle porte dello switch o dei file system e dei loro mount point).
Dopo ogni modifica è necessario attivare le modifiche per renderle effettive.
6. Importazione di host da un file CSV
Se vuoi aggiungere un gran numero di host a Checkmk in un'unica operazione, puoi semplificare il compito importando gli host da un file CSV. Questo è particolarmente utile in due scenari di utilizzo:
Vuoi importare host da un altro sistema di monitoraggio che supporta l'esportazione in formati di dati strutturati. Puoi creare un file CSV da questo sistema di origine e utilizzare questo file per l'importazione nel sistema Checkmk di destinazione.
Vuoi creare molti nuovi host contemporaneamente. In questo caso, inserisci gli host in un foglio di calcolo Excel, quindi importa semplicemente questo elenco come file CSV.
Checkmk è piuttosto flessibile nell'importazione dei dati CSV. Nel caso più semplice, in ogni riga del file CSV hai semplicemente un nome host risolvibile tramite DNS:
myserver01
myserver02Puoi anche passare attributi aggiuntivi contemporaneamente durante un'importazione. Una panoramica di tutti gli attributi possibili è disponibile nella sezione successiva. Se il file CSV contiene i nomi degli attributi nella prima riga, Checkmk può persino assegnarli automaticamente. Checkmk è, per quanto possibile, tollerante nei confronti di ortografie non esatte (cerca di interpretare piccole variazioni). Ad esempio, nel file seguente, Checkmk può effettuare automaticamente la mappatura di tutte le colonne in modo corretto:
hostname;ip address;alias;agent;snmp_ds
lnx17.example.com;192.168.178.48;Webserver;cmk-agent;
lnx18.exmpl.com;192.168.178.55;Backupserver;cmk-agent;
switch47-11;;Switch47;no-agent;snmp-v2La procedura è la seguente:
Seleziona o crea una cartella in cui deve avvenire l'importazione.
Vai a questa cartella (Setup > Hosts > …) e nel menu Hosts seleziona la voce
Import hosts via CSV file.
Nella pagina seguente, usa Upload CSV File per caricare il file. In alternativa, seleziona Content of CSV File e copia il contenuto del file nella box di testo sotto l'elenco. Puoi eseguire immediatamente la scoperta del servizio sui host appena importati. Per farlo, seleziona l'opzione Perform automatic service discovery.

Cliccando su
Upload passerai alla pagina successiva:

In questo esempio non è necessario selezionare un delimitatore (Set field delimiter), poiché il punto e virgola è già stato interpretato correttamente. Checkmk riconosce automaticamente i delimitatori comuni, come il tabulatore o il punto e virgola. Seleziona qui l'opzione Has title line per riconoscere le intestazioni. Sotto Preview puoi vedere un'anteprima della nuova tabella.
Se il rilevamento automatico di una colonna non funziona correttamente, puoi anche selezionare manualmente l'attributo da assegnare.
Usa l'elenco corrispondente per farlo.
Per i tag host (quelle voci che iniziano con Tag), il file CSV deve contenere l'ID interno del tag (qui ad esempio cmk-agent e non il suo titolo Checkmk agent / API integrations visibile nella GUI).
Puoi vedere esattamente quali sono gli ID interni dei tag host in Setup > Hosts > Tags.
Per gli ID dei tag predefiniti (builtin), consulta la tabella nell'articolo che descrive i tag host.
Avvia l'importazione cliccando su
Import.
Se hai selezionato l'opzione Perform automatic service discovery, verrai reindirizzato alla pagina Rilevamento massivo dei servizi e dovrai comunque modificarla.
Una volta completata la scoperta del servizio, non resta che attivare le modifiche come al solito, dopodiché tutti i nuovi host saranno nel monitoraggio.
6.1. Panoramica degli attributi da importare
| Attributo | Descrizione |
|---|---|
|
Nome dell'host (massimo 240 caratteri) |
|
Nome alias dell'host |
|
Istanza su cui viene effettuato il monitoraggio di questo host |
|
Indirizzo IPv4 |
|
Indirizzo IPv6 |
|
Comunità SNMP |
|
Tag: Criticità |
|
Tag: Segmento di rete |
|
Tag: Agente Checkmk / Integrazione API |
|
Tag: Piggyback |
|
Tag: SNMP |
|
Tag: Famiglia di indirizzi IP |
7. Eseguire una scansione di rete alla ricerca di cartelle
7.1. Il principio
Checkmk offre la possibilità di eseguire scansioni automatiche e regolari della tua rete — o solo di parti di essa — alla ricerca di host (nuovi). Questa scansione di rete viene configurata al livello di cartella nell'amministrazione host di Checkmk. Ogni minuto viene eseguito in background un cronjob. Questo checka tutte le cartelle per verificare se è prevista un’altra scansione. Il cronjob checka le due impostazioni Scan interval e Time allowed. Se questo intervallo di tempo è scaduto e il server rientra nel tempo consentito per la scansione, questa verrà avviata. Pertanto, una scansione di rete appena configurata inizierebbe entro un minuto dal clic su Save, a condizione che tu non abbia modificato l’Time allowed.
Una volta avviata la scansione, in pratica succedono tre cose:
Checkmk determina innanzitutto gli indirizzi IP da scansionare. Dagli intervalli di indirizzi configurati, vengono rimossi tutti gli indirizzi già in uso in qualsiasi cartella delle configurazioni dei tuoi host.
Gli indirizzi identificati verranno ora sottoposti a ping. Se c'è una risposta a questo ping su un indirizzo, si tenta di determinare un nome host.
Infine vengono creati gli host nella cartella. Tutti gli host con nomi già esistenti sull'istanza verranno omessi.
7.2. Configurazione di una scansione di rete
Come menzionato sopra, la scansione di rete viene configurata al livello di cartella. Per prima cosa apri Setup > Hosts > Hosts. Poi vai in una cartella qualsiasi o resta nella cartella Main.. Tramite il menu Folder > Properties troverai la box Network Scan.

Abilita la scansione di rete utilizzando la checkbox corrispondente.

Quindi, in IP ranges to scan, specifica gli indirizzi IP che Checkmk dovrebbe monitorare automaticamente per te.
Per questa definizione puoi scegliere tra singoli indirizzi IP, intervalli di IP e intere reti.
Ti consigliamo di non selezionare un intervallo di indirizzi troppo ampio, altrimenti la scansione di rete potrebbe richiedere molto tempo.
Quando scegli una rete, ti consigliamo inoltre di non superare la netmask di /21, che corrisponde a 2048 indirizzi IP.
Non dovresti superare il numero di 2048 indirizzi IP nemmeno quando selezioni tramite IP-Range.
Naturalmente, questa può essere solo una raccomandazione approssimativa, poiché la rete della tua organizzazione potrebbe essere in grado di gestire intervalli di indirizzi più ampi senza alcun problema.
L'opzione IP ranges to exclude che segue ti permette di escludere parti dall'intervallo di indirizzi configurato sopra. Questa opzione è utile anche per escludere dalla scansione di rete host o indirizzi IP già noti e sottoposti a monitoraggio. In questo modo, puoi evitare che vengano creati host duplicati.
Le due opzioni seguenti, Scan interval e Time allowed, ti consentono di specificare la frequenza con cui la scansione deve essere eseguita e a che ora desideri consentirla.
Una delle considerazioni più importanti quando si configura la scansione di rete è come handle gli host che vengono trovati. L'opzione "Set criticality host tag" gioca un ruolo centrale in questo caso:
Per impostazione predefinita, è selezionata l'opzione "Do not monitor this host". Ciò significa che gli host individuati vengono inclusi solo nella gestione degli host per il momento. Non viene effettuato alcun monitoraggio effettivo. Un approccio potrebbe essere quello di spostare manualmente gli host individuati nella tua struttura di host esistente, ad esempio utilizzando la funzione "Move this host to another folder". Dopo lo spostamento, dovrai personalizzare o rimuovere il tag host "Criticality". Se hai un numero elevato di host, puoi utilizzare la funzione "Remove explicit attribute settings" in Setup > Hosts > Hosts.
Se invece selezioni Productive system come tag host qui, gli host trovati — se configurati correttamente con il set di regole Periodic service discovery — saranno inclusi direttamente nel monitoraggio.
Prima di utilizzare la scansione di rete, tieni presente anche le seguenti considerazioni di base:
La scansione viene eseguita tramite un ping. Ciò significa anche che i dispositivi SNMP che possono essere monitorati solo tramite SNMP potrebbero essere rilevati, ma non saranno monitorati automaticamente perché l'SNMP credentials non sarà stato configurato.
Per i nuovi host Windows, la cosiddetta Echo Request sarà disattivata nel firewall a meno che non sia stata definita una configurazione corrispondente, ad esempio tramite policy di gruppo. Tali host Windows non risponderanno quindi alla scansione e non verranno individuati.
Checkmk può fornirti dati puliti per gli host che trova solo se la tua rete e il tuo sito sono configurati di conseguenza. Voci in conflitto nel DNS e nel tuo sito Checkmk possono portare a duplicazioni. Si crea un duplicato quando un host con un nome (ma senza un indirizzo IP) è già stato configurato in Checkmk e ora viene trovato con un nome diverso tramite il suo indirizzo IP.
8. Ricerca degli host in Setup
Checkmk offre un modo pratico per effettuare ricerche nell'ambiente di monitoraggio (nel menu Monitor) e nell'ambiente di configurazione (nel menu Setup). I risultati di queste ricerche potrebbero differire perché gli host nell'ambiente di monitoraggio non sono necessariamente gli stessi dell'ambiente di configurazione; ad esempio, se hai creato un host in Setup senza abilitare questa modifica, esso non sarà (ancora) presente nel monitoraggio.
Esiste un altro modo per cercare gli host nell'ambiente di configurazione, che presenta i seguenti vantaggi:
Puoi cercare gli host in base a una varietà di criteri.
Gli host trovati sono elencati in una pagina dei risultati da cui puoi avviare le azioni massive, come descritto in precedenza in questo articolo.
Puoi trovare questa ricerca sotto "Setup > Hosts > Hosts" nella pagina di una cartella aperta nel menu "Display > Search hosts". Una ricerca di questo tipo parte sempre dalla cartella corrente, in modo ricorsivo in tutte le sue sottocartelle. Per effettuare una ricerca globale, basta avviare la ricerca dalla cartella "Main":

Per il campo Host name viene utilizzata una ricerca parziale (ricerca infissa): il testo inserito viene cercato, in qualsiasi posizione, nel nome host. Inoltre, puoi limitare la ricerca utilizzando altri attributi. Tutte le condizioni sono collegate con AND. Quindi l'esempio della schermata sopra cerca tutti gli host con my nel nome e che hanno anche il tag Test system.
Si avvia la ricerca con Submit. La pagina dei risultati può essere gestita quasi come una normale cartella. Ciò significa che qui puoi utilizzare le azioni massive disponibili nel menu Hosts nella sezione On selected hosts, ad esempio per spostare tutti gli host trovati in una cartella specifica.
Puoi personalizzare e affinare ulteriormente la ricerca nella pagina dei risultati su Refine search.
9. Rinominare gli host
Rinominare gli host può sembrare un'operazione semplice a prima vista, ma a un esame più attento si rivela piuttosto complessa. Il motivo è che Checkmk utilizza il nome dell'host come chiave univoca per l'host stesso, e lo fa in numerosi contesti. Ciò include nomi di file, dati di log, regole, dashboard, rapporti, aggregazioni BI e altro ancora. Il nome di un host compare anche negli URL.
Checkmk offre due funzioni nell'Setup per rinominare in modo pulito un host in tutte le sue occorrenze. Puoi rinominare un singolo host (nelle proprietà dell'host nel menu "Host > Rename") oppure rinominare più host in una cartella contemporaneamente (nel menu "Hosts > Rename multiple hosts").
Quando si apportano modifiche a più host e in più posizioni, è sempre possibile che qualcosa vada storto. Pertanto, assicurati di avere un backup aggiornato della tua istanza prima di avviare l'operazione di rinominazione. |
L'Bulk renaming of hostse consente la corrispondenza simultanea e sistematica dei nomi per più host:

Nel campo "Host name matching", specifica prima, se lo desideri, un'espressione regolare che corrisponda all'inizio dei nomi host che vuoi rinominare — quindi, in questo esempio, tutti gli host i cui nomi iniziano con lnx.
Poi aggiungi una o più operazioni con "Add renaming". Queste vengono applicate in sequenza ai nomi host.
Nell'esempio sopra, prima "Drop Domain Suffix" tronca tutto ciò che segue il primo . da tutti i nomi host, e poi "Add Suffix" aggiunge il suffisso -linuxserver ai nomi.
Sono disponibili ulteriori operazioni, la maggior parte delle quali sono intuitive. In alternativa, puoi ottenere ulteriori informazioni tramite l'aiuto in linea.
Dopo aver avviato la procedura di rinominazione con
Bulk rename e aver confermato la domanda obbligatoria "Sei sicuro…?" …

… il completamento del processo potrebbe richiedere un po' di tempo. Durante il processo di rinominazione il monitoraggio verrà completamente interrotto! Questo è necessario per mantenere tutto in uno stato coerente. Al termine del processo otterrai una panoramica di dove esattamente sono state eseguite le rinominazioni:

10. Richieste API REST per host e cartelle
Puoi anche eseguire molte delle azioni descritte in questo articolo utilizzando l'API REST di Checkmk. Questo è particolarmente interessante se hai molti oggetti da gestire sull'istanza e desideri automatizzare le azioni. Ad esempio, puoi creare molti host utilizzando l'API REST ed evitare i potenziali errori che possono sempre verificarsi quando li inserisci manualmente tramite la GUI.
Se la riga di comando, gli script e le API non sono i tuoi strumenti preferiti, a questo punto è sufficiente sapere che questa API esiste. Questo ti offre uno strumento potente a cui ricorrere quando ne hai bisogno, come alternativa alla gestione tramite l'interfaccia web.
Consulta l'articolo sull'API REST per un'introduzione all'uso di questa API. Puoi trovare la documentazione di riferimento nell'interfaccia web del tuo sito Checkmk. Lì potrai familiarizzare con la sintassi delle richieste e la struttura delle risposte. Puoi accedere a tutte le voci importanti dell'API REST nell'interfaccia web di Checkmk tramite la barra di navigazione nel menu Help > Developer resources.
Infine, consulta l'articolo sull'API REST per esempi che spiegano come eseguire azioni su host e cartelle tramite la riga di comando, come visualizzare la struttura delle cartelle e gli host in una cartella, creare un host in una cartella specifica e altro ancora.
11. File e directory
| Percorso del file | Funzione |
|---|---|
|
In questa directory, la struttura delle cartelle nel Setup sotto la cartella Main viene effettuata una mappatura tramite una struttura di sottodirectory. Se viene creata una cartella nell'interfaccia GUI, viene creata anche una nuova directory nel file system. Qui Checkmk si assicura che i nomi delle directory siano univoci e che vengano utilizzati solo caratteri consentiti nel file system. Ad esempio, uno spazio viene sostituito da un trattino basso. |
|
File di configurazione per tutti gli host nella cartella Main. Per gli host nelle sottocartelle di Main, c'è un file con lo stesso nome in ogni sottodirectory. |
|
Questo file nascosto contiene il nome visualizzato nella GUI (Main) e tutte le altre proprietà di questa directory.
In ogni sottodirectory esiste un file |
