Home

Argus wiki

Operational Prometheus / OpenTelemetry metrics for discord.py bots, in one line.

from argus import Argus
Argus(bot)

This wiki is the in-depth reference. The README is the quick start; everything below assumes you know discord.py and Prometheus and want the specifics.

Pages

• Architecture and Invariants — the three layers, the seven invariants, and why they exist.
• Configuration — every kwarg/env var, precedence, and resolution.
• Metrics Reference — every metric, its kind, labels, and source.
• Dashboard — the built-in SPA, the SSE snapshot protocol, auth.
• History and ClickHouse — the per-guild analytical path and the event sink.
• OTLP — the OpenTelemetry push adapter.
• Clustering — multi-process deployments and the cluster label.
• Releasing — release-please, PyPI Trusted Publishing, the GHCR image.
• Contributing — dev setup, the checks, the DCO.

Mental model

core observes the bot and maintains a backend-neutral metric registry. adapters (Prometheus, OTLP) translate that registry into a backend. exposition serves /metrics and the dashboard on the bot's own aiohttp loop. history is a separate, optional path that drains per-guild events to an OLAP store. Data flows one way: bot -> core -> adapters/exposition; core never imports an adapter.