ai-tools/private-proxy-mcp

Watch

Fork 0

Observability, Health Checks und Graceful Shutdown implementieren #12

New issue

Closed

opened 2026-07-17 09:05:50 +02:00 by frank · 1 comment

frank commented

2026-07-17 09:05:50 +02:00

Owner

Teil von #1.

Ziel

Beide Betriebsmodi sind im Betrieb diagnostizierbar, ohne Secrets oder sensible Webinhalte offenzulegen, und fahren kontrolliert herunter.

Scope

Strukturierte Logs mit log/slog.
Konfigurierbare Level und Text-/JSON-Ausgabe.
Korrelationsfelder: MCP Request-ID sofern verfügbar, Tunnel Request-ID, Proxy-Identität und Dauer.
Redaction für Authorization, Cookie, Set-Cookie, Proxy-Authorization, Shared Keys und konfigurierbare Header.
Request-/Response-Bodies standardmäßig nie loggen.
Health:
- liveness des Prozesses
- readiness des MCP-Servers abhängig von einer gesunden Proxy-Verbindung
- Status ohne interne Ziel- oder Secret-Details
Basis-Metriken über eine abstrahierte interne Schnittstelle, auch wenn ein Prometheus-Endpoint erst später kommt:
- aktive Proxy-Verbindungen
- In-Flight-Requests
- Dauer und Fehler nach stabiler Kategorie
- Reconnects, Auth-Fehler, Timeouts, Truncations und Policy-Denials
SIGINT/SIGTERM: neue Requests stoppen, laufende Requests bis Deadline drainen, Goaway senden, HTTP-Server Shutdown und Idle-Verbindungen schließen.
Panics an Servergrenzen abfangen, loggen und den betroffenen Request sicher fehlschlagen lassen.

Akzeptanzkriterien

Readiness ist false ohne Proxy und true mit gesunder Verbindung.
Shutdown beendet einen Idle-Prozess sofort und respektiert die Drain-Deadline bei laufenden Requests.
Tests bestätigen Redaction aller Standard-Sensitive-Header.
Logs sind maschinenlesbar und enthalten stabile Fehlercodes.
Keine Goroutine-Leaks nach wiederholtem Start/Stop in Tests.

Referenzen

Go slog: https://pkg.go.dev/log/slog
http.Server.Shutdown: https://pkg.go.dev/net/http#Server.Shutdown

Teil von #1. ## Ziel Beide Betriebsmodi sind im Betrieb diagnostizierbar, ohne Secrets oder sensible Webinhalte offenzulegen, und fahren kontrolliert herunter. ## Scope - Strukturierte Logs mit log/slog. - Konfigurierbare Level und Text-/JSON-Ausgabe. - Korrelationsfelder: MCP Request-ID sofern verfügbar, Tunnel Request-ID, Proxy-Identität und Dauer. - Redaction für Authorization, Cookie, Set-Cookie, Proxy-Authorization, Shared Keys und konfigurierbare Header. - Request-/Response-Bodies standardmäßig nie loggen. - Health: - liveness des Prozesses - readiness des MCP-Servers abhängig von einer gesunden Proxy-Verbindung - Status ohne interne Ziel- oder Secret-Details - Basis-Metriken über eine abstrahierte interne Schnittstelle, auch wenn ein Prometheus-Endpoint erst später kommt: - aktive Proxy-Verbindungen - In-Flight-Requests - Dauer und Fehler nach stabiler Kategorie - Reconnects, Auth-Fehler, Timeouts, Truncations und Policy-Denials - SIGINT/SIGTERM: neue Requests stoppen, laufende Requests bis Deadline drainen, Goaway senden, HTTP-Server Shutdown und Idle-Verbindungen schließen. - Panics an Servergrenzen abfangen, loggen und den betroffenen Request sicher fehlschlagen lassen. ## Akzeptanzkriterien - Readiness ist false ohne Proxy und true mit gesunder Verbindung. - Shutdown beendet einen Idle-Prozess sofort und respektiert die Drain-Deadline bei laufenden Requests. - Tests bestätigen Redaction aller Standard-Sensitive-Header. - Logs sind maschinenlesbar und enthalten stabile Fehlercodes. - Keine Goroutine-Leaks nach wiederholtem Start/Stop in Tests. ## Referenzen - Go slog: https://pkg.go.dev/log/slog - http.Server.Shutdown: https://pkg.go.dev/net/http#Server.Shutdown

frank added this to the v0.3.0 – MCP MVP milestone

2026-07-17 09:27:20 +02:00

frank added the

area/observability

priority/P1

type/feature

labels

2026-07-17 09:27:50 +02:00

frank added a new dependency

2026-07-17 09:30:39 +02:00

#1 MVP: Private Proxy MCP – Basisfunktionen und Lieferumfang

frank added a new dependency

2026-07-17 09:30:41 +02:00

#7 Private-Proxy-Modus mit Reconnect und Verbindungsübernahme implementieren

frank added a new dependency

2026-07-17 09:30:42 +02:00

#9 MCP-Tools http_get und http_request bereitstellen

frank added a new dependency

2026-07-17 09:30:42 +02:00

#13 Teststrategie und Forgejo-Actions-CI aufsetzen

frank added a new dependency

2026-07-17 09:30:43 +02:00

#14 Architektur, Konfiguration und Betrieb im Projekt-Wiki dokumentieren

codex was assigned by frank

2026-07-17 10:41:56 +02:00

frank added a new dependency

2026-07-17 11:57:49 +02:00

#21 Browser Use über den privaten Reverse Proxy anbieten

frank added a new dependency

2026-07-17 11:57:50 +02:00

#22 yt-dlp-Medien- und YouTube-Transcript-Tools über den privaten Proxy bereitstellen

frank commented

2026-07-17 14:03:45 +02:00

Author

Owner

🤖 forge agent started

Agent: codex
Model: gpt-5.6-sol
Mode: pr
Trigger: assignee=agent|+5 mapped

Observability, Health Checks und Graceful Shutdown implementieren — Teil von #1.

🤖 **forge agent started** - Agent: `codex` - Model: `gpt-5.6-sol` - Mode: `pr` - Trigger: `assignee=agent|+5 mapped` Observability, Health Checks und Graceful Shutdown implementieren — Teil von #1.

frank added the

agent:working

label

2026-07-17 14:03:45 +02:00

~~frank referenced this issue 2026-07-17 14:03:47 +02:00~~

fix: #12 Observability, Health Checks und Graceful Shutdown implementieren #29

frank referenced this issue

2026-07-17 14:03:47 +02:00

fix: #12 Observability, Health Checks und Graceful Shutdown implementieren #29

frank referenced this issue

2026-07-17 14:22:07 +02:00

fix: #12 Observability, Health Checks und Graceful Shutdown implementieren #29