repository·main·Indexed 25 days ago
https://github.com/open-telemetry/opentelemetry-pythonImplementation of the OpenTelemetry specification for Python applications to collect, process, and export traces, metrics, and logs. It consists of the opentelemetry-api for abstract definitions and the opentelemetry-sdk for the reference implementation, along with separate packages for exporters and propagators. The project also includes opentelemetry-configuration for declarative SDK setup via JSON or YAML and an internal opentelemetry-codegen-json library for generating Python code from OTLP JSON representations.
The opentelemetry-codegen-json library is a protocol buffer plugin designed to generate Python code for the OpenTelemetry protocol (OTLP) specifically in JSON format.
Note: This is an internal package and is not intended for publication to PyPI.
This package provides OpenTelemetry OTLP export utilities. It is designed to be used by OpenTelemetry signal exporters (such as those for traces, metrics, and logs) that transmit telemetry using the OTLP protocol.
Note: All functionality in this package is currently marked as internal. It is intended for use by other OpenTelemetry exporter packages and is not intended for direct use by application developers.
opentelemetry-exporter-otlp-json-file library exports telemetry as OTLP JSON to a file-like text stream (such as a file or stdout). It writes newline-delimited OTLP JSON records, which is suitable for file-based collection workflows.The basic_tracer examples demonstrate two primary patterns for instrumenting Python applications:
SpanProcessor and an Exporter, how to initialize a tracer, and how to manually create and manage a span.resource information (metadata about the entity producing the telemetry, such as service name or version) to a Provider.Detailed source files can be found in the docs/examples/basic_tracer/ directory.
opentelemetry-exporter-otlp-json-common library provides convenience utilities for encoding telemetry data into the OpenTelemetry Protocol (OTLP) JSON format.opentelemetry-configuration package allows you to use file-based configuration for the OpenTelemetry Python SDK, following the OpenTelemetry configuration specification. This enables declarative setup of the SDK using JSON or YAML files instead of purely programmatic configuration.This library is a low-level utility used to handle Protobuf encoding for OpenTelemetry. It is not typically used directly by end-users but serves as a core dependency for the following exporters:
opentelemetry-exporter-otlp-proto-grpcopentelemetry-exporter-otlp-proto-httpopentelemetry.sdk._logs are subject to change in minor or patch releases and do not currently provide backward compatibility guarantees.OpenTelemetry Python allows you to customize how metrics are processed and output by the SDK using Views. Views can be used to modify the aggregation, naming, or attribute set of metrics before they are exported.
Common scenarios for using Views include:
change_aggregation.py).change_name.py).limit_num_of_attrs.py).drop_metrics_from_instrument.py).ExemplarReservoir (e.g., change_reservoir_factory.py).When using OTEL_CONFIG_FILE, keep the following behaviors in mind:
OTEL_* environment variables are ignored.OTEL_PYTHON_* variables (like OTEL_PYTHON_TRACER_CONFIGURATOR) are not applied. You must capture this behavior in the config file or your code.tracer_provider) is omitted from the file, it results in a no-op provider.disabled: true at the top level of the configuration file turns the entire SDK into a no-op.