Monitoring

Frona AI exposes a Prometheus-compatible metrics endpoint for monitoring your deployment.

Metrics endpoint

The engine exposes metrics at:

GET /api/metrics

This returns metrics in Prometheus exposition format, ready to be scraped by Prometheus, Grafana Agent, or any compatible collector.

Available metrics

The metrics endpoint provides standard application metrics including:

• HTTP request counts and latencies
• Active connections and sessions
• Task execution counts and durations
• Error rates

Setting up Prometheus

Add the Frona engine as a scrape target in your Prometheus configuration:

scrape_configs:
  - job_name: 'frona'
    scrape_interval: 15s
    static_configs:
      - targets: ['frona-engine:3001']
    metrics_path: '/api/metrics'

Docker health checks

Monitor container health with Docker’s built-in health check status:

docker compose ps

Log monitoring

The engine outputs structured logs to stdout. In Docker Compose, view them with:

# All services
docker compose logs -f

# Just the engine
docker compose logs -f frona

# Last 100 lines
docker compose logs --tail 100 frona

For production, consider forwarding logs to a centralized logging system (ELK, Loki, etc.) using a Docker logging driver.

Key things to watch

• Engine health: is the container running and responding to requests?
• Browserless sessions: are sessions being created and cleaned up properly?
• Disk usage: the database and browser profiles grow over time
• Memory usage: especially when many browser sessions are active
• LLM API errors: provider outages or rate limits affect agent responses