Telemetry Manager

LLM-friendly telemetry abstraction layer for Arshai framework.

This module provides a well-behaved OTEL citizen implementation that: 1. Never creates TracerProvider/MeterProvider instances 2. Always uses get_tracer(“arshai”, version) pattern 3. Respects parent application’s configuration 4. Works with and without OTEL dependencies 5. Provides no-op implementations when OTEL is unavailable

Classes

arshai.observability.telemetry_manager.Meter

alias of NoOpMeter

class arshai.observability.telemetry_manager.NoOpInstrument

Bases: object

add(value, attributes=None)

record(value, attributes=None)

class arshai.observability.telemetry_manager.NoOpMeter

Bases: object

create_counter(**kwargs)

create_histogram(**kwargs)

create_up_down_counter(**kwargs)

class arshai.observability.telemetry_manager.NoOpSpan

Bases: object

set_attribute(key, value)

set_status(status)

record_exception(exception)

class arshai.observability.telemetry_manager.NoOpTracer

Bases: object

start_as_current_span(name, **kwargs)

arshai.observability.telemetry_manager.Span

alias of NoOpSpan

class arshai.observability.telemetry_manager.SpanKind

Bases: object

CLIENT = 'CLIENT'

class arshai.observability.telemetry_manager.Status(code, description='')

Bases: object

__init__(code, description='')

class arshai.observability.telemetry_manager.StatusCode

Bases: object

ERROR = 'ERROR'

OK = 'OK'

class arshai.observability.telemetry_manager.TelemetryManager(config=None)

Bases: object

LLM-friendly telemetry manager that respects parent OTEL configuration.

__init__(config=None)

Initialize telemetry manager.

Parameters:

config (Optional[PackageObservabilityConfig]) – Optional observability configuration

is_enabled()

Check if telemetry is enabled and functional.

Return type:

bool

is_metrics_enabled()

Check if metrics collection is enabled.

Return type:

bool

get_tracer()

Get the tracer instance.

Return type:

NoOpTracer

get_meter()

Get the meter instance.

Return type:

NoOpMeter

create_span(name, attributes=None, kind=None)

Create a span with automatic context propagation.

Parameters:

• name (str) – Span name

• attributes (Optional[Dict[str, Any]]) – Optional span attributes

• kind (Optional[SpanKind]) – Optional span kind

create_async_span(name, attributes=None, kind=None)

Create an async span with automatic context propagation.

Parameters:

• name (str) – Span name

• attributes (Optional[Dict[str, Any]]) – Optional span attributes

• kind (Optional[SpanKind]) – Optional span kind

create_counter(name, description, unit='1')

Create a counter metric.

create_histogram(name, description, unit='1')

Create a histogram metric.

create_up_down_counter(name, description, unit='1')

Create an up-down counter metric.

set_span_attributes_safely(span, attributes)

Safely set span attributes with error handling.

set_span_status_safely(span, success, error_message=None)

Safely set span status with error handling.

record_exception_safely(span, exception)

Safely record exception on span.

get_package_info()

Get package information for telemetry.

Return type:

Dict[str, str]

arshai.observability.telemetry_manager.Tracer

alias of NoOpTracer

Functions

arshai.observability.telemetry_manager.get_telemetry_manager(config=None)

Get or create the default telemetry manager.

Parameters:

config (Optional[PackageObservabilityConfig]) – Optional configuration (only used for first creation)

Return type:

TelemetryManager

Returns:

TelemetryManager instance

arshai.observability.telemetry_manager.reset_telemetry_manager()

Reset the global telemetry manager (useful for testing).