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. Introduction
Les paquets d'extension Checkmk (MKP) permettent de regrouper des extensions fonctionnelles ainsi que des extensions destinées à l'interface utilisateur graphique (GUI), c'est-à-dire des tableaux de bord, des vues ou des rapports.
L'avantage de cette fonctionnalité est que, dans les éditions commerciales, vous pouvez créer ces MKP directement depuis l'interface web, sans avoir besoin de fichiers ou d'outils externes.
Bien entendu, la ligne de commande est également disponible à cette fin, là encore exclusivement dans les éditions commerciales.
Les MKP peuvent ensuite être partagés en interne avec d'autres utilisateurs et installations Checkmk, et bien sûr via Checkmk Exchange. Mais même sans la participation de la communauté ou d'autres sites, il peut être utile de pouvoir regrouper des créations complexes.
Par exemple, si un tableau de bord est créé à l’aide de l’option « Make this dashboard available for other users », il sera également accessible à tous les utilisateurs ou à certains d’entre eux. Si des utilisateurs suppriment leurs tableaux de bord à un moment donné, ceux-ci sont bien sûr perdus pour tous les autres — à moins que d’autres n’en aient déjà fait des copies personnelles. C’est pourquoi il est judicieux que les utilisateurs disposant des droits appropriés puissent mettre les tableaux de bord à disposition sous forme d’extension.
Cela permet également la gestion des versions des tableaux de bord — ce qui est utile pour des mises à jour sans problème.
La procédure de création des MKP est identique pour tous les types d’extensions d’interface graphique ; nous nous limiterons donc à l’exemple de tableau de bord décrit ci-dessous.
Condition préalable : les utilisateurs doivent disposer de l’autorisation « Manage Extension Packages (MKPs) ».
2. Interface web
2.1. Création de MKP d'interface graphique
Commençons par la liste des tableaux de bord sous Customize > Visualization > Dashboards. Si vous avez déjà créé votre propre tableau de bord, vous pouvez l'utiliser. Sinon, créez une copie privée de n'importe quel tableau de bord intégré. Dans les deux cas, votre point de départ est un tableau de bord situé dans la section Customized.

Via
Clone this dashboard for packaging as extension package, vous créez une extension à partir du tableau de bord, qui sera ensuite ajoutée à la section Extensions :

À partir de là,
Go to extension packages vous mènera au gestionnaire de packs d'extensions.
Vous pouvez voir vos extensions non packagées, ou fichiers, sous Packages > List unpackaged files.

Via
Create Package, vous pouvez désormais créer le paquet.

Dans les propriétés du paquet, en bas sous Packaged files, ajoutez l'extension d'interface graphique que vous venez de créer.
Bien sûr, il peut également s'agir de plusieurs tableaux de bord ou d'autres éléments.
Sinon, le point principal auquel vous devez prêter attention est l'exactitude des informations de version.
Tout d’abord, le paquet lui-même doit comporter un numéro de version.
Celui-ci doit respecter les directives expliquées dans la gestion sémantique des versions, par exemple 1.0.0.
Ensuite, vous pouvez spécifier les versions minimales et maximales de Checkmk prises en charge.
La gestion des versions est utile pour les mises à jour de Checkmk et la supervision distribuée qui inclut des instances utilisant différentes versions de Checkmk (voir l’article MKP pour plus d’informations).
Une fois le packaging terminé, votre liste de nouveaux paquets sera affichée sur la page d'accueil des paquets d'extension — ici, dans notre exemple, en deux versions différentes, l'une activée, l'autre désactivée :

Sous « All packages (enabled or disabled) », vous avez désormais la possibilité de télécharger les paquets sous forme de fichiers MKP.
2.2. Installation du MKP d'interface graphique
L'installation des paquets est en grande partie intuitive.
Commencez par télécharger le paquet souhaité via
Upload package sous Setup > Maintenance > Extension packages.

Le paquet se retrouve alors à nouveau dans le tableau All packages (enabled or disabled) et peut être activé à partir de là via
.

3. Ligne de commande
3.1. Création de MKP d'interface graphique
Vous pouvez également effectuer le packaging à partir de la ligne de commande. La procédure est exactement la même que pour le packaging d'extensions fonctionnelles, comme décrit en détail dans l'article sur les MKP ; nous n'en présentons donc ici qu'une version abrégée :
Créez le tableau de bord.
Passez en ligne de commande en tant que utilisateur de l'instance.
Liste des fichiers non packagés :
mkp findCréez la configuration du paquet :
mkp template mydashboardModifiez la configuration dans :
~/tmp/check_mk/mydashboard.manifest.tempCréez le paquet avec :
mkp package tmp/check_mk/mydashboard.manifest.tempLe paquet est enregistré sous :
/var/check_mk/packages_local/mydashboard-1.0.0.mkp
3.2. Installation du MKP d'interface graphique
Si vous souhaitez maintenant installer et activer ces MKP :
Installer :
mkp add /tmp/mydashboard-1.0.0.mkpActiver :
mkp enable mydashboard-1.0.0.mkp
Pour les références d'instructions, une description du format MKP et d'autres remarques, consultez l'article sur les MKP.
Remarque
à l'attention des utilisateurs de Checkmk Community :
Une fois encore, vous pouvez installer les extensions d'interface graphique comme n'importe quel autre MKP.
Cependant, étant donné que les éditions commerciales contiennent certains éléments visuels exclusifs (tels que des dashlets), vous pourriez rencontrer un message du type suivant :
Dashlet type 'state_host' could not be found. Please remove it from your dashboard configuration.
Dans ce cas, un seul dashlet est manquant, mais le reste du tableau de bord reste utilisable.
4. Fichiers et répertoires
| Chemin d'accès au fichier | Description |
|---|---|
|
Répertoire de stockage des vues de la table clonées en tant qu'extensions. |
|
Emplacement de stockage des rapports clonés en tant qu'extensions. |
|
Emplacement des tableaux de bord clonés en tant qu'extensions. |
|
Fichier de configuration pour créer le package. |
|
Emplacement des MKP installés. |
|
Emplacement des MKP activés. |
