Document Checkmk integration tasks

README.md

@@ -129,6 +129,17 @@ Empfehlung:
 
 ## Integration in Checkmk Managed Services Edition 2.4
 
+Aufgaben der Checkmk-Kollegen:
+
+1. BizTalk-Hosts in Checkmk anlegen oder bestehende Hosts pruefen.
+2. Sicherstellen, dass der Checkmk Windows Agent installiert, registriert und erreichbar ist.
+3. Plugin-Dateien auf die BizTalk-Server verteilen, manuell oder per Agent Bakery.
+4. Optional `EnvironmentName` je Umgebung setzen, z.B. `ACC`, `DEV`, `TST` oder `PRD`.
+5. Agent-Ausgabe mit `cmk-agent-ctl.exe dump` pruefen.
+6. Service Discovery fuer jeden BizTalk-Host ausfuehren.
+7. Gefundene `BizTalk ...` Services aufnehmen und Changes aktivieren.
+8. Views, Dashboards, Servicegruppen und Benachrichtigungen fuer die BizTalk-Services konfigurieren.
+
 Manuelle Integration:
 
 1. Dateien auf dem BizTalk-Server nach `%ProgramData%\checkmk\agent\local` kopieren.
@@ -146,6 +157,14 @@ Integration ueber Agent Bakery:
 
 Die Checkmk-Dokumentation nennt fuer Windows Local Checks `%ProgramData%\checkmk\agent\local` und fuer Windows Agent Plugins `%ProgramData%\checkmk\agent\plugins`. Dieses Projekt nutzt bewusst `local`, weil der Zustand direkt vom Host berechnet und sofort als Checkmk-Service geliefert wird.
 
+Empfohlene Alarmierung:
+
+- `BizTalk Platform`: `UNKNOWN` immer untersuchen, da dann WMI, Rechte oder Deployment betroffen sind.
+- `BizTalk Suspended Instances`: in `PRD` direkt alarmieren; in Nicht-PRD nach Betriebsbedarf.
+- `BizTalk Host Instances`: `CRIT` alarmieren, weil gestoppte Host Instances Laufzeitverarbeitung verhindern koennen.
+- `BizTalk Runtime Artifacts`: zunaechst beobachten; strengere Alarmierung erst aktivieren, wenn deaktivierte Artefakte nicht fachlich gewollt sind.
+- `BizTalk Event Log`: Schwellwerte nach Beobachtungsphase anpassen.
+
 ## Quellen
 
 - Checkmk Local Checks: https://docs.checkmk.com/latest/en/localchecks.html

docs/Integration.md

@@ -33,6 +33,29 @@
 - gefundene `BizTalk ...` Services aufnehmen
 - Changes aktivieren
 
+## Aufgaben in Checkmk
+
+Die Checkmk-Kollegen muessen kein serverseitiges Python-Check-Plugin installieren. Das Plugin liefert bereits fertige Local-Check-Services ueber den Windows Agent. In Checkmk selbst sind diese Schritte erforderlich:
+
+1. BizTalk-Hosts fuer `ACC`, `DEV`, `TST` und `PRD` anlegen oder vorhandene Hosts pruefen.
+2. Windows-Agent-Status pruefen: Host muss Agent-Daten liefern.
+3. Nach Installation des Local Checks den Agent-Dump pruefen.
+4. Service Discovery fuer jeden BizTalk-Host ausfuehren.
+5. Gefundene `BizTalk ...` Services aufnehmen.
+6. Changes aktivieren.
+7. Views oder Dashboards mit Filter `Service starts with: BizTalk` anlegen.
+8. Benachrichtigungen und Eskalationen je Umgebung definieren.
+
+Empfohlene Service-Behandlung:
+
+| Service | Empfehlung |
+| --- | --- |
+| `BizTalk Platform` | `UNKNOWN` immer als Integrationsproblem behandeln. |
+| `BizTalk Suspended Instances` | In `PRD` alarmieren; in `ACC`/`TST`/`DEV` nach Teamvereinbarung. |
+| `BizTalk Host Instances` | `CRIT` alarmieren. |
+| `BizTalk Runtime Artifacts` | Erst beobachten; strenge Alarmierung nur bei klar definiertem Runtime-Sollzustand. |
+| `BizTalk Event Log` | Schwellwerte nach Beobachtungsphase feinjustieren. |
+
 ## Agent Bakery
 
 Checkmk Managed Services Edition 2.4 enthaelt die kommerziellen Mechanismen fuer Agent Bakery. Fuer einen sauberen Rollout:
@@ -68,4 +91,3 @@ Dashboard-Kacheln:
 - Graph `biztalk_host_instances_stopped`
 - Graph `biztalk_eventlog_errors`
 - MSSQL-Services des SQL-Servers daneben
-