> ## 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.

## Fields

| Field                | Type              | Required             | Description | Example                                                                        |
| -------------------- | ----------------- | -------------------- | ----------- | ------------------------------------------------------------------------------ |
| `generation_name`    | *Optional\[str]*  | :heavy\_minus\_sign: | N/A         |                                                                                |
| `parent_span_id`     | *Optional\[str]*  | :heavy\_minus\_sign: | N/A         |                                                                                |
| `span_name`          | *Optional\[str]*  | :heavy\_minus\_sign: | N/A         |                                                                                |
| `trace_id`           | *Optional\[str]*  | :heavy\_minus\_sign: | N/A         |                                                                                |
| `trace_name`         | *Optional\[str]*  | :heavy\_minus\_sign: | N/A         |                                                                                |
| `__pydantic_extra__` | Dict\[str, *Any*] | :heavy\_minus\_sign: | N/A         | \{<br />"trace\_id": "trace-abc123",<br />"trace\_name": "my-app-trace"<br />} |