# 🖥️ 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