로그, 메트릭, 트레이스, 알림을 하나로 모은 오픈소스 OpenTelemetry 기반 셀프 호스팅 관측성 플랫폼
open-telemetry/opentelemetry-python
애플리케이션에서 트레이스, 메트릭, 로그를 수집하는 벤더 중립적 프레임워크인 OpenTelemetry의 Python API와 SDK입니다.
- 스타
- 2,702
- 포크
- 1,059
- 열린 이슈
- 428
- 마지막 커밋
- 23시간 전
어떤 프로젝트인가요?
OpenTelemetry Python은 OpenTelemetry 관측성 표준을 Python으로 구현한 프로젝트입니다. 코드에 트레이스, 메트릭, 로그를 계측할 수 있는 API와, 해당 API의 참조 구현으로서 텔레메트리 데이터의 샘플링, 처리, 내보내기를 담당하는 SDK를 제공합니다.
프로젝트는 여러 패키지로 구성됩니다. 텔레메트리를 생성하는 라이브러리는 opentelemetry-api에만 의존하므로 SDK는 애플리케이션에서 선택할 수 있습니다. Exporter와 propagator 패키지도 같은 저장소에 있으며, API와 SDK는 PyPI에 배포됩니다. 트레이스와 메트릭은 안정화된 상태지만 로그는 아직 개발 중입니다.
이 SDK는 코드를 특정 벤더에 종속시키지 않고 Python 서비스의 텔레메트리를 OpenTelemetry 호환 백엔드로 전송하려는 팀을 대상으로 합니다. 일반적인 프레임워크용 계측 라이브러리는 별도의 opentelemetry-python-contrib 저장소에서 관리합니다.
핵심 기능
- 01트레이스, 메트릭, 로그를 위한 벤더 중립적인 API를 제공합니다.
- 02텔레메트리 데이터를 처리하고 내보내는 참조 SDK를 포함합니다.
- 03API와 SDK를 분리해 라이브러리가 백엔드를 선택하지 않고도 텔레메트리를 생성할 수 있습니다.
- 04pip로 각각 설치할 수 있는 Exporter 및 propagator 패키지를 제공합니다.
- 05현재 지원되는 Python 버전을 지원하며, 각 버전이 수명 종료에 도달하면 지원을 중단합니다.
활용 사례
- 분산 시스템 전반에서 요청을 추적하도록 Python 웹 서비스를 계측합니다.
- 애플리케이션 메트릭을 OpenTelemetry 호환 모니터링 백엔드로 내보냅니다.
- 사용자가 SDK를 선택하도록 맡기면서 텔레메트리를 생성하는 Python 라이브러리를 개발합니다.
빠른 시작
- 1
PyPI에서 API 패키지를 설치하세요
pip install opentelemetry-api - 2
PyPI에서 SDK 패키지를 설치하세요
pip install opentelemetry-sdk
사용 전 알아둘 점
- Logs signal은 아직 개발 중이며 호환성을 깨뜨리는 변경이 있을 수 있습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- opentelemetry-python은(는) 무엇인가요?
- 애플리케이션에서 트레이스, 메트릭, 로그를 수집하는 벤더 중립적 프레임워크인 OpenTelemetry의 Python API와 SDK입니다. OpenTelemetry Python은 OpenTelemetry 관측성 표준을 Python으로 구현한 프로젝트입니다. 코드에 트레이스, 메트릭, 로그를 계측할 수 있는 API와, 해당 API의 참조 구현으로서 텔레메트리 데이터의 샘플링, 처리, 내보내기를 담당하는 SDK를 제공합니다.
- opentelemetry-python은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- opentelemetry-python은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- opentelemetry-python은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. opentelemetry-python의 마지막 커밋은 2026년 11월 6일입니다.
- opentelemetry-python은(는) 어디에 사용할 수 있나요?
- 분산 시스템 전반에서 요청을 추적하도록 Python 웹 서비스를 계측합니다. 애플리케이션 메트릭을 OpenTelemetry 호환 모니터링 백엔드로 내보냅니다. 사용자가 SDK를 선택하도록 맡기면서 텔레메트리를 생성하는 Python 라이브러리를 개발합니다.
- opentelemetry-python는 어떻게 설치하나요?
- PyPI에서 API 패키지를 설치하세요: pip install opentelemetry-api PyPI에서 SDK 패키지를 설치하세요: pip install opentelemetry-sdk
- opentelemetry-python은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/open-telemetry/opentelemetry-python
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
분산 및 클라우드 네이티브 마이크로서비스 아키텍처를 모니터링하고 추적·진단하는 APM 시스템입니다.
Rust로 구축한 셀프 호스팅 가능한 관측성 플랫폼으로, 로그·메트릭·트레이스·RUM·LLM 모니터링을 지원하며 Datadog과 Splunk의 대안으로 소개됩니다.
Go 애플리케이션에 트레이스, 메트릭, 로그를 계측할 수 있도록 API와 SDK를 제공하는 OpenTelemetry의 Go 구현체입니다.
OpenTelemetry 트레이스, 메트릭, 로그를 ClickHouse 스토리지 기반의 단일 UI에서 수집하는 오픈소스 APM입니다.
여러 관측 백엔드로 트레이스, 메트릭, 로그를 수집·처리·내보내는 벤더 중립 서비스입니다.