> ## Documentation Index
> Fetch the complete documentation index at: https://helloluciallc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sentry Observability

<Note>
  Sentry captures real runtime failures and helps distinguish system bugs from provider or configuration issues.
</Note>

***

## Role

Sentry is used for:

```text theme={"dark"}
runtime error capture
payload failures
environment visibility
trace context
deployment confidence
```

***

## Current Value

Sentry has already identified live-transition issues such as:

```text theme={"dark"}
PayloadTooLargeError
request entity too large
webhook parsing limits
```

This confirms Sentry is catching meaningful system failures.

***

## Product Importance

Observability is not optional for Lucia.

Lucia handles real-world operational signals. Failures must be visible.

***

## Useful Signals

Important Sentry events include:

```text theme={"dark"}
webhook failures
OpenAI gateway failures
body parser failures
unhandled route errors
provider payload issues
```

***

## Relationship to Render Logs

Render logs answer:

```text theme={"dark"}
Did the request arrive?
What was the status?
How long did it take?
```

Sentry answers:

```text theme={"dark"}
Why did the request fail?
Where in code did it fail?
What environment did it affect?
```

***

## See Also

* [01 - Render](/lucia/infrastructure/render)
* [Webhook Routing Strategy](/lucia/infrastructure/webhook-routing-strategy)
* [07 - Postmark (Email Inbound)](/lucia/infrastructure/postmark-email-inbound)