280 lines
11 KiB
Markdown
280 lines
11 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.
|
|
|
|
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 neun 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 Endpoint Reachability
|
|
|
|
Zweck:
|
|
|
|
- Prueft nur Receive Locations mit `IsDisabled=false` und Send Ports mit
|
|
`Status=Started`.
|
|
- Reduziert die Adresse auf Host/Port und fuehrt keinen fachlichen
|
|
HTTP-, FTP-, SFTP-, WCF- oder BizTalk-Aufruf aus.
|
|
- Dedupliziert gemeinsame Host/Port-Ziele und prueft sie mit begrenzter
|
|
Parallelitaet; das Ergebnis wird danach wieder den Artefakten zugeordnet.
|
|
- Zeigt im gesunden Zustand nur `Alle n ... erreichbar`. Nur bei Fehlern
|
|
erscheint die begrenzte Liste `unavailable=`.
|
|
|
|
Status:
|
|
|
|
| Status | Bedingung |
|
|
| --- | --- |
|
|
| `OK` | Katalog und Runtimezustand vollstaendig; alle aktiven pruefbaren Ziele erreichbar. |
|
|
| `CRIT` | Mindestens ein getestetes TCP-/UDP-Ziel nicht erreichbar. |
|
|
| `UNKNOWN` | Katalog fehlt/ist ungueltig, Wochenabgleich scheitert, Runtimezustand ist unvollstaendig oder ein aktiver externer Endpoint kann nicht sicher auf Host/Port reduziert werden. |
|
|
| `OK` mit Hinweis | Nur wenn `ProbeEndpointConnectivity=false`; der Test ist bewusst deaktiviert. |
|
|
|
|
Metriken:
|
|
|
|
| Metrik | Bedeutung |
|
|
| --- | --- |
|
|
| `biztalk_endpoints_configured` | Eintraege in `endpoints.xml`, einschliesslich derzeit inaktiver. |
|
|
| `biztalk_endpoints_active` | Im aktuellen Lauf Started/Enabled und fuer die Probe ausgewaehlt. |
|
|
| `biztalk_endpoints_tested` | Vollstaendig abgeschlossene Artefaktprobes. |
|
|
| `biztalk_endpoints_available` | Erreichbare aktive Artefaktziele. |
|
|
| `biztalk_endpoints_failed` | Nicht erreichbare aktive Artefaktziele; CRIT ab 1. |
|
|
| `biztalk_endpoints_unsupported` | Aktive externe Adressen ohne sicher bestimmbaren Host/Port. |
|
|
| `biztalk_endpoints_inactive_skipped` | Konfigurierte Eintraege, deren BizTalk-Artefakt aktuell nicht aktiv ist. |
|
|
|
|
Bei expliziten `udp://host:port`-Eintraegen kann ein generischer Check ohne
|
|
applikationsspezifisches Protokoll nur DNS, Route und erfolgreichen lokalen
|
|
Datagrammversand bestaetigen. Er beweist keine Antwort des entfernten
|
|
UDP-Dienstes. Fuer alle ueblichen streambasierten Adapter wird deshalb TCP
|
|
verwendet.
|
|
|
|
## 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 <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.
|