94 lines
3.1 KiB
Markdown
94 lines
3.1 KiB
Markdown
# Integration in Checkmk
|
|
|
|
## Zielstruktur auf dem BizTalk-Server
|
|
|
|
```text
|
|
%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:
|
|
|
|
```cmd
|
|
"%ProgramData%\checkmk\agent\local\biztalk_checkmk_pulse.cmd" --self-test
|
|
"%ProgramData%\checkmk\agent\local\biztalk_checkmk_pulse.cmd"
|
|
```
|
|
|
|
5. Agent-Ausgabe pruefen:
|
|
|
|
```cmd
|
|
"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:
|
|
|
|
```text
|
|
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
|