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

# run_telemetry

# `prefect.telemetry.run_telemetry`

## Classes

### `OTELSetter` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run\_telemetry.py#L35](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run_telemetry.py#L35)</sup>

A setter for OpenTelemetry that supports Prefect's custom labels.

**Methods:**

#### `set` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run\_telemetry.py#L40](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run_telemetry.py#L40)</sup>

```python theme={null}
set(self, carrier: KeyValueLabels, key: str, value: str) -> None
```

### `RunTelemetry` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run\_telemetry.py#L45](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run_telemetry.py#L45)</sup>

A class for managing the telemetry of runs.

**Methods:**

#### `async_start_span` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run\_telemetry.py#L60](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run_telemetry.py#L60)</sup>

```python theme={null}
async_start_span(self, run: FlowOrTaskRun, client: PrefectClient, parameters: dict[str, Any] | None = None) -> Span | None
```

#### `end_span_on_failure` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run\_telemetry.py#L178](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run_telemetry.py#L178)</sup>

```python theme={null}
end_span_on_failure(self, terminal_message: str | None = None) -> None
```

End a span for a run on failure.

#### `end_span_on_success` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run\_telemetry.py#L169](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run_telemetry.py#L169)</sup>

```python theme={null}
end_span_on_success(self) -> None
```

End a span for a run on success.

#### `record_exception` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run\_telemetry.py#L189](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run_telemetry.py#L189)</sup>

```python theme={null}
record_exception(self, exc: BaseException) -> None
```

Record an exception on a span.

#### `start_span` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run\_telemetry.py#L78](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run_telemetry.py#L78)</sup>

```python theme={null}
start_span(self, run: FlowOrTaskRun, client: SyncPrefectClient, parameters: dict[str, Any] | None = None) -> Span | None
```

#### `traceparent_from_span` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run\_telemetry.py#L164](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run_telemetry.py#L164)</sup>

```python theme={null}
traceparent_from_span(span: Span) -> str | None
```

#### `update_run_name` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run\_telemetry.py#L211](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run_telemetry.py#L211)</sup>

```python theme={null}
update_run_name(self, name: str) -> None
```

Update the name of the run.

#### `update_state` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run\_telemetry.py#L196](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/telemetry/run_telemetry.py#L196)</sup>

```python theme={null}
update_state(self, new_state: State) -> None
```

Update a span with the state of a run.