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

# bridge

## SplunkAOAgentControlBridge

Bridge Agent Control telemetry into the active Splunk AO logger hierarchy.

Bridge rules:

* Events are converted only when the logger has an active trace parent.
* Events are converted only when their `trace_id` and `span_id` match the
  current Splunk AO trace/span context advertised through the public provider.
* Events that fail validation or do not match the active context are dropped
  safely rather than attached to the wrong logger hierarchy.

### register

```python theme={null}
def register(self) -> SplunkAOAgentControlBridge
```

Register this bridge and install the shared Splunk AO trace-context dispatcher.

### unregister

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

Unregister this bridge and restore the previous provider only if Splunk AO still owns the slot.

### write\_events

```python theme={null}
def write_events(self, events: Any) -> Any
```

Convert Agent Control events into Splunk AO control spans.

## setup\_agent\_control\_bridge

```python theme={null}
def setup_agent_control_bridge(splunk_ao_logger: SplunkAOLogger,
```

Create and register an Agent Control bridge for a Splunk AO logger.