Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[pt] Localize content/pt/docs/languages/python/getting-started.md #6292

Open
wants to merge 5 commits into
base: main
Choose a base branch
from

Conversation

EzzioMoreira
Copy link
Contributor

Tracked on #6291

Localizes the content (Portuguese) for the following files:

content/pt/docs/languages/python/getting-started.md

#6291

@EzzioMoreira EzzioMoreira self-assigned this Feb 11, 2025
@EzzioMoreira EzzioMoreira requested a review from a team as a code owner February 11, 2025 22:44
@opentelemetrybot opentelemetrybot requested review from a team February 11, 2025 22:44
@EzzioMoreira
Copy link
Contributor Author

/fix:fix:dict

1 similar comment
@EzzioMoreira
Copy link
Contributor Author

/fix:fix:dict

@EzzioMoreira
Copy link
Contributor Author

/fix:all

@opentelemetrybot
Copy link
Collaborator

You triggered fix:all action run at https://github.com/open-telemetry/opentelemetry.io/actions/runs/13274109143

@opentelemetrybot
Copy link
Collaborator

fix:all failed or was cancelled. For details, see https://github.com/open-telemetry/opentelemetry.io/actions/runs/13274109143.

flask run -p 8080
```

Quando você enviar uma solicitação ao servidor, verá dois trechos no rastro
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

return randint(1, 6)
```

Agora execute o aplicativo novamente:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Agora execute o aplicativo novamente:
Agora, execute a aplicação novamente:

flask run -p 8080
```

Quando você enviar uma solicitação para o servidor, verá a métrica do contador
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Comment on lines 488 to 489
de jogadas emitida para o console, com contagens separadas para cada valor de
jogada:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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:

"metrics": [
{
"name": "http.server.active_requests",
"description": "mede o número de solicitações HTTP simultâneas que estão atualmente em andamento",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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",

},
{
"name": "http.server.duration",
"description": "mede a duração da solicitação HTTP recebida",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"description": "mede a duração da solicitação HTTP recebida",
"description": "mede a duração da requisição HTTP recebida",


</details>

## Envie telemetria para um Coletor OpenTelemetry {#send-telemetry-to-an-opentelemetry-collector}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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}

Comment on lines 649 to 650
das implantações em produção. Alguns exemplos de quando é benéfico usar um
coletor:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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:


- 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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

- 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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
desejará usar um coletor em implantações de produção.
desejará usar um Collector em implantações de produção.

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}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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}


### 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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

processors: [batch]
```

Em seguida, execute o comando docker para adquirir e executar o coletor com base
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Comment on lines 706 to 704
Agora você terá uma instância do coletor em execução localmente, ouvindo na
porta 4317.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

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}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Execute o aplicativo {#run-the-application}
### Execute a aplicação {#run-the-application}


### Execute o aplicativo {#run-the-application}

Execute o aplicativo como antes, mas não exporte para o console:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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:

```

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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

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:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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:

## 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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

[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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Para aprender como exportar seus dados para um backend preferido, veja
Para aprender como exportar seus dados para um _backend_ preferido, veja

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/).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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/).

- 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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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_

Copy link
Member

@vitorvasc vitorvasc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sensacional! Parabéns pelo PR! E que venha a tradução de mais uma linguagem 🚀 🚀

Deixei alguns comentários com algumas sugestões, porém, zero problemas caso não faça sentido ou tenha outro ponto de vista!

Copy link
Contributor

@maryliag maryliag left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Muita bom trabalho! Adicionei alguns comentários!

de jogada possível:

```python
# Há mais imports necessários agora
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
# Há mais imports necessários agora
# Estas são as declarações de _imports_ necessários

das implantações em produção. Alguns exemplos de quando é benéfico usar um
coletor:

- Um único ponto de telemetria compartilhado por vários serviços, para reduzir a
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Um único ponto de telemetria compartilhado por vários serviços, para reduzir a
- Um único coletor de telemetria compartilhado por vários serviços, para reduzir a

Agora você terá uma instância do coletor em execução localmente, ouvindo na
porta 4317.

### Modifique o comando para exportar trechos e métricas via OTLP {#modify-the-command-to-export- spans-and-metrics-via-otlp}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Modifique o comando para exportar trechos e métricas via OTLP {#modify-the-command-to-export- spans-and-metrics-via-otlp}
### Modifique o comando para exportar trechos e métricas via OTLP {#modify-the-command-to-export-spans-and-metrics-via-otlp}

@opentelemetrybot opentelemetrybot requested a review from a team February 14, 2025 17:20
@EzzioMoreira EzzioMoreira force-pushed the feat/add-pt-langage-python-getting-start branch from f929c56 to 896c4f9 Compare February 19, 2025 20:28
@maryliag
Copy link
Contributor

Quando vc corrigir os erros que estão falhando nos testes, me me/avisa que eu aprovo aqui e aviso pessoal pra dar merge!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
Development

Successfully merging this pull request may close these issues.

5 participants