cmk-plugins/README.md

🔍 Checkmk Plugins

Sammlung eigener Plugins und Erweiterungen für Checkmk Community 2.5.x.

Die Erweiterungen werden für die eigene Monitoring-Umgebung entwickelt und getestet. Jedes Plugin besitzt einen eigenen Ordner mit Dokumentation, Source-Code und installierbarem MKP-Paket.

📦 Verfügbare Plugins

🔗 Remote Access

Direkter SSH- und RDP-Zugriff auf überwachte Hosts aus der Checkmk-Weboberfläche.

Aktuelle Version: 1.4.4

SSH für Linux-/Unix-Systeme   RDP für Windows-Systeme

• Automatische Betriebssystemerkennung über Checkmk Host Labels
• Verwendung der von Checkmk ermittelten Host-IP
• Integration in Setup → Hosts
• Integration in Checkmk Monitoring Views
• Eigene SSH- und RDP-Icons
• Direkter SSH-Aufruf über ssh://
• Direkter RDP-Aufruf über rdpadmin://

➡️ Dokumentation
📦 MKP-Paket

🖥️ OS Info

Zeigt Betriebssysteminformationen eines überwachten Hosts als eigenen Checkmk-Service an.

Aktuelle Version: 1.0.0

Linux   Windows   macOS

• Betriebssystem bzw. Distribution
• Version / Windows-Build
• Architektur
• Kernel-Version
• OS-ID und Version-ID

➡️ Dokumentation
📦 MKP-Paket

🛠️ Umgebung und Kompatibilität

Primär entwickelt und getestet mit:

• Checkmk Community Edition
• Checkmk 2.5.x
• Checkmk Agent 2.5
• Linux-Hosts
• Windows-Hosts

Die Kompatibilität mit anderen Checkmk-Versionen oder Editionen ist nicht grundsätzlich ausgeschlossen, wird aber nicht zwingend getestet.

📂 Repository-Struktur

cmk-plugins/
├── README.md
├── remote_access/
│   ├── README.md
│   ├── CHANGELOG.md
│   ├── packages/
│   └── src/
└── os-info/
    ├── README.md
    ├── CHANGELOG.md
    ├── PROJECT.md
    ├── LICENSE
    ├── dist/
    └── src/

Jedes Plugin wird unabhängig versioniert und dokumentiert.

📥 Installation von MKP-Paketen

Das gewünschte .mkp-Paket auf den Checkmk-Server übertragen und als Site-Benutzer installieren:

mkp add /pfad/zum/plugin.mkp
mkp enable PLUGIN_NAME VERSION

Je nach Plugin anschließend beispielsweise:

cmk -R

oder bei Web-Erweiterungen:

omd restart apache

Installierte Pakete anzeigen:

mkp list

Die plugin-spezifischen Installationsschritte stehen in der jeweiligen README.

🏷️ Releases und Versionierung

Die Plugins werden unabhängig voneinander versioniert. Git-Tags verwenden das Schema:

PLUGIN_NAME-vVERSION

Beispiele:

remote_access-v1.4.4
os_info-v1.0.0

🧑‍💻 Entwicklung

Der Source-Code befindet sich im jeweiligen Plugin-Verzeichnis unter src/. Die Verzeichnisstruktur orientiert sich möglichst an der späteren Struktur innerhalb der Checkmk-Site.

⚠️ Hinweise

Die Plugins wurden primär für die eigene Checkmk-Umgebung entwickelt. Vor dem Einsatz in produktiven Umgebungen sollte die jeweilige Erweiterung zunächst in einer Testumgebung geprüft werden.

👤 Autor

Domenik Bildhauer

⚖️ Lizenz

Die Lizenz ist im jeweiligen Plugin dokumentiert. Checkmk ist eine Marke der Checkmk GmbH.