Documentation Index
Fetch the complete documentation index at: https://docs.risolu.to/llms.txt
Use this file to discover all available pages before exploring further.
Risoluto exposes Prometheus metrics at GET /metrics. This recipe wires up Prometheus + Grafana for dashboards and alerting.
Available metrics
| Metric | Type | Description |
|---|
risoluto_http_requests_total | Counter | HTTP requests by method and status |
risoluto_http_request_duration_seconds | Histogram | Request latency distribution (buckets) |
risoluto_orchestrator_polls_total | Counter | Poll cycles by status (success, error, skipped) |
risoluto_agent_runs_total | Counter | Agent completions by outcome (completed, failed, oom, stalled) |
Setup
Create Prometheus config
Create prometheus.yml alongside your docker-compose.yml:global:
scrape_interval: 15s
evaluation_interval: 15s
scrape_configs:
- job_name: risoluto
static_configs:
- targets: ["risoluto:4000"]
metrics_path: /metrics
scrape_interval: 10s
Add monitoring services
Create docker-compose.monitoring.yml:docker-compose.monitoring.yml
services:
prometheus:
image: prom/prometheus:latest
volumes:
- ./prometheus.yml:/etc/prometheus/prometheus.yml:ro
- prometheus-data:/prometheus
ports:
- "9090:9090"
restart: unless-stopped
grafana:
image: grafana/grafana:latest
volumes:
- grafana-data:/var/lib/grafana
ports:
- "3001:3000"
environment:
- GF_SECURITY_ADMIN_PASSWORD=changeme
depends_on:
- prometheus
restart: unless-stopped
volumes:
prometheus-data:
grafana-data:
Start the stack
docker compose -f docker-compose.yml -f docker-compose.monitoring.yml up -d
# Prometheus targets should show risoluto as UP
curl -s http://localhost:9090/api/v1/targets | jq '.data.activeTargets[].health'
Configure Grafana
- Open Grafana at http://localhost:3001 (admin / changeme)
- Data Sources > Add Prometheus:
http://prometheus:9090
- Import or build dashboards using the queries below
Grafana dashboard queries
Agent success rate (1h window)
sum(rate(risoluto_agent_runs_total{outcome="completed"}[1h]))
/
sum(rate(risoluto_agent_runs_total[1h]))
Active polls per minute
rate(risoluto_orchestrator_polls_total{status="success"}[5m]) * 60
HTTP error rate
sum(rate(risoluto_http_requests_total{status=~"5.."}[5m]))
/
sum(rate(risoluto_http_requests_total[5m]))
P95 API latency
histogram_quantile(0.95, rate(risoluto_http_request_duration_seconds_bucket[5m]))
Agent runs by outcome (stacked)
sum by (outcome) (increase(risoluto_agent_runs_total[1h]))
Alert rules
Add alert rules to your Prometheus config or a separate rules.yml:
groups:
- name: risoluto
rules:
- alert: HighAgentFailureRate
expr: >
rate(risoluto_agent_runs_total{outcome="failed"}[15m])
/ rate(risoluto_agent_runs_total[15m]) > 0.3
for: 15m
labels:
severity: critical
annotations:
summary: "Agent failure rate above 30%"
- alert: PollStalled
expr: increase(risoluto_orchestrator_polls_total[10m]) == 0
for: 10m
labels:
severity: warning
annotations:
summary: "Orchestrator hasn't polled in 10 minutes"
- alert: HighApiLatency
expr: >
histogram_quantile(0.95,
rate(risoluto_http_request_duration_seconds_bucket[5m])
) > 2
for: 5m
labels:
severity: warning
annotations:
summary: "P95 API latency above 2 seconds"
- alert: HighErrorRate
expr: >
rate(risoluto_http_requests_total{status=~"5.."}[5m])
/ rate(risoluto_http_requests_total[5m]) > 0.05
for: 5m
labels:
severity: warning
annotations:
summary: "HTTP 5xx error rate above 5%"
For lightweight monitoring without Prometheus, Risoluto’s built-in Slack notifications cover agent lifecycle events (start, complete, fail, PR delivered). See Notifications for setup. Scraping from outside Docker
If Risoluto runs directly on the host (not in a container), point Prometheus at host.docker.internal:4000 or your machine’s LAN IP:
# Quick test — confirm metrics are reachable
curl -s http://127.0.0.1:4000/metrics | head -20
What’s Next
Observability
Full observability reference — SSE events, audit logs, and data persistence.
Troubleshooting
Common failure cases and recovery procedures.
Notifications
Configure Slack notifications for agent lifecycle events.
