From 4d0a9df7e8bc8750753ff58eb26938e577a552cd Mon Sep 17 00:00:00 2001 From: Ezzio Moreira Date: Fri, 14 Mar 2025 21:29:36 -0300 Subject: [PATCH 1/5] feat: add pt localization python libraries --- content/pt/docs/languages/python/libraries.md | 113 ++++++++++++++++++ 1 file changed, 113 insertions(+) create mode 100644 content/pt/docs/languages/python/libraries.md diff --git a/content/pt/docs/languages/python/libraries.md b/content/pt/docs/languages/python/libraries.md new file mode 100644 index 000000000000..f721fec5b25a --- /dev/null +++ b/content/pt/docs/languages/python/libraries.md @@ -0,0 +1,113 @@ +--- +title: Usando bibliotecas de instrumentação +linkTitle: Bibliotecas +weight: 40 +cSpell:ignore: httpx instrumentor uninstrument +default_lang_commit: 918511661af010726c8847d7fe41a46231fa59cc +--- + +{{% docs/languages/libraries-intro "python" %}} + +## Usar bibliotecas de instrumentação {#use-instrumentation-libraries} + +Se uma biblioteca não oferece suporte nativo ao OpenTelemetry, você pode usar +[bibliotecas de instrumentação](/docs/specs/otel/glossary/#instrumentation-library) +para gerar dados de telemetria para uma biblioteca ou framework. + +Por exemplo, +[a biblioteca de instrumentação para HTTPX](https://pypi.org/project/opentelemetry-instrumentation-httpx/) +cria automaticamente [trechos](/docs/concepts/signals/traces/#spans) com base em +solicitações HTTP. + +## Configuração {#setup} + +Você pode instalar cada biblioteca de instrumentação separadamente usando pip. +Por exemplo: + +```sh +pip install opentelemetry-instrumentation-{instrumented-library} +``` + +No exemplo anterior, `{instrumented-library}` é o nome da instrumentação. + +Para instalar uma versão de desenvolvimento, clone ou faça um _fork_ do +repositório `opentelemetry-python-contrib` e execute o seguinte comando para +fazer uma instalação editável: + +```sh +pip install -e ./instrumentation/opentelemetry-instrumentation-{integration} +``` + +Após a instalação, você precisará inicializar a biblioteca de instrumentação. +Cada biblioteca geralmente tem sua própria maneira de inicializar. + +## Exemplo com instrumentação HTTPX {#example-with-httpx-instrumentation} + +Veja como você pode instrumentar solicitações HTTP feitas usando a biblioteca +`httpx`. + +Primeiro, instale a biblioteca de instrumentação usando pip: + +```sh +pip install opentelemetry-instrumentation-httpx +``` + +Em seguida, use o instrumentador para rastrear automaticamente as solicitações +de todos os clientes: + +```python +import httpx +from opentelemetry.instrumentation.httpx import HTTPXClientInstrumentor + +url = "https://some.url/get" +HTTPXClientInstrumentor().instrument() + +with httpx.Client() as client: + response = client.get(url) + +async with httpx.AsyncClient() as client: + response = await client.get(url) +``` + +### Desativar instrumentações {#turn-off-instrumentations} + +Se necessário, você pode desinstalar a instrumentação clientes específicas ou +todos os clientes usando o método `uninstrument_client`. Por exemplo: + +```python +import httpx +from opentelemetry.instrumentation.httpx import HTTPXClientInstrumentor + +HTTPXClientInstrumentor().instrument() +client = httpx.Client() + +# Desinstrumentar um cliente específico +HTTPXClientInstrumentor.uninstrument_client(client) + +# Desinstrumentar todos os clientes +HTTPXClientInstrumentor().uninstrument() +``` + +## Bibliotecas de instrumentação disponíveis {#available-instrumentation-libraries} + +Uma lista completa de bibliotecas de instrumentação elaboradas pelo +OpenTelemetry está disponível no repositório [opentelemetry-python-contrib][]. + +Você também pode encontrar mais instrumentações disponíveis em +[registro](/ecosystem/registry/?language=python&component=instrumentation). + +## Próximos passos {#next-steps} + +Depois de configurar as bibliotecas de instrumentação, você pode querer +adicionar sua própria [instrumentação](/docs/languages/python/instrumentation) +no seu código, para coletar dados de telemetria personalizados. + +Você também pode querer configurar um exporter apropriado para +[exportar seus dados de telemetria](/docs/languages/python/exporters) para um ou +mais _backends_ de telemetria. + +Você também pode verificar a +[Instrumentação sem código para Python](/docs/zero-code/python/). + +[opentelemetry-python-contrib]: + https://github.com/open-telemetry/opentelemetry-python-contrib/tree/main/instrumentation#readme From 5fd3e88fd30a773f15b22a4b8e5c61ae5a640389 Mon Sep 17 00:00:00 2001 From: Ezzio Moreira Date: Fri, 14 Mar 2025 21:39:30 -0300 Subject: [PATCH 2/5] fix: cspell --- content/pt/docs/languages/python/libraries.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/python/libraries.md b/content/pt/docs/languages/python/libraries.md index f721fec5b25a..d89b5a84c76c 100644 --- a/content/pt/docs/languages/python/libraries.md +++ b/content/pt/docs/languages/python/libraries.md @@ -2,8 +2,8 @@ title: Usando bibliotecas de instrumentação linkTitle: Bibliotecas weight: 40 -cSpell:ignore: httpx instrumentor uninstrument default_lang_commit: 918511661af010726c8847d7fe41a46231fa59cc +cSpell:ignore: httpx instrumentor uninstrument --- {{% docs/languages/libraries-intro "python" %}} From 10b734624639d862e325e1d902de9da27704c1b9 Mon Sep 17 00:00:00 2001 From: Ezzio Moreira Date: Tue, 18 Mar 2025 19:12:18 -0300 Subject: [PATCH 3/5] fix: apply suggestions from code review Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/python/libraries.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/pt/docs/languages/python/libraries.md b/content/pt/docs/languages/python/libraries.md index d89b5a84c76c..296433e6973e 100644 --- a/content/pt/docs/languages/python/libraries.md +++ b/content/pt/docs/languages/python/libraries.md @@ -8,7 +8,7 @@ cSpell:ignore: httpx instrumentor uninstrument {{% docs/languages/libraries-intro "python" %}} -## Usar bibliotecas de instrumentação {#use-instrumentation-libraries} +## Use bibliotecas de instrumentação {#use-instrumentation-libraries} Se uma biblioteca não oferece suporte nativo ao OpenTelemetry, você pode usar [bibliotecas de instrumentação](/docs/specs/otel/glossary/#instrumentation-library) @@ -71,7 +71,7 @@ async with httpx.AsyncClient() as client: ### Desativar instrumentações {#turn-off-instrumentations} -Se necessário, você pode desinstalar a instrumentação clientes específicas ou +Se necessário, você pode desinstrumentar clientes específicos ou todos os clientes usando o método `uninstrument_client`. Por exemplo: ```python @@ -90,7 +90,7 @@ HTTPXClientInstrumentor().uninstrument() ## Bibliotecas de instrumentação disponíveis {#available-instrumentation-libraries} -Uma lista completa de bibliotecas de instrumentação elaboradas pelo +Uma lista completa de bibliotecas de instrumentação produzidas pelo OpenTelemetry está disponível no repositório [opentelemetry-python-contrib][]. Você também pode encontrar mais instrumentações disponíveis em From 7eb9aabf5392e2c1c064d5b33c506952b7312132 Mon Sep 17 00:00:00 2001 From: Ezzio Moreira Date: Tue, 18 Mar 2025 19:17:54 -0300 Subject: [PATCH 4/5] fix: lint text --- content/pt/docs/languages/python/libraries.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/pt/docs/languages/python/libraries.md b/content/pt/docs/languages/python/libraries.md index 296433e6973e..66bb0d6c7d97 100644 --- a/content/pt/docs/languages/python/libraries.md +++ b/content/pt/docs/languages/python/libraries.md @@ -3,7 +3,7 @@ title: Usando bibliotecas de instrumentação linkTitle: Bibliotecas weight: 40 default_lang_commit: 918511661af010726c8847d7fe41a46231fa59cc -cSpell:ignore: httpx instrumentor uninstrument +cSpell:ignore: httpx instrumentor uninstrument desinstrumentar --- {{% docs/languages/libraries-intro "python" %}} @@ -71,8 +71,8 @@ async with httpx.AsyncClient() as client: ### Desativar instrumentações {#turn-off-instrumentations} -Se necessário, você pode desinstrumentar clientes específicos ou -todos os clientes usando o método `uninstrument_client`. Por exemplo: +Se necessário, você pode desinstrumentar clientes específicos ou todos os +clientes usando o método `uninstrument_client`. Por exemplo: ```python import httpx From cb375689abc35f5e892770d16043ba0fe5cc17e2 Mon Sep 17 00:00:00 2001 From: Ezzio Moreira Date: Tue, 18 Mar 2025 19:28:50 -0300 Subject: [PATCH 5/5] fix: change cspell --- content/pt/docs/languages/python/libraries.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/python/libraries.md b/content/pt/docs/languages/python/libraries.md index 66bb0d6c7d97..aa5d1db59373 100644 --- a/content/pt/docs/languages/python/libraries.md +++ b/content/pt/docs/languages/python/libraries.md @@ -3,7 +3,7 @@ title: Usando bibliotecas de instrumentação linkTitle: Bibliotecas weight: 40 default_lang_commit: 918511661af010726c8847d7fe41a46231fa59cc -cSpell:ignore: httpx instrumentor uninstrument desinstrumentar +cSpell:ignore: desinstrumentar httpx instrumentor uninstrument --- {{% docs/languages/libraries-intro "python" %}}