Monitoring

Zustand und Performance des Outposts überwachen

Hinweis

Dieses Kapitel gilt für den Docker-Weg. Bei der Desktop-App siehst du Zustand und Verbindung direkt in der Oberfläche — sie überwacht Tunnel und Dienste selbst.

Health-Check

Der Outpost stellt einen einfachen Health-Endpoint bereit:

# Prüfen, ob der Vault läuft
curl http://localhost:8080/health/
# Antwort: {"status":"healthy"}
 
# Datenbank (PostgreSQL/VectorChord) prüfen
docker compose exec database pg_isready -U datavault -d datavault
# Antwort: accepting connections

Basis-Monitoring

Täglicher Health-Check

daily-check.sh

#!/bin/bash
echo "=== Data Vault Status - $(date) ==="
 
# Dienst-Status
docker compose ps
 
# Ressourcen-Auslastung
docker stats --no-stream vault vault-worker database
 
# API-Health
if curl -s http://localhost:8080/health/ | grep -q "healthy"; then
    echo "✅ Data Vault: Healthy"
else
    echo "❌ Data Vault: Down"
fi
 
# Aktuelle Fehler
docker compose logs --since 24h | grep -i error | tail -3

Eingebautes Monitoring

Der Outpost hat optionales eingebautes Monitoring, gesteuert über diese Konfiguration:

Monitoring-Konfiguration

logging:
  # Heartbeat für Uptime-Monitoring (externer Dienst nötig)
  heartbeat_url: $HEARTBEAT_URL          # Optional: Better Stack o. Ä.
  heartbeat_interval_minutes: 1
 
  # System-Monitoring (0 zum Deaktivieren)
  system_monitoring_interval: 60         # CPU/Memory-Statistiken
  storage_monitoring_interval: 300       # Speichernutzung
  database_monitoring_interval: 60       # Datenbank-Statistiken

System-Monitoring-API

Wenn aktiviert, kannst du System-Statistiken abfragen:

# System-Auslastung (Authentifizierung erforderlich)
curl -H "Authorization: Bearer $VAULT_SECRET" \
  http://localhost:8080/health/system
 
# Rate-Limit-Status
curl -H "Authorization: Bearer $VAULT_SECRET" \
  http://localhost:8080/health/ratelimit

Log-Monitoring

Logs prüfen

# Aktuelle Fehler
docker compose logs | grep -i error | tail -10
 
# Ingestion-Probleme
docker compose logs vault-worker | grep -i "ingestion\|processing"
 
# Datenbank-Verbindung
docker compose logs vault | grep -i "database\|postgres"
 
# Status des Tunnel-Sidecars
docker compose logs piko

Log-Dateien

Bei log_to_file: true:

# Anwendungs-Logs
tail -f logs/app.log
 
# Webserver-Logs
tail -f logs/uvicorn.log

Performance-Monitoring

# Ingestion-Durchsatz
docker compose logs vault-worker | grep -i "ingestion.*finished"
 
# Ressourcen-Trends
docker stats --no-stream
 
# Aktueller Ingestion-Status
docker compose logs vault-worker | grep -i "started\|finished" | tail -5

Troubleshooting

Dienst-Probleme

# Dienste neu starten
docker compose restart
 
# Health prüfen
docker compose ps
curl http://localhost:8080/health/
 
# Aktuelle Logs
docker compose logs --tail 50 vault

Verbindungs-Probleme

Der Docker-Weg verbindet sich über den gebündelten Tunnel-Sidecar (piko-Dienst) mit meinGPT. (Die Desktop-App nutzt stattdessen den Go-Bridge-Agenten und blendet das in der Oberfläche ein.)

# Tunnel-Sidecar prüfen
docker compose logs piko | tail -10
 
# Externe Erreichbarkeit von meinGPT prüfen
curl -I https://vault-proxy.meingpt.com
 
# Vault-Zugangsdaten prüfen
echo $VAULT_ID
echo $VAULT_SECRET

Das war's: Der Outpost bietet einfache Health-Endpoints und optionales System-Monitoring. Nutze die Docker-Logs zur Fehlersuche.

War diese Seite hilfreich?