Checkmk
DeutschEnglish
master2.3.0
to checkmk.com

1. Introduzione

Se dovessi mai trovarti di fronte a problemi in Checkmk che — con l'aiuto di questo manuale — non riesci a risolvere da solo, puoi rivolgerti al supporto ufficiale di Checkmk e al forum di Checkmk, che rappresentano due ottimi punti di contatto. In entrambi i casi è ovviamente essenziale fornire una descrizione precisa dell'errore o del problema. Inoltre, alcune informazioni specifiche sul tuo ambiente Checkmk sono indispensabili per un'analisi e una soluzione rapide. Le informazioni più essenziali sono ovviamente la versione e l'edizione di Checkmk che stai utilizzando. A seconda della situazione, tuttavia, potrebbero essere necessarie molte più informazioni per poter arrivare al nocciolo del tuo problema. In passato, l'assistenza Checkmk ti diceva quali informazioni dovevi fornire.

Invece di ricevere dal supporto un "elenco dei desideri", che ti costringeva a una caccia al tesoro tra i vari componenti di Checkmk, con pochi clic nell'interfaccia grafica puoi creare un pacchetto di informazioni su misura — chiamato "dump" in questo articolo. Qui decidi tu stesso se includere o meno i file di configurazione che potrebbero contenere informazioni riservate e, in caso affermativo, specificare quali.

CEE Alcuni dei dati selezionabili sono disponibili solo nelle edizioni commerciali, ad esempio Performance Graphs of Checkmk Server, CMC (Checkmk Microcore) e Licensing information.

Important

Le informazioni che selezioni qui potrebbero contenere dati riservati. Procedi con cautela!
Important

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.

2. Raccogli le informazioni di supporto

2.1. Seleziona l'istanza

Dopo aver cliccato su Setup > Maintenance > Support diagnostics vedrai la seguente schermata:

Support diagnostics options.

Se stai utilizzando il monitoraggio distribuito, nel primo campo puoi specificare l'Site da cui desideri selezionare i dati da raccogliere per la raccolta.

2.2. Informazioni generali

Sotto General information troverai fondamentalmente solo un avviso che indica che le informazioni sulla versione di Checkmk e sul sistema operativo in uso saranno comunque incluse. Se lasci le cose così come sono — cioè non selezioni nessuna delle opzioni — e avvii la raccolta dei dati tramite Collect diagnostics, otterrai un file che contiene solo i seguenti dati:

general.json
{
    "arch": "x86_64",
    "core": "cmc",
    "edition": "cee",
    "os": "Ubuntu 22.04.5 LTS",
    "python_paths": [
        "/opt/omd/versions/2.4.0p18.cee/bin",
        "/omd/sites/mysite/local/lib/python3",
        ...
        "/omd/sites/mysite/lib/python3"
    ],
    "python_version": "3.12.11 (main, Dec 14 2025, 01:22:15) [GCC 14.2.0]",
    "time": 1768405446.6220105,
    "time_human_readable": "2026-01-14 16:44:06.622010",
    "version": "2.4.0p18"
}
Copia il contenuto del file negli appunti
Contenuto del file copiato con successo negli appunti!
L'accesso in scrittura agli appunti è stato negato!

Oltre al file general.json, Checkmk genera ulteriori file in questa impostazione standard con dati sulla performance quali il numero di host e servizi, l’hardware del server Checkmk, le variabili d'ambiente impostate nell’istanza, i nomi e le dimensioni dei file presenti nell’istanza e i moduli Python ivi installati con le relative versioni. La pagina Background job details, che si apre dopo aver cliccato su Collect diagnostics, mostra esattamente quali dati vengono raccolti.

2.3. Informazioni generali opzionali

Alla voce Optional general information troverai poi delle opzioni che puoi compilare in anticipo in base alla tua richiesta, o che potrebbero essere richieste esplicitamente dal personale di supporto.

Se selezioni qui Local Files and MKPs, Checkmk creerà anche una panoramica di tutti i file presenti nella directory ~/local/ dell'istanza. Questo può essere utile se le tue personalizzazioni locali sono incompatibili con un recente aggiornamento di Checkmk. Qui sono inclusi anche tutti gli MKP installati.

Selezionando "OMD Config" puoi aggiungere al dump le informazioni sulla tua configurazione di OMD. Queste corrispondono esattamente a ciò che otterresti dalla riga di comando con il comando omd config show.

omd_config.json
{
    "CONFIG_ADMIN_MAIL": "",
    "CONFIG_AGENT_RECEIVER": "on",
    "CONFIG_AGENT_RECEIVER_PORT": "8000",
    "CONFIG_APACHE_MODE": "own",
    "CONFIG_APACHE_TCP_ADDR": "127.0.0.1",
    "CONFIG_APACHE_TCP_PORT": "5000",
    "CONFIG_AUTOSTART": "off",
    "CONFIG_CORE": "cmc",
    "CONFIG_LIVEPROXYD": "on",
    "CONFIG_LIVESTATUS_TCP": "off",
    "CONFIG_LIVESTATUS_TCP_ONLY_FROM": "0.0.0.0 ::/0",
    "CONFIG_LIVESTATUS_TCP_PORT": "6557",
    "CONFIG_LIVESTATUS_TCP_TLS": "on",
    "CONFIG_MKEVENTD": "on",
    "CONFIG_MKEVENTD_SNMPTRAP": "off",
    "CONFIG_MKEVENTD_SYSLOG": "on",
    "CONFIG_MKEVENTD_SYSLOG_TCP": "off",
    "CONFIG_MULTISITE_AUTHORISATION": "on",
    "CONFIG_MULTISITE_COOKIE_AUTH": "on",
    "CONFIG_PNP4NAGIOS": "on",
    "CONFIG_TMPFS": "on"
}
Copia il contenuto del file negli appunti
Contenuto del file copiato con successo negli appunti!
L'accesso in scrittura agli appunti è stato negato!

Se selezioni la checkbox "Checkmk Overview", verranno incluse le informazioni generali su tutte le istanze in esecuzione sul tuo server Checkmk. Questo crea anche un elenco di tutte le versioni di Checkmk installate. E se il sito selezionato sopra è il nodo di un cluster, anche questo fatto verrà registrato qui.

Con l'opzione "Crash Reports", puoi aggiungere al dump gli ultimi rapporti sui crash delle varie categorie — ad esempio base, check, gui o rest_api. Ulteriori informazioni sui rapporti sui crash sono disponibili nell'articolo sulla programmazione dei plug-in di controllo basati su agenti. In Checkmk puoi trovare i rapporti sui crash alla voce "Monitor > System > Crash reports".

Dopo aver attivato Checkmk Log files o Checkmk Configuration files, hai la possibilità di rimuovere eventuali dati riservati da questa parte del pacchetto — tramite la selezione Pack only Low sensitivity files. Tutti i file che puoi selezionare qui provengono dalle directory ~/var/log/ o ~/etc/checkmk/ e dalle loro sottodirectory. Puoi vedere un elenco dettagliato direttamente sotto il menu a discesa. Con l’opzione Select individual files from list hai anche la possibilità di includere nel dump solo i file specificati.

Con questa opzione puoi anche vedere quali file hanno uno dei livelli di riservatezza Alto (H), ad esempio file con password, Medio (M), se contengono indirizzi o nomi utente, o infine Basso (L).

List of selectable files.
Tip

Per avere il maggior numero possibile di informazioni dettagliate sul comportamento di Checkmk nei file di log, potrebbe essere necessario modificare temporaneamente il livello di log in Checkmk. Le impostazioni corrispondenti si trovano all’indirizzo Setup > General > Global settings. In questa pagina, basta digitare logging nel campo Filter e poi impostare, ad esempio, il livello di log per l’Core su Debug. Se ora lasci semplicemente l'istanza in esecuzione per qualche minuto o se ripeti un errore riproducibile, aumentano le probabilità che le informazioni su questo errore compaiano nei file di log.

Successivamente, hai la possibilità di aggiungere "Performance Graphs of Checkmk Server" al dump. Soprattutto in caso di problemi con la performance di un'istanza Checkmk, questi rapporti vengono quasi sempre richiesti, quindi è una buona idea includerli in presenza di tali problemi. Il supporto e la diagnostica faranno il lavoro per te generando manualmente una serie di rapporti in formato PDF. Tra gli altri, vengono generati i rapporti del servizio "OMD mysite performance" relativi alle ultime 25 ore e agli ultimi 35 giorni.

2.4. Informazioni specifiche sui componenti

La sezione "Component specific information" ti permette ancora una volta di decidere in modo molto dettagliato quali informazioni delle tue impostazioni globali di Checkmk, dei tuoi host e cartelle e delle tue impostazioni di notifica devono essere incluse nel dump.

Important

A seconda della configurazione, i file che selezioni qui potrebbero contenere informazioni riservate, come le password. Durante il normale funzionamento, questi dati sono protetti dal fatto che solo l'utente dell’istanza e gli amministratori hanno accesso ad essi. Se rendi questi dati disponibili a terzi a scopo di analisi, dovresti procedere con molta cautela.

Nell'elemento "Global Settings" troverai tutti i file `global.mk` dei singoli componenti della tua istanza Checkmk, come il Dynamic Configuration Daemon (DCD) o il Livestatus Proxy Daemon.

Le informazioni che puoi selezionare tramite la sottosezione Hosts and Folders possono, tra le altre cose, aiutarti a individuare set di regole non ottimali ed errori nella configurazione dell'host.

Nella sezione "Notifications" troverai, oltre ai file di configurazione corrispondenti, un'opzione per la selezione dei file di log. In caso di difficoltà con le tue notifiche, tu — o in ultima analisi il supporto Checkmk — potrai spesso individuare la causa del problema in questi log.

Selection of files for the notifications.

Usa l'opzione "Business Intelligence" per selezionare i file di configurazione per Business Intelligence. Dopo aver attivato una delle opzioni "CMC (Checkmk Microcore)" o "Licensing information", hai nuovamente la possibilità di rimuovere dati più o meno riservati dalla rispettiva parte del pacchetto, tramite la selezione "Pack only Medium and Low sensitivity files" o "Pack only Low sensitivity files".

3. Supporto e diagnostica tramite riga di comando

Come spesso accade in Checkmk, questa operazione può essere eseguita semplicemente da un terminale. Puoi farlo facilmente con il comando cmk e l'opzione --create-diagnostics-dump. Per tutte le opzioni descritte sopra puoi aggiungere il parametro corrispondente al comando.

OMD[mysite]:~$ cmk --create-diagnostics-dump --local-files --omd-config --performance-graphs
Copia i comandi negli appunti
Comandi copiati con successo negli appunti!
L'accesso in scrittura agli appunti è stato negato!

Le seguenti opzioni completano l'output del comando:

--local-files

Elenco di tutti i file installati, non impacchettati e opzionali in ~/local/. Questo include anche informazioni sugli MKP installati.

--omd-config

Contenuto del file ~/etc/omd/site.conf.

--checkmk-crashes

Ultimo rapporto sui crash da ciascuna sottodirectory di ~/var/check_mk/crashes/.

--checkmk-overview H

Informazioni dal nodo di inventario HW/SW Software > Applications > Checkmk del server Checkmk. Per il parametro H , devi specificare il nome host del server Checkmk.

--checkmk-config-files FILE,FILE …​

File di configurazione dalla directory ~/etc/check_mk/. Tutti i file desiderati devono essere specificati esplicitamente, con tutti i nomi dei file relativi a ~/etc/check_mk/. Esempio: --checkmk-config-files main.mk,apache.d/wato/global.mk

--checkmk-log-files FILE,FILE …​

File di log (.log e .state) da ~/var/log/. Tutti i file desiderati devono essere specificati esplicitamente, con tutti i nomi dei file relativi a ~/var/log/. Esempio: --checkmk-log-files apache/error_log,update.log,web.log

--performance-graphs H

Grafici delle prestazioni (ad es. carico della CPU, utilizzo della CPU) del server Checkmk — disponibili solo nelle edizioni commerciali. Per il parametro H , devi specificare il nome host del server Checkmk.

Quanto sopra e tutte le altre opzioni del comando cmk si trovano, come al solito, nell'output di cmk --help.

4. Informazioni mancanti nel dump

4.1. Agente aggiornato richiesto

Per poter ottenere informazioni complete nel supporto e nella diagnostica, devi assicurarti che l'agente installato sui server Checkmk abbia lo stesso numero di versione del server Checkmk. In particolare, le informazioni provenienti dall'inventario HW/SW del server Checkmk potrebbero non essere ancora fornite dalle versioni precedenti dell'agente.

4.2. Etichetta l'cmk/check_mk_server:yes

Il supporto e la diagnostica dipendono dal fatto che i server Checkmk nel tuo ambiente siano etichettati in modo appropriato. Se ti mancano alcuni dati in un dump, controlla se i tuoi server Checkmk sono etichettati con l'etichetta cmk/check_mk_server:yes.

Last modified: Wed, 14 Jan 2026 15:52:09 GMT via commit 0f693d07f
In questa pagina