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

# Server telemetry quickstart

> Install @aient/otel and initialize it before HTTP, database, or queue clients to send Node.js traces and logs to Aient with service name and release metadata.

# Server telemetry quickstart

Install the server package and initialize it before your application creates HTTP servers, database clients, queues, or framework handlers.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
pnpm add @aient/otel
```

```ts theme={"theme":{"light":"github-light","dark":"github-dark"}}
import { registerOTel } from '@aient/otel'

registerOTel({
  publishableKey: process.env.AIENT_PUBLISHABLE_KEY,
  serviceName: 'api',
  release: {
    commit: process.env.COMMIT_SHA,
    branch: process.env.COMMIT_REF,
    environment: process.env.NODE_ENV ?? 'development',
  },
})
```

## Required values

| Value                 | Source                                                                    |
| --------------------- | ------------------------------------------------------------------------- |
| `publishableKey`      | Aient environment key for the target environment                          |
| `serviceName`         | Stable name for this runtime, matching source map uploads when applicable |
| `release.environment` | Deployment environment slug such as `prod`, `qa`, or `dev`                |
| `release.commit`      | Exact deployed commit SHA for release correlation                         |

Send traces and logs to Aient unless you override endpoints for local collector testing.