# Checkmk Services und Metriken Alle Services werden als Checkmk Local Checks ausgegeben. Das Format ist: ```text "" ``` Die Ausgabe ist so gebaut, dass sie auch mit Checkmk 2.4.0p4 kompatibel bleibt: zwischen den vier Feldern steht genau ein normales Leerzeichen. Die fachlichen Daten werden minuetlich vom privilegierten Scheduled-Task- Provider erzeugt. Der Checkmk-Agent liest als `LocalSystem` nur den integritaets- und altersgeprueften Snapshot. Ist dieser Transport nicht verfuegbar, liefern alle acht stabilen Services `UNKNOWN`. ## BizTalk Platform Zweck: - Prueft, ob der BizTalk-WMI-Namespace erreichbar ist. - Zeigt Server, Gruppe, konfigurierte BizTalk-Read-Only-/Operator-Gruppe, Management-DB und Master-MessageBox-DB aus `MSBTS_GroupSetting`. Status: | Status | Bedingung | | --- | --- | | `OK` | WMI-Verbindung erfolgreich und `MSBTS_GroupSetting` liefert beide vollstaendigen Datenbankziele. | | `UNKNOWN` | Namespace, `MSBTS_GroupSetting`, ein erforderliches Datenbankziel oder der Programmstart fehlgeschlagen. | Metriken: - keine ## BizTalk SQL Access Zweck: - Ermittelt Management- und Master-MessageBox-Datenbank ueber `MSBTS_GroupSetting`. - Oeffnet mit der Windows-Identitaet des privilegierten Provider-Tasks eine integrierte SQL-Verbindung. - Fuehrt die harmlose Abfrage `SELECT 1` aus und schliesst die Verbindung sofort wieder. - Zeigt lokale Ausfuehrungsidentitaet und erwartete Netzwerkidentitaet an. Der Service ersetzt nicht das Checkmk-MSSQL-Plugin. Er prueft den fuer das BizTalk-Monitoring relevanten Zugriff des dedizierten Provider-Kontos. Status: | Status | Bedingung | | --- | --- | | `OK` | WMI-Zielermittlung vollstaendig und alle ermittelten Datenbanken erreichbar. | | `UNKNOWN` | Zielermittlung unvollstaendig, Anmeldung verweigert, SQL nicht erreichbar, Timeout oder Providerfehler. | | `OK` mit Hinweis | Nur wenn `ProbeSqlConnectivity=false`; der Test ist dann bewusst deaktiviert. | Fehlerkategorien: | Kategorie | Typische Bedeutung | | --- | --- | | `Sql/Permission` | Login abgelehnt, Datenbank nicht oeffenbar oder fehlende Berechtigung. | | `Sql/Connectivity` | DNS, SQL-Dienst, Instanz, TCP-Port oder Firewall nicht erreichbar. | | `Sql/Timeout` | Verbindungsaufbau oder Testabfrage ueberschreitet das konfigurierte Zeitlimit. | | `Sql/Provider` | Sonstiger von SQL Server oder SqlClient gemeldeter Providerfehler. | | `Sql/Configuration` | WMI-Ziele aus einem Nicht-Berechtigungsgrund unvollstaendig oder TLS-, Zertifikats-, SPN-/SSPI-Konfiguration fehlerhaft. | Ist die Zielermittlung wegen eines eingebetteten SQL-Loginfehlers des BizTalk-WMI-Providers unvollstaendig, wird die Folgediagnose als `Sql/Permission` statt als `Sql/Configuration` ausgegeben. Metriken: | Metrik | Bedeutung | | --- | --- | | `biztalk_sql_targets_total` | Anzahl eindeutiger Management-/MessageBox-Ziele. | | `biztalk_sql_targets_available` | Erfolgreich getestete SQL-Ziele. | | `biztalk_sql_targets_failed` | Fehlgeschlagene SQL-Ziele. | ## BizTalk Suspended Instances Zweck: - Ermittelt suspendierte BizTalk-Service-Instanzen. - Unterscheidet resumable und non-resumable. - Zaehlt Routing Failure Reports (`ServiceClass=64`) separat. - 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`. | | `CRIT` | `biztalk_routing_failure_reports >= CritRoutingFailureThreshold`. | | `UNKNOWN` | `MSBTS_ServiceInstance` nicht verlaesslich lesbar 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_routing_failure_reports` | Routing Failure Reports; Teilmenge der non-resumable Instanzen. | ## BizTalk Host Instances Zweck: - Ueberwacht BizTalk Host Instances auf dem BizTalk-Server. - Filtert die gruppenweite WMI-Auflistung clientseitig auf den konfigurierten BizTalk-Server; Namen mit Sonderzeichen gelangen nicht in WQL. - 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 Receive Locations Zweck: - Zaehlt alle konfigurierten Receive Locations und ihren `IsDisabled`-Zustand. - Trennt bewusst deaktivierte von unerwartet deaktivierten Namen. Status: | Status | Bedingung | | --- | --- | | `OK` | Daten lesbar und keine unerwartet deaktivierte Receive Location. | | `CRIT` | Mindestens eine unerwartet deaktivierte Receive Location bei `AlertOnArtifactRuntimeIssues=true`. | | `UNKNOWN` | `MSBTS_ReceiveLocation` nicht verlaesslich lesbar oder `IsDisabled` eines Objekts nicht interpretierbar. | Metriken: | Metrik | Bedeutung | | --- | --- | | `biztalk_receive_locations_total` | Gesamtzahl Receive Locations. | | `biztalk_receive_locations_enabled` | Aktivierte Receive Locations. | | `biztalk_receive_locations_disabled` | Deaktivierte Receive Locations. | | `biztalk_receive_locations_unexpected_disabled` | Deaktiviert und nicht in der Allowlist; CRIT ab 1. | | `biztalk_receive_locations_expected_disabled` | Bewusst deaktiviert und exakt allowlisted. | | `biztalk_receive_locations_unknown` | Fehlender oder nicht interpretierbarer `IsDisabled`-Wert. | ## BizTalk Send Ports Status: | Status | Bedingung | | --- | --- | | `OK` | Alle nicht allowlisted Send Ports sind started. | | `CRIT` | Mindestens ein unerwartet stopped/bound Port oder unbekannter Status. | | `UNKNOWN` | `MSBTS_SendPort` nicht verlaesslich lesbar. | Metriken: | Metrik | Bedeutung | | --- | --- | | `biztalk_send_ports_total` | Gesamtzahl Send Ports. | | `biztalk_send_ports_started` | Gestartete Send Ports. | | `biztalk_send_ports_stopped` | Enlisted, Subscription deaktiviert (`Status=2`). | | `biztalk_send_ports_bound` | Bound/unenlisted (`Status=1`). | | `biztalk_send_ports_unexpected_inactive` | Stopped/bound und nicht allowlisted; CRIT ab 1. | | `biztalk_send_ports_expected_inactive` | Bewusst inactive und exakt allowlisted. | | `biztalk_send_ports_unknown` | Nicht interpretierbarer Send-Port-Status. | ## BizTalk Orchestrations Status: | Status | Bedingung | | --- | --- | | `OK` | Daten lesbar und kein unbekannter Status; inaktive Orchestrations sind standardmaessig nur Information. | | `WARN` | stopped/bound/unbound bei `AlertOnInactiveOrchestrations=true`. | | `CRIT` | Mindestens ein unbekannter Statuswert. | | `UNKNOWN` | `MSBTS_Orchestration` nicht verlaesslich lesbar. | Metriken: | Metrik | Bedeutung | | --- | --- | | `biztalk_orchestrations_total` | Gesamtzahl Orchestrations. | | `biztalk_orchestrations_started` | Gestartete Orchestrations. | | `biztalk_orchestrations_stopped` | Gestoppte Orchestrations. | | `biztalk_orchestrations_bound` | Bound Orchestrations. | | `biztalk_orchestrations_unbound` | Unbound Orchestrations. | | `biztalk_orchestrations_unknown` | Nicht interpretierbarer Orchestration-Status. | Allowlist-Syntax fuer Receive Locations und Send Ports: ```text Name|Anwendung\Name|Weiterer Name ``` Die Auswertung ist case-insensitive und exakt. Wildcards werden bewusst nicht unterstuetzt, damit eine breite Regel keine neuen Artefaktfehler verdeckt. ## 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 und deren Anwendung per WMI tatsaechlich zugeordnet werden konnte: ```text BizTalk Suspended ``` Nicht zuordenbare Instanzen bleiben im stabilen Aggregat-Service enthalten; ein irrefuehrender per-Application-Service namens `(unknown)` wird nicht erzeugt. Die Option kann die Service-Anzahl erhoehen und bleibt fuer den Basisausbau deaktiviert.