 |
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 estensione Checkmk (MKP) possono contenere sia estensioni funzionali che estensioni per l'interfaccia grafica (GUI), ovvero dashboard, visualizzazioni o rapporti.
Il vantaggio di questa funzionalità è che nelle edizioni commerciali puoi creare tali MKP direttamente dall'interfaccia web, senza bisogno di file o strumenti esterni.
Naturalmente, anche la riga di comando è disponibile a questo scopo, sempre esclusivamente nelle edizioni commerciali.
Gli MKP possono quindi essere condivisi internamente con altri utenti e installazioni di Checkmk e, naturalmente, tramite Checkmk Exchange. Ma anche senza la partecipazione della community o di altre istanze, può essere utile poter creare pacchetti di creazioni complesse.
Ad esempio, se si crea una dashboard utilizzando l'opzione Make this dashboard available for other users, questa sarà disponibile anche per tutti o per utenti selezionati. Se gli utenti cancellano le loro dashboard a un certo punto, queste andranno ovviamente perse per tutti gli altri, a meno che altri non ne abbiano già fatto delle copie personali. Ecco perché ha senso che gli utenti con i diritti appropriati rendano disponibili le dashboard come estensione.
Questo permette anche la gestione delle versioni dei dashboard, utile per aggiornamenti senza problemi.
La procedura per creare gli MKP è identica per tutti i tipi di estensioni GUI, quindi ci limiteremo all'esempio della dashboard descritto di seguito.
Prerequisito: gli utenti devono disporre del permesso "Manage Extension Packages (MKPs)".
2. Interfaccia web
2.1. Creazione di MKP GUI
Iniziamo dall'elenco delle dashboard alla voce "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 puoi creare un'estensione dalla dashboard, che verrà successivamente elencata nella sezione Extensions:
Da qui, 
Go to extension packages ti porterà al gestore di pacchetti per le estensioni.
Puoi vedere le tue estensioni non ancora impacchettate, o i file, sotto Packages > List unpackaged files.
Tramite 
Create Package ora puoi creare il pacchetto.
Nelle proprietà del pacchetto, in fondo alla pagina Packaged files, aggiungi l'estensione GUI che hai appena creato.
Ovviamente, può trattarsi anche di più dashboard o altri elementi.
Altrimenti, la cosa principale a cui devi prestare attenzione sono le informazioni corrette sulla versione.
In primo luogo, il pacchetto stesso necessita di un numero di versione.
Questo deve seguire le linee guida spiegate nel Semantic Versioning, ad esempio 1.0.0.
In secondo luogo, puoi specificare le versioni minime e massime di Checkmk supportate.
Il versioning è utile per gli aggiornamenti di Checkmk e per il monitoraggio distribuito che include istanze con diverse versioni di Checkmk (vedi l’articolo MKP per maggiori informazioni).
Dopo la creazione dei pacchetti, il tuo elenco dei nuovi pacchetti sarà presente nella home page dei pacchetti di estensione — qui nel nostro esempio in due versioni diverse, una attivata e una disattivata:
Alla voce "All packages (enabled or disabled)" hai ora la possibilità di effettuare lo scaricamento dei pacchetti come file MKP.
2.2. Installazione degli MKP GUI
L'installazione dei pacchetti è in gran parte intuitiva.
Per prima cosa, carica il pacchetto desiderato tramite 
Upload package alla voce Setup > Maintenance > Extension packages.
Il pacchetto finisce quindi nuovamente nella tabella All packages (enabled or disabled) e da lì può essere attivato tramite 
.
3. Riga di comando
3.1. Creazione di MKP GUI
In alternativa, puoi anche eseguire il packaging dalla riga di comando. La procedura è esattamente la stessa del packaging delle estensioni funzionali, come descritto in dettaglio nell'articolo sugli MKP, quindi qui viene presentata solo una versione abbreviata:
Crea la dashboard.
Passa alla riga di comando come utente dell’istanza.
Elenca i file non impacchettati:
mkp findCrea 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 degli MKP GUI
Se ora vuoi effettuare l'installazione e attivare tali MKP:
Installazione:
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 MKP.
Nota
per gli utenti della Comunità Checkmk:
Anche in questo caso, puoi installare le estensioni GUI proprio come tutti gli altri MKP.
Tuttavia, poiché le edizioni commerciali contengono alcuni elementi visivi esclusivi (come i 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 della dashboard è comunque utilizzabile.
4. File e directory
| Percorso del file | Descrizione |
|---|---|
|
Archivio delle visualizzazioni clonate come estensioni. |
|
Posizione di archiviazione per i rapporti clonati come estensioni. |
|
Posizione dei dashboard clonati come estensioni. |
|
File di configurazione per creare il pacchetto. |
|
Posizione per gli MKP installati. |
|
Percorso per gli MKP attivati. |