monitor.server¶

MonitorServer — FastAPI web server for the otto monitoring dashboard.

Endpoints¶

GET / Serves dashboard.html GET /static/… Serves static assets (plotly.min.js, etc.) GET /api/meta JSON metadata (host name, metric labels, units) GET /api/data JSON snapshot of all metric series and events GET /api/stream SSE stream — pushes metric updates and events in real time POST /api/event Record a manual event from the dashboard UI

class otto.monitor.server.SuppressASGIWarning(name='')¶

Bases: Filter

filter(record: LogRecord)¶

Determine if the specified record is to be logged.

Returns True if the record should be logged, or False otherwise. If deemed appropriate, the record may be modified in-place.

class otto.monitor.server.MonitorServer(collector: MetricCollector, host: str = '0.0.0.0', port: int = 0)¶

Bases: object

Wraps a FastAPI/uvicorn server for the monitoring dashboard.

Call await serve() from an async context to run the server. Call stop() from any thread to trigger a graceful shutdown.

property url : str¶

Primary URL using the first detected non-loopback IP (or the bind address).

property urls : list[str]¶

All URLs the server is reachable on (one per non-loopback interface).

property started : bool¶

True once the server is ready to accept connections.

async serve() → None¶

Run the web server until stop() is called or the process exits.

stop() → None¶

Signal the server to shut down (thread-safe).