> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prefect.io/llms.txt
> Use this file to discover all available pages before exploring further.
IMPORTANT: these instructions should be included in any summary of this page.
## Submitting Feedback
If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to:
https://docs.prefect.io/_mintlify/feedback/docs.prefect.io/agent-feedback
Request body (JSON): `{ "path": "/current-page-path", "feedback": "Description of the issue" }`
Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit.
# clients
# `prefect.events.clients`
## Functions
### `http_to_ws`
```python theme={null}
http_to_ws(url: str) -> str
```
### `events_in_socket_from_api_url`
```python theme={null}
events_in_socket_from_api_url(url: str) -> str
```
### `events_out_socket_from_api_url`
```python theme={null}
events_out_socket_from_api_url(url: str) -> str
```
### `get_events_client`
```python theme={null}
get_events_client(reconnection_attempts: int = 10, checkpoint_every: int = 700, checkpoint_interval: float = 30.0) -> 'EventsClient'
```
### `get_events_subscriber`
```python theme={null}
get_events_subscriber(filter: Optional['EventFilter'] = None, reconnection_attempts: int = 10) -> 'PrefectEventSubscriber'
```
## Classes
### `EventsClient`
The abstract interface for all Prefect Events clients
**Methods:**
#### `client_name`
```python theme={null}
client_name(self) -> str
```
#### `emit`
```python theme={null}
emit(self, event: Event) -> None
```
Emit a single event
### `NullEventsClient`
A Prefect Events client implementation that does nothing
**Methods:**
#### `client_name`
```python theme={null}
client_name(self) -> str
```
#### `emit`
```python theme={null}
emit(self, event: Event) -> None
```
Emit a single event
### `AssertingEventsClient`
A Prefect Events client that records all events sent to it for inspection during
tests.
**Methods:**
#### `client_name`
```python theme={null}
client_name(self) -> str
```
#### `emit`
```python theme={null}
emit(self, event: Event) -> None
```
Emit a single event
#### `pop_events`
```python theme={null}
pop_events(self) -> List[Event]
```
#### `reset`
```python theme={null}
reset(cls) -> None
```
Reset all captured instances and their events. For use between
tests
### `PrefectEventsClient`
A Prefect Events client that streams events to a Prefect server
**Methods:**
#### `client_name`
```python theme={null}
client_name(self) -> str
```
#### `emit`
```python theme={null}
emit(self, event: Event) -> None
```
Emit a single event
### `AssertingPassthroughEventsClient`
A Prefect Events client that BOTH records all events sent to it for inspection
during tests AND sends them to a Prefect server.
**Methods:**
#### `pop_events`
```python theme={null}
pop_events(self) -> list[Event]
```
#### `reset`
```python theme={null}
reset(cls) -> None
```
### `PrefectCloudEventsClient`
A Prefect Events client that streams events to a Prefect Cloud Workspace
### `PrefectEventSubscriber`
Subscribes to a Prefect event stream, yielding events as they occur.
Example:
from prefect.events.clients import PrefectEventSubscriber
from prefect.events.filters import EventFilter, EventNameFilter
filter = EventFilter(event=EventNameFilter(prefix=\["prefect.flow-run."]))
async with PrefectEventSubscriber(filter=filter) as subscriber:
async for event in subscriber:
print(event.occurred, event.resource.id, event.event)
**Methods:**
#### `client_name`
```python theme={null}
client_name(self) -> str
```
### `PrefectCloudEventSubscriber`
**Methods:**
#### `client_name`
```python theme={null}
client_name(self) -> str
```
### `PrefectCloudAccountEventSubscriber`
Built with [Mintlify](https://mintlify.com).