> ## Documentation Index
> Fetch the complete documentation index at: https://logixlysia-claude-elysia-v2-open-beta-i2faib.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sentry

> Ship structured logs to Sentry next to your errors and traces

Send logs to [Sentry](https://sentry.io)'s structured logs (**Explore → Logs**). Every meta field becomes a typed, searchable attribute, and logs link to traces through `trace_id` — no Sentry SDK required.

## Setup

1. Create (or open) a project in Sentry and copy its DSN from **Settings → Projects → Client Keys (DSN)**.
2. Set the environment variable:

```bash theme={null}
SENTRY_DSN=https://your-public-key@o0.ingest.sentry.io/your-project-id
```

3. Wire the transport:

```ts theme={null}
import { Elysia } from 'elysia'
import logixlysia from 'logixlysia'
import { createSentryTransport } from 'logixlysia/sentry'

const app = new Elysia()
  .use(
    logixlysia({
      config: {
        transports: [createSentryTransport()]
      }
    })
  )
  .get('/', () => 'ok')
  .listen(3000)
```

4. Trigger a request and open **Explore → Logs** in Sentry.

## Environment Variables

| Variable             | Required | Description                                              |
| -------------------- | -------- | -------------------------------------------------------- |
| `SENTRY_DSN`         | Yes      | Project DSN (`https://<public-key>@<host>/<project-id>`) |
| `SENTRY_ENVIRONMENT` | No       | Sets the `sentry.environment` attribute                  |
| `SENTRY_RELEASE`     | No       | Sets the `sentry.release` attribute                      |

## Options

```ts theme={null}
const sentry = createSentryTransport({
  environment: 'production',
  release: '1.4.2',
  tags: { team: 'backend' }
})
```

| Option        | Type                     | Default              | Description                         |
| ------------- | ------------------------ | -------------------- | ----------------------------------- |
| `dsn`         | `string`                 | `SENTRY_DSN`         | Project DSN                         |
| `environment` | `string`                 | `SENTRY_ENVIRONMENT` | `sentry.environment` attribute      |
| `release`     | `string`                 | `SENTRY_RELEASE`     | `sentry.release` attribute          |
| `tags`        | `Record<string, string>` | —                    | Extra attributes added to every log |

Plus the shared batching options: `maxBatchSize`, `flushIntervalMs`, `timeout`, `retries` — see the [overview](/docs/adapters/overview#shared-behavior).

## Payload

Logs post to the project's envelope endpoint as Sentry log items:

* **Body** — the log message, or `GET /path` for access logs.
* **Level** — `DEBUG` → `debug`, `INFO` → `info`, `WARNING` → `warn`, `ERROR` → `error`.
* **Attributes** — meta fields flattened to typed attributes (`string`, `integer`, `double`, `boolean`): `request.method`, `status`, `durationMs`, `context.requestId`, and anything you merge into the request context.
* **Trace ID** — reused from `context.trace_id` when [`logixlysia/otel`](/docs/integrations/otel) injected one (linking logs to the trace), otherwise generated.

Filter in Sentry by any attribute, e.g. `status:500` or `context.requestId:0d5e…`.

## Troubleshooting

* **`401` / `403`** — the DSN was revoked or belongs to another project; copy a fresh one from Client Keys.
* **`invalid DSN` at startup** — the expected shape is `https://<public-key>@<host>/<project-id>`.
* **Logs don't link to traces** — make sure `trace_id` reaches the request context via [`logixlysia/otel`](/docs/integrations/otel).