Files
cmk-plugins/os-info/README.md
T

103 lines
2.1 KiB
Markdown

# 🖥️ Checkmk OS Info
![Version](https://img.shields.io/badge/Version-1.0.0-blue)
![Checkmk](https://img.shields.io/badge/Checkmk-2.5.x-15d1a0)
![API](https://img.shields.io/badge/Check%20API-V2-informational)
![License](https://img.shields.io/badge/License-GPL--2.0-lightgrey)
MKP-Erweiterung für **Checkmk Community 2.5.x**, die pro überwachten Host einen Service **„Betriebssystem“** bereitstellt.
⬅️ [Zurück zur Plugin-Übersicht](../README.md)
## ✨ Funktionen
- Betriebssystem bzw. Linux-Distribution
- Betriebssystem-Version / Windows-Build
- Architektur und Kernel-Version
- OS-ID und Version-ID
- 🐧 Linux · 🪟 Windows · 🍎 macOS
## 📥 Installation des MKP
Paket: `dist/os_info-1.0.0.mkp`
```bash
mkp add /tmp/os_info-1.0.0.mkp
mkp enable os_info 1.0.0
cmk -R
mkp list
```
## 🐧 Agent-Plug-in für Linux / macOS
Nach Aktivierung:
```text
~/local/share/check_mk/agents/plugins/os_info
```
Auf den Zielhost kopieren und testen:
```bash
scp ~/local/share/check_mk/agents/plugins/os_info root@HOST:/usr/lib/check_mk_agent/plugins/os_info
chmod 755 /usr/lib/check_mk_agent/plugins/os_info
/usr/lib/check_mk_agent/plugins/os_info
```
Die Ausgabe muss mit `<<<os_info:sep(9)>>>` beginnen.
## 🪟 Agent-Plug-in für Windows
Quelldatei:
```text
~/local/share/check_mk/agents/windows/plugins/os_info.ps1
```
Ziel:
```text
C:\ProgramData\checkmk\agent\plugins\os_info.ps1
```
## 🔎 Service Discovery
```bash
cmk -d HOSTNAME | grep -A2 '^<<<os_info'
cmk -vI HOSTNAME
cmk -R
```
Anschließend erscheint der Service **Betriebssystem**.
## 🧰 Fehlersuche
```bash
find ~/local -type f -name 'os_info*'
mkp list
cmk -d HOSTNAME | grep -A2 '^<<<os_info'
```
## 📂 Repository-Struktur
```text
os-info/
├── src/
│ ├── agents/
│ └── cmk_addons_plugins/os_info/
├── dist/
│ └── os_info-1.0.0.mkp
├── CHANGELOG.md
├── PROJECT.md
├── LICENSE
└── README.md
```
## 🛠️ Kompatibilität
Checkmk Community 2.5.x · Check API V2 · Linux-Agent · Windows-Agent · macOS grundsätzlich unterstützt
## ⚖️ Lizenz
GPL-2.0