162 lines
2.8 KiB
Markdown
162 lines
2.8 KiB
Markdown
# 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
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
dist/os_info-1.0.0.mkp
|
|
```
|
|
|
|
Auf den Checkmk-Server kopieren und als Site-Benutzer installieren:
|
|
|
|
```bash
|
|
mkp add /tmp/os_info-1.0.0.mkp
|
|
mkp enable os_info 1.0.0
|
|
cmk -R
|
|
```
|
|
|
|
Kontrolle:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```text
|
|
~/local/share/check_mk/agents/plugins/os_info
|
|
```
|
|
|
|
Auf den Zielhost kopieren:
|
|
|
|
```bash
|
|
scp ~/local/share/check_mk/agents/plugins/os_info \
|
|
root@HOST:/usr/lib/check_mk_agent/plugins/os_info
|
|
```
|
|
|
|
Danach auf dem Zielhost:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```text
|
|
<<<os_info:sep(9)>>>
|
|
```
|
|
|
|
## Agent-Plug-in für Windows
|
|
|
|
Nach Aktivierung liegt die PowerShell-Datei auf dem Checkmk-Server unter:
|
|
|
|
```text
|
|
~/local/share/check_mk/agents/windows/plugins/os_info.ps1
|
|
```
|
|
|
|
Auf dem Windows-Host nach folgendem Verzeichnis kopieren:
|
|
|
|
```text
|
|
C:\ProgramData\checkmk\agent\plugins\os_info.ps1
|
|
```
|
|
|
|
## Service Discovery
|
|
|
|
Auf dem Checkmk-Server zunächst prüfen, ob die Agent-Sektion ankommt:
|
|
|
|
```bash
|
|
cmk -d HOSTNAME | grep -A2 '^<<<os_info'
|
|
```
|
|
|
|
Danach die Service-Erkennung ausführen:
|
|
|
|
```bash
|
|
cmk -vI HOSTNAME
|
|
cmk -R
|
|
```
|
|
|
|
Anschließend erscheint beim Host der Service:
|
|
|
|
```text
|
|
Betriebssystem
|
|
```
|
|
|
|
## Fehlersuche
|
|
|
|
Installierte Dateien des MKP suchen:
|
|
|
|
```bash
|
|
find ~/local -type f -name 'os_info*'
|
|
```
|
|
|
|
Status des Pakets:
|
|
|
|
```bash
|
|
mkp list
|
|
```
|
|
|
|
Agent-Ausgabe kontrollieren:
|
|
|
|
```bash
|
|
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
|