# 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 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:

```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.