docs: finalize and verify Zipkin integration in system hardening roadmap
Marked Zipkin integration tasks as completed and verified in archived roadmaps. Documented fixes for gateway propagation type (`w3c` → `b3`) and Zipkin endpoint configuration. Removed redundant dependencies in `build.gradle.kts` and updated related session logs. Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
This commit is contained in:
@@ -46,8 +46,35 @@ Sicherheitseinstellungen auf einen produktionsreifen Stand gebracht.
|
||||
Verifiziert: `micrometer = "1.16.1"` und `micrometerTracing = "1.6.1"` waren bereits korrekt in
|
||||
`gradle/libs.versions.toml` gesetzt — kein Code-Change erforderlich. Archiv-Roadmaps entsprechend abgehakt.
|
||||
|
||||
## ✅ Zipkin Integration (2026-03-09, gleiche Session)
|
||||
|
||||
Analyse ergab: Infrastruktur war bereits zu ~90% korrekt aufgebaut. Einzige Lücke war eine falsche
|
||||
Propagation-Konfiguration im Gateway.
|
||||
|
||||
### Befund
|
||||
|
||||
- `dc-infra.yaml`: Zipkin-Container (`openzipkin/zipkin:3`, Port 9411) bereits vorhanden.
|
||||
- `monitoring-client`-Bundle: enthält `micrometer-tracing-bridge-brave`, `zipkin-reporter-brave`,
|
||||
`zipkin-sender-okhttp3` — von allen Services eingebunden.
|
||||
- `monitoring-defaults.properties`: setzt `management.zipkin.tracing.endpoint=http://localhost:9411/api/v2/spans`
|
||||
als Default, überschreibbar via `MANAGEMENT_ZIPKIN_TRACING_ENDPOINT`.
|
||||
- `dc-backend.yaml`: setzt `MANAGEMENT_ZIPKIN_TRACING_ENDPOINT=http://zipkin:9411/api/v2/spans` für alle
|
||||
Services inkl. Gateway.
|
||||
|
||||
### Fix: Gateway `application.yaml`
|
||||
|
||||
- **`management.tracing.propagation.type`**: `w3c` → `b3`
|
||||
(B3 ist das native Format von Brave/Zipkin; W3C wäre für OpenTelemetry — Mismatch hätte
|
||||
Trace-Korrelation zwischen Gateway und Services gebrochen).
|
||||
- **`management.zipkin.tracing.endpoint`**: Explizit mit lokalem Default + ENV-Override ergänzt.
|
||||
- **`TRACING_SAMPLING_PROBABILITY`**: Konsistent mit Services via ENV-Variable.
|
||||
|
||||
### Fix: Gateway `build.gradle.kts`
|
||||
|
||||
- Redundante direkte `micrometer-tracing-bridge-brave`-Dependency entfernt
|
||||
(bereits transitiv via `monitoring-client` vorhanden).
|
||||
|
||||
## 🔜 Nächste Schritte
|
||||
|
||||
- **Zipkin Integration** — Tracing vom Gateway bis zur DB aktivieren.
|
||||
- **OIDC Client im Frontend** — Login-Flow mit `ktor-client-auth` und `frontend-client` implementieren.
|
||||
- **TLS/HTTPS** — Langfristig: `KC_HOSTNAME_STRICT_HTTPS=true` setzen, sobald TLS eingerichtet ist.
|
||||
|
||||
Reference in New Issue
Block a user