biztalk-checkmk-pulse/docs/Integration.md

Integration in Checkmk

Zielstruktur auf dem BizTalk-Server

%ProgramData%\checkmk\agent\local\biztalk_checkmk_pulse.cmd
%ProgramData%\checkmk\agent\local\BizTalkCheckmkPulse\BizTalkCheckmkPulse.exe
%ProgramData%\checkmk\agent\local\BizTalkCheckmkPulse\BizTalkCheckmkPulse.exe.config

Manuelle Installation

1. Release-Paket auf den BizTalk-Server kopieren.
2. Inhalt nach %ProgramData%\checkmk\agent\local kopieren.
3. Optional EnvironmentName in der .exe.config setzen.
4. Test ausfuehren:

"%ProgramData%\checkmk\agent\local\biztalk_checkmk_pulse.cmd" --self-test
"%ProgramData%\checkmk\agent\local\biztalk_checkmk_pulse.cmd"

5. Agent-Ausgabe pruefen:

"C:\Program Files (x86)\checkmk\service\cmk-agent-ctl.exe" dump

6. In Checkmk:

• Host oeffnen
• Service Discovery ausfuehren
• gefundene BizTalk ... Services aufnehmen
• Changes aktivieren

Aufgaben in Checkmk

Die Checkmk-Kollegen muessen kein serverseitiges Python-Check-Plugin installieren. Das Plugin liefert bereits fertige Local-Check-Services ueber den Windows Agent. In Checkmk selbst sind diese Schritte erforderlich:

1. BizTalk-Hosts fuer ACC, DEV, TST und PRD anlegen oder vorhandene Hosts pruefen.
2. Windows-Agent-Status pruefen: Host muss Agent-Daten liefern.
3. Nach Installation des Local Checks den Agent-Dump pruefen.
4. Service Discovery fuer jeden BizTalk-Host ausfuehren.
5. Gefundene BizTalk ... Services aufnehmen.
6. Changes aktivieren.
7. Views oder Dashboards mit Filter Service starts with: BizTalk anlegen.
8. Benachrichtigungen und Eskalationen je Umgebung definieren.

Empfohlene Service-Behandlung:

Service	Empfehlung
BizTalk Platform	UNKNOWN immer als Integrationsproblem behandeln.
BizTalk Suspended Instances	In PRD alarmieren; in ACC/TST/DEV nach Teamvereinbarung.
BizTalk Host Instances	CRIT alarmieren.
BizTalk Runtime Artifacts	Erst beobachten; strenge Alarmierung nur bei klar definiertem Runtime-Sollzustand.
BizTalk Event Log	Schwellwerte nach Beobachtungsphase feinjustieren.

Agent Bakery

Checkmk Managed Services Edition 2.4 enthaelt die kommerziellen Mechanismen fuer Agent Bakery. Fuer einen sauberen Rollout:

1. Deployment-Dateien als Custom Files oder ueber ein spaeteres MKP bereitstellen.
2. Regel nur auf BizTalk-Hosts anwenden, z.B. Host-Tag application:biztalk.
3. Gebackenen Windows-Agenten fuer die BizTalk-Hosts installieren.
4. Service Discovery ausfuehren.

Hinweis: Dieses Repository enthaelt bewusst noch kein Bakery-Python-Plugin. Die manuelle bzw. dateibasierte Verteilung ist die risikoarme erste Version. Eine Bakery-Erweiterung ist eine sinnvolle Version-2-Ausbaustufe.

Empfohlene Host-Struktur

Host-Tags oder Ordner:

• env:ACC
• env:DEV
• env:TST
• env:PRD
• app:biztalk

Service-Filter fuer Views:

Service starts with: BizTalk

Dashboard-Kacheln:

• Host/Service state fuer BizTalk-Host
• Service state fuer BizTalk Suspended Instances
• Graph biztalk_suspended_total
• Graph biztalk_host_instances_stopped
• Graph biztalk_eventlog_errors
• MSSQL-Services des SQL-Servers daneben