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

# nemoguardrails.tracing.span_format

Span format definitions for NeMo Guardrails tracing.

## Module Contents

### Classes

| Name                                                           | Description                         |
| -------------------------------------------------------------- | ----------------------------------- |
| [`SpanFormat`](#nemoguardrails-tracing-span_format-SpanFormat) | Supported span formats for tracing. |

### Functions

| Name                                                                               | Description                                                |
| ---------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [`validate_span_format`](#nemoguardrails-tracing-span_format-validate_span_format) | Validate and convert span format value to SpanFormat enum. |

### Data

[`SpanFormatType`](#nemoguardrails-tracing-span_format-SpanFormatType)

### API

```python
class nemoguardrails.tracing.span_format.SpanFormat
```

**Bases:** `enum.Enum`

Supported span formats for tracing.

Inherits from str to allow direct string comparison and JSON serialization.

```python
nemoguardrails.tracing.span_format.validate_span_format(
    value: nemoguardrails.tracing.span_format.SpanFormatType
) -> nemoguardrails.tracing.span_format.SpanFormat
```

Validate and convert span format value to SpanFormat enum.

**Parameters:**

Span format as enum, literal, or string

**Returns:** `SpanFormat`

Validated SpanFormat enum value

**Raises:**

* `ValueError`: If value is not a valid span format

```python
nemoguardrails.tracing.span_format.SpanFormatType = Union[SpanFormat, Literal['legacy', 'opentelemetry'], str]
```