182 lines
6.7 KiB
Markdown
182 lines
6.7 KiB
Markdown
# 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 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 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.
|
|
- 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 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 der per WMI erkannten Anwendungs-Buckets; `(unknown)` ist moeglich, da die dokumentierten Artefaktklassen keine verlaessliche Application-Property garantieren. |
|
|
| `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 und deren Anwendung per WMI tatsaechlich zugeordnet werden konnte:
|
|
|
|
```text
|
|
BizTalk Suspended <ApplicationName>
|
|
```
|
|
|
|
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.
|