Observability

AegisFlow exposes free local observability by default. No hosted monitoring service is required.

Prometheus Metrics

Metrics are served from the admin port:

curl -fsS http://localhost:8081/metrics | grep '^aegisflow_'

Local Prometheus scrape config:

deployments/observability/prometheus.yml

The main gateway metrics are:

Metric	Meaning
aegisflow_requests_total	Request count by tenant, method, path, and status
aegisflow_request_duration_seconds	Request latency histogram by tenant, method, and path

Grafana

Dashboard JSON:

deployments/grafana/aegisflow-dashboard.json

Import the dashboard into a local Grafana instance and point it at a local Prometheus datasource. The dashboard includes:

• gateway throughput
• p50 and p95 latency
• request count by status
• request count by tenant
• request count by path

Local-Only Docker Example

Run AegisFlow:

make demo-local

Run Prometheus locally with the included config:

docker run --rm -p 9090:9090 \
  -v "$PWD/deployments/observability/prometheus.yml:/etc/prometheus/prometheus.yml:ro" \
  prom/prometheus:latest

Grafana can be run locally as well:

docker run --rm -p 3000:3000 grafana/grafana-oss:latest

These containers are optional. AegisFlow itself exposes metrics without them.