Creazione automatica di host

I permessi necessari per registrare l'agente con il server Checkmk (per il trasferimento dei dati criptati TLS) e per creare host sono contenuti nel ruolo Agent registration user. I permessi per registrare nuovi host sono disponibili in questo ruolo solo a partire da Checkmk Cloud.

Questo ruolo è assegnato all'utente automazione agent_registration, che viene impostato in ogni istanza Checkmk e le cui proprietà possono essere visualizzate tramite Setup > Users > Users:

È opportuno utilizzare questo utente automazione per la registrazione automatica, che non può fare altro che registrare gli host.

Gli host creati automaticamente devono essere creati in una nuova cartella. In alternativa, puoi utilizzare una cartella esistente se la configuri come descritto di seguito.

Avvia la creazione di una cartella con Setup > Hosts > Hosts > Add folder.Dai un nome alla nuova cartella nel box Basic settings.

Il box Network address include l'opzione IP address family. Se vuoi che gli agenti Checkmk dell'host siano impostati per utilizzare la modalità pull, puoi lasciare invariato il valore predefinito IPv4 only. Per la modalità push, seleziona il valore No IP. Questo impedisce di verificare l'accessibilità dell'host tramite Smart Ping.

Nel box Monitoring agents seguente, specifichi due importanti opzioni per la registrazione automatica. Con Checkmk agent connection mode decidi se l'agente Checkmk deve funzionare in modalità pull o (come nell'immagine seguente) in modalità push. Questa opzione è disponibile solo a partire da Checkmk Cloud. Infine, in Bake agent packages, attiva il checkbox Bake a generic agent package for this folder. Questo ti permette di utilizzare l'Agent bakery, per creare una configurazione dell'agente per una cartella e per tutti gli host in essa contenuti, nonché per tutti gli host che potrebbero essere aggiunti a questa cartella in futuro.

Completa la creazione della cartella con Save.

La decisione su quali host sono autorizzati a registrarsi automaticamente, su quali nomi vengono assegnati e su cosa succede loro dopo la registrazione, viene presa in Checkmk - non a caso - con delle regole. Le etichette con cui l'agente dell'host si registrerà giocano un ruolo decisivo in questo senso, ma prima di tutto.

Il set di regole Agent registration è disponibile solo a partire da Checkmk Cloud. Puoi trovarlo sotto Setup > Agents (se la modalità Mostra di più è attiva) o cercando nel menu Setup. Inizia con Add rule la creazione di una nuova regola e assegna nel primo box Properties, come di consueto con Checkmk, prima un ID e un titolo.

Nel box successivo Matching criteria specifica quali etichette devono essere accettate quando il server Checkmk riceve una richiesta di registrazione da un agente. Queste etichette dell'agente sono utilizzate esclusivamente per la registrazione automatica e sono diverse dalle etichette altrimenti utilizzate in Checkmk per identificare host e servizi. L'agente Checkmk fornisce due etichette dell'agente che possono essere selezionate dall'elenco:cmk/hostname-simple contiene il nome dell'host senza il componente di dominio (da cui simple) che serve per la progettazione di un nome host univoco in Checkmk e cmk/os-family contiene il sistema operativo dell'host che può essere utilizzato, ad esempio, per archiviare gli host in cartelle diverse. Puoi anche inserire le tue etichette con Custom label.

La coppia chiave-valore separata dai due punti che compone un'etichetta (es. cmk/os-family:linux) viene valutata separatamente. In questo modo puoi specificare esplicitamente che una chiave (es. cmk/os-family) deve esistere (Exists), può non esistere (Does not exist) o è accettata solo con un determinato valore (Equals). Puoi anche inserire un'espressione regolare (Regex) come valore. Se definisci più etichette agente, queste saranno logicamente collegate tra loro con AND. Nell'esempio seguente, oltre all'etichetta predefinita cmk/hostname-simple, deve essere controllata anche l'etichetta personalizzata my_autoregister_label:

Nota: ogni host che è stato registrato con successo riceve automaticamente l'etichetta dell'host cmk/agent_auto_registered:yes aggiunta da Checkmk. Tuttavia, non puoi utilizzare questa etichetta in questo caso, perché non è un'etichetta agente e viene assegnata solo dopo la registrazione.

Nel box successivo, Action, stabilisci cosa deve succedere quando la valutazione delle etichette diventa effettiva: Se selezioni Stop and do not create hosts, la valutazione della regola è completa e i due box successivi non sono più rilevanti. Nel nostro esempio, tuttavia, gli host devono essere creati:

Nel riquadro Hostname computation, specifica il nome che dovrà ricevere l'host. Nel riquadro Hostname template, inserisci il modello. Qui puoi utilizzare delle macro per leggere i valori effettivi dalle etichette dell'host che hai selezionato nel riquadro Matching criteria - con $cmk/hostname-simple$, ad esempio, il semplice nome host fornito dall'agente Checkmk. Se lo desideri, puoi modificare il modello con la conversione in minuscolo o maiuscolo e con sostituzioni con espressioni regolari e con nomi host espliciti. Queste sono le stesse opzioni disponibili per personalizzare i nomi degli host piggyback. Maggiori informazioni sono disponibili anche nell'aiuto inline.

Infine, nel box Host creation, seleziona la cartella predefinita in cui devono finire i nuovi host. Inoltre, puoi specificare gli attributi che devono essere assegnati all'host. Puoi leggere ulteriori informazioni su questi attributi nell'articolo sull'amministrazione degli host.

Dopo aver salvato la regola, torna alla pagina Agent registration. Qui troverai la pagina Agent labels simulator. Se hai definito molte regole, il simulatore ti aiuterà a tenerne traccia. Puoi inserire le etichette per le regole e con Try out simulare se e quale regola si applica quando viene inviata un'etichetta agente. I risultati ti mostreranno i simboli semaforici colorati come descritto nell'articolo sulle regole.

Dopo aver configurato il sito Checkmk nella sezione precedente, ora ci occupiamo dell'Agent Controller. A questo scopo, si utilizza il set di regole Agent controller auto-registration nell'Agent Bakery, disponibile solo a partire da Checkmk Cloud. Puoi trovare il set di regole nell'Agent Bakery alla voce Agent rules oppure il modo più veloce è cercarlo nel menu Setup. Crea una nuova regola.

Nel box Agent controller auto-registration, fornisci all'Agent Controller tutte le informazioni necessarie per effettuare una richiesta di registrazione all'Agent Receiver: il server Checkmk (Monitoring server address), se applicabile, il numero di porta dell'Agent Receiver (Agent receiver port), l'istanza Checkmk (Site to register with) e l'utente dell'automazione per la registrazione automatica.

Puoi anche definire delle etichette personalizzate all'opzione Additional agent labels to send during registration. Affinché la registrazione automatica funzioni, queste etichette devono corrispondere a quelle che hai inserito alla voce Custom label nell'istanza Checkmk: nell'esempio, l'etichetta personalizzata creata in precedenza con la chiave my_autoregister_label.

Con l'ultima opzione Keep existing connections stabilisci se l'Agent Controller deve eliminare (no) o mantenere (yes) le connessioni già esistenti. Se hai configurato delle connessioni manuali ad altre istanze Checkmk oltre alla registrazione automatica di una connessione e vuoi mantenerle anche dopo un riavvio dell'Agent Controller cmk-agent-ctl, devi impostare questa opzione su yes.

Importante: Per l'ultimo box di questa regola, Conditions, seleziona nuovamente la cartella predefinita Folder.

Ora continua nella Agent bakery con Setup > Agents > Windows, Linux, Solaris, AIX. Clicca su e prepara un nuovo agente. Di conseguenza, oltre alla configurazione dell'agente Vanilla (factory settings), riceverai una nuova riga per la configurazione in cui è stata inserita la regola creata nella sezione precedente:

Il pacchetto agente deve essere installato su ogni host che deve avviare la registrazione automatica. Scarica il pacchetto agente appropriato per il sistema operativo dell'host e installalo sull'host. La procedura è la solita dell'Agent bakery. Per saperne di più, consulta gli articoli sugli agenti di monitoraggio, l'agente Linux e l'agente Windows.

Dopo aver installato il pacchetto dell'agente Checkmk, l'Agent Controller valuta il file /var/lib/cmk-agent/pre_configured_connections.json ed emette il comando di registrazione di una connessione in esso contenuta. Se l'Agent Receiver accetta il comando, la connessione viene impostata e l'host creato nell'istanza Checkmk.

Viene quindi eseguita una scoperta del servizio e le modifiche vengono attivate, in modo che l'host sia visibile anche nel monitoraggio. Tieni presente che durante l'attivazione automatica verranno attivate anche tutte le altre modifiche accumulate, anche da altri utenti.

Questo processo può durare diversi (fino a 5) minuti dall'installazione del pacchetto agente fino alla comparsa dell'host nel monitoraggio. Puoi seguire le singole fasi di questo processo in Setup > General > Audit log dopo aver selezionato il file wato_audit.log.

Sull'host puoi utilizzare un comando per visualizzare lo stato di connessione dell'Agent Controller, che si presenta così dopo una registrazione riuscita in modalità push:

Gli host creati automaticamente possono anche essere rimossi automaticamente. A partire da Checkmk Cloud, Checkmk fornisce i due componenti più importanti per la gestione del ciclo di vita degli host. Inoltre, la rimozione automatica funziona anche per gli host creati manualmente e in tutte le edizioni.