[pt] Localize content/pt/docs/languages/python/getting-started.md #6292
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
/fix:fix:dict |
1 similar comment
|
/fix:fix:dict |
|
/fix:all |
|
You triggered fix:all action run at https://github.com/open-telemetry/opentelemetry.io/actions/runs/13274109143 |
|
fix:all failed or was cancelled. For details, see https://github.com/open-telemetry/opentelemetry.io/actions/runs/13274109143. |
vitorvasc
reviewed
Feb 12, 2025
|
|
||
| O exemplo a seguir usa um aplicativo básico | ||
| [Flask](https://flask.palletsprojects.com/). Se você não estiver usando Flask, | ||
| tudo bem — você pode usar OpenTelemetry Python com outros frameworks web também, |
There was a problem hiding this comment.
Suggested change
| tudo bem — você pode usar OpenTelemetry Python com outros frameworks web também, | |
| tudo bem — você pode usar OpenTelemetry Python com outros _frameworks_ web também, |
vitorvasc
reviewed
Feb 12, 2025
| [Flask](https://flask.palletsprojects.com/). Se você não estiver usando Flask, | ||
| tudo bem — você pode usar OpenTelemetry Python com outros frameworks web também, | ||
| como Django e FastAPI. Para uma lista completa de bibliotecas para frameworks | ||
| suportados, veja o |
There was a problem hiding this comment.
Deixando meus 5 cents, para reflexão de todos.
Na tradução de "see the [...]", lembro que utilizei o termo "consulte" nas traduções de Go e algumas outras páginas. Não sei se, de repente, acham que esse termo possa fazer mais sentido.
Suggested change
| suportados, veja o | |
| suportados, consulte o |
vitorvasc
reviewed
Feb 12, 2025
| suportados, veja o | ||
| [registro](/ecosystem/registry/?component=instrumentation&language=python). | ||
|
|
||
| Para exemplos mais elaborados, veja |
There was a problem hiding this comment.
Mesmo ponto do comentário anterior, caso faça sentido :)
Suggested change
| Para exemplos mais elaborados, veja | |
| Para exemplos mais elaborados, consulte |
vitorvasc
reviewed
Feb 12, 2025
| return randint(1, 6) | ||
| ``` | ||
|
|
||
| Execute o aplicativo com o seguinte comando e acesse |
There was a problem hiding this comment.
Suggested change
| Execute o aplicativo com o seguinte comando e acesse | |
| Execute a aplicação utilizando o comando abaixo e acesse |
vitorvasc
reviewed
Feb 12, 2025
|
|
||
| A instrumentação sem código gerará dados de telemetria para você. Existem várias | ||
| opções que você pode seguir, cobertas em mais detalhes em | ||
| [Instrumentação sem Código](/docs/zero-code/python/). Aqui usaremos o agente |
There was a problem hiding this comment.
Suggested change
| [Instrumentação sem Código](/docs/zero-code/python/). Aqui usaremos o agente | |
| [Instrumentação sem código](/docs/zero-code/python/). Aqui usaremos o agente |
vitorvasc
reviewed
Feb 12, 2025
Comment on lines
+94
to
+96
| Instale o pacote `opentelemetry-distro`, que contém a API, SDK do OpenTelemetry | ||
| e também as ferramentas `opentelemetry-bootstrap` e `opentelemetry-instrument` | ||
| que você usará a seguir. |
There was a problem hiding this comment.
Acha que a sugestão abaixo fica mais fluída?
Suggested change
| Instale o pacote `opentelemetry-distro`, que contém a API, SDK do OpenTelemetry | |
| e também as ferramentas `opentelemetry-bootstrap` e `opentelemetry-instrument` | |
| que você usará a seguir. | |
| Instale o pacote `opentelemetry-distro`, que contém a API e SDK do OpenTelemetry, além das ferramentas `opentelemetry-bootstrap` e `opentelemetry-instrument` | |
| que serão utilizadas a seguir. |
vitorvasc
reviewed
Feb 12, 2025
Comment on lines
+112
to
+113
| Agora você pode executar seu aplicativo instrumentado com | ||
| `opentelemetry-instrument` e fazer com que ele imprima no console por enquanto: |
There was a problem hiding this comment.
Usando como referência a tradução que subimos para NodeJS: https://opentelemetry.io/pt/docs/languages/js/getting-started/nodejs/
Suggested change
| Agora você pode executar seu aplicativo instrumentado com | |
| `opentelemetry-instrument` e fazer com que ele imprima no console por enquanto: | |
| Agora, você poderá executar a sua aplicação instrumentada com | |
| `opentelemetry-instrument` e fazer com que os dados sejam emitidos no console: |
vitorvasc
reviewed
Feb 12, 2025
|
|
||
| Isso instalará a instrumentação do Flask. | ||
|
|
||
| ## Execute o aplicativo instrumentado {#run-the-instrumented-app} |
There was a problem hiding this comment.
Suggested change
| ## Execute o aplicativo instrumentado {#run-the-instrumented-app} | |
| ## Execute a aplicação instrumentada {#run-the-instrumented-app} |
vitorvasc
reviewed
Feb 12, 2025
| ``` | ||
|
|
||
| Acesse <http://localhost:8080/rolldice> no seu navegador e recarregue a página | ||
| algumas vezes. Depois de um tempo, você deverá ver os trechos impressos no |
There was a problem hiding this comment.
Suggested change
| algumas vezes. Depois de um tempo, você deverá ver os trechos impressos no | |
| algumas vezes. Depois de um tempo, você deverá ver os trechos exibidos no |
vitorvasc
reviewed
Feb 12, 2025
| } | ||
| } | ||
| { | ||
| "body": "Jogador anonimo esta jogando os dados: 3", |
There was a problem hiding this comment.
Suggested change
| "body": "Jogador anonimo esta jogando os dados: 3", | |
| "body": "Jogador anônimo está jogando os dados: 3", |
vitorvasc
reviewed
Feb 12, 2025
|
|
||
| </details> | ||
|
|
||
| O trecho gerado rastreia a duração de uma solicitação para a rota `/rolldice`. |
There was a problem hiding this comment.
Usando como referência a mesma tradução em NodeJS: https://opentelemetry.io/pt/docs/languages/js/getting-started/nodejs/
Suggested change
| O trecho gerado rastreia a duração de uma solicitação para a rota `/rolldice`. | |
| O trecho gerado rastreia o tempo de vida de uma requisição para a rota `/rolldice`. |
vitorvasc
reviewed
Feb 12, 2025
| A linha de log emitida durante a solicitação contém o mesmo ID de rastro e ID de | ||
| trecho e é exportada para o console via o exportador de logs. | ||
|
|
||
| Envie mais algumas solicitações para o endpoint e em seguida, espere um pouco ou |
There was a problem hiding this comment.
Suggested change
| Envie mais algumas solicitações para o endpoint e em seguida, espere um pouco ou | |
| Envie mais algumas solicitações para esta rota e em seguida, espere um pouco ou |
vitorvasc
reviewed
Feb 12, 2025
| ], | ||
| "is_monotonic": false | ||
| }, | ||
| "description": "mede o número de solicitações HTTP simultâneas que estão atualmente em andamento", |
There was a problem hiding this comment.
Suggested change
| "description": "mede o número de solicitações HTTP simultâneas que estão atualmente em andamento", | |
| "description": "mede o número de requisições HTTP simultâneas que estão atualmente em andamento", |
vitorvasc
reviewed
Feb 12, 2025
| } | ||
| ] | ||
| }, | ||
| "description": "mede a duração da solicitação HTTP recebida", |
There was a problem hiding this comment.
Suggested change
| "description": "mede a duração da solicitação HTTP recebida", | |
| "description": "mede a duração da requisição HTTP recebida", |
vitorvasc
reviewed
Feb 12, 2025
| ## Adicione instrumentação manual à instrumentação automática {#add-manual-instrumentation-to-automatic-instrumentation} | ||
|
|
||
| A instrumentação automática captura telemetria nas bordas dos seus sistemas, | ||
| como solicitações HTTP de entrada e saída, mas não captura o que está |
There was a problem hiding this comment.
Suggested change
| como solicitações HTTP de entrada e saída, mas não captura o que está | |
| como requisições HTTP de entrada e saída, mas não captura o que está |
vitorvasc
reviewed
Feb 12, 2025
|
|
||
| A instrumentação automática captura telemetria nas bordas dos seus sistemas, | ||
| como solicitações HTTP de entrada e saída, mas não captura o que está | ||
| acontecendo no seu aplicativo. Para isso, você precisará escrever alguma |
There was a problem hiding this comment.
Suggested change
| acontecendo no seu aplicativo. Para isso, você precisará escrever alguma | |
| acontecendo na sua aplicação. Para isso, você precisará escrever alguma |
vitorvasc
reviewed
Feb 12, 2025
| return res | ||
| ``` | ||
|
|
||
| Agora execute o aplicativo novamente: |
There was a problem hiding this comment.
Suggested change
| Agora execute o aplicativo novamente: | |
| Agora, execute a aplicação novamente: |
vitorvasc
reviewed
Feb 12, 2025
| flask run -p 8080 | ||
| ``` | ||
|
|
||
| Quando você enviar uma solicitação ao servidor, verá dois trechos no rastro |
There was a problem hiding this comment.
Suggested change
| Quando você enviar uma solicitação ao servidor, verá dois trechos no rastro | |
| Quando você enviar uma requisição ao servidor, verá dois trechos no rastro |
vitorvasc
reviewed
Feb 12, 2025
| return randint(1, 6) | ||
| ``` | ||
|
|
||
| Agora execute o aplicativo novamente: |
There was a problem hiding this comment.
Suggested change
| Agora execute o aplicativo novamente: | |
| Agora, execute a aplicação novamente: |
vitorvasc
reviewed
Feb 12, 2025
| flask run -p 8080 | ||
| ``` | ||
|
|
||
| Quando você enviar uma solicitação para o servidor, verá a métrica do contador |
There was a problem hiding this comment.
Suggested change
| Quando você enviar uma solicitação para o servidor, verá a métrica do contador | |
| Quando você enviar uma requisição para o servidor, verá a métrica do contador |
vitorvasc
reviewed
Feb 12, 2025
Comment on lines
+488
to
+489
| de jogadas emitida para o console, com contagens separadas para cada valor de | ||
| jogada: |
There was a problem hiding this comment.
Suggested change
| de jogadas emitida para o console, com contagens separadas para cada valor de | |
| jogada: | |
| de jogadas emitida para o console, com contagens de valor separadas para cada jogada: |
vitorvasc
reviewed
Feb 12, 2025
| "metrics": [ | ||
| { | ||
| "name": "http.server.active_requests", | ||
| "description": "mede o número de solicitações HTTP simultâneas que estão atualmente em andamento", |
There was a problem hiding this comment.
Suggested change
| "description": "mede o número de solicitações HTTP simultâneas que estão atualmente em andamento", | |
| "description": "mede o número de requisições HTTP simultâneas que estão atualmente em andamento", |
vitorvasc
reviewed
Feb 12, 2025
| }, | ||
| { | ||
| "name": "http.server.duration", | ||
| "description": "mede a duração da solicitação HTTP recebida", |
There was a problem hiding this comment.
Suggested change
| "description": "mede a duração da solicitação HTTP recebida", | |
| "description": "mede a duração da requisição HTTP recebida", |
vitorvasc
reviewed
Feb 12, 2025
|
|
||
| </details> | ||
|
|
||
| ## Envie telemetria para um Coletor OpenTelemetry {#send-telemetry-to-an-opentelemetry-collector} |
There was a problem hiding this comment.
Suggested change
| ## Envie telemetria para um Coletor OpenTelemetry {#send-telemetry-to-an-opentelemetry-collector} | |
| ## Envie telemetria para o OpenTelemetry Collector {#send-telemetry-to-an-opentelemetry-collector} |
vitorvasc
reviewed
Feb 12, 2025
Comment on lines
+649
to
+650
| das implantações em produção. Alguns exemplos de quando é benéfico usar um | ||
| coletor: |
There was a problem hiding this comment.
Ficaria mais fluído dessa maneira? Além disso, faz sentido utilizar o termo Collector, como componente?
Suggested change
| das implantações em produção. Alguns exemplos de quando é benéfico usar um | |
| coletor: | |
| das implantações em produção. Alguns exemplos de quando é benéfico utilizar um Collector: |
vitorvasc
reviewed
Feb 12, 2025
|
|
||
| - Um único ponto de telemetria compartilhado por vários serviços, para reduzir a | ||
| sobrecarga de troca de exportadores | ||
| - Agregando rastros entre vários serviços, executados em vários hosts |
There was a problem hiding this comment.
Pensei em utilizarmos "instâncias", mas não sei se essa é a melhor tradução para "hosts" 🤔
Suggested change
| - Agregando rastros entre vários serviços, executados em vários hosts | |
| - Agregando rastros entre vários serviços, executados em várias instâncias |
vitorvasc
reviewed
Feb 12, 2025
| - Um local central para processar rastros antes de exportá-los para um backend | ||
|
|
||
| A menos que você tenha apenas um único serviço ou esteja experimentando, você | ||
| desejará usar um coletor em implantações de produção. |
There was a problem hiding this comment.
Suggested change
| desejará usar um coletor em implantações de produção. | |
| desejará usar um Collector em implantações de produção. |
vitorvasc
reviewed
Feb 12, 2025
| A menos que você tenha apenas um único serviço ou esteja experimentando, você | ||
| desejará usar um coletor em implantações de produção. | ||
|
|
||
| ### Configure e execute um coletor local {#configure-and-run-a-local-collector} |
There was a problem hiding this comment.
Suggested change
| ### Configure e execute um coletor local {#configure-and-run-a-local-collector} | |
| ### Configure e execute um Collector local {#configure-and-run-a-local-collector} |
vitorvasc
reviewed
Feb 12, 2025
|
|
||
| ### Configure e execute um coletor local {#configure-and-run-a-local-collector} | ||
|
|
||
| Primeiro, salve o seguinte código de configuração do coletor em um arquivo no |
There was a problem hiding this comment.
Suggested change
| Primeiro, salve o seguinte código de configuração do coletor em um arquivo no | |
| Primeiro, salve o seguinte código de configuração do Collector em um arquivo no |
vitorvasc
reviewed
Feb 12, 2025
| processors: [batch] | ||
| ``` | ||
|
|
||
| Em seguida, execute o comando docker para adquirir e executar o coletor com base |
There was a problem hiding this comment.
Suggested change
| Em seguida, execute o comando docker para adquirir e executar o coletor com base | |
| Em seguida, execute o comando docker para adquirir e executar o Collector com base |
vitorvasc
reviewed
Feb 12, 2025
Comment on lines
+706
to
+707
| Agora você terá uma instância do coletor em execução localmente, ouvindo na | ||
| porta 4317. |
There was a problem hiding this comment.
Suggested change
| Agora você terá uma instância do coletor em execução localmente, ouvindo na | |
| porta 4317. | |
| Agora, você terá uma instância do Collector em execução localmente, ouvindo na | |
| porta 4317. |
vitorvasc
reviewed
Feb 12, 2025
| O agente `opentelemetry-instrument` detectará o pacote que você acabou de | ||
| instalar e usará a exportação OTLP na próxima vez que for executado. | ||
|
|
||
| ### Execute o aplicativo {#run-the-application} |
There was a problem hiding this comment.
Suggested change
| ### Execute o aplicativo {#run-the-application} | |
| ### Execute a aplicação {#run-the-application} |
vitorvasc
reviewed
Feb 12, 2025
|
|
||
| ### Execute o aplicativo {#run-the-application} | ||
|
|
||
| Execute o aplicativo como antes, mas não exporte para o console: |
There was a problem hiding this comment.
Suggested change
| Execute o aplicativo como antes, mas não exporte para o console: | |
| Execute a aplicação como antes, mas não exporte para o console: |
vitorvasc
reviewed
Feb 12, 2025
| ``` | ||
|
|
||
| Por padrão, `opentelemetry-instrument` exporta rastros e métricas via OTLP/gRPC | ||
| e os enviará para `localhost:4317`, que é onde o coletor está ouvindo. |
There was a problem hiding this comment.
Suggested change
| e os enviará para `localhost:4317`, que é onde o coletor está ouvindo. | |
| e os enviará para `localhost:4317`, endereço onde o Collector está ouvindo. |
vitorvasc
reviewed
Feb 12, 2025
| e os enviará para `localhost:4317`, que é onde o coletor está ouvindo. | ||
|
|
||
| Quando você acessar a rota `/rolldice` agora, verá a saída no processo do | ||
| coletor em vez do processo do flask, que deve ser algo assim: |
There was a problem hiding this comment.
Suggested change
| coletor em vez do processo do flask, que deve ser algo assim: | |
| Collector em vez do processo do Flask, que deve ser algo assim: |
vitorvasc
reviewed
Feb 12, 2025
| ## Próximos passos {#next-steps} | ||
|
|
||
| Existem várias opções disponíveis para instrumentação automática em Python. Veja | ||
| [Instrumentação sem Código](/docs/zero-code/python/) para aprender sobre e como |
There was a problem hiding this comment.
Suggested change
| [Instrumentação sem Código](/docs/zero-code/python/) para aprender sobre e como | |
| [Instrumentação sem código](/docs/zero-code/python/) para aprender sobre e como |
vitorvasc
reviewed
Feb 12, 2025
| [Instrumentação Manual](../instrumentation/). | ||
|
|
||
| Existem várias opções para exportar seus dados de telemetria com OpenTelemetry. | ||
| Para aprender como exportar seus dados para um backend preferido, veja |
There was a problem hiding this comment.
Suggested change
| Para aprender como exportar seus dados para um backend preferido, veja | |
| Para aprender como exportar seus dados para um _backend_ preferido, veja |
vitorvasc
reviewed
Feb 12, 2025
Comment on lines
+832
to
+835
| Se você gostaria de explorar um exemplo mais complexo, dê uma olhada no | ||
| [Na demonstração do OpenTelemetry](/docs/demo/), que inclui o | ||
| [Serviço de Recomendação](/docs/demo/services/recommendation/) baseado em Python | ||
| e o [Gerador de Carga](/docs/demo/services/load-generator/). |
There was a problem hiding this comment.
Suggested change
| Se você gostaria de explorar um exemplo mais complexo, dê uma olhada no | |
| [Na demonstração do OpenTelemetry](/docs/demo/), que inclui o | |
| [Serviço de Recomendação](/docs/demo/services/recommendation/) baseado em Python | |
| e o [Gerador de Carga](/docs/demo/services/load-generator/). | |
| Se você gostaria de explorar um exemplo mais complexo, dê uma olhada na | |
| [demonstração do OpenTelemetry](/docs/demo/), que inclui o | |
| [Serviço de Recomendação](/docs/demo/services/recommendation/) baseado em Python | |
| e o [Gerador de Carga](/docs/demo/services/load-generator/). |
vitorvasc
reviewed
Feb 12, 2025
| - Um único ponto de telemetria compartilhado por vários serviços, para reduzir a | ||
| sobrecarga de troca de exportadores | ||
| - Agregando rastros entre vários serviços, executados em vários hosts | ||
| - Um local central para processar rastros antes de exportá-los para um backend |
There was a problem hiding this comment.
Suggested change
| - Um local central para processar rastros antes de exportá-los para um backend | |
| - Um local central para processar rastros antes de exportá-los para um _backend_ |
vitorvasc
reviewed
Feb 12, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Tracked on #6291
Localizes the content (Portuguese) for the following files:
content/pt/docs/languages/python/getting-started.md
#6291