Home

Argus Wiki

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

from argus import Argus
Argus(bot)

Pages

• Metric Reference — every metric Argus exposes, with labels.
• Clustering — running one Argus per process with the cluster label.

Quick start

pip install argus-dpy

Add Argus(bot) to your bot. Metrics are served at http://0.0.0.0:9191/metrics once the bot starts. Run docker compose up -d from the repo for a provisioned Prometheus + Grafana stack.

Design principles

• Collection is decoupled from exposition; the core imports no backend.
• No guild_id / user_id / channel_id ever becomes a Prometheus label.
• Hooks are O(1) and non-blocking; instrumentation fails open.
• Gauges are read live at scrape time, never polled into a cache.

See the README for the full introduction and the LICENSE (AGPL-3.0-or-later).