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

# TraceConfig

Metadata for observability and tracing. Known keys (trace\_id, trace\_name, span\_name, generation\_name, parent\_span\_id) have special handling. Additional keys are passed through as custom metadata to configured broadcast destinations.

## Example Usage

```typescript theme={null}
import { TraceConfig } from "@openrouter/sdk/models";

let value: TraceConfig = {};
```

## Fields

| Field                  | Type                   | Required             | Description | Example                                                                        |
| ---------------------- | ---------------------- | -------------------- | ----------- | ------------------------------------------------------------------------------ |
| `generationName`       | *string*               | :heavy\_minus\_sign: | N/A         |                                                                                |
| `parentSpanId`         | *string*               | :heavy\_minus\_sign: | N/A         |                                                                                |
| `spanName`             | *string*               | :heavy\_minus\_sign: | N/A         |                                                                                |
| `traceId`              | *string*               | :heavy\_minus\_sign: | N/A         |                                                                                |
| `traceName`            | *string*               | :heavy\_minus\_sign: | N/A         |                                                                                |
| `additionalProperties` | Record\<string, *any*> | :heavy\_minus\_sign: | N/A         | \{<br />"trace\_id": "trace-abc123",<br />"trace\_name": "my-app-trace"<br />} |