Add BizTalk Checkmk Pulse local check

2026-07-22 11:34:28 +02:00
commit 7660dc4555
20 changed files with 1919 additions and 0 deletions
@@ -0,0 +1,144 @@
+# Checkmk Services und Metriken
+
+Alle Services werden als Checkmk Local Checks ausgegeben. Das Format ist:
+
+```text
+<state> "<service name>" <metrics-or-minus> <summary>
+```
+
+Die Ausgabe ist so gebaut, dass sie auch mit Checkmk 2.4.0p4 kompatibel bleibt: zwischen den vier Feldern steht genau ein normales Leerzeichen.
+
+## BizTalk Platform
+
+Zweck:
+
+- Prueft, ob der BizTalk-WMI-Namespace erreichbar ist.
+- Zeigt Server, Gruppe, Management-DB und MessageBox-DB, soweit WMI diese Werte liefert.
+
+Status:
+
+| Status | Bedingung |
+| --- | --- |
+| `OK` | WMI-Verbindung erfolgreich. |
+| `UNKNOWN` | WMI-Verbindung oder Programmstart fehlgeschlagen. |
+
+Metriken:
+
+- keine
+
+## BizTalk Suspended Instances
+
+Zweck:
+
+- Ermittelt suspendierte BizTalk-Service-Instanzen.
+- Unterscheidet resumable und non-resumable.
+- Zeigt betroffene Anwendungen und Beispiele in der Summary.
+
+Status:
+
+| Status | Bedingung |
+| --- | --- |
+| `OK` | keine suspendierten Instanzen. |
+| `WARN` | `biztalk_suspended_resumable >= WarnResumableThreshold`. |
+| `CRIT` | `biztalk_suspended_nonresumable >= CritNonResumableThreshold`. |
+| `UNKNOWN` | WMI oder Programmfehler. |
+
+Metriken:
+
+| Metrik | Bedeutung |
+| --- | --- |
+| `biztalk_suspended_total` | Summe aller suspendierten Instanzen. |
+| `biztalk_suspended_resumable` | Resumable suspended instances. |
+| `biztalk_suspended_nonresumable` | Non-resumable suspended instances. |
+
+## BizTalk Host Instances
+
+Zweck:
+
+- Ueberwacht BizTalk Host Instances auf dem BizTalk-Server.
+- Nicht gestartete Host Instances sind normalerweise betriebsrelevant.
+
+Status:
+
+| Status | Bedingung |
+| --- | --- |
+| `OK` | alle Host Instances sind started. |
+| `WARN` | mindestens eine Host Instance ist pending. |
+| `CRIT` | mindestens eine Host Instance ist stopped oder unknown. |
+| `UNKNOWN` | keine Host Instances gefunden oder WMI/Programmfehler. |
+
+Metriken:
+
+| Metrik | Bedeutung |
+| --- | --- |
+| `biztalk_host_instances_total` | Gesamtzahl Host Instances. |
+| `biztalk_host_instances_started` | Gestartete Host Instances. |
+| `biztalk_host_instances_stopped` | Gestoppte Host Instances. |
+| `biztalk_host_instances_pending` | StartPending/StopPending. |
+| `biztalk_host_instances_unknown` | Nicht interpretierbarer Status. |
+
+## BizTalk Runtime Artifacts
+
+Zweck:
+
+- Summiert Laufzeitzustaende von Receive Locations, Send Ports und Orchestrations.
+- Liefert dashboard-taugliche Zahlen zur Laufzeitlandschaft.
+
+Status:
+
+| Status | Bedingung |
+| --- | --- |
+| `OK` | Artefakte lesbar; keine unbekannten Statuswerte. |
+| `WARN` | Nur bei `AlertOnArtifactRuntimeIssues=true` und inaktiven/deaktivierten Artefakten. |
+| `CRIT` | Unbekannte Send-Port- oder Orchestration-Statuswerte. |
+| `UNKNOWN` | Programmfehler. |
+
+Metriken:
+
+| Metrik | Bedeutung |
+| --- | --- |
+| `biztalk_applications` | Anzahl erkannter BizTalk-Anwendungen. |
+| `biztalk_receive_locations` | Gesamtzahl Receive Locations. |
+| `biztalk_receive_locations_disabled` | Deaktivierte Receive Locations. |
+| `biztalk_send_ports` | Gesamtzahl Send Ports. |
+| `biztalk_send_ports_started` | Gestartete Send Ports. |
+| `biztalk_send_ports_inactive` | Bound oder stopped Send Ports. |
+| `biztalk_send_ports_unknown` | Nicht interpretierbarer Send-Port-Status. |
+| `biztalk_orchestrations` | Gesamtzahl Orchestrations. |
+| `biztalk_orchestrations_started` | Gestartete Orchestrations. |
+| `biztalk_orchestrations_inactive` | Bound, unbound oder stopped Orchestrations. |
+| `biztalk_orchestrations_unknown` | Nicht interpretierbarer Orchestration-Status. |
+
+## BizTalk Event Log
+
+Zweck:
+
+- Erfasst BizTalk-bezogene Errors und Warnings aus dem Windows Application Log.
+- Ergaenzt WMI-Zustandsdaten um aktuelle Laufzeitereignisse.
+
+Status:
+
+| Status | Bedingung |
+| --- | --- |
+| `OK` | Schwellwerte nicht erreicht. |
+| `WARN` | Errors oder Warnings ab `EventLogWarnThreshold`. |
+| `CRIT` | Errors ab `EventLogCritThreshold`. |
+| `UNKNOWN` | Application Event Log nicht lesbar. |
+
+Metriken:
+
+| Metrik | Bedeutung |
+| --- | --- |
+| `biztalk_eventlog_errors` | BizTalk-bezogene Errors im Lookback-Fenster. |
+| `biztalk_eventlog_warnings` | BizTalk-bezogene Warnings im Lookback-Fenster. |
+
+## Optionale per-Application-Services
+
+Wenn `EmitPerApplicationSuspensionServices=true` gesetzt ist, werden zusaetzliche Services fuer Anwendungen erzeugt, die suspendierte Instanzen haben:
+
+```text
+BizTalk Suspended <ApplicationName>
+```
+
+Das ist fuer Anwendungsteams hilfreich, kann aber die Service-Anzahl erhoehen. Fuer den Basisausbau wird empfohlen, diese Option deaktiviert zu lassen.
+