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