From ccf779fb06b23744efff82016395389154c94210 Mon Sep 17 00:00:00 2001 From: Janssen Lima Date: Thu, 22 Aug 2024 20:10:12 -0300 Subject: [PATCH 01/28] [pt] Add content/pt/docs/concepts/instrumentation/code-based.md --- .../concepts/instrumentation/code-based.md | 70 +++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 content/pt/docs/concepts/instrumentation/code-based.md diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md new file mode 100644 index 000000000000..81fb3de6f90d --- /dev/null +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -0,0 +1,70 @@ +--- +title: Baseada em código +description: + Informe-se sobre as etapas essenciais na configuração da instrumentação + baseada em código +weight: 20 +aliases: [manual] +default_lang_commit: fe0c3f68902aeb6e7584ffc32c6c8964d7a89e6e +--- + +## Importar a API e o SDK do OpenTelemetry + +Primeiro, você precisará importar o OpenTelemetry para o seu código. Se estiver +desenvolvendo uma biblioteca ou algum outro componente que se destina a ser +consumido por um binário executável, você só dependeria da API. Se o seu +artefato for um processo ou serviço independente, então você dependeria da API e +do SDK. Para obter mais informações sobre a API e o SDK do OpenTelemetry, +consulte a [especificação](/docs/specs/otel/). + +## Configurar a API do OpenTelemetry + +Para criar rastros ou métricas, primeiro você precisa criar um provider tracer +e/ou meter. Geralmente, recomendamos que o SDK forneça um único provider padrão +para esses objetos. Em seguida, você obtem uma instância tracer ou meter desse +provider e atribui a ela um nome e uma versão. O nome que você escolher aqui +deve identificar exatamente o que está sendo instrumentado - se você está +desenvolvendo uma biblioteca, por exemplo, você deve nomeá-la com o nome da sua +biblioteca (por exemplo `com.example.myLibrary`), pois esse nome será usado como +namespace todos os eventos de trecho ou métricas que for produzidos. Além disso, +é recomendável fornecer uma string de versão (ou seja, `semver:1.0.0`) que +corresponda à versão atual da sua biblioteca ou serviço. + +## Configurar o SDK do OpenTelemetry + +Se você está desenvolvendo um processo de serviço, também precisará configurar o +SDK com as opções adequadas para exportar seus dados de telemetria para um +backend de análise. Recomendamos que esta configuração seja feita +programaticamente por meio de um arquivo de configuração ou outro mecanismo. +Além disso, existem opções de ajuste específicas para cada linguagem de +programação que você pode utilizar. + +## Criar dados de telemetria + +Depois de configurar a API e o SDK, você estará livre para criar eventos de +rastro e métricas usando os objetos tracer e meter obtidos do provider. Utilize +bibliotecas de instrumentação para suas dependências -- confira o +[registry](/ecosystem/registry/) ou o repositório da sua linguagem de +programação para mais informações sobre essas bibliotecas. + +## Exportar dados + +Depois de criar os dados de telemetria, você vai querer enviá-los para algum +lugar. OpenTelemetry oferece suporte a dois métodos principais de exportação de +dados do seu processo para um backend de análise, diretamente de um processo ou +através de um proxy através do [OpenTelemetry Collector](/docs/collector). + +A exportação em processo exige que você importe e dependa de um ou mais +_exporters_, bibliotecas responsáveis por traduzir os objetos de trechos e +métricas em memória do OpenTelemetry para o formato apropriado para ferramentas +de análise de telemetria, como Jaeger ou Prometheus. Além disso, o OpenTelemetry +suporta um protocolo conhecido como `OTLP`, que é compatível com todos os SDKs +do OpenTelemetry. Esse protocolo pode ser utilizado para enviar dados ao +OpenTelemetry Collector, um processo binário que pode ser executado como proxy, +sidecar ou em um host separado. O Collector pode então ser configurado para +encaminhar e exportar esses dados para ferramentas de análise de sua escolha. + +Além das ferramentas open source como Jaeger ou Prometheus, uma lista crescente +de empresas oferece suporte para ingestão de dados de telemetria do +OpenTelemetry. Para mais detalhes, consulte os +[Fornecedores](/ecosystem/vendors/). From 5285831f8296ed4abdb0747464b5dd7743c753fc Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 08:28:28 -0300 Subject: [PATCH 02/28] Update content/pt/docs/concepts/instrumentation/code-based.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Emídio Neto <9735060+emdneto@users.noreply.github.com> --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 81fb3de6f90d..360693b00401 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -26,7 +26,7 @@ provider e atribui a ela um nome e uma versão. O nome que você escolher aqui deve identificar exatamente o que está sendo instrumentado - se você está desenvolvendo uma biblioteca, por exemplo, você deve nomeá-la com o nome da sua biblioteca (por exemplo `com.example.myLibrary`), pois esse nome será usado como -namespace todos os eventos de trecho ou métricas que for produzidos. Além disso, +namespace todos os eventos de trecho ou métricas que forem produzidos. Além disso, é recomendável fornecer uma string de versão (ou seja, `semver:1.0.0`) que corresponda à versão atual da sua biblioteca ou serviço. From 10c54e04937d1f1c52bf178902b9bafa9c28fc03 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 08:28:46 -0300 Subject: [PATCH 03/28] Update content/pt/docs/concepts/instrumentation/code-based.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Emídio Neto <9735060+emdneto@users.noreply.github.com> --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 360693b00401..d64d608c1204 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -21,7 +21,7 @@ consulte a [especificação](/docs/specs/otel/). Para criar rastros ou métricas, primeiro você precisa criar um provider tracer e/ou meter. Geralmente, recomendamos que o SDK forneça um único provider padrão -para esses objetos. Em seguida, você obtem uma instância tracer ou meter desse +para esses objetos. Em seguida, você obtém uma instância tracer ou meter desse provider e atribui a ela um nome e uma versão. O nome que você escolher aqui deve identificar exatamente o que está sendo instrumentado - se você está desenvolvendo uma biblioteca, por exemplo, você deve nomeá-la com o nome da sua From bfac31bc12b835bfc740fdb8b310f97e27d7bf78 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 08:29:15 -0300 Subject: [PATCH 04/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Ezzio Moreira --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index d64d608c1204..91dbee02f054 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -52,7 +52,7 @@ programação para mais informações sobre essas bibliotecas. Depois de criar os dados de telemetria, você vai querer enviá-los para algum lugar. OpenTelemetry oferece suporte a dois métodos principais de exportação de dados do seu processo para um backend de análise, diretamente de um processo ou -através de um proxy através do [OpenTelemetry Collector](/docs/collector). +por meio de um proxy através do [OpenTelemetry Collector](/docs/collector). A exportação em processo exige que você importe e dependa de um ou mais _exporters_, bibliotecas responsáveis por traduzir os objetos de trechos e From 0a3c52784959c0ad04be8ce6cf56a7a6cb7091f8 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 08:29:53 -0300 Subject: [PATCH 05/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Ezzio Moreira --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 91dbee02f054..341cf1205d5a 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -50,7 +50,7 @@ programação para mais informações sobre essas bibliotecas. ## Exportar dados Depois de criar os dados de telemetria, você vai querer enviá-los para algum -lugar. OpenTelemetry oferece suporte a dois métodos principais de exportação de +lugar. O OpenTelemetry oferece suporte a dois métodos principais de exportação de dados do seu processo para um backend de análise, diretamente de um processo ou por meio de um proxy através do [OpenTelemetry Collector](/docs/collector). From 4d78f16dc66ab24ac3b0fdfdeb73420c00966fad Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 08:37:34 -0300 Subject: [PATCH 06/28] Update code-based.md --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 341cf1205d5a..d2246d17067a 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -26,7 +26,7 @@ provider e atribui a ela um nome e uma versão. O nome que você escolher aqui deve identificar exatamente o que está sendo instrumentado - se você está desenvolvendo uma biblioteca, por exemplo, você deve nomeá-la com o nome da sua biblioteca (por exemplo `com.example.myLibrary`), pois esse nome será usado como -namespace todos os eventos de trecho ou métricas que forem produzidos. Além disso, +_namespace_ todos os eventos de trecho ou métricas que forem produzidos. Além disso, é recomendável fornecer uma string de versão (ou seja, `semver:1.0.0`) que corresponda à versão atual da sua biblioteca ou serviço. From b26c9ed8c169a90cc8fca03855f4dff92c4d90de Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 08:44:01 -0300 Subject: [PATCH 07/28] Update code-based.md --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index d2246d17067a..edc698b9ffd4 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -26,7 +26,7 @@ provider e atribui a ela um nome e uma versão. O nome que você escolher aqui deve identificar exatamente o que está sendo instrumentado - se você está desenvolvendo uma biblioteca, por exemplo, você deve nomeá-la com o nome da sua biblioteca (por exemplo `com.example.myLibrary`), pois esse nome será usado como -_namespace_ todos os eventos de trecho ou métricas que forem produzidos. Além disso, +_namespace_ em todos os eventos de trecho ou métricas que forem produzidos. Além disso, é recomendável fornecer uma string de versão (ou seja, `semver:1.0.0`) que corresponda à versão atual da sua biblioteca ou serviço. From 89d645cf737eb6a37479379bafd63b7241f1b776 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 09:33:21 -0300 Subject: [PATCH 08/28] Fix file format --- content/pt/docs/concepts/instrumentation/code-based.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index edc698b9ffd4..e5b4da071e59 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -26,9 +26,9 @@ provider e atribui a ela um nome e uma versão. O nome que você escolher aqui deve identificar exatamente o que está sendo instrumentado - se você está desenvolvendo uma biblioteca, por exemplo, você deve nomeá-la com o nome da sua biblioteca (por exemplo `com.example.myLibrary`), pois esse nome será usado como -_namespace_ em todos os eventos de trecho ou métricas que forem produzidos. Além disso, -é recomendável fornecer uma string de versão (ou seja, `semver:1.0.0`) que -corresponda à versão atual da sua biblioteca ou serviço. +_namespace_ em todos os eventos de trecho ou métricas que forem produzidos. Além +disso, é recomendável fornecer uma string de versão (ou seja, `semver:1.0.0`) +que corresponda à versão atual da sua biblioteca ou serviço. ## Configurar o SDK do OpenTelemetry From 3abd8a1a8a8967296cbd8da671692c514ff9f8c7 Mon Sep 17 00:00:00 2001 From: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> Date: Fri, 23 Aug 2024 13:52:22 +0000 Subject: [PATCH 09/28] Results from /fix:all --- content/pt/docs/concepts/instrumentation/code-based.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index e5b4da071e59..dea4dd0df762 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -50,9 +50,9 @@ programação para mais informações sobre essas bibliotecas. ## Exportar dados Depois de criar os dados de telemetria, você vai querer enviá-los para algum -lugar. O OpenTelemetry oferece suporte a dois métodos principais de exportação de -dados do seu processo para um backend de análise, diretamente de um processo ou -por meio de um proxy através do [OpenTelemetry Collector](/docs/collector). +lugar. O OpenTelemetry oferece suporte a dois métodos principais de exportação +de dados do seu processo para um backend de análise, diretamente de um processo +ou por meio de um proxy através do [OpenTelemetry Collector](/docs/collector). A exportação em processo exige que você importe e dependa de um ou mais _exporters_, bibliotecas responsáveis por traduzir os objetos de trechos e From f7048e54e8e0bc0e038d28f520f3c05b5dea5136 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Fri, 23 Aug 2024 11:17:38 -0400 Subject: [PATCH 10/28] Tweak front matter --- content/pt/docs/concepts/instrumentation/code-based.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index dea4dd0df762..3ecb207c28aa 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -1,10 +1,9 @@ --- title: Baseada em código -description: +description: >- Informe-se sobre as etapas essenciais na configuração da instrumentação baseada em código weight: 20 -aliases: [manual] default_lang_commit: fe0c3f68902aeb6e7584ffc32c6c8964d7a89e6e --- From 52a19d4b0a24fd7f130a937bc9ea0f096eb257b0 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 16:42:05 -0300 Subject: [PATCH 11/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 3ecb207c28aa..0ea2e0fcb9de 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -18,10 +18,10 @@ consulte a [especificação](/docs/specs/otel/). ## Configurar a API do OpenTelemetry -Para criar rastros ou métricas, primeiro você precisa criar um provider tracer -e/ou meter. Geralmente, recomendamos que o SDK forneça um único provider padrão -para esses objetos. Em seguida, você obtém uma instância tracer ou meter desse -provider e atribui a ela um nome e uma versão. O nome que você escolher aqui +Para criar rastros ou métricas, primeiro você precisa criar um _provider_ do tipo _tracer_ +e/ou _meter_. Geralmente, recomendamos que o SDK forneça um único provider padrão +para esses objetos. Em seguida, você obtém uma instância _tracer_ ou _meter_ desse +_provider_ e atribui a ela um nome e uma versão. O nome que você escolher aqui deve identificar exatamente o que está sendo instrumentado - se você está desenvolvendo uma biblioteca, por exemplo, você deve nomeá-la com o nome da sua biblioteca (por exemplo `com.example.myLibrary`), pois esse nome será usado como From f0e64af3519772a3e0cdf8f2f8e3da475d4777bb Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 16:42:19 -0300 Subject: [PATCH 12/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 0ea2e0fcb9de..3a30b83ea727 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -50,7 +50,7 @@ programação para mais informações sobre essas bibliotecas. Depois de criar os dados de telemetria, você vai querer enviá-los para algum lugar. O OpenTelemetry oferece suporte a dois métodos principais de exportação -de dados do seu processo para um backend de análise, diretamente de um processo +de dados do seu processo para um _backend_ de análise, diretamente de um processo ou por meio de um proxy através do [OpenTelemetry Collector](/docs/collector). A exportação em processo exige que você importe e dependa de um ou mais From b236f3607770471210d53a7f6140a3c578052510 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 16:42:43 -0300 Subject: [PATCH 13/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 3a30b83ea727..f058f3f43005 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -59,8 +59,8 @@ métricas em memória do OpenTelemetry para o formato apropriado para ferramenta de análise de telemetria, como Jaeger ou Prometheus. Além disso, o OpenTelemetry suporta um protocolo conhecido como `OTLP`, que é compatível com todos os SDKs do OpenTelemetry. Esse protocolo pode ser utilizado para enviar dados ao -OpenTelemetry Collector, um processo binário que pode ser executado como proxy, -sidecar ou em um host separado. O Collector pode então ser configurado para +OpenTelemetry Collector, um processo binário que pode ser executado como _proxy_, +_sidecar_ ou em um _host_ separado. O Collector pode então ser configurado para encaminhar e exportar esses dados para ferramentas de análise de sua escolha. Além das ferramentas open source como Jaeger ou Prometheus, uma lista crescente From 757312cd649daff8141e25ab256861993a897f3f Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 16:42:51 -0300 Subject: [PATCH 14/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index f058f3f43005..54b84b67998c 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -63,7 +63,7 @@ OpenTelemetry Collector, um processo binário que pode ser executado como _proxy _sidecar_ ou em um _host_ separado. O Collector pode então ser configurado para encaminhar e exportar esses dados para ferramentas de análise de sua escolha. -Além das ferramentas open source como Jaeger ou Prometheus, uma lista crescente +Além das ferramentas _open source_ como Jaeger ou Prometheus, uma lista crescente de empresas oferece suporte para ingestão de dados de telemetria do OpenTelemetry. Para mais detalhes, consulte os [Fornecedores](/ecosystem/vendors/). From dcd291dba4da5511390c0d71463120815ca7909b Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 16:52:47 -0300 Subject: [PATCH 15/28] Update code-based.md --- .../concepts/instrumentation/code-based.md | 28 ++++++++++--------- 1 file changed, 15 insertions(+), 13 deletions(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 54b84b67998c..42812a232fdf 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -43,25 +43,27 @@ programação que você pode utilizar. Depois de configurar a API e o SDK, você estará livre para criar eventos de rastro e métricas usando os objetos tracer e meter obtidos do provider. Utilize bibliotecas de instrumentação para suas dependências -- confira o -[registry](/ecosystem/registry/) ou o repositório da sua linguagem de -programação para mais informações sobre essas bibliotecas. +[OpenTelemetry Registry](/ecosystem/registry/) ou o repositório da sua linguagem +de programação para mais informações sobre essas bibliotecas. ## Exportar dados Depois de criar os dados de telemetria, você vai querer enviá-los para algum lugar. O OpenTelemetry oferece suporte a dois métodos principais de exportação -de dados do seu processo para um _backend_ de análise, diretamente de um processo -ou por meio de um proxy através do [OpenTelemetry Collector](/docs/collector). +de dados do seu processo para um _backend_ de análise: diretamente da sua +aplicação ou por meio de um proxy através do +[OpenTelemetry Collector](/docs/collector). -A exportação em processo exige que você importe e dependa de um ou mais -_exporters_, bibliotecas responsáveis por traduzir os objetos de trechos e -métricas em memória do OpenTelemetry para o formato apropriado para ferramentas -de análise de telemetria, como Jaeger ou Prometheus. Além disso, o OpenTelemetry -suporta um protocolo conhecido como `OTLP`, que é compatível com todos os SDKs -do OpenTelemetry. Esse protocolo pode ser utilizado para enviar dados ao -OpenTelemetry Collector, um processo binário que pode ser executado como _proxy_, -_sidecar_ ou em um _host_ separado. O Collector pode então ser configurado para -encaminhar e exportar esses dados para ferramentas de análise de sua escolha. +A exportação a partir da sua aplicação exige que você importe e dependa de um +ou mais _exporters_, bibliotecas responsáveis por traduzir os objetos de +trechos e métricas em memória do OpenTelemetry para o formato apropriado para +ferramentas de análise de telemetria, como Jaeger ou Prometheus. Além disso, +o OpenTelemetry suporta um protocolo conhecido como `OTLP`, que é compatível +com todos os SDKs do OpenTelemetry. Esse protocolo pode ser utilizado para +enviar dados ao OpenTelemetry Collector, um processo binário que pode ser +executado como _proxy_, _sidecar_ ou em um _host_ separado. O Collector pode +então ser configurado para encaminhar e exportar esses dados para ferramentas +de análise de sua escolha. Além das ferramentas _open source_ como Jaeger ou Prometheus, uma lista crescente de empresas oferece suporte para ingestão de dados de telemetria do From e437cf8f0ac67e4b7c5200657827c2ba5137389b Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 16:53:01 -0300 Subject: [PATCH 16/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 42812a232fdf..c7408750ee7c 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -26,7 +26,7 @@ deve identificar exatamente o que está sendo instrumentado - se você está desenvolvendo uma biblioteca, por exemplo, você deve nomeá-la com o nome da sua biblioteca (por exemplo `com.example.myLibrary`), pois esse nome será usado como _namespace_ em todos os eventos de trecho ou métricas que forem produzidos. Além -disso, é recomendável fornecer uma string de versão (ou seja, `semver:1.0.0`) +disso, é recomendável fornecer uma _string_ de versão (ou seja, `semver:1.0.0`) que corresponda à versão atual da sua biblioteca ou serviço. ## Configurar o SDK do OpenTelemetry From e3bfe3cb6508631c12158156970ae5c489349db5 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 16:53:17 -0300 Subject: [PATCH 17/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index c7408750ee7c..2b58f8c64b31 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -33,7 +33,7 @@ que corresponda à versão atual da sua biblioteca ou serviço. Se você está desenvolvendo um processo de serviço, também precisará configurar o SDK com as opções adequadas para exportar seus dados de telemetria para um -backend de análise. Recomendamos que esta configuração seja feita +_backend_ de análise. Recomendamos que esta configuração seja feita programaticamente por meio de um arquivo de configuração ou outro mecanismo. Além disso, existem opções de ajuste específicas para cada linguagem de programação que você pode utilizar. From de2882267cd30d588638368c5a12c34f72a22171 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 16:54:39 -0300 Subject: [PATCH 18/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 2b58f8c64b31..5fb41b439968 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -40,7 +40,7 @@ programação que você pode utilizar. ## Criar dados de telemetria -Depois de configurar a API e o SDK, você estará livre para criar eventos de +Depois de configurar a API e o SDK, você estará pronto para criar eventos de rastro e métricas usando os objetos tracer e meter obtidos do provider. Utilize bibliotecas de instrumentação para suas dependências -- confira o [OpenTelemetry Registry](/ecosystem/registry/) ou o repositório da sua linguagem From 48a132edeaae874c11dbba326bd6fb5433030472 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 16:55:08 -0300 Subject: [PATCH 19/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 5fb41b439968..ced6ab5c3a52 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -41,7 +41,7 @@ programação que você pode utilizar. ## Criar dados de telemetria Depois de configurar a API e o SDK, você estará pronto para criar eventos de -rastro e métricas usando os objetos tracer e meter obtidos do provider. Utilize +rastros e métricas usando os objetos _tracer_ e _meter_ obtidos do _provider_. Utilize bibliotecas de instrumentação para suas dependências -- confira o [OpenTelemetry Registry](/ecosystem/registry/) ou o repositório da sua linguagem de programação para mais informações sobre essas bibliotecas. From ce1ab8edc14287d43da8da8f3a5d1a1abe54b594 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Fri, 23 Aug 2024 16:58:47 -0300 Subject: [PATCH 20/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index ced6ab5c3a52..3612d897516a 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -31,7 +31,7 @@ que corresponda à versão atual da sua biblioteca ou serviço. ## Configurar o SDK do OpenTelemetry -Se você está desenvolvendo um processo de serviço, também precisará configurar o +Se você está desenvolvendo um serviço, também precisará configurar o SDK com as opções adequadas para exportar seus dados de telemetria para um _backend_ de análise. Recomendamos que esta configuração seja feita programaticamente por meio de um arquivo de configuração ou outro mecanismo. From a5f1c417efcfe4aa9fd3b6e1d089f4707d2ca872 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Sat, 24 Aug 2024 10:36:54 -0300 Subject: [PATCH 21/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 3612d897516a..5debac613351 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -7,7 +7,7 @@ weight: 20 default_lang_commit: fe0c3f68902aeb6e7584ffc32c6c8964d7a89e6e --- -## Importar a API e o SDK do OpenTelemetry +## Importe a API e o SDK do OpenTelemetry Primeiro, você precisará importar o OpenTelemetry para o seu código. Se estiver desenvolvendo uma biblioteca ou algum outro componente que se destina a ser From 8f9fcf9e81303f3a9b228eb5f905a481a6562dc5 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Sat, 24 Aug 2024 10:37:12 -0300 Subject: [PATCH 22/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 5debac613351..75bfc172a245 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -16,7 +16,7 @@ artefato for um processo ou serviço independente, então você dependeria da AP do SDK. Para obter mais informações sobre a API e o SDK do OpenTelemetry, consulte a [especificação](/docs/specs/otel/). -## Configurar a API do OpenTelemetry +## Configure a API do OpenTelemetry Para criar rastros ou métricas, primeiro você precisa criar um _provider_ do tipo _tracer_ e/ou _meter_. Geralmente, recomendamos que o SDK forneça um único provider padrão From 3ef7347c3eb7fecf61f2a17ae4d84dd88438411f Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Sat, 24 Aug 2024 10:37:28 -0300 Subject: [PATCH 23/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 75bfc172a245..f7c4cada1806 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -29,7 +29,7 @@ _namespace_ em todos os eventos de trecho ou métricas que forem produzidos. Al disso, é recomendável fornecer uma _string_ de versão (ou seja, `semver:1.0.0`) que corresponda à versão atual da sua biblioteca ou serviço. -## Configurar o SDK do OpenTelemetry +## Configure o SDK do OpenTelemetry Se você está desenvolvendo um serviço, também precisará configurar o SDK com as opções adequadas para exportar seus dados de telemetria para um From cec51e88da39a5e2cf71f707c33eddc101e3d258 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Sat, 24 Aug 2024 10:38:21 -0300 Subject: [PATCH 24/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index f7c4cada1806..bb80c0fe0ad9 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -38,7 +38,7 @@ programaticamente por meio de um arquivo de configuração ou outro mecanismo. Além disso, existem opções de ajuste específicas para cada linguagem de programação que você pode utilizar. -## Criar dados de telemetria +## Crie dados de telemetria Depois de configurar a API e o SDK, você estará pronto para criar eventos de rastros e métricas usando os objetos _tracer_ e _meter_ obtidos do _provider_. Utilize From 7eb7fe354a9f3b749ec6528d45b2f39661213022 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Sat, 24 Aug 2024 10:38:59 -0300 Subject: [PATCH 25/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index bb80c0fe0ad9..e08646d5a656 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -1,7 +1,7 @@ --- title: Baseada em código description: >- - Informe-se sobre as etapas essenciais na configuração da instrumentação + Aprenda as etapas essenciais na configuração da instrumentação baseada em código weight: 20 default_lang_commit: fe0c3f68902aeb6e7584ffc32c6c8964d7a89e6e From 0e07e34b779ada6caa4c9eee6f9f51fff2fa0e64 Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Sat, 24 Aug 2024 10:39:21 -0300 Subject: [PATCH 26/28] Update content/pt/docs/concepts/instrumentation/code-based.md Co-authored-by: Luiz Aoqui --- content/pt/docs/concepts/instrumentation/code-based.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index e08646d5a656..1d607a40b309 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -46,7 +46,7 @@ bibliotecas de instrumentação para suas dependências -- confira o [OpenTelemetry Registry](/ecosystem/registry/) ou o repositório da sua linguagem de programação para mais informações sobre essas bibliotecas. -## Exportar dados +## Exporte dados Depois de criar os dados de telemetria, você vai querer enviá-los para algum lugar. O OpenTelemetry oferece suporte a dois métodos principais de exportação From ab04256535607843aed621337598d998af06532f Mon Sep 17 00:00:00 2001 From: Janssen dos Reis Lima Date: Sun, 25 Aug 2024 23:00:47 -0300 Subject: [PATCH 27/28] Update code-based.md Title changed according to alignment. --- content/pt/docs/concepts/instrumentation/code-based.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 1d607a40b309..42f68a860cd3 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -1,8 +1,8 @@ --- -title: Baseada em código +title: Manual description: >- Aprenda as etapas essenciais na configuração da instrumentação - baseada em código + manual weight: 20 default_lang_commit: fe0c3f68902aeb6e7584ffc32c6c8964d7a89e6e --- From a8d84ceecd2e011cf77c820ec2abefa1d118fd5c Mon Sep 17 00:00:00 2001 From: Janssen Lima Date: Mon, 26 Aug 2024 09:35:13 -0300 Subject: [PATCH 28/28] Fix code style issues with Prettier --- .../concepts/instrumentation/code-based.md | 64 +++++++++---------- 1 file changed, 32 insertions(+), 32 deletions(-) diff --git a/content/pt/docs/concepts/instrumentation/code-based.md b/content/pt/docs/concepts/instrumentation/code-based.md index 42f68a860cd3..997ec126abeb 100644 --- a/content/pt/docs/concepts/instrumentation/code-based.md +++ b/content/pt/docs/concepts/instrumentation/code-based.md @@ -1,8 +1,7 @@ --- title: Manual description: >- - Aprenda as etapas essenciais na configuração da instrumentação - manual + Aprenda as etapas essenciais na configuração da instrumentação manual weight: 20 default_lang_commit: fe0c3f68902aeb6e7584ffc32c6c8964d7a89e6e --- @@ -18,31 +17,32 @@ consulte a [especificação](/docs/specs/otel/). ## Configure a API do OpenTelemetry -Para criar rastros ou métricas, primeiro você precisa criar um _provider_ do tipo _tracer_ -e/ou _meter_. Geralmente, recomendamos que o SDK forneça um único provider padrão -para esses objetos. Em seguida, você obtém uma instância _tracer_ ou _meter_ desse -_provider_ e atribui a ela um nome e uma versão. O nome que você escolher aqui -deve identificar exatamente o que está sendo instrumentado - se você está -desenvolvendo uma biblioteca, por exemplo, você deve nomeá-la com o nome da sua -biblioteca (por exemplo `com.example.myLibrary`), pois esse nome será usado como -_namespace_ em todos os eventos de trecho ou métricas que forem produzidos. Além -disso, é recomendável fornecer uma _string_ de versão (ou seja, `semver:1.0.0`) -que corresponda à versão atual da sua biblioteca ou serviço. +Para criar rastros ou métricas, primeiro você precisa criar um _provider_ do +tipo _tracer_ e/ou _meter_. Geralmente, recomendamos que o SDK forneça um único +provider padrão para esses objetos. Em seguida, você obtém uma instância +_tracer_ ou _meter_ desse _provider_ e atribui a ela um nome e uma versão. O +nome que você escolher aqui deve identificar exatamente o que está sendo +instrumentado - se você está desenvolvendo uma biblioteca, por exemplo, você +deve nomeá-la com o nome da sua biblioteca (por exemplo +`com.example.myLibrary`), pois esse nome será usado como _namespace_ em todos os +eventos de trecho ou métricas que forem produzidos. Além disso, é recomendável +fornecer uma _string_ de versão (ou seja, `semver:1.0.0`) que corresponda à +versão atual da sua biblioteca ou serviço. ## Configure o SDK do OpenTelemetry -Se você está desenvolvendo um serviço, também precisará configurar o -SDK com as opções adequadas para exportar seus dados de telemetria para um -_backend_ de análise. Recomendamos que esta configuração seja feita -programaticamente por meio de um arquivo de configuração ou outro mecanismo. -Além disso, existem opções de ajuste específicas para cada linguagem de -programação que você pode utilizar. +Se você está desenvolvendo um serviço, também precisará configurar o SDK com as +opções adequadas para exportar seus dados de telemetria para um _backend_ de +análise. Recomendamos que esta configuração seja feita programaticamente por +meio de um arquivo de configuração ou outro mecanismo. Além disso, existem +opções de ajuste específicas para cada linguagem de programação que você pode +utilizar. ## Crie dados de telemetria Depois de configurar a API e o SDK, você estará pronto para criar eventos de -rastros e métricas usando os objetos _tracer_ e _meter_ obtidos do _provider_. Utilize -bibliotecas de instrumentação para suas dependências -- confira o +rastros e métricas usando os objetos _tracer_ e _meter_ obtidos do _provider_. +Utilize bibliotecas de instrumentação para suas dependências -- confira o [OpenTelemetry Registry](/ecosystem/registry/) ou o repositório da sua linguagem de programação para mais informações sobre essas bibliotecas. @@ -54,18 +54,18 @@ de dados do seu processo para um _backend_ de análise: diretamente da sua aplicação ou por meio de um proxy através do [OpenTelemetry Collector](/docs/collector). -A exportação a partir da sua aplicação exige que você importe e dependa de um -ou mais _exporters_, bibliotecas responsáveis por traduzir os objetos de -trechos e métricas em memória do OpenTelemetry para o formato apropriado para -ferramentas de análise de telemetria, como Jaeger ou Prometheus. Além disso, -o OpenTelemetry suporta um protocolo conhecido como `OTLP`, que é compatível -com todos os SDKs do OpenTelemetry. Esse protocolo pode ser utilizado para -enviar dados ao OpenTelemetry Collector, um processo binário que pode ser -executado como _proxy_, _sidecar_ ou em um _host_ separado. O Collector pode -então ser configurado para encaminhar e exportar esses dados para ferramentas -de análise de sua escolha. +A exportação a partir da sua aplicação exige que você importe e dependa de um ou +mais _exporters_, bibliotecas responsáveis por traduzir os objetos de trechos e +métricas em memória do OpenTelemetry para o formato apropriado para ferramentas +de análise de telemetria, como Jaeger ou Prometheus. Além disso, o OpenTelemetry +suporta um protocolo conhecido como `OTLP`, que é compatível com todos os SDKs +do OpenTelemetry. Esse protocolo pode ser utilizado para enviar dados ao +OpenTelemetry Collector, um processo binário que pode ser executado como +_proxy_, _sidecar_ ou em um _host_ separado. O Collector pode então ser +configurado para encaminhar e exportar esses dados para ferramentas de análise +de sua escolha. -Além das ferramentas _open source_ como Jaeger ou Prometheus, uma lista crescente -de empresas oferece suporte para ingestão de dados de telemetria do +Além das ferramentas _open source_ como Jaeger ou Prometheus, uma lista +crescente de empresas oferece suporte para ingestão de dados de telemetria do OpenTelemetry. Para mais detalhes, consulte os [Fornecedores](/ecosystem/vendors/).