Document Checkmk integration tasks

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
-