 |
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. Introducción
Los paquetes de extensión de Checkmk (MKP) pueden empaquetar tanto extensiones funcionales como aquellas destinadas a la interfaz de usuario (GUI), es decir, dashboards, vistas de tabla o informes.
La ventaja de esta función es que, en las ediciones comerciales, puedes crear estos MKP directamente desde la interfaz web, sin necesidad de archivos ni herramientas externas.
Por supuesto, también puedes usar la línea de comandos para esto, aunque solo en las ediciones comerciales.
Los MKP se pueden compartir internamente con otros usuarios e instalaciones de Checkmk y, por supuesto, a través de Checkmk Exchange. Pero incluso sin la participación de la comunidad u otros sitios, puede resultar útil poder empaquetar creaciones complejas.
Por ejemplo, si se crea un dashboard utilizando la opción «Make this dashboard available for other users», también estará disponible para todos o para usuarios seleccionados. Si los usuarios borran sus dashboards en algún momento, estos se pierden para todos los demás, a menos que otros ya hayan hecho copias personales. Por eso tiene sentido que los usuarios con los derechos adecuados pongan los dashboards a disposición como una extensión.
Esto también permite el control de versiones de los dashboards, lo cual es útil para realizar actualizaciones sin problemas.
El procedimiento para crear MKP es idéntico para todos los tipos de extensiones de la GUI, así que nos limitaremos al ejemplo del dashboard que se describe a continuación.
Requisito previo: los usuarios necesitan el permiso «Manage Extension Packages (MKPs)».
2. Interfaz web
2.1. Creación de MKP de la GUI
Empecemos por la lista de dashboards en Customize > Visualization > Dashboards. Si ya has creado tu propio dashboard, puedes trabajar con ese. Si no, crea una copia privada de cualquier dashboard integrado. En ambos casos, tu punto de partida es un dashboard de la sección Customized.
A través de 
Clone this dashboard for packaging as extension package creas una extensión a partir del dashboard, que posteriormente aparecerá en la sección Extensions:
Desde aquí, 
Go to extension packages te llevará al administrador de paquetes de extensiones.
Puedes ver tus extensiones sin empaquetar, o archivos, en Packages > List unpackaged files.
A través de 
Create Package ya puedes crear el paquete.
En las propiedades del paquete, en la parte inferior, en Packaged files, añade la extensión GUI que acabas de crear.
Por supuesto, también pueden ser varios dashboard u otros elementos.
Por lo demás, lo principal a lo que debes prestar atención es a la información correcta de la versión.
En primer lugar, el propio paquete necesita un número de versión.
Este debe seguir las directrices explicadas en Semantic Versioning, por ejemplo 1.0.0.
En segundo lugar, puedes especificar las versiones mínimas y máximas de Checkmk compatibles.
El control de versiones resulta útil para las actualizaciones de Checkmk y la monitorización distribuida, que incluye sitios con diferentes versiones de Checkmk (consulta el artículo de MKP para obtener más información).
Tras el empaquetado, tus nuevos paquetes estarán en la lista de paquetes de extensión —aquí, en nuestro ejemplo, en dos versiones diferentes, una activada y otra desactivada:
En All packages (enabled or disabled) ahora tienes la opción de descargar los paquetes como archivos MKP.
2.2. Instalación de MKP de GUI
La instalación de los paquetes es bastante intuitiva.
Primero, sube el paquete deseado a través de 
Upload package en Setup > Maintenance > Extension packages.
El paquete volverá a aparecer en la tabla de All packages (enabled or disabled) y, desde allí, podrás activarlo a través de 
.
3. Línea de comandos
3.1. Creación de MKP de GUI
Como alternativa, también puedes realizar el empaquetado desde la línea de comandos. El procedimiento es exactamente el mismo que para empaquetar extensiones funcionales, tal y como se describe en detalle en el artículo sobre MKP, por lo que aquí solo se presenta una versión resumida:
Crea el dashboard.
Switch a la línea de comandos como usuario del site.
Lista de archivos sin empaquetar:
mkp findCrea la configuración del paquete:
mkp template mydashboardEdita la configuración en:
~/tmp/check_mk/mydashboard.manifest.tempCrea el paquete con:
mkp package tmp/check_mk/mydashboard.manifest.tempEl paquete se guarda como:
/var/check_mk/packages_local/mydashboard-1.0.0.mkp
3.2. Instalación de MKP de GUI
Si ahora quieres instalar y activar estos MKP:
Instalar:
mkp add /tmp/mydashboard-1.0.0.mkpActivar:
mkp enable mydashboard-1.0.0.mkp
Para consultar los comandos, una descripción del formato MKP y otras notas, consulta el artículo sobre MKP.
Nota
para los usuarios de Checkmk Community:
Una vez más, puedes instalar extensiones GUI igual que cualquier otro MKP.
Sin embargo, dado que las ediciones comerciales contienen algunos elementos visuales exclusivos (como dashlets), es posible que te encuentres con un mensaje del tipo:
Dashlet type 'state_host' could not be found. Please remove it from your dashboard configuration.
En este caso, falta un solo dashlet, pero el resto del dashboard sigue siendo utilizable.
4. Archivos y directorios
| Ruta del archivo | Descripción |
|---|---|
|
Repositorio para vistas de tabla clonadas como extensiones. |
|
Ubicación de almacenamiento para los informes clonados como extensiones. |
|
Ubicación de los dashboards clonados como extensiones. |
|
Archivo de configuración para compilar el paquete. |
|
Ubicación de los MKP instalados. |
|
Ubicación de los MKP activados. |