diff --git a/README.md b/README.md index 6cd747d..a2f7c5c 100644 --- a/README.md +++ b/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 diff --git a/docs/Integration.md b/docs/Integration.md index 5cfda8e..a5e431f 100644 --- a/docs/Integration.md +++ b/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 -