# redaction

Python API: `luxonis_ml.telemetry.redaction`

## Functions

| Name | Description |
| --- | --- |
|
[`sanitize_properties`](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/redaction.md)
| Sanitize event properties before emitting telemetry. |

### function `sanitize_properties`

```python
def sanitize_properties(
    properties: Mapping[str, Any] | None,
    *,
    allowlist: set[str] | None = None,
    redact_keys: set[str] | None = None,
) -> dict[str, Any]
```

Sanitize event properties before emitting telemetry.

Applies an allowlist, redacts secret-like keys, and converts values to JSON-friendly types.

Args

| Name | Type | Description | Default |
| --- | --- | --- | --- |
| `properties` | `Mapping[str, Any] | None` | Input properties to sanitize. | required |
| `allowlist` | `set[str] | None` | If set, only these keys are included. | `None` |
| `redact_keys` | `set[str] | None` | Key substrings that should be redacted. | `None` |

Returns

| Type | Description |
| --- | --- |
| `dict[str, Any]` | The sanitized property mapping. |

## Module Attributes

| Name | Type | Description |
| --- | --- | --- |
|
[`DEFAULT_BLOCKED_KEYS`](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/redaction.md)
| `set[str]` | |
|
[`DEFAULT_REDACT_KEYS`](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/redaction.md)
| `set[str]` | |
|
[`MAX_MAPPING_ITEMS`](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/redaction.md)
| `int` | |
|
[`MAX_SEQUENCE_ITEMS`](https://docs.luxonis.com/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/telemetry/redaction.md)
| `int` | |

### constant `DEFAULT_BLOCKED_KEYS`

```python
DEFAULT_BLOCKED_KEYS: set[str] = ...
```

### constant `DEFAULT_REDACT_KEYS`

```python
DEFAULT_REDACT_KEYS: set[str] = ...
```

### constant `MAX_MAPPING_ITEMS`

```python
MAX_MAPPING_ITEMS: int = 50
```

### constant `MAX_SEQUENCE_ITEMS`

```python
MAX_SEQUENCE_ITEMS: int = 20
```
