Skip to content

Monitoring and Alerts

Aegis provides local health/metrics endpoints and aggregates telemetry into Axis.

What to Monitor

  • Agent liveness/readiness
  • Enrollment and heartbeat status
  • Policy sync status
  • TLS handshake success/failure rates
  • Latency and error rates

Metrics Endpoint

By default, agents expose:

  • Health: http://127.0.0.1:9080/health
  • Metrics: http://127.0.0.1:9080/metrics

In Kubernetes, you can query metrics from inside the pod:

kubectl -n <namespace> exec <agent-pod> -- sh -lc 'curl -fsS http://127.0.0.1:9080/metrics | head'

Axis Dashboards

Use Axis for:

  • fleet-wide health
  • telemetry trends
  • policy rollout visibility

Alerts

Alerting is deployment-dependent. Common alert types:

  • agent heartbeat missing
  • policy sync failures
  • TLS failure rate spikes
  • latency regression during rollout