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