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/js/getting-started/ #5415

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

Conversation

leandrocarpenter
Copy link

@leandrocarpenter leandrocarpenter commented Oct 16, 2024

Docs PR Checklist

Fixes #5323

  • Tradução inicial do Getting Started.
  • Paginas:
  • _index.md
  • browser.md
  • nodejs.md
  • This PR is for a documentation page whose authoritative copy is in the
    opentelemetry.io repository.

@leandrocarpenter leandrocarpenter requested a review from a team as a code owner October 16, 2024 00:03
@edsoncelio edsoncelio changed the title Tradução JS - Getting Started [pt] Localize content/pt/docs/languages/js/getting-started/ Nov 2, 2024
@edsoncelio
Copy link
Member

Hey @leandrocarpenter, um detalhe antes de conseguirmos revisar seu PR:

  • precisa adicionar o campo default_lang_commit nos arquivos que traduziu, pode ver detalhes de como fazer isso no nosso guia de contribuição

Pode nos avisar por aqui (ou slack) quando isso tiver sido feito, por favor? Obrigado!

content/pt/docs/languages/js/getting-started/browser.md Outdated Show resolved Hide resolved
content/pt/docs/languages/js/getting-started/nodejs.md Outdated Show resolved Hide resolved
O Node SDK permite que você inicialize o OpenTelemetry com várias configurações
padrões que são corretos para a maioria dos casos de uso.

O `auto-instrumentação-node` pacote instala as bibliotecas de instrumentação que irão criar automaticamente Trechos correspondentes ao código chamado em bibliotecas. Neste caso, ele fornece instrumentação parao Express, permitindo que o aplicativo de exemplo crie automaticamente intervalos para cada solicitação 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
O `auto-instrumentação-node` pacote instala as bibliotecas de instrumentação que irão criar automaticamente Trechos correspondentes ao código chamado em bibliotecas. Neste caso, ele fornece instrumentação parao Express, permitindo que o aplicativo de exemplo crie automaticamente intervalos para cada solicitação recebida.
O `auto-instrumentação-node` pacote instala as bibliotecas de instrumentação que irão criar automaticamente Trechos correspondentes ao código chamado em bibliotecas. Neste caso, ele fornece instrumentação para o Express, permitindo que o aplicativo de exemplo crie automaticamente intervalos para cada solicitação recebida.

@opentelemetrybot opentelemetrybot requested a review from a team November 5, 2024 00:03
npx parcel index.html
```

e abra o servidor de desenvolvimento web (e.g. at `http://localhost:1234`) para ver se o seu código funciona.
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
e abra o servidor de desenvolvimento web (e.g. at `http://localhost:1234`) para ver se o seu código funciona.
E abra o servidor de desenvolvimento web (e.g. at `http://localhost:1234`) para ver se o seu código funciona.

Esse e deveria ser maiúsculo ou minusculo?

backend de rastreamento. Seguir [estas instruções](../../exporters) para configurar um
backend e exportador.

Você também pode querer usar o `BatchSpanProcessor` para exportar trechos em lotes para usar os recursos de forma mais eficiente..
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
Você também pode querer usar o `BatchSpanProcessor` para exportar trechos em lotes para usar os recursos de forma mais eficiente..
Você também pode querer usar o `BatchSpanProcessor` para exportar trechos em lotes para usar os recursos de forma mais eficiente.

ao seguinte trecho de código:

```js
/* document-load.ts|js file - the code is the same for both the languages */
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
/* document-load.ts|js file - the code is the same for both the languages */
/* document-load.ts|js arquivo - o código é o mesmo para ambas as linguagens */

provider.addSpanProcessor(new SimpleSpanProcessor(new ConsoleSpanExporter()));

provider.register({
// Changing default contextManager to use ZoneContextManager - supports asynchronous operations - optional
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
// Changing default contextManager to use ZoneContextManager - supports asynchronous operations - optional
// Alterando o contextManager padrão para usar ZoneContextManager - oferece suporte para operações assíncronas - opcional

contextManager: new ZoneContextManager(),
});

// Registering instrumentations
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
// Registering instrumentations
// Registrando instrumentações

Comment on lines 236 to 237
Se você quiser instrumentar solicitações Ajax, interações do usuário e outros, você pode
registrar instrumentações adicionais para eles:
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
Se você quiser instrumentar solicitações Ajax, interações do usuário e outros, você pode
registrar instrumentações adicionais para eles:
Caso deseje instrumentar solicitações Ajax, interações do usuário e outros, é possível registrar instrumentações adicionais para esses elementos:

Acha que assim fica melhor?


Agora você pode executar seu aplicativo normalmente, mas, você pode usar o
`--require` sinalizador para carregar a instrumentação antes dos códigos de aplicação. Certifique-se
de que vocÊ não tem outros conflitos `--require` sinalizar como
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
de que vocÊ não tem outros conflitos `--require` sinalizar como
de que você não tem outros conflitos `--require` sinalizar como


{{% /tab %}} {{< /tabpane >}}

Abra <http://localhost:8080/rolldice> no seu navegador e recarregue a página
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
Abra <http://localhost:8080/rolldice> no seu navegador e recarregue a página
Acesse <http://localhost:8080/rolldice> no seu navegador e recarregue a página

Mesmo caso do comentário anterior.


O intervalo gerado rastreia o tempo de vida de uma solicitação para a `/rolldice` rota.

Envie mais algumas solicitações para o endpoint. Depois de um momento, você verá métricas na saída do console, como o seguinte:
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
Envie mais algumas solicitações para o endpoint. Depois de um momento, você verá métricas na saída do console, como o seguinte:
Envie mais algumas solicitações para o endpoint. Depois de um tempo, você verá métricas na saída do console, como o seguinte:

Talvez tempo faça mais sentido.

[exporte seus dados de telemetria](/docs/languages/js/exporters) para um ou mais
backends de telemetria.

Se você quiser explorar um exemplo mais complexo, dê uma olhada no
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
Se você quiser explorar um exemplo mais complexo, dê uma olhada no
Se você quiser explorar um exemplo mais complexo, dê uma olhada em

backends de telemetria.

Se você quiser explorar um exemplo mais complexo, dê uma olhada no
[Demonstração OpenTelemetry ](/docs/demo/), que inclui o JavaScript baseado
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
[Demonstração OpenTelemetry ](/docs/demo/), que inclui o JavaScript baseado
[Demonstração OpenTelemetry](/docs/demo/), que inclui o JavaScript baseado


## Soluções de Problemas

Algo deu errado ? Você pode habilitar o registro de diagnóstico para validar que o
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
Algo deu errado ? Você pode habilitar o registro de diagnóstico para validar que o
Algo deu errado? Você pode habilitar o registro de diagnóstico para validar que o

/*instrumentation.ts*/
import { diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api";

// For troubleshooting, set the log level to DiagLogLevel.DEBUG
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
// For troubleshooting, set the log level to DiagLogLevel.DEBUG
// Para solução de problemas, defina o nível de log como DiagLogLevel.DEBUG


```js
/*instrumentation.js*/
// Require dependencies
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
// Require dependencies
// Requer dependências

// Require dependencies
const { diag, DiagConsoleLogger, DiagLogLevel } = require("@opentelemetry/api");

// For troubleshooting, set the log level to DiagLogLevel.DEBUG
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
// For troubleshooting, set the log level to DiagLogLevel.DEBUG
// Para solução de problemas, defina o nível de log como DiagLogLevel.DEBUG

{{% /tab %}} {{< /tabpane >}}

[Rastros]: /docs/concepts/signals/traces/
[Metricas]: /docs/concepts/signals/metrics/
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
[Metricas]: /docs/concepts/signals/metrics/
[Métricas]: /docs/concepts/signals/metrics/

@EzzioMoreira
Copy link
Contributor

@leandrocarpenter deixei meu comentário.


Enquanto este guia utiliza o exemplo de aplicação apresentado abaixo, os passos para instrumentar sua própria aplicação devem ser similares.

## Pré-requisitos
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
## Pré-requisitos
## Pré-requisitos {#prerequisites}

Adiciona ancora

- [TypeScript](https://www.typescriptlang.org/download), se você for usar
TypeScript.

## Exemplo de Aplicação
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
## Exemplo de Aplicação
## Exemplo de Aplicação {#example-application}

</html>
```

### Instalação
Copy link
Contributor

@EzzioMoreira EzzioMoreira Nov 20, 2024

Choose a reason for hiding this comment

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

Suggested change
### Instalação
### Instalação {#installation}

@opentelemetry/context-zone
```

### Inicialização e Configuração
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
### Inicialização e Configuração
### Inicialização e Configuração {#initialization-and-configuration}


Implementaremos código para monitorar os tempos de carregamento do documento e relatar esses dados como Spans OpenTelemetry.

### Criando um Provedor de Rastros
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
### Criando um Provedor de Rastros
### Criando um Provedor de Rastros {#creating-a-tracer-provider}


Ainda não haverá saída de rastros, para isso precisamos adicionar um exportador.

### Criando um Exportador
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
### Criando um Exportador
### Criando um Exportador {#creating-an-exporter}

}
```

### Adicionar Instrumentações
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
### Adicionar Instrumentações
### Adicionar Instrumentações {#add-instrumentations}

});
```

## Meta Pacotes para Web
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
## Meta Pacotes para Web
## Meta Pacotes para Web {#meta-packages-for-web}

abaixo. Olhe [aqui](/docs/languages/js) para mais informações sobre o status do
OpenTelemetry em JavaScript. {{% /alert %}}

## Pré-requisitos
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
## Pré-requisitos
## Pré-requisitos {#prerequisites}

- [TypeScript](https://www.typescriptlang.org/download), se você for usar
TypeScript.

## Exemplo de aplicação
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
## Exemplo de aplicação
## Exemplo de aplicação {#example-application}


{{% /tab %}} {{< /tabpane >}}

### Crie e inicie um servidor HTTP
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
### Crie e inicie um servidor HTTP
### Crie e inicie um servidor HTTP {#create-and-launch-an-http-server}


{{% /tab %}} {{< /tabpane >}}

## Instrumentação
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
## Instrumentação
## Instrumentação {#instrumentation}

A seguir mostramos como instalar, iniciar, e rodar o aplicativo
instrumentado com OpenTelemetry.

### Mais dependências
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
### Mais dependências
### Mais dependências {#more-dependencies}

Para encontrar todos os módulos de auto-instrumentação, você pode olhar o
[registro](/ecosystem/registry/?language=js&component=instrumentation).

### Configurar
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
### Configurar
### Configurar {#setup}


{{% /tab %}} {{< /tabpane >}}

## Execute o aplicativo instrumentado
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
## Execute o aplicativo instrumentado
## Execute o aplicativo instrumentado {#run-the-instrumented-app}


</details>

## Próximos passos
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
## Próximos passos
## Próximos passos {#next-steps}

[Serviço de Pagamento](/docs/demo/services/payment/) e o TypeScript baseado
[Serviço de Frontend](/docs/demo/services/frontend/).

## Soluções de Problemas
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
## Soluções de Problemas
## Soluções de Problemas {#troubleshooting}

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.

Obrigada pela contribuição!

Parece que alguma ferramenta está sendo utilizada para estas traduções, não há problema em utilizar, mas dê uma lida com bastante cuidado no resultado final, pois há alguns falsos cognatos que acabam não fazendo sentido.
Também existem alguns termos que não devem ser traduzidos, eles estão listados aqui

---
title: Navegador
aliases: [/docs/js/getting_started/browser]
description: Aprenda como adicionar OpenTelemetry para seu aplicativo de navegador
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
description: Aprenda como adicionar OpenTelemetry para seu aplicativo de navegador
description: Aprenda como adicionar OpenTelemetry para sua aplicação de navegador

{{% alert title="Warning" color="warning" %}}
{{% _param notes.browser-instrumentation %}} {{% /alert %}}

Enquanto este guia utiliza o exemplo de aplicação apresentado abaixo, os passos para instrumentar sua própria aplicação devem ser similares.
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
Enquanto este guia utiliza o exemplo de aplicação apresentado abaixo, os passos para instrumentar sua própria aplicação devem ser similares.
Enquanto este guia utiliza aplicação de exemplo apresentada abaixo, os passos para instrumentar sua própria aplicação devem ser similares.

<!--
https://www.w3.org/TR/trace-context/
Defina o `traceparent` no código do template HTML do servidor.
Ele deve ser gerado dinamicamente no lado do servidor para conter o
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
Ele deve ser gerado dinamicamente no lado do servidor para conter o
Ele deve ser gerado dinamicamente pelo servidor para conter o

https://www.w3.org/TR/trace-context/
Defina o `traceparent` no código do template HTML do servidor.
Ele deve ser gerado dinamicamente no lado do servidor para conter o
trace Id da requisição do servidor, um span Id de pai que foi definido
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
trace Id da requisição do servidor, um span Id de pai que foi definido
Id do rastro da requisição do servidor, o Id do trecho pai que foi definido

Defina o `traceparent` no código do template HTML do servidor.
Ele deve ser gerado dinamicamente no lado do servidor para conter o
trace Id da requisição do servidor, um span Id de pai que foi definido
no span de requisição do servidor, e as flags de rastreamento para
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
no span de requisição do servidor, e as flags de rastreamento para
no trecho de requisição do servidor, e as flags de rastreamento para


Se você quiser explorar um exemplo mais complexo, dê uma olhada no
[Demonstração OpenTelemetry ](/docs/demo/), que inclui o JavaScript baseado
[Serviço de Pagamento](/docs/demo/services/payment/) e o TypeScript baseado
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
[Serviço de Pagamento](/docs/demo/services/payment/) e o TypeScript baseado
[Serviço de Pagamento](/docs/demo/services/payment/) em JavaScript e o

Se você quiser explorar um exemplo mais complexo, dê uma olhada no
[Demonstração OpenTelemetry ](/docs/demo/), que inclui o JavaScript baseado
[Serviço de Pagamento](/docs/demo/services/payment/) e o TypeScript baseado
[Serviço de Frontend](/docs/demo/services/frontend/).
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
[Serviço de Frontend](/docs/demo/services/frontend/).
[Serviço de Frontend](/docs/demo/services/frontend/) em TypeScript.


## Soluções de Problemas

Algo deu errado ? Você pode habilitar o registro de diagnóstico para validar que o
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
Algo deu errado ? Você pode habilitar o registro de diagnóstico para validar que o
Algo deu errado ? Você pode habilitar o _logging_ de diagnóstico para validar que o


{{% /tab %}} {{< /tabpane >}}

[Rastros]: /docs/concepts/signals/traces/
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
[Rastros]: /docs/concepts/signals/traces/
[rastros]: /docs/concepts/signals/traces/

{{% /tab %}} {{< /tabpane >}}

[Rastros]: /docs/concepts/signals/traces/
[Metricas]: /docs/concepts/signals/metrics/
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
[Metricas]: /docs/concepts/signals/metrics/
[métricas]: /docs/concepts/signals/metrics/

@svrnm
Copy link
Member

svrnm commented Dec 18, 2024

@leandrocarpenter can you take a look at the feedback provided? Thanks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
Status: Review Required
Status: No status
Development

Successfully merging this pull request may close these issues.

[pt] localization content/pt/docs/languages/js/_index.md
5 participants