Observabilidad¶

WSBuilder expone metricas y logs sin obligarte a meter un stack pesado.

Metricas¶

from wsbuilder import App, install_metrics

app = App()
metrics = install_metrics(app, app_name="my-app")

Eso crea:

GET /api/metrics
GET /api/metrics/stream

`AppMetrics`¶

AppMetrics registra:

conexiones TCP
requests HTTP
responses HTTP
upgrades WebSocket
mensajes WebSocket
errores

Snapshot¶

snap = app.metrics.snapshot()

El snapshot incluye totales, tasas y el estado de cada subsistema cuando la app agrega snapshots extra.

Streaming¶

for chunk in app.metrics.stream_chunks(interval_seconds=1.0):
    print(chunk.decode("utf-8"))

Metricas de la app¶

App.enable_metrics() añade informacion adicional:

resumen de threads por ruta
snapshot de cache general
snapshot de cache HTTP
snapshot de security
snapshot de proxyi
snapshot de tasks

Logs¶

from wsbuilder import App

app = App()
logger = app.enable_logs(path="logs/wsbuilder.ndjson")
logger.event("server_start", host="0.0.0.0", port=8765)

NDJSONLog escribe un evento por linea y funciona bien para ingest para herramientas externas.

Docs nativas¶

App.enable_docs() publica una vista HTML y un endpoint JSON con App.describe(). Es util para inspeccion local, automatizacion o integracion con dashboards de desarrollo.

Ruta de trabajo sugerida¶

Activa install_metrics().
Activa enable_logs() si quieres traza historica.
Usa enable_docs() para exponer la configuracion real de la app.
Consulta /api/metrics cuando algo no cuadre en produccion.