> ## Documentation Index
> Fetch the complete documentation index at: https://openrouter-d02e98a0-mintlify-5b6e02fd.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TraceConfig - Python SDK

> TraceConfig method reference

<Warning>
  The Python SDK and docs are currently in beta.
  Report issues on [GitHub](https://github.com/OpenRouterTeam/python-sdk/issues).
</Warning>

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, *Nullable\[Any]*] | :heavy\_minus\_sign: | N/A         | `{"trace_id": "trace-abc123","trace_name": "my-app-trace"}` |