> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://openrouter.ai/docs/llms.txt.
> For full documentation content, see https://openrouter.ai/docs/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://openrouter.ai/docs/_mcp/server.

# TraceConfig - Python SDK

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

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"}` |