Plataforma open source de observabilidade nativa do OpenTelemetry que reúne logs, métricas, traces, alertas e dashboards em uma única ferramenta que pode ser hospedada por você.
open-telemetry/opentelemetry-python
API e SDK em Python para OpenTelemetry, o framework independente de fornecedores para coletar traces, métricas e logs de aplicações.
- Estrelas
- 2,702
- Forks
- 1,059
- Issues abertas
- 428
- Último commit
- há 15 horas
O que é?
OpenTelemetry Python é a implementação em Python do padrão de observabilidade OpenTelemetry. Ele oferece uma API para instrumentar código com traces, métricas e logs, além de um SDK que serve como implementação de referência dessa API e gerencia a amostragem, o processamento e a exportação dos dados de telemetria.
O projeto é dividido em pacotes. Bibliotecas que emitem telemetria dependem apenas de opentelemetry-api, deixando a escolha do SDK a cargo da aplicação. Os pacotes de exporters e propagators ficam no mesmo repositório, e a API e o SDK são publicados no PyPI. Traces e métricas são considerados estáveis, enquanto logs ainda estão em desenvolvimento.
O SDK é voltado a equipes que querem enviar telemetria de serviços Python para qualquer backend compatível com OpenTelemetry, sem vincular o código a um único fornecedor. Bibliotecas de instrumentação para frameworks comuns são mantidas separadamente no repositório opentelemetry-python-contrib.
Recursos principais
- 01Oferece uma API independente de fornecedores para traces, métricas e logs.
- 02Inclui um SDK de referência para processar e exportar dados de telemetria.
- 03Mantém a API separada do SDK para que bibliotecas emitam telemetria sem precisar escolher um backend.
- 04Disponibiliza pacotes de exporters e propagators que podem ser instalados separadamente via pip.
- 05Oferece suporte às versões atuais do Python, encerrando o suporte quando elas chegam ao fim da vida útil.
Casos de uso
- Instrumentar um serviço web em Python para rastrear requisições entre sistemas distribuídos.
- Exportar métricas de aplicações para um backend de monitoramento compatível com OpenTelemetry.
- Criar uma biblioteca Python que emita telemetria e deixe a escolha do SDK a cargo de quem a utiliza.
Início rápido
- 1
Instale o pacote da API pelo PyPI
pip install opentelemetry-api - 2
Instale o pacote do SDK pelo PyPI
pip install opentelemetry-sdk
Antes de usar
- Logs signal ainda está em desenvolvimento e pode passar por mudanças incompatíveis.
Em coleções
Tópicos
Perguntas frequentes
- O que é opentelemetry-python?
- API e SDK em Python para OpenTelemetry, o framework independente de fornecedores para coletar traces, métricas e logs de aplicações. OpenTelemetry Python é a implementação em Python do padrão de observabilidade OpenTelemetry. Ele oferece uma API para instrumentar código com traces, métricas e logs, além de um SDK que serve como implementação de referência dessa API e gerencia a amostragem, o processamento e a exportação dos dados de telemetria.
- opentelemetry-python é gratuito? Qual é a licença?
- opentelemetry-python é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- opentelemetry-python ainda é mantido?
- Manutenção ativa. O último commit de opentelemetry-python foi em 6 de nov. de 2026.
- Para que posso usar opentelemetry-python?
- Instrumentar um serviço web em Python para rastrear requisições entre sistemas distribuídos. Exportar métricas de aplicações para um backend de monitoramento compatível com OpenTelemetry. Criar uma biblioteca Python que emita telemetria e deixe a escolha do SDK a cargo de quem a utiliza.
- Como instalar opentelemetry-python?
- Instale o pacote da API pelo PyPI: pip install opentelemetry-api Instale o pacote do SDK pelo PyPI: pip install opentelemetry-sdk
- Onde consigo opentelemetry-python?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/open-telemetry/opentelemetry-python
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Sistema de APM para monitorar, rastrear e diagnosticar arquiteturas distribuídas e cloud-native de microsserviços.
Plataforma de observabilidade auto-hospedável para logs, métricas, traces, RUM e monitoramento de LLMs, desenvolvida em Rust e apresentada como alternativa ao Datadog e ao Splunk.
A implementação do OpenTelemetry em Go, com APIs e SDKs para instrumentar aplicações Go com traces, métricas e logs.
APM de código aberto que reúne traces, métricas e logs do OpenTelemetry em uma única interface, com armazenamento no ClickHouse.
Serviço independente de fornecedor que recebe, processa e exporta traces, métricas e logs para vários back-ends de observabilidade.