# Python

> <img width="35" class="img-initial otel-icon" src="/img/logos/32x32/Python_SDK.svg" alt="Python"> Uma implementação específica de linguagem do OpenTelemetry em Python.

---

LLMS index: [llms.txt](/llms.txt)

---


Esta é a documentação do OpenTelemetry para a linguagem Python. O
OpenTelemetry é um framework de observabilidade -- API, SDKs, e ferramentas que
são desenvolvidas para auxiliar na geração e coleta de dados de telemetria de
aplicações, como métricas, logs e rastros. Esta documentação foi criada para te
auxiliar a entender como começar a utilizar o OpenTelemetry em Python.

## Estado e Lançamentos {#status-and-releases}

O estado atual dos principais componentes funcionais do OpenTelemetry para
Python é o seguinte:

| Rastros             | Métricas             | Logs              |
| ------------------- | -------------------- | ----------------- |
| [Stable](/docs/specs/otel/versioning-and-stability/#stable) | [Stable](/docs/specs/otel/versioning-and-stability/#stable) | [Development](/docs/specs/otel/versioning-and-stability/#development) |

Para lançamentos, incluindo a [última versão][latest release], consulte a página
de [Lançamentos][Releases]. 

[latest release]:
  <https://github.com/open-telemetry/opentelemetry-python/releases/latest>
[Releases]:
  <https://github.com/open-telemetry/opentelemetry-python/releases>
{{__hugo_ctx/}}


## Suporte de Versão {#status-and-releases}

O OpenTelemetry suporta a versão Python 3.9 e superiores.

## Instalação {#installation}

Os pacotes API e SDK estão disponíveis no PyPI e podem ser instalados via pip:

```sh
pip install opentelemetry-api
pip install opentelemetry-sdk
```

Além disso, existem vários pacotes de extensão que podem ser instalados
separadamente como:

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

Essas são as bibliotecas de exporters e instrumentação, respectivamente. Os
exporters Jaeger, Zipkin, Prometheus, OTLP e OpenCensus podem ser encontrados no
diretório de
[exporters](https://github.com/open-telemetry/opentelemetry-python/blob/main/exporter/)
do repositório. Instrumentações e exporters adicionais podem ser encontrados no
repositório contrib
[instrumentação](https://github.com/open-telemetry/opentelemetry-python-contrib/tree/main/instrumentation)
e
[exporter](https://github.com/open-telemetry/opentelemetry-python-contrib/tree/main/exporter)
diretórios.

## Extensões {#extensions}

Para encontrar projetos relacionados como exporters, bibliotecas de
instrumentação, implementações de rastreadores, etc., visite o
[Registro](/ecosystem/registry/?s=python).

### Instalando Pacotes de Ponta {#installing-cutting-edge-packages}

Há algumas funcionalidades que ainda não foram lançadas no PyPI. Nessa situação,
você pode querer instalar os pacotes diretamente do repositório. Isso pode ser
feito clonando o repositório e fazendo uma
[instalação editável](https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs):

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

## Repositórios e _benchmarks_

- Repositório Principal: [opentelemetry-python][]
- Repositório Contrib: [opentelemetry-python-contrib][]

[opentelemetry-python]: https://github.com/open-telemetry/opentelemetry-python
[opentelemetry-python-contrib]:
  https://github.com/open-telemetry/opentelemetry-python-contrib

---

Section pages:

- [Primeiros Passos](/pt/docs/languages/python/getting-started/): Obtenha telemetria para sua aplicação em menos de 5 minutos!
- [Instrumentação](/pt/docs/languages/python/instrumentation/): Instrumentação manual para OpenTelemetry Python
- [Usando bibliotecas de instrumentação](/pt/docs/languages/python/libraries/)
- [Exporters](/pt/docs/languages/python/exporters/): Processar e exportar seus dados de telemetria
- [Propagação](/pt/docs/languages/python/propagation/): Propagação de contexto para o SDK Python
- [Cookbook](/pt/docs/languages/python/cookbook/)
- [Distribuição do OpenTelemetry](/pt/docs/languages/python/distro/)
- [Usando o mypy](/pt/docs/languages/python/mypy/)
- [Benchmarks](/pt/docs/languages/python/benchmarks/)
- [Referência da API](/pt/docs/languages/python/api/)
- [Exemplos](/pt/docs/languages/python/examples/)
- [Registry](/pt/docs/languages/python/registry/): Bibliotecas de instrumentação, exportadores e outros componentes úteis para OpenTelemetry Python