biztalk-checkmk-pulse/docs/CheckmkServices.md

Checkmk Services und Metriken

Alle Services werden als Checkmk Local Checks ausgegeben. Das Format ist:

<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 und beide Plattform-Pflichtklassen erfolgreich.
UNKNOWN	Namespace, MSBTS_GroupSetting, MSBTS_MessageBoxSetting oder Programmstart fehlgeschlagen.

Metriken:

• keine

BizTalk SQL Access

Zweck:

• Ermittelt Management- und MessageBox-Datenbank ueber BizTalk-WMI.
• Oeffnet mit der Windows-Identitaet des Checkmk-Agentprozesses 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 Local Checks.

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 unvollstaendig oder TLS-, Zertifikats-, SPN-/SSPI-Konfiguration fehlerhaft.

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.
• 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	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 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	Mindestens eine erforderliche Artefaktklasse nicht lesbar oder 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:

BizTalk Suspended <ApplicationName>

Das ist fuer Anwendungsteams hilfreich, kann aber die Service-Anzahl erhoehen. Fuer den Basisausbau wird empfohlen, diese Option deaktiviert zu lassen.