monitor/monitor-api-sample.conf
fds2610-bot 51c6a7b648 OPs-Agent bleibt in der Praesenz: check_fds.sh meldet working/idle
check_fds.sh rief last_seen_at des OPs-Agenten nie an - der Agent fiel zehn
Minuten nach seiner Registrierung dauerhaft vom Schreibtisch, obwohl der
Ping-Check normal weiterlief. Das Skript meldet jetzt zu Beginn "working" und
am Ende (auch bei einem fruehen Abbruch, per trap) "idle" per
POST /api/v1/agents/{id}/activity, analog zum Cron-Skript des
Entwickler-Agenten. Fehler dabei werden nur protokolliert, nicht fatal.

Dafuer braucht monitor-api.conf zusaetzlich MONITOR_AGENT_ID:
register-ops-agent.sh schreibt sie bei einer Neuregistrierung mit und
traegt sie bei einer bestehenden, aber noch unmigrierten Datei ohne
Neuregistrierung nach.

Schliesst #75.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-02 12:49:34 +02:00

27 lines
1.4 KiB
Text

# Zugangsdaten, mit denen check_fds.sh die Ping-Ergebnisse zusaetzlich per REST an die
# monitor-API meldet (POST /api/v1/systems/{id}/status, siehe API.md Abschnitt "Systeme").
#
# Noetig ist das, wenn check_fds.sh auf einem anderen Rechner laeuft als die API: der
# Legacy-Import liest status.txt als lokale Datei und erreicht sie dann nicht.
#
# Diese Datei nach "monitor-api.conf" neben check_fds.sh kopieren und ausfuellen. Fehlt sie
# oder bleibt ein Wert leer, meldet check_fds.sh wie bisher nur nach status.txt und per Mail.
#
# Der Key gehoert einem eigens registrierten Agenten der Rolle "ops" (Issue #66), der in der
# Buero-Visualisierung als "OPs" an einem Schreibtisch sitzt. Am einfachsten legt
# register-ops-agent.sh beides an - Agent und diese Datei; der Key wird nur bei der
# Registrierung einmalig ausgegeben.
#
# Enthaelt ein Secret: chmod 600 monitor-api.conf
# Basis-URL der API, ohne abschliessenden Slash (Host-Port des api-Service)
MONITOR_API_BASE="http://monitor.example.lan:8091"
# API-Key des registrierten Agenten
MONITOR_API_KEY=""
# ID des registrierten Agenten (aus der Registrierungsantwort). Noetig, damit check_fds.sh
# per POST /api/v1/agents/{id}/activity working/idle melden und so in der Praesenz bleiben
# kann (Issue #75) - ohne diesen Wert unterbleibt nur diese Meldung, alles andere
# funktioniert weiter wie zuvor.
MONITOR_AGENT_ID=""