Add BizTalk endpoint reachability monitoring

docs/CheckmkServices.md

@@ -11,7 +11,7 @@ Die Ausgabe ist so gebaut, dass sie auch mit Checkmk 2.4.0p4 kompatibel bleibt:
 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 acht stabilen Services `UNKNOWN`.
+verfuegbar, liefern alle neun stabilen Services `UNKNOWN`.
 
 ## BizTalk Platform
 
@@ -174,6 +174,46 @@ Metriken:
 | `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: