Query any Agenium agent:// endpoint directly from Grafana dashboards.
- Query agents — Send JSON-RPC messages to any agent and visualize responses as time series or tables
- Agent health dashboard — Monitor agent status with built-in alerting
- Template variables — Use
agents()andcapabilities(uri)for dynamic dashboards - Annotations — Overlay agent events on any panel
- Alert on status changes — Native Grafana alerting on agent health
# Clone into Grafana plugins directory
git clone <repo> /var/lib/grafana/plugins/agenium-datasource
cd /var/lib/grafana/plugins/agenium-datasource
npm install && npm run build
# Restart Grafana
systemctl restart grafana-serverOr use the provisioning config in provisioning/datasources/agenium.yaml.
| Setting | Description | Default |
|---|---|---|
| DNS Server | Agenium DNS endpoint | http://185.204.169.26:3000 |
| Default Agent URI | Pre-fill agent URI in queries | — |
| API Key | dom_ prefixed registration key |
— |
| Field | Description |
|---|---|
| Agent URI | agent://name.agenium or $variable |
| Method | JSON-RPC method (e.g., agent/status) |
| Format | table or timeseries |
| Payload | JSON params for the call |
| Time Field | Field name for timestamps (timeseries) |
| Value Fields | Comma-separated numeric fields (timeseries) |
# List all registered agents
agents()
# List capabilities of a specific agent
capabilities(search.agenium)
Configure an annotation query with an Agent URI and method (default: agent/events). Events should return objects with timestamp, title, and optionally text and tags.
Set AGENIUM_API_KEY env var and copy provisioning/datasources/agenium.yaml to your Grafana provisioning directory.
MIT
This project includes optional bug reporting to the Agenium monitoring server.
Set the following environment variables to enable bug reporting:
BUG_REPORT_URL=http://130.185.123.153:3100
BUG_REPORT_TOKEN=your_token_here
Bug reporting is disabled by default — it only activates when BUG_REPORT_TOKEN is set. Reports are sent asynchronously (fire and forget) and never block the main application.