> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/gym/_mcp/server.

# nemo_gym.telemetry

NeMo Gym telemetry: optional OpenTelemetry instrumentation via nemo-lens.

Importing this package never requires nemo-lens. Install it with
`uv sync --extra telemetry` and switch it on with a `telemetry:` block or
`NEMO_LENS_ENABLED=1`; with either missing, every instrumentation site in `nemo_gym`
is a \~0-cost no-op.

**Public surface**

* `TelemetryConfig` — the `telemetry:` config block.
* `GymSpanGroup` — Gym span groups and presets.
* `configure_telemetry_env` — supervisor side; hands
  the settings to spawned server processes through the environment.
* `init_telemetry` /
  `get_telemetry` /
  `shutdown_telemetry` — per-process lifecycle.

Instrumentation primitives (`managed_span` / `span_cm` / `trace_fn` /
`is_span_group_enabled` / `safe_set_span_attributes`) come from
`nemo_gym.telemetry._fallbacks`, which resolves to the real nemo-lens
implementations when it is installed and to no-op stubs when it is not.

See `nemo_gym/telemetry/README.md` for the design, and
`fern/versions/latest/pages/observability/` for user documentation.

## Submodules

* **[`nemo_gym.telemetry.concurrency`](/nemo/gym/nemo-gym/nemo_gym/telemetry/concurrency)**
* **[`nemo_gym.telemetry.config`](/nemo/gym/nemo-gym/nemo_gym/telemetry/config)**
* **[`nemo_gym.telemetry.connection_pool`](/nemo/gym/nemo-gym/nemo_gym/telemetry/connection_pool)**
* **[`nemo_gym.telemetry.contrib`](/nemo/gym/nemo-gym/nemo_gym/telemetry/contrib)**
* **[`nemo_gym.telemetry.endpoints`](/nemo/gym/nemo-gym/nemo_gym/telemetry/endpoints)**
* **[`nemo_gym.telemetry.gym_metrics`](/nemo/gym/nemo-gym/nemo_gym/telemetry/gym_metrics)**
* **[`nemo_gym.telemetry.memory`](/nemo/gym/nemo-gym/nemo_gym/telemetry/memory)**
* **[`nemo_gym.telemetry.metrics`](/nemo/gym/nemo-gym/nemo_gym/telemetry/metrics)**
* **[`nemo_gym.telemetry.observer`](/nemo/gym/nemo-gym/nemo_gym/telemetry/observer)**
* **[`nemo_gym.telemetry.profiling`](/nemo/gym/nemo-gym/nemo_gym/telemetry/profiling)**
* **[`nemo_gym.telemetry.resources_operations`](/nemo/gym/nemo-gym/nemo_gym/telemetry/resources_operations)**
* **[`nemo_gym.telemetry.setup`](/nemo/gym/nemo-gym/nemo_gym/telemetry/setup)**
* **[`nemo_gym.telemetry.span_groups`](/nemo/gym/nemo-gym/nemo_gym/telemetry/span_groups)**
* **[`nemo_gym.telemetry.spans`](/nemo/gym/nemo-gym/nemo_gym/telemetry/spans)**
* **[`nemo_gym.telemetry.startup`](/nemo/gym/nemo-gym/nemo_gym/telemetry/startup)**

## Package Contents

### Data

[`_PUBLIC_API`](#nemo_gym-telemetry-_PUBLIC_API)

### API

```python
nemo_gym.telemetry._PUBLIC_API = {'MeteredSemaphore': 'concurrency', 'Profiler': 'profiling', 'ResourcesOperation...
```

## Docs

- [nemo_gym.telemetry.concurrency](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/concurrency.md)
- [nemo_gym.telemetry.config](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/config.md)
- [nemo_gym.telemetry.connection_pool](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/connection_pool.md)
- [nemo_gym.telemetry.contrib](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/contrib.md)
- [nemo_gym.telemetry.endpoints](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/endpoints.md)
- [nemo_gym.telemetry.gym_metrics](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/gym_metrics.md)
- [nemo_gym.telemetry.memory](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/memory.md)
- [nemo_gym.telemetry.metrics](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/metrics.md)
- [nemo_gym.telemetry.observer](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/observer.md)
- [nemo_gym.telemetry.profiling](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/profiling.md)
- [nemo_gym.telemetry.resources_operations](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/resources_operations.md)
- [nemo_gym.telemetry.setup](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/setup.md)
- [nemo_gym.telemetry.span_groups](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/span_groups.md)
- [nemo_gym.telemetry.spans](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/spans.md)
- [nemo_gym.telemetry.startup](https://docs.nvidia.com/nemo/gym/main/nemo-gym/nemo_gym/telemetry/startup.md)