# events

Python API: `luxonis_ml.telemetry.events`

## Classes

### TelemetryEvent

Represents a single telemetry event.

#### Methods

##### create

```python
def create(*, name: str, properties: dict[str, Any], context: dict[str, Any], distinct_id: str | None = None, schema_version: int = 1) -> TelemetryEvent:
```

Create a telemetry event with a UTC timestamp.

Parameters

 * `name` (`str`): Event name.
 * `properties` (`dict[str, Any]`): Event properties after sanitization.
 * `context` (`dict[str, Any]`): Merged context to attach to the event.
 * `distinct_id` (`str | None`): Optional backend identity override.
 * `schema_version` (`int`): Event schema version.

Returns

 * `TelemetryEvent`: A telemetry event with a UTC timestamp.

##### to_payload

```python
def to_payload(self) -> dict[str, Any]:
```

Serialize the event into a JSON-friendly dict.

#### Attributes

##### context

##### distinct_id

##### name

##### properties

##### schema_version

##### timestamp