cmk-plugins/os-info/README.md

Checkmk OS Info

MKP-Erweiterung für Checkmk Community 2.5.x, die auf überwachten Hosts einen eigenen Service „Betriebssystem“ bereitstellt.

Funktionen

Der Service zeigt unter anderem:

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

Unterstützt werden Linux, Windows und grundsätzlich auch macOS.

Repository-Struktur

checkmk-os-info/
├── src/
│   ├── agents/
│   │   ├── plugins/
│   │   │   └── os_info
│   │   └── windows/
│   │       └── plugins/
│   │           └── os_info.ps1
│   └── cmk_addons_plugins/
│       └── os_info/
│           ├── agent_based/
│           │   └── os_info.py
│           └── checkman/
│               └── os_info
├── dist/
│   └── os_info-1.0.0.mkp
├── CHANGELOG.md
├── LICENSE
└── README.md

Installation des MKP

Das fertige Paket befindet sich unter:

dist/os_info-1.0.0.mkp

Auf den Checkmk-Server kopieren und als Site-Benutzer installieren:

mkp add /tmp/os_info-1.0.0.mkp
mkp enable os_info 1.0.0
cmk -R

Kontrolle:

mkp list

Der Eintrag os_info sollte als Enabled (active on this site) erscheinen.

Agent-Plug-in für Linux/macOS

Nach Aktivierung des MKP liegt das Plug-in im lokalen Site-Verzeichnis:

~/local/share/check_mk/agents/plugins/os_info

Auf den Zielhost kopieren:

scp ~/local/share/check_mk/agents/plugins/os_info \
root@HOST:/usr/lib/check_mk_agent/plugins/os_info

Danach auf dem Zielhost:

chmod 755 /usr/lib/check_mk_agent/plugins/os_info
/usr/lib/check_mk_agent/plugins/os_info

Die Ausgabe muss mit folgender Sektion beginnen:

<<<os_info:sep(9)>>>

Agent-Plug-in für Windows

Nach Aktivierung liegt die PowerShell-Datei auf dem Checkmk-Server unter:

~/local/share/check_mk/agents/windows/plugins/os_info.ps1

Auf dem Windows-Host nach folgendem Verzeichnis kopieren:

C:\ProgramData\checkmk\agent\plugins\os_info.ps1

Service Discovery

Auf dem Checkmk-Server zunächst prüfen, ob die Agent-Sektion ankommt:

cmk -d HOSTNAME | grep -A2 '^<<<os_info'

Danach die Service-Erkennung ausführen:

cmk -vI HOSTNAME
cmk -R

Anschließend erscheint beim Host der Service:

Betriebssystem

Fehlersuche

Installierte Dateien des MKP suchen:

find ~/local -type f -name 'os_info*'

Status des Pakets:

mkp list

Agent-Ausgabe kontrollieren:

cmk -d HOSTNAME | grep -A2 '^<<<os_info'

Kompatibilität

Entwickelt für:

• Checkmk Community 2.5.x
• Check API V2
• Linux-Agent
• Windows-Agent

Aktuelle Paketversion: 1.0.0

Lizenz

GPL-2.0