Plugin last modified: 2026-05-12
Pushes per-channel IRC statistics to an Alloy collector via OTLP/HTTP for storage in Mimir. The bot pushes outbound — no listening port is required.
| Metric | Type | Description |
|---|---|---|
irc.channels |
Gauge | Total number of channels the bot is in |
irc.channel.users |
Gauge | Current user count per channel |
irc.channel.operators |
Gauge | Current operator count per channel |
irc.channel.users.by_country |
Gauge | Current user count per channel broken down by country (requires GeoIP) |
irc.channel.messages |
Counter | Total messages seen per channel |
irc.user.duration |
Histogram | Time in seconds a user spent in a channel per session, tagged with channel and country where available |
If a MaxMind GeoLite2-City database is configured, the plugin geolocates users on join and via a WHO scan when the bot itself joins a channel. Country codes are attached as a country attribute on irc.channel.users.by_country and irc.user.duration.
[metrics]
otlp_endpoint = http://alloy:4318/v1/metrics
export_interval = 60
geoip_db = /data/geoip/GeoLite2-City.mmdb
| Key | Description |
|---|---|
otlp_endpoint |
OTLP/HTTP endpoint to push metrics to. Defaults to http://alloy:4318/v1/metrics |
export_interval |
How often (in seconds) to export metrics. Defaults to 60 |
geoip_db |
Absolute path to a MaxMind GeoLite2-City .mmdb file. Optional — country metrics are omitted if not set |