---
title: Troubleshooting
path: troubleshooting
status: published
---

# Troubleshooting

Targeted diagnostic guides for the most common production issues. Each page walks through what the system actually does, where it logs, and the SQL queries to run.

| If you're seeing… | Go to |
|---|---|
| A draft invoice that won't transition to finalized | [Invoice won't finalise](./troubleshooting/invoice-not-finalising) |
| A webhook subscriber not receiving (or not processing) events | [Webhook not delivered](./troubleshooting/webhook-not-delivered) |
| A registered service showing `health_status='unreachable'` | [Service marked unreachable](./troubleshooting/service-marked-unreachable) |

For more abstract operational background, see [Reference: configuration](./reference/configuration) (env vars), [CLI](./reference/cli) (`scaicontrol setup` / `sync` / `admin`), and [state machines](./reference/state-machines).