 |
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
I pacchetti di estensioni di Checkmk (MKP) possono contenere sia estensioni funzionali che estensioni per l'interfaccia grafica (GUI), cioè dashboard, visualizzazioni o report. Il vantaggio di questa funzione è che nelle edizioni commerciali è possibile creare tali MKP direttamente dall'interfaccia web e non sono necessari file o strumenti esterni. Naturalmente, a questo scopo è disponibile anche la linea di comando, anch'essa esclusivamente nelle edizioni commerciali.
Gli MKP possono poi essere condivisi internamente con altri utenti dell'istanza Checkmk e naturalmente tramite Checkmk Exchange. Ma anche senza la partecipazione della comunità di Checkmk o di altre istanze, può essere utile poter confezionare creazioni complesse.
Ad esempio, se un dashboard viene creato utilizzando l'opzione Make this dashboard available for other users, sarà disponibile per tutti gli utenti o per alcuni utenti selezionati. Se gli utenti cancellano i loro dashboard a un certo punto, ovviamente li perdono per tutti gli altri, a meno che non ne abbiano già fatto una copia personale. Per questo motivo, per gli utenti con i diritti appropriati, ha senso rendere disponibili i dashboard come estensione.
In questo modo è anche possibile creare delle versioni dei dashboard, utili per aggiornare i dati senza problemi.
La procedura di creazione degli MKP è identica per tutti i tipi di estensioni GUI, quindi ci limiteremo all'esempio di dashboard descritto di seguito.
Prerequisiti: Gli utenti devono ottenere il permesso Manage Extension Packages (MKPs).
2. Interfaccia web
2.1. Creazione di GUI-MKP
Iniziamo dall'elenco delle dashboard in Customize > Visualization > Dashboards. Se hai già creato una tua dashboard, puoi lavorare con quella. Altrimenti, crea una copia privata di una qualsiasi dashboard integrata. In entrambi i casi, il punto di partenza è una dashboard nella sezione Customized.
Tramite Clone this dashboard for packaging as extension package crei un'estensione dalla dashboard, che verrà successivamente elencata nella sezione Extensions:
Da qui, Go to extension packages ti condurrà alla gestione dei pacchetti delle estensioni, dove potrai vedere le tue estensioni non pacchettizzate, o i tuoi file, alla voce Packages > List unpackaged files.
Tramite Create Package puoi ora creare il pacchetto.
Nelle proprietà del pacchetto, in basso sotto Packaged files, aggiungi l'estensione GUI che hai appena creato. Naturalmente, questa può essere costituita anche da più dashboard o altri elementi. Per il resto, la cosa principale a cui devi prestare attenzione è la corretta informazione sulla versione. Innanzitutto, il pacchetto stesso ha bisogno di un numero di versione.
Questo deve seguire le linee guida spiegate in Semantic Versioning, ad esempio 1.0.0. In secondo luogo, puoi specificare la versione minima e massima di Checkmk supportata. Il versioning è utile per gli aggiornamenti di Checkmk e per il monitoraggio distribuito che include istanze Checkmk con versioni diverse (vedi l'articolo MKP per maggiori informazioni).
Dopo l'impacchettamento, i nuovi pacchetti saranno elencati nella pagina iniziale dei pacchetti di estensione - nel nostro esempio in due versioni diverse, una attivata e una disattivata:
Alla voce All packages (enabled or disabled) hai la possibilità di scaricare i pacchetti come file MKP.
2.2. Installazione dei GUI-MKP
L'installazione dei pacchetti si spiega da sola: per prima cosa, carica il pacchetto desiderato tramite Upload package sotto Setup > Maintenance > Extension packages.
Il pacchetto finisce di nuovo nella tabella All packages (enabled or disabled) e da lì può essere attivato tramite .
3. Linea di comando
3.1. Creazione di GUI-MKP
In alternativa, puoi anche eseguire il confezionamento da linea di comando. La procedura è esattamente la stessa del confezionamento delle estensioni funzionali, come descritto in dettaglio nell'articolo sugli MKP, quindi qui viene presentata solo una versione ridotta:
Crea la dashboard.
Passa alla linea di comando come utente dell'istanza.
Elenco dei file non pacchettizzati:
mkp findCreare la configurazione del pacchetto:
mkp template mydashboardModifica la configurazione in:
~/tmp/check_mk/mydashboard.manifest.tempCrea il pacchetto con:
mkp package tmp/check_mk/mydashboard.manifest.tempIl pacchetto viene salvato come:
/var/check_mk/packages_local/mydashboard-1.0.0.mkp
3.2. Installazione dei GUI-MKP
Se ora vuoi installare e attivare questi MKP:
Installa:
mkp add /tmp/mydashboard-1.0.0.mkpAttiva:
mkp enable mydashboard-1.0.0.mkp
Per i riferimenti ai comandi, una descrizione del formato MKP e altre note, consulta l'articolo sugli MKP.
Nota per gli utenti di Checkmk Raw: anche in questo caso, puoi installare le estensioni dell'interfaccia grafica come tutti gli altri MKP. Tuttavia, poiché le edizioni commerciali contengono alcuni elementi visuali esclusivi (come le dashlet), potresti imbatterti in un messaggio del tipo seguente:
Dashlet type 'state_host' could not be found. Please remove it from your dashboard configuration.
In questo caso manca un singolo dashlet, ma il resto del dashboard è ancora utilizzabile.
4. File e directory
| Percorso del file | Descrizione |
|---|---|
|
Deposito per le visualizzazioni clonate come estensioni. |
|
Luogo di archiviazione per i report clonati come estensioni. |
|
Posizione per i dashboard clonati come estensioni. |
|
File di configurazione per la creazione del pacchetto. |
|
Posizione per gli MKP installati. |
|
Posizione per gli MKP attivati. |