Skip to content

Commit cc1a110

Browse files
[pt] Add localization content/pt/docs/languages/python/libaries.md (#6554)
Co-authored-by: Marylia Gutierrez <[email protected]>
1 parent 779dec2 commit cc1a110

File tree

1 file changed

+113
-0
lines changed

1 file changed

+113
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,113 @@
1+
---
2+
title: Usando bibliotecas de instrumentação
3+
linkTitle: Bibliotecas
4+
weight: 40
5+
default_lang_commit: 918511661af010726c8847d7fe41a46231fa59cc
6+
cSpell:ignore: desinstrumentar httpx instrumentor uninstrument
7+
---
8+
9+
{{% docs/languages/libraries-intro "python" %}}
10+
11+
## Use bibliotecas de instrumentação {#use-instrumentation-libraries}
12+
13+
Se uma biblioteca não oferece suporte nativo ao OpenTelemetry, você pode usar
14+
[bibliotecas de instrumentação](/docs/specs/otel/glossary/#instrumentation-library)
15+
para gerar dados de telemetria para uma biblioteca ou framework.
16+
17+
Por exemplo,
18+
[a biblioteca de instrumentação para HTTPX](https://pypi.org/project/opentelemetry-instrumentation-httpx/)
19+
cria automaticamente [trechos](/docs/concepts/signals/traces/#spans) com base em
20+
solicitações HTTP.
21+
22+
## Configuração {#setup}
23+
24+
Você pode instalar cada biblioteca de instrumentação separadamente usando pip.
25+
Por exemplo:
26+
27+
```sh
28+
pip install opentelemetry-instrumentation-{instrumented-library}
29+
```
30+
31+
No exemplo anterior, `{instrumented-library}` é o nome da instrumentação.
32+
33+
Para instalar uma versão de desenvolvimento, clone ou faça um _fork_ do
34+
repositório `opentelemetry-python-contrib` e execute o seguinte comando para
35+
fazer uma instalação editável:
36+
37+
```sh
38+
pip install -e ./instrumentation/opentelemetry-instrumentation-{integration}
39+
```
40+
41+
Após a instalação, você precisará inicializar a biblioteca de instrumentação.
42+
Cada biblioteca geralmente tem sua própria maneira de inicializar.
43+
44+
## Exemplo com instrumentação HTTPX {#example-with-httpx-instrumentation}
45+
46+
Veja como você pode instrumentar solicitações HTTP feitas usando a biblioteca
47+
`httpx`.
48+
49+
Primeiro, instale a biblioteca de instrumentação usando pip:
50+
51+
```sh
52+
pip install opentelemetry-instrumentation-httpx
53+
```
54+
55+
Em seguida, use o instrumentador para rastrear automaticamente as solicitações
56+
de todos os clientes:
57+
58+
```python
59+
import httpx
60+
from opentelemetry.instrumentation.httpx import HTTPXClientInstrumentor
61+
62+
url = "https://some.url/get"
63+
HTTPXClientInstrumentor().instrument()
64+
65+
with httpx.Client() as client:
66+
response = client.get(url)
67+
68+
async with httpx.AsyncClient() as client:
69+
response = await client.get(url)
70+
```
71+
72+
### Desativar instrumentações {#turn-off-instrumentations}
73+
74+
Se necessário, você pode desinstrumentar clientes específicos ou todos os
75+
clientes usando o método `uninstrument_client`. Por exemplo:
76+
77+
```python
78+
import httpx
79+
from opentelemetry.instrumentation.httpx import HTTPXClientInstrumentor
80+
81+
HTTPXClientInstrumentor().instrument()
82+
client = httpx.Client()
83+
84+
# Desinstrumentar um cliente específico
85+
HTTPXClientInstrumentor.uninstrument_client(client)
86+
87+
# Desinstrumentar todos os clientes
88+
HTTPXClientInstrumentor().uninstrument()
89+
```
90+
91+
## Bibliotecas de instrumentação disponíveis {#available-instrumentation-libraries}
92+
93+
Uma lista completa de bibliotecas de instrumentação produzidas pelo
94+
OpenTelemetry está disponível no repositório [opentelemetry-python-contrib][].
95+
96+
Você também pode encontrar mais instrumentações disponíveis em
97+
[registro](/ecosystem/registry/?language=python&component=instrumentation).
98+
99+
## Próximos passos {#next-steps}
100+
101+
Depois de configurar as bibliotecas de instrumentação, você pode querer
102+
adicionar sua própria [instrumentação](/docs/languages/python/instrumentation)
103+
no seu código, para coletar dados de telemetria personalizados.
104+
105+
Você também pode querer configurar um exporter apropriado para
106+
[exportar seus dados de telemetria](/docs/languages/python/exporters) para um ou
107+
mais _backends_ de telemetria.
108+
109+
Você também pode verificar a
110+
[Instrumentação sem código para Python](/docs/zero-code/python/).
111+
112+
[opentelemetry-python-contrib]:
113+
https://github.com/open-telemetry/opentelemetry-python-contrib/tree/main/instrumentation#readme

0 commit comments

Comments
 (0)