From f32c782861edc31aeaf734011e8a99c7acb997ea Mon Sep 17 00:00:00 2001 From: leandrocarpenter Date: Tue, 15 Oct 2024 21:01:32 -0300 Subject: [PATCH 1/4] =?UTF-8?q?Tradu=C3=A7=C3=A3o=20JS=20-=20Getting=20Sta?= =?UTF-8?q?rted?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../languages/js/getting-started/_index.md | 8 + .../languages/js/getting-started/browser.md | 250 +++++++++ .../languages/js/getting-started/nodejs.md | 513 ++++++++++++++++++ 3 files changed, 771 insertions(+) create mode 100644 content/pt/docs/languages/js/getting-started/_index.md create mode 100644 content/pt/docs/languages/js/getting-started/browser.md create mode 100644 content/pt/docs/languages/js/getting-started/nodejs.md diff --git a/content/pt/docs/languages/js/getting-started/_index.md b/content/pt/docs/languages/js/getting-started/_index.md new file mode 100644 index 000000000000..78cbd6f04e43 --- /dev/null +++ b/content/pt/docs/languages/js/getting-started/_index.md @@ -0,0 +1,8 @@ +--- +title: Começando +aliases: [/docs/js/getting_started] +weight: 10 +description: Começando a usar OpenTelemetry no Node.js e no navegador. +--- + +Esses dois guias para Node.js e o navegador usam exemplos básicos em JavaScript para você começar com OpenTelemetry. diff --git a/content/pt/docs/languages/js/getting-started/browser.md b/content/pt/docs/languages/js/getting-started/browser.md new file mode 100644 index 000000000000..4c6d3ec26df7 --- /dev/null +++ b/content/pt/docs/languages/js/getting-started/browser.md @@ -0,0 +1,250 @@ +--- +title: Navegador +aliases: [/docs/js/getting_started/browser] +description: Aprenda como adicionar OpenTelemetry para seu aplicativo de navegador +weight: 20 +--- + +{{% 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. + +## Pré-requisitos + +Certifique-se de que você tem instalado localmente: + +- [Node.js](https://nodejs.org/en/download/) +- [TypeScript](https://www.typescriptlang.org/download), se você for usar + TypeScript. + +## Exemplo de Aplicação + +Este é um guia muito simples, se você quiser ver exemplos mais complexos, vá para +[examples/opentelemetry-web](https://github.com/open-telemetry/opentelemetry-js/tree/main/examples/opentelemetry-web). + +Copie o seguinte arquivo em um diretório vazio e chame-o `index.html`. + +```html + + + + + Document Load Instrumentation Example + + + + + + + Example of using Web Tracer with document load instrumentation with console + exporter and collector exporter + + +``` + +### Instalação + +Para criar rastros no navegador, você irá precisar `@opentelemetry/sdk-trace-web`, +e a instrumentação `@opentelemetry/instrumentation-document-load`: + +```shell +npm init -y +npm install @opentelemetry/api \ + @opentelemetry/sdk-trace-web \ + @opentelemetry/instrumentation-document-load \ + @opentelemetry/context-zone +``` + +### Inicialização e Configuração + +Se você estiver codificando em TypeScript, execute o seguinte comando: + +```shell +tsc --init +``` + +Então adicione [parcel](https://parceljs.org/), que (entre outras coisas) permitirá que você trabalhe com TypeScript. + +```shell +npm install --save-dev parcel +``` + +Crie um arquivo de código vazio chamado `document-load` com um `.ts` ou `.js` extensão, +com base no idioma que você escolheu para escrever seu aplicativo. Adicione o seguinte código ao seu HTML logo antes do `` fechando tag: + +{{< tabpane text=true >}} {{% tab TypeScript %}} + +```html + +``` + +{{% /tab %}} {{% tab JavaScript %}} + +```html + +``` + +{{% /tab %}} {{< /tabpane >}} + +Implementaremos código para monitorar os tempos de carregamento do documento e relatar esses dados como Spans OpenTelemetry. + +### Criando um Provedor de Rastros + +Adicione o seguinte código ao `document-load.ts|js` para criar um provedor de rastros, +que traz a instrumentação para rastrear a carga do documento: + +```js +/* document-load.ts|js file - the code snippet is the same for both the languages */ +import { WebTracerProvider } from "@opentelemetry/sdk-trace-web"; +import { DocumentLoadInstrumentation } from "@opentelemetry/instrumentation-document-load"; +import { ZoneContextManager } from "@opentelemetry/context-zone"; +import { registerInstrumentations } from "@opentelemetry/instrumentation"; + +const provider = new WebTracerProvider(); + +provider.register({ + // Changing default contextManager to use ZoneContextManager - supports asynchronous operations - optional + contextManager: new ZoneContextManager(), +}); + +// Registering instrumentations +registerInstrumentations({ + instrumentations: [new DocumentLoadInstrumentation()], +}); +``` + +Agora crie o aplicativo com parcel: + +```shell +npx parcel index.html +``` + +e abra o sevidor de desenvolvimento web (e.g. at `http://localhost:1234`) para ver o se código funciona. + +Ainda não haverá saída de rastros, para isso precisamos adicionar um exportador. + +### Criando um Exportador + +No exemplo a seguir, usaremos o `ConsoleSpanExporter` que imprime todos os +spans no console. + +Para visualizar e analisar seus rastros, você precisará exportá-los para um +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.. + +Para exportar rastros para o console, modifique `document-load.ts|js` para que corresponda +ao seguinte trecho de código: + +```js +/* document-load.ts|js file - the code is the same for both the languages */ +import { + ConsoleSpanExporter, + SimpleSpanProcessor, +} from "@opentelemetry/sdk-trace-base"; +import { WebTracerProvider } from "@opentelemetry/sdk-trace-web"; +import { DocumentLoadInstrumentation } from "@opentelemetry/instrumentation-document-load"; +import { ZoneContextManager } from "@opentelemetry/context-zone"; +import { registerInstrumentations } from "@opentelemetry/instrumentation"; + +const provider = new WebTracerProvider(); +provider.addSpanProcessor(new SimpleSpanProcessor(new ConsoleSpanExporter())); + +provider.register({ + // Changing default contextManager to use ZoneContextManager - supports asynchronous operations - optional + contextManager: new ZoneContextManager(), +}); + +// Registering instrumentations +registerInstrumentations({ + instrumentations: [new DocumentLoadInstrumentation()], +}); +``` + +Agora, reconstrua seu aplicativo e abra o navegador novamente. No console da +barra de ferramentas do desenvolvedor, você deve ver alguns rastros sendo exportados: + +```json +{ + "traceId": "ab42124a3c573678d4d8b21ba52df3bf", + "parentId": "cfb565047957cb0d", + "name": "documentFetch", + "id": "5123fc802ffb5255", + "kind": 0, + "timestamp": 1606814247811266, + "duration": 9390, + "attributes": { + "component": "document-load", + "http.response_content_length": 905 + }, + "status": { + "code": 0 + }, + "events": [ + { + "name": "fetchStart", + "time": [1606814247, 811266158] + }, + { + "name": "domainLookupStart", + "time": [1606814247, 811266158] + }, + { + "name": "domainLookupEnd", + "time": [1606814247, 811266158] + }, + { + "name": "connectStart", + "time": [1606814247, 811266158] + }, + { + "name": "connectEnd", + "time": [1606814247, 811266158] + }, + { + "name": "requestStart", + "time": [1606814247, 819101158] + }, + { + "name": "responseStart", + "time": [1606814247, 819791158] + }, + { + "name": "responseEnd", + "time": [1606814247, 820656158] + } + ] +} +``` + +### Adicionar Instrumentações + +Se você quiser instrumentar solicitações Ajax, interações do usuário e outros, você pode +registrar instrumentações adicionais para eles: + +```javascript +registerInstrumentations({ + instrumentations: [ + new UserInteractionInstrumentation(), + new XMLHttpRequestInstrumentation(), + ], +}); +``` + +## Meta Pacotes para Web + +Para aproveitar as instrumentações mais comuns em um só lugar, você pode simplesmente usar o +[OpenTelemetry Meta Pacotes para Web](https://www.npmjs.com/package/@opentelemetry/auto-instrumentations-web) diff --git a/content/pt/docs/languages/js/getting-started/nodejs.md b/content/pt/docs/languages/js/getting-started/nodejs.md new file mode 100644 index 000000000000..ab79c8c5a0b7 --- /dev/null +++ b/content/pt/docs/languages/js/getting-started/nodejs.md @@ -0,0 +1,513 @@ +--- +title: Node.js +description: Obtenha telemetria para seu aplicativo em menos de 5 minutos! +aliases: [/docs/js/getting_started/nodejs] +cSpell:ignore: autoinstrumentations KHTML rolldice +weight: 10 +--- + +Esta página mostrará como começar a usar o OpenTelemetry no Node.js. + +Você aprenderá como instrumentar [traços][] e [métricas][] e registrá-los +no console. + +{{% alert title="Note" color="info" %}} A biblioteca de registro para OpenTelemetry +para Node.js ainda está em desenvolvimento, portanto, um exemplo para ela não é fornecido +abaixo. Olhe [aqui](/docs/languages/js) para mais informações sobre o status do +OpenTelemetry em JavaScript. {{% /alert %}} + +## Pré-requisitos + +Certifique-se de ter o seguinte instalado localmente: + +- [Node.js](https://nodejs.org/en/download/) +- [TypeScript](https://www.typescriptlang.org/download), se você for usar +TypeScript. + +## Exemplo de aplicação + +O exemplo a seguir usa um básico [Express](https://expressjs.com/) +aplicação. Se você não estiver usando o Express, está OK — você pode usar OpenTelemetry +JavaScript com outras estruturas da web também, como Koa e Nest.JS. Para uma lista completa de blibliotecas para frameworks suportados, veja o +[registry](/ecosystem/registry/?component=instrumentation&language=js). + +Para exemplos mais elaborados, veja [exemplos](/docs/languages/js/examples/). + +### Dependências + +Para começar, configure um em branco `package.json` em um novo diretório: + +```shell +npm init -y +``` + +Em seguida, instale as dependências do Express. + +{{< tabpane text=true >}} {{% tab TypeScript %}} + +```sh +npm install typescript \ + ts-node \ + @types/node \ + express \ + @types/express + +# initialize typescript +npx tsc --init +``` + +{{% /tab %}} {{% tab JavaScript %}} + +```sh +npm install express +``` + +{{% /tab %}} {{< /tabpane >}} + +### Crie e inicie um servidor HTTP + +Crie um arquivo chamado `app.ts` (ou `app.js` se você não estiver usando TypeScript) e adicione o seguinte código a ele: + +{{% tabpane text=true %}} {{% tab TypeScript %}} + +```ts +/*app.ts*/ +import express, { Express } from "express"; + +const PORT: number = parseInt(process.env.PORT || "8080"); +const app: Express = express(); + +function getRandomNumber(min: number, max: number) { + return Math.floor(Math.random() * (max - min) + min); +} + +app.get("/rolldice", (req, res) => { + res.send(getRandomNumber(1, 6).toString()); +}); + +app.listen(PORT, () => { + console.log(`Listening for requests on http://localhost:${PORT}`); +}); +``` + +{{% /tab %}} {{% tab JavaScript %}} + +```js +/*app.js*/ +const express = require("express"); + +const PORT = parseInt(process.env.PORT || "8080"); +const app = express(); + +function getRandomNumber(min, max) { + return Math.floor(Math.random() * (max - min) + min); +} + +app.get("/rolldice", (req, res) => { + res.send(getRandomNumber(1, 6).toString()); +}); + +app.listen(PORT, () => { + console.log(`Listening for requests on http://localhost:${PORT}`); +}); +``` + +{{% /tab %}} {{% /tabpane %}} + +Execute o aplicativo com o seguinte comando e abra + no seu navegador para garantir que está funcionando. + +{{< tabpane text=true >}} {{% tab TypeScript %}} + +```console +$ npx ts-node app.ts +Listening for requests on http://localhost:8080 +``` + +{{% /tab %}} {{% tab JavaScript %}} + +```console +$ node app.js +Listening for requests on http://localhost:8080 +``` + +{{% /tab %}} {{< /tabpane >}} + +## Instrumentação + +A seguir mostramos como instalar, iniciar, e rodar o aplicativo +instrumentado com OpenTelemetry. + +### Mais dependências + +Primeiro, instale o Node SDK e pacote de autoinstrumentações. + +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. + +```shell +npm install @opentelemetry/sdk-node \ + @opentelemetry/api \ + @opentelemetry/auto-instrumentations-node \ + @opentelemetry/sdk-metrics \ + @opentelemetry/sdk-trace-node +``` + +Para encontrar todos os módulos de auto-instrumentação, você pode olhar o +[registro](/ecosystem/registry/?language=js&component=instrumentation). + +### Configurar + +A configuração da instrumentação e a configuração devem ser executadas _antes_ seu +código de aplicação. Uma ferramenta frequentemente utilizada para essa tarefa é a +[--require](https://nodejs.org/api/cli.html#-r---require-module) flag. + +Crie um arquivo chamado `instrumentation.ts` (ou `instrumentation.js` se não estiver utilizando +TypeScript) , onde você colocará seu código de configuração de instrumentação. + +{{< tabpane text=true >}} {{% tab TypeScript %}} + +```ts +/*instrumentation.ts*/ +import { NodeSDK } from "@opentelemetry/sdk-node"; +import { ConsoleSpanExporter } from "@opentelemetry/sdk-trace-node"; +import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node"; +import { + PeriodicExportingMetricReader, + ConsoleMetricExporter, +} from "@opentelemetry/sdk-metrics"; + +const sdk = new NodeSDK({ + traceExporter: new ConsoleSpanExporter(), + metricReader: new PeriodicExportingMetricReader({ + exporter: new ConsoleMetricExporter(), + }), + instrumentations: [getNodeAutoInstrumentations()], +}); + +sdk.start(); +``` + +{{% /tab %}} {{% tab JavaScript %}} + +```js +/*instrumentation.js*/ +// Require dependencies +const { NodeSDK } = require("@opentelemetry/sdk-node"); +const { ConsoleSpanExporter } = require("@opentelemetry/sdk-trace-node"); +const { + getNodeAutoInstrumentations, +} = require("@opentelemetry/auto-instrumentations-node"); +const { + PeriodicExportingMetricReader, + ConsoleMetricExporter, +} = require("@opentelemetry/sdk-metrics"); + +const sdk = new NodeSDK({ + traceExporter: new ConsoleSpanExporter(), + metricReader: new PeriodicExportingMetricReader({ + exporter: new ConsoleMetricExporter(), + }), + instrumentations: [getNodeAutoInstrumentations()], +}); + +sdk.start(); +``` + +{{% /tab %}} {{< /tabpane >}} + +## Execute o aplicativo instrumentado + +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 +`--require @opentelemetry/auto-instrumentations-node/register` no seu +`NODE_OPTIONS` variável de ambiente. + +{{< tabpane text=true >}} {{% tab TypeScript %}} + +```console +$ npx ts-node --require ./instrumentation.ts app.ts +Listening for requests on http://localhost:8080 +``` + +{{% /tab %}} {{% tab JavaScript %}} + +```console +$ node --require ./instrumentation.js app.js +Listening for requests on http://localhost:8080 +``` + +{{% /tab %}} {{< /tabpane >}} + +Abra no seu navegador e recarregue a página +algumas vezes. Depois de um tempo você deverá ver os Trechos exibidos no console pelo +`ConsoleSpanExporter`. + +
+View example output + +```json +{ + "traceId": "3f1fe6256ea46d19ec3ca97b3409ad6d", + "parentId": "f0b7b340dd6e08a7", + "name": "middleware - query", + "id": "41a27f331c7bfed3", + "kind": 0, + "timestamp": 1624982589722992, + "duration": 417, + "attributes": { + "http.route": "/", + "express.name": "query", + "express.type": "middleware" + }, + "status": { "code": 0 }, + "events": [] +} +{ + "traceId": "3f1fe6256ea46d19ec3ca97b3409ad6d", + "parentId": "f0b7b340dd6e08a7", + "name": "middleware - expressInit", + "id": "e0ed537a699f652a", + "kind": 0, + "timestamp": 1624982589725778, + "duration": 673, + "attributes": { + "http.route": "/", + "express.name": "expressInit", + "express.type": "middleware" + }, + "status": { code: 0 }, + "events": [] +} +{ + "traceId": "3f1fe6256ea46d19ec3ca97b3409ad6d", + "parentId": "f0b7b340dd6e08a7", + "name": "request handler - /", + "id": "8614a81e1847b7ef", + "kind": 0, + "timestamp": 1624982589726941, + "duration": 21, + "attributes": { + "http.route": "/", + "express.name": "/", + "express.type": "request_handler" + }, + "status": { code: 0 }, + "events": [] +} +{ + "traceId": "3f1fe6256ea46d19ec3ca97b3409ad6d", + "parentId": undefined, + "name": "GET /", + "id": "f0b7b340dd6e08a7", + "kind": 1, + "timestamp": 1624982589720260, + "duration": 11380, + "attributes": { + "http.url": "http://localhost:8080/", + "http.host": "localhost:8080", + "net.host.name": "localhost", + "http.method": "GET", + "http.route": "", + "http.target": "/", + "http.user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36", + "http.flavor": "1.1", + "net.transport": "ip_tcp", + "net.host.ip": "::1", + "net.host.port": 8080, + "net.peer.ip": "::1", + "net.peer.port": 61520, + "http.status_code": 304, + "http.status_text": "NOT MODIFIED" + }, + "status": { "code": 1 }, + "events": [] +} +``` + +
+ +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: + +
+View example output + +```yaml +{ + descriptor: { + name: 'http.server.duration', + type: 'HISTOGRAM', + description: 'measures the duration of the inbound HTTP requests', + unit: 'ms', + valueType: 1 + }, + dataPointType: 0, + dataPoints: [ + { + attributes: [Object], + startTime: [Array], + endTime: [Array], + value: [Object] + } + ] +} +{ + descriptor: { + name: 'http.client.duration', + type: 'HISTOGRAM', + description: 'measures the duration of the outbound HTTP requests', + unit: 'ms', + valueType: 1 + }, + dataPointType: 0, + dataPoints: [] +} +{ + descriptor: { + name: 'db.client.connections.usage', + type: 'UP_DOWN_COUNTER', + description: 'The number of connections that are currently in the state referenced by the attribute "state".', + unit: '{connections}', + valueType: 1 + }, + dataPointType: 3, + dataPoints: [] +} +{ + descriptor: { + name: 'http.server.duration', + type: 'HISTOGRAM', + description: 'measures the duration of the inbound HTTP requests', + unit: 'ms', + valueType: 1 + }, + dataPointType: 0, + dataPoints: [ + { + attributes: [Object], + startTime: [Array], + endTime: [Array], + value: [Object] + } + ] +} +{ + descriptor: { + name: 'http.client.duration', + type: 'HISTOGRAM', + description: 'measures the duration of the outbound HTTP requests', + unit: 'ms', + valueType: 1 + }, + dataPointType: 0, + dataPoints: [] +} +{ + descriptor: { + name: 'db.client.connections.usage', + type: 'UP_DOWN_COUNTER', + description: 'The number of connections that are currently in the state referenced by the attribute "state".', + unit: '{connections}', + valueType: 1 + }, + dataPointType: 3, + dataPoints: [] +} +{ + descriptor: { + name: 'http.server.duration', + type: 'HISTOGRAM', + description: 'measures the duration of the inbound HTTP requests', + unit: 'ms', + valueType: 1 + }, + dataPointType: 0, + dataPoints: [ + { + attributes: [Object], + startTime: [Array], + endTime: [Array], + value: [Object] + } + ] +} +{ + descriptor: { + name: 'http.client.duration', + type: 'HISTOGRAM', + description: 'measures the duration of the outbound HTTP requests', + unit: 'ms', + valueType: 1 + }, + dataPointType: 0, + dataPoints: [] +} +{ + descriptor: { + name: 'db.client.connections.usage', + type: 'UP_DOWN_COUNTER', + description: 'The number of connections that are currently in the state referenced by the attribute "state".', + unit: '{connections}', + valueType: 1 + }, + dataPointType: 3, + dataPoints: [] +} +``` + +
+ +## Próximos passos + +Enriqueça sua instrumentação gerada automaticamente com +[instrumentação manual](/docs/languages/js/instrumentation) da sua própria base de código. +Isso lhe dá dados de observabilidade personalizados. + +Você também vai querer configurar um exportador apropriado para +[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 +[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/). + +## Soluções de Problemas + +Algo deu errado ? Você pode habilitar o registro de diagnóstico para validar que o +OpenTelemetry foi inicializado corretamente: + +{{< tabpane text=true >}} {{% tab TypeScript %}} + +```ts +/*instrumentation.ts*/ +import { diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api"; + +// For troubleshooting, set the log level to DiagLogLevel.DEBUG +diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.INFO); + +// const sdk = new NodeSDK({... +``` + +{{% /tab %}} {{% tab JavaScript %}} + +```js +/*instrumentation.js*/ +// Require dependencies +const { diag, DiagConsoleLogger, DiagLogLevel } = require("@opentelemetry/api"); + +// For troubleshooting, set the log level to DiagLogLevel.DEBUG +diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.INFO); + +// const sdk = new NodeSDK({... +``` + +{{% /tab %}} {{< /tabpane >}} + +[Rastros]: /docs/concepts/signals/traces/ +[Metricas]: /docs/concepts/signals/metrics/ From 97d539b1d21b466e4688f6282b919954c3f44bfd Mon Sep 17 00:00:00 2001 From: leandrocarpenter Date: Mon, 4 Nov 2024 21:02:50 -0300 Subject: [PATCH 2/4] =?UTF-8?q?Ajuste=20das=20recomenda=C3=A7=C3=B5es=20e?= =?UTF-8?q?=20inclus=C3=A3o=20do=20"default=5Flang=5Fcommit"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/pt/docs/languages/js/getting-started/_index.md | 1 + content/pt/docs/languages/js/getting-started/browser.md | 3 ++- content/pt/docs/languages/js/getting-started/nodejs.md | 3 ++- 3 files changed, 5 insertions(+), 2 deletions(-) diff --git a/content/pt/docs/languages/js/getting-started/_index.md b/content/pt/docs/languages/js/getting-started/_index.md index 78cbd6f04e43..c694bcfebb75 100644 --- a/content/pt/docs/languages/js/getting-started/_index.md +++ b/content/pt/docs/languages/js/getting-started/_index.md @@ -3,6 +3,7 @@ title: Começando aliases: [/docs/js/getting_started] weight: 10 description: Começando a usar OpenTelemetry no Node.js e no navegador. +default_lang_commit: 06837fe15457a584f6a9e09579be0f0400593d57 --- Esses dois guias para Node.js e o navegador usam exemplos básicos em JavaScript para você começar com OpenTelemetry. diff --git a/content/pt/docs/languages/js/getting-started/browser.md b/content/pt/docs/languages/js/getting-started/browser.md index 4c6d3ec26df7..74f80f12bc60 100644 --- a/content/pt/docs/languages/js/getting-started/browser.md +++ b/content/pt/docs/languages/js/getting-started/browser.md @@ -3,6 +3,7 @@ title: Navegador aliases: [/docs/js/getting_started/browser] description: Aprenda como adicionar OpenTelemetry para seu aplicativo de navegador weight: 20 +default_lang_commit: 06837fe15457a584f6a9e09579be0f0400593d57 --- {{% alert title="Warning" color="warning" %}} @@ -131,7 +132,7 @@ Agora crie o aplicativo com parcel: npx parcel index.html ``` -e abra o sevidor de desenvolvimento web (e.g. at `http://localhost:1234`) para ver o se código funciona. +e abra o servidor de desenvolvimento web (e.g. at `http://localhost:1234`) para ver se o seu código funciona. Ainda não haverá saída de rastros, para isso precisamos adicionar um exportador. diff --git a/content/pt/docs/languages/js/getting-started/nodejs.md b/content/pt/docs/languages/js/getting-started/nodejs.md index ab79c8c5a0b7..ef0b90d19fab 100644 --- a/content/pt/docs/languages/js/getting-started/nodejs.md +++ b/content/pt/docs/languages/js/getting-started/nodejs.md @@ -4,6 +4,7 @@ description: Obtenha telemetria para seu aplicativo em menos de 5 minutos! aliases: [/docs/js/getting_started/nodejs] cSpell:ignore: autoinstrumentations KHTML rolldice weight: 10 +default_lang_commit: 2bda479b6ce77f51266845ade9fe1b431dfde0d3 --- Esta página mostrará como começar a usar o OpenTelemetry no Node.js. @@ -28,7 +29,7 @@ TypeScript. O exemplo a seguir usa um básico [Express](https://expressjs.com/) aplicação. Se você não estiver usando o Express, está OK — você pode usar OpenTelemetry -JavaScript com outras estruturas da web também, como Koa e Nest.JS. Para uma lista completa de blibliotecas para frameworks suportados, veja o +JavaScript com outras estruturas da web também, como Koa e Nest.JS. Para uma lista completa de bibliotecas para frameworks suportados, veja o [registry](/ecosystem/registry/?component=instrumentation&language=js). Para exemplos mais elaborados, veja [exemplos](/docs/languages/js/examples/). From 180c657369252d2f32f85589bbacefa3bd388ea9 Mon Sep 17 00:00:00 2001 From: Leandro Carpenter <76078156+leandrocarpenter@users.noreply.github.com> Date: Mon, 18 Nov 2024 21:27:04 -0300 Subject: [PATCH 3/4] Update content/pt/docs/languages/js/getting-started/browser.md Co-authored-by: Ezzio Moreira --- content/pt/docs/languages/js/getting-started/browser.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/js/getting-started/browser.md b/content/pt/docs/languages/js/getting-started/browser.md index 74f80f12bc60..2a99f8339825 100644 --- a/content/pt/docs/languages/js/getting-started/browser.md +++ b/content/pt/docs/languages/js/getting-started/browser.md @@ -82,7 +82,7 @@ Então adicione [parcel](https://parceljs.org/), que (entre outras coisas) permi npm install --save-dev parcel ``` -Crie um arquivo de código vazio chamado `document-load` com um `.ts` ou `.js` extensão, +Crie um arquivo de código vazio chamado `document-load` com a extensão `.ts` ou `.js`, com base no idioma que você escolheu para escrever seu aplicativo. Adicione o seguinte código ao seu HTML logo antes do `` fechando tag: {{< tabpane text=true >}} {{% tab TypeScript %}} From efc33db81fbbb318364392a268914fc8a1b30358 Mon Sep 17 00:00:00 2001 From: leandrocarpenter Date: Mon, 18 Nov 2024 22:16:59 -0300 Subject: [PATCH 4/4] Ajust translation --- .../languages/js/getting-started/browser.md | 31 +++++++++---------- .../languages/js/getting-started/nodejs.md | 2 +- 2 files changed, 16 insertions(+), 17 deletions(-) diff --git a/content/pt/docs/languages/js/getting-started/browser.md b/content/pt/docs/languages/js/getting-started/browser.md index 2a99f8339825..e6f2216e682d 100644 --- a/content/pt/docs/languages/js/getting-started/browser.md +++ b/content/pt/docs/languages/js/getting-started/browser.md @@ -35,11 +35,11 @@ Copie o seguinte arquivo em um diretório vazio e chame-o `index.html`.