Creazione automatica di host

I permessi necessari per registrare l'agente sul server Checkmk (per il trasferimento dati crittografato con TLS) e per creare host sono contenuti nel ruolo Agent registration user. I permessi per registrare nuovi host sono disponibili in questo ruolo solo in Checkmk Ultimate.

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

Ha senso utilizzare questo utente automazione per la registrazione automatica, che non è autorizzato a fare altro che registrare host.

Gli host creati automaticamente devono essere inseriti 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. Assegna un nome alla nuova cartella nella box Basic settings.

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

Nella box "Monitoring agents" che segue, specifichi due opzioni importanti 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 in Checkmk Ultimate. Infine, in "Bake agent packages", attiva la 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 tutti gli host che contiene, nonché per eventuali host che potrebbero essere aggiunti a questa cartella in futuro.

Completa la creazione della cartella con "Save".

La decisione su quali host possono registrarsi automaticamente, quali nomi vengono loro assegnati e cosa succede loro dopo la registrazione, viene presa in Checkmk — non a caso — tramite regole. Le etichette con cui l’agente dell’host si registrerà giocano un ruolo decisivo in questo. Ma andiamo con ordine.

Il set di regole di Agent registration è disponibile solo in Checkmk Ultimate. Puoi trovare Agent registration all’indirizzo 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 nella prima box Properties , come di consueto in Checkmk, prima un ID e un titolo.

Nella box successiva Matching criteria, specifichi quali etichette devono essere accettate quando il server Checkmk riceve una richiesta di registrazione da un agente. Queste etichette agente sono utilizzate esclusivamente per la registrazione automatica e sono diverse dalle etichette altrimenti utilizzate in Checkmk per identificare host e servizi. Due etichette agente sono fornite dall’agente Checkmk e possono essere selezionate dall’elenco: cmk/os-family contiene il sistema operativo dell’host che può essere utilizzato, ad esempio, per archiviare gli host in cartelle diverse. cmk/hostname-simple contiene il nome host senza la componente di dominio (quindi simple) che serve a designare un nome host univoco in Checkmk. Non esiste un'etichetta agente con un nome di dominio completo (FQDN), poiché l'FQDN non è una proprietà dell'host, ma della rete. Puoi anche inserire le tue etichette personalizzate con Custom label.

La coppia chiave-valore separata da due punti che compone un'etichetta (ad es. cmk/os-family:linux) viene valutata separatamente. In questo modo puoi specificare esplicitamente che una chiave (ad es. cmk/os-family) deve esistere (Exists), non deve 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 agenti, queste saranno collegate logicamente con AND. Nell'esempio seguente, oltre all'etichetta predefinita cmk/hostname-simple, va controllata anche l'etichetta personalizzata my_autoregister_label:

Nella box successiva, Action, decidi cosa deve succedere quando la valutazione delle etichette ha effetto: creare l'host o meno. Se selezioni Stop and do not create hosts, la valutazione della regola è completa e le due box successive non sono più rilevanti. Nel nostro esempio, però, gli host devono essere creati:

Nella box "Host name computation" (Nome host), ora specifichi quale nome deve ricevere l'host. Nella box "Host name template" (Modello), inserisci il modello. Qui puoi usare le macro per leggere i valori effettivi dalle etichette agenti che hai selezionato nella box "Matching criteria" (Etichette agenti) sopra — con "$cmk/hostname-simple$", ad esempio, il semplice nome host fornito dall'agente Checkmk. Se lo desideri, puoi poi modificare il modello convertendo le lettere maiuscole in minuscole o viceversa, e sostituendo i valori con espressioni regolari e nomi host espliciti. Queste sono, tra l’altro, le stesse opzioni disponibili nella personalizzazione dei nomi degli host piggybacked. Maggiori informazioni sono disponibili anche nell’aiuto in linea.

Infine, nella box Host creation, seleziona la cartella predefinita in cui devono essere inseriti i nuovi host. Inoltre, puoi specificare gli attributi da assegnare 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 l'Agent labels simulator. Se hai definito molte regole, il simulatore ti aiuterà a tenerne traccia. Puoi inserire le etichette agenti e, con l'Try out, simulare se e quale regola si applica quando viene inviata un'etichetta agente. I risultati ti mostreranno i simboli colorati del semaforo come descritto nell'articolo sulle regole.

Dopo aver configurato l'istanza Checkmk nella sezione precedente, ora ci occupiamo del Checkmk Agent Controller. Per farlo, utilizza il set di regole "Agent controller auto-registration" nell'agent bakery, disponibile solo in Checkmk Ultimate. Puoi trovare il set di regole nell'agent bakery alla voce "Agent rules" oppure, in modo più rapido, cercandolo nel menu "Setup". Crea una nuova regola.

Nella box "Agent controller auto-registration", fornisci all'Agent Controller tutte le informazioni necessarie per inviare 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'utente automazione per la registrazione automatica (Authorization) e il sito Checkmk (Site to register with) che deve monitorare l'host. In un monitoraggio distribuito, questo sarà solitamente una istanza remota.

Qui puoi anche definire le tue 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 in Custom label nella regola per l'istanza Checkmk: nell'esempio, l'etichetta personalizzata creata in precedenza con la chiave my_autoregister_label.

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

Importante: per l'ultima box in questa regola, Conditions, seleziona nuovamente la cartella predefinita come Folder.

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

Il pacchetto dell'agente deve ora essere installato su ogni host che deve avviare la registrazione automatica. Esegui lo scaricamento del pacchetto dell'agente appropriato per il sistema operativo dell'host e installa il pacchetto sull'host. La procedura è la stessa di sempre in agent bakery. Per ulteriori informazioni, consulta gli articoli sugli agenti di monitoraggio, l'agente Linux e l'agente Windows.

Dopo aver installato il pacchetto dell'agente, l'Agent Controller valuta il file pre_configured_connections.json sull'host ed emette il comando di registrazione per una connessione in esso contenuta. Se l'Agent Receiver accetta questo comando, la connessione verrà stabilita e l'host creato nell'istanza Checkmk.

Viene quindi eseguita la 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 eventuali altre modifiche accumulate, anche da parte di altri utenti.

Questo processo può richiedere diversi minuti (fino a 5) dall’installazione del pacchetto dell’agente fino a quando l’host non appare nel monitoraggio. Puoi seguire i singoli passaggi di questo processo in Setup > General > Audit log dopo aver selezionato il file wato_audit.log.

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

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