docs: zwei Eigenheiten festhalten, die sonst zweimal Zeit kosten

Das Tracing-Rauschen alle fuenf Minuten ist kein Fehler und laesst sich in
beta.23 nicht abstellen: otlpEndpoint ist eine Konstante, ENV waehlt nur
zwischen TLS und unverschluesselt. Da die Adresse localhost lautet, hilft auch
kein Jaeger-Container daneben — der muesste sich den Netzwerk-Namensraum
teilen.

Wichtiger: wenn ein Knopf in der Oberflaeche nichts tut, steht der Grund im
Log und nie auf dem Bildschirm. http-util.ts wirft jeden Fehler als
new Error(...) weiter, die Hooks pruefen auf "instanceof ApiError" — das ist
danach nie wahr. 401, 500 und ein falscher Rumpf sehen alle gleich aus.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-11 15:03:27 +02:00
co-authored by Claude Opus 5
parent e2e12409b8
commit 0b45f31c15
+19
View File
@@ -172,6 +172,25 @@ Bucket schon existiert — deshalb legt dieser Stack ihn **nicht** vorher an.
---
## Zwei Eigenheiten, die Zeit kosten
**`traces export: … dial tcp [::1]:4318: connect: connection refused`**, alle
fünf Minuten. Kein Fehler: Lite schickt Tracing-Daten an einen Collector, den
dieser Stack bewusst nicht mitbringt. Abschalten geht in `beta.23` **nicht**
`otlpEndpoint` ist eine Konstante in `pkg/otel/exporter.go`, `ENV` wählt nur
zwischen TLS und unverschlüsselt. Weil die Adresse `localhost` ist, würde auch
ein Jaeger-Container daneben nichts nützen; er müsste sich den Netzwerk-
Namensraum teilen. Ignorieren.
**Ein Knopf in der Oberfläche tut gar nichts.** Dann steht der Grund im
Container-Log, nicht auf dem Bildschirm. `web/src/utils/http-util.ts` wirft
jeden Fehler als `new Error(…)` weiter, die aufrufenden Hooks prüfen aber auf
`err instanceof ApiError` — das ist danach nie wahr, und der Fehler wird
verschluckt. 401, 500 und ein falscher Rumpf sehen deshalb alle gleich aus:
nichts passiert.
---
## Was hier bewusst fehlt
**ClickHouse und Jaeger.** Beide stehen in der Entwicklungs-Compose des