Troubleshooting

Edge returns 503 on /v1/decision

Likely causes:

• no bundle loaded
• invalid startup env combination
• runtime dependency init failure

Checks:

curl -i http://localhost:8080/readyz
fairvisor status --edge-url=http://localhost:8080

Unexpected 429 spikes

Likely causes:

• overly strict limiter config
• wrong descriptor key forwarding
• rollout regression

Checks:

• Rejection Reasons
• Runbooks

SaaS disconnected

Likely causes:

• token invalid/expired
• bad SaaS URL
• network/TLS issues

Checks:

curl -sS http://localhost:8080/metrics | rg fairvisor_saas_reachable

Rules not matching expected traffic

Likely causes:

• selector mismatch (hosts, pathExact, pathPrefix)
• missing X-Original-* headers in decision_service mode
• method filter mismatch

Checks:

• verify request host against selector.hosts
• if using decision_service, ensure X-Original-Host is forwarded
• Selectors
• Decision API