Module logging 

Dynamo Distributed Logging Module.

• Configuration loaded from:
  1. Environment variables (highest priority).
  2. Optional TOML file pointed to by the DYN_LOGGING_CONFIG_PATH environment variable.
  3. /opt/dynamo/etc/logging.toml.

Logging can take two console forms: READABLE or JSONL. Select one with DYN_LOGGING_CONSOLE_FORMAT=readable|jsonl; the default is READABLE. DYN_LOGGING_JSONL=1 remains a legacy fallback when the new setting is unset or blank. Console presentation is independent of OpenTelemetry export.

To use local timezone for logging timestamps, set the DYN_LOG_USE_LOCAL_TZ environment variable to 1.

Filters can be configured using the DYN_LOG environment variable or by setting the filters key in the TOML configuration file. Filters are comma-separated key-value pairs where the key is the crate or module name and the value is the log level. The default log level is info.

Example:

log_level = "error"

[log_filters]
"test_logging" = "info"
"test_logging::api" = "trace"

Structs

DistributedTraceContext

DistributedTraceIdLayer

FieldVisitor

TraceParent

Traits

GenericHeaders

Functions

extract_otel_context_from_nats_headers

Extract OpenTelemetry trace context from NATS headers for distributed tracing

get_distributed_tracing_context

init

Initialize logging (idempotent). Safe to call with or without a running Tokio runtime — OTLP exporters fall back to a persistent background runtime.

inject_current_trace_into_nats_headers

Inject trace context from current span into NATS headers

inject_otel_context_into_nats_headers

Inject OpenTelemetry trace context into NATS headers using W3C Trace Context propagation

inject_trace_headers_into_map

is_valid_span_id

Validate a given span ID according to W3C Trace Context specifications. A valid span ID is a 16-character hexadecimal string (lowercase).

is_valid_trace_id

Validate a given trace ID according to W3C Trace Context specifications. A valid trace ID is a 32-character hexadecimal string (lowercase).

log_message

Log a message with file and line info Used by Python wrapper

make_client_request_span

Create a client_request span linked to the parent trace context

make_handle_payload_span

Create a handle_payload span from NATS headers with component context

make_handle_payload_span_from_tcp_headers

Create a handle_payload span from TCP/HashMap headers with component context

make_inference_request_span

Create a span for inference request endpoints (completions, chat, embeddings, etc.).

make_system_request_span

Create a span for system endpoints (health, metrics, models, engine, loras, etc.).

otel_parent_context_from_distributed

parse_traceparent

Parse a traceparent string into its components