The Aris Brain exposes a Prometheus-compatible API at /prometheus/* for integration with Grafana and other monitoring tools.
The Prometheus query API is a de facto standard for time-series monitoring. By exposing this interface, Aris Brain can integrate with:
- Grafana - Create dashboards and alerts
- Prometheus - Federate metrics
- AlertManager - Configure alerting rules
- Custom tools - Any Prometheus-compatible client
Base URL
http://aris.local/prometheus/api/v1/
Authentication
The Prometheus endpoints require API token authentication (not session tokens).Create an API token via the web UI or /api/tokens endpoint.
Authorization header:
curl http://aris.local/prometheus/api/v1/query?query=up \
-H "Authorization: Bearer YOUR_API_TOKEN"
Grafana Configuration
When adding as a Prometheus data source in Grafana:
| Setting | Value |
|---|
| URL | http://aris.local/prometheus |
| Access | Server (default) |
| Custom Headers | Authorization: Bearer YOUR_API_TOKEN |
Available Endpoints
| Endpoint | Method | Description |
|---|
/api/v1/query | GET, POST | Instant query |
/api/v1/query_range | GET, POST | Range query |
/api/v1/labels | GET | List all label names |
/api/v1/label/{name}/values | GET | List values for a label |
/api/v1/series | GET | Find series by selectors |
/api/v1/metadata | GET | Metric metadata |
Backend
The Prometheus API proxies to VictoriaMetrics running on the Brain. VictoriaMetrics provides efficient storage and querying of time-series data with full PromQL support. 
