---
title: "Telemetry"
canonical_url: "https://www.nutrient.io/api/python/telemetry/"
md_url: "https://www.nutrient.io/api/python/telemetry.md"
last_updated: "2026-07-15T14:46:57.766Z"
description: "Telemetry control surface used by the fiona CLI's send-only child mode. Lets a parent process dump proto payloads to disk via the `NUTRIENT_PAYLOAD_PATH` envir…"
---

Telemetry control surface used by the fiona CLI's send-only child mode. Lets a parent process dump proto payloads to disk via the `NUTRIENT_PAYLOAD_PATH` environment variable, exit fast, and have a short-lived child re-hydrate and ship them in parallel.

```python

from nutrient_sdk import Telemetry

```

## Construction

```python

Telemetry()

```

Creates a new `Telemetry` instance with default settings.

## Class Methods

### flush

```python

@classmethod
def flush(cls, timeout_milliseconds: int) -> None

```

Waits up to `timeoutMilliseconds` for any in-flight telemetry sends to complete. Strategy-dependent: a no-op for the default channel strategy, blocking for the parallel-send strategy.

**Parameters:**

| Name                   | Type  | Description |
| ---------------------- | ----- | ----------- |
| `timeout_milliseconds` | `int` |             |

---

### send_payloads_from_directory

```python

@classmethod
def send_payloads_from_directory(cls, directory: str) -> None

```

Re-enqueues every `*.pb` file in `directory` into the active telemetry strategy as a raw payload, deleting each file on successful enqueue. Intended for the fiona send-only child mode.

**Parameters:**

| Name        | Type  | Description |
| ----------- | ----- | ----------- |
| `directory` | `str` |             |

---

---

## Related pages

- [Open a PDF and convert it to a Word document](/api/python.md)
- [Document](/api/python/document.md)
- [License](/api/python/license.md)
- [Query](/api/python/query.md)
- [Vision](/api/python/vision.md)