# Troubleshooting

- Canonical URL: https://docs.fairvisor.com/docs/reference/troubleshooting/
- Section: docs
- Last updated: n/a
> Symptom-driven troubleshooting for common edge issues.


## Edge returns 503 on /v1/decision

Likely causes:

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

Checks:

```bash
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](/docs/reference/reasons/)
- [Runbooks](/docs/reference/runbooks/)

## SaaS disconnected

Likely causes:

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

Checks:

```bash
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](/docs/policy/selectors/)
- [Decision API](/docs/reference/api/)