# telemetry

Python API: `luxonis_ml.telemetry`

Public telemetry API for Luxonis packages.

The luxonis_ml.telemetry package exposes a lightweight event-capture client, environment-driven configuration, singleton helpers,
context providers, and suppression tools. It is designed so consuming packages can emit usage events without coupling directly to
a specific analytics backend. PostHog support is optional through `luxonis-ml[telemetry]`; disabled, misconfigured, and debug
configurations can use no-op or stdout backends.

> **Example**
> Emit an event from a component while keeping backend configuration separate from the call site.

```python
from luxonis_ml.telemetry import Telemetry

telemetry = Telemetry("luxonis_ml", source_component="data")
telemetry.capture(
    "dataset_export_started",
    {"dataset_type": "coco"},
)
```

> **Note**
> Telemetry failures are intentionally non-fatal for host applications. If a backend cannot be initialized or capture fails, the telemetry layer falls back or suppresses the error rather than interrupting the caller.

> **See Also**
> [luxonis_ml.telemetry.client](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/client.md) for the capture client, [luxonis_ml.telemetry.config](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/config.md) for configuration, and [luxonis_ml.telemetry.backends](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/backends.md) for backend implementations.

## Child Pages

 * [backends](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/backends.md)
 * [cli](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/cli.md)
 * [client](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/client.md)
 * [config](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/config.md)
 * [context](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/context.md)
 * [events](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/events.md)
 * [redaction](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/redaction.md)
 * [singleton](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/singleton.md)
 * [suppression](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/suppression.md)