Registry / observability / nv-one-logger-core

nv-one-logger-core

library2.3.1pypypi✓ verified 79d ago

nv-one-logger-core is the foundational logging library within the NVIDIA one-logger ecosystem, providing core logging functionality, including spans, events, and attributes. It enables tracking of GPU application progress and helps identify overhead. The library also integrates with OpenTelemetry (OTEL) for backend telemetry. The current version is 2.3.1, with recent releases indicating an active development cadence.

observability

pip install nv-one-logger-core

package ↗

INSTALL

IMPORT

SIG · NV-ONE-LOGGER-CORE

nv-one-logger-core

observabilitypythonv2.3.1

Install

3.4s avg

Import

—

Disk

27MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.3.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.940 runs

installs and imports cleanly · install 0.0s · import 0.000s · 28.7MB

glibc

py 3.10–3.940 runs

installs and imports cleanly · install 3.4s · import 0.000s · 28MB

27MB installed

● package 27MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Logger

✓ import nv_one_logger

✗ from nv_one_logger import Logger

This quickstart demonstrates how to initialize the nv-one-logger-core with OpenTelemetry console exporter, create a logger, and use spans to track operations. The `OTEL_EXPORTER_OTLP_ENDPOINT` environment variable can be set for OTLP exporters.

import os from nv_one_logger.core.api import Logger, Span from nv_one_logger.otel.api import configure_otel from nv_one_logger.otel.config import OTELConfig # Configure OpenTelemetry to export to console for demonstration otel_config = OTELConfig( exporter_type='console', # Options: 'console', 'otlp_grpc', 'otlp_http' service_name='my-application', endpoint=os.environ.get('OTEL_EXPORTER_OTLP_ENDPOINT', '') # Set if using otlp_grpc or otlp_http ) configure_otel(otel_config) # Get a logger instance logger = Logger.get_logger("my_app_logger") # Log a simple message logger.info("Application started.") # Create a span to track an operation with Span.create("process_data", logger=logger) as span: span.set_attribute("input_size", 100) logger.debug("Processing data...") # Simulate some work result = sum(range(100)) span.set_attribute("output_result", result) logger.info("Data processed successfully.") logger.info("Application finished.")

Debug

Known issues

breakingOlder versions (prior to 2.5.0) of the underlying `nv-one-logger` system, which `nv-one-logger-core` is part of, had a 'Too many open files' (`OSError: [Errno 24]`) issue, particularly when integrated with frameworks like NeMo, due to file handlers not being correctly closed.

fix

Upgrade to `nv-one-logger-core` version 2.5.0 or later if available, and ensure any dependent libraries like `nv-one-logger-training-telemetry` are also updated to versions that incorporate this fix. (Note: Current `nv-one-logger-core` is 2.3.1, implying a subsequent release will address this).

affects: <2.5.0

gotchaWhen `nv-one-logger` is disabled or not properly initialized in an environment (e.g., specific distributed training ranks), you might encounter 'Skipping execution of X because OneLogger is not enabled.' warnings. This indicates that instrumentation calls are being made without an active logger.

fix

Ensure `nv-one-logger` is correctly initialized and enabled in all relevant processes/ranks. If logging is intentionally disabled, consider conditionally calling `nv-one-logger` APIs or adjusting framework integrations to avoid unnecessary calls.

affects: All

gotchaThe PyPI description 'Extensions to onelogger library' might be misleading. `nv-one-logger-core` is a core component of the `NVIDIA/nv-one-logger` project, which includes its own OpenTelemetry integration (`nv_one_logger.otel`), and is distinct from other Python 'onelogger' projects (e.g., realsdx/onelogger).

fix

Refer to the NVIDIA GitHub repository (NVIDIA/nv-one-logger) for the authoritative project structure and usage patterns to avoid confusion with unrelated libraries.

affects: All

Upgrade

Version history

2.3.1latest on PyPI · released Oct 29, 2025

Audit

Dependencies

strenumrequiredUsed for robust enum types.

typing-extensionsrequiredProvides backported and experimental typing features.

Agent activity

22 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/nv-one-logger-core/ ↗