From 083cb5a63fe06eb4280b6c592041f052cae3fe61 Mon Sep 17 00:00:00 2001 From: Rafaela <81582376+GRISONRF@users.noreply.github.com> Date: Tue, 14 Apr 2026 18:06:46 +0000 Subject: [PATCH 1/5] portuguese translation to deploy/agent.md --- content/pt/docs/collector/deploy/agent.md | 135 ++++++++++++++++++++++ 1 file changed, 135 insertions(+) create mode 100644 content/pt/docs/collector/deploy/agent.md diff --git a/content/pt/docs/collector/deploy/agent.md b/content/pt/docs/collector/deploy/agent.md new file mode 100644 index 000000000000..8cedca0cbca8 --- /dev/null +++ b/content/pt/docs/collector/deploy/agent.md @@ -0,0 +1,135 @@ +--- +title: Padrão de implantação de agente +linkTitle: Padrão de agente +description: Envie sinais para Collectors e, em seguida, exporte para backends +aliases: [/docs/collector/deployment/agent] +weight: 200 +cSpell:ignore: prometheusremotewrite +default_lang_commit: bcca85a165acd5dc0c99b011665c53cb30de5ca5 +--- + +No padrão de implantação de agente, os sinais de telemetria podem vir de: + +- Aplicações [instrumentadas][instrumentation] com um SDK do OpenTelemetry usando + o [OpenTelemetry Protocol (OTLP)][otlp]. +- Collectors usando o exportador OTLP. + +Os sinais são enviados para uma instância do [Collector][collector] que executa ao lado +da aplicação ou no mesmo host, como um sidecar ou DaemonSet. + +Cada SDK do lado do cliente ou Collector downstream é configurado com o endereço de uma +instância do Collector: + +![Conceito de implantação descentralizada do collector](../../img/otel-agent-sdk.svg) + +1. Na aplicação, o SDK é configurado para enviar dados OTLP para um Collector. +1. O Collector é configurado para enviar dados de telemetria para um ou mais backends. + +## Example + +Neste exemplo do padrão de implantação de agente, comece instrumentando manualmente +uma [aplicação Java para exportar métricas][instrument-java-metrics] usando o +SDK Java do OpenTelemetry, incluindo o valor padrão de `OTEL_METRICS_EXPORTER`, +`otlp`. Em seguida, configure o [exportador OTLP][otlp-exporter] com o endereço do +seu Collector. Por exemplo: + +```shell +export OTEL_EXPORTER_OTLP_ENDPOINT=http://collector.example.com:4318 +``` + +Depois, configure o Collector executando em `collector.example.com:4318` da +seguinte forma: + +{{< tabpane text=true >}} {{% tab Traces %}} + +```yaml +receivers: + otlp: # o receptor OTLP para onde o app envia traces + protocols: + http: + endpoint: 0.0.0.0:4318 + +exporters: + otlp/jaeger: # o Jaeger suporta OTLP diretamente + endpoint: https://jaeger.example.com:4317 + sending_queue: + batch: + +service: + pipelines: + traces/dev: + receivers: [otlp] + exporters: [otlp/jaeger] +``` + +{{% /tab %}} {{% tab Metrics %}} + +```yaml +receivers: + otlp: # o receptor OTLP para o qual o app envia métricas + protocols: + http: + endpoint: 0.0.0.0:4318 + +exporters: + prometheusremotewrite: # o exportador PRW, para enviar métricas no backend + endpoint: https://prw.example.com/v1/api/remote_write + sending_queue: + batch: + +service: + pipelines: + metrics/prod: + receivers: [otlp] + exporters: [prometheusremotewrite] +``` + +{{% /tab %}} {{% tab Logs %}} + +```yaml +receivers: + otlp: # o receptor OTLP para onde o app envia logs + protocols: + http: + endpoint: 0.0.0.0:4318 + +exporters: + file: # o Exportador de Arquivo, para graver logs em um arquivo local + path: ./app42_example.log + rotation: + +service: + pipelines: + logs/dev: + receivers: [otlp] + exporters: [file] +``` + +{{% /tab %}} {{< /tabpane >}} + +Para explorar esse padrão de ponta a ponta, veja os exemplos em [Java][java-otlp-example] ou +[Python][py-otlp-example]. + +## Trade-offs {#trade-offs} + +Aqui estão os principais prós e contras de usar um collector no modo agente: + +Prós: + +- Fácil de começar +- Mapeamento claro um-para-um entre aplicação e Collector + +Contras: + +- Escalabilidade limitada para equipes e recursos de infraestrutura +- Inflexible para implantações complexas ou em evolução + +[instrumentation]: /docs/languages/ +[otlp]: /docs/specs/otel/protocol/ +[collector]: /docs/collector/ +[instrument-java-metrics]: /docs/languages/java/api/#meterprovider +[otlp-exporter]: /docs/specs/otel/protocol/exporter/ +[java-otlp-example]: + https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/otlp +[py-otlp-example]: + https://opentelemetry-python.readthedocs.io/en/stable/examples/metrics/instruments/README.html From 94cecbdebd3b6187f1f91c18673a9c49d0822203 Mon Sep 17 00:00:00 2001 From: Rafaela <81582376+GRISONRF@users.noreply.github.com> Date: Tue, 14 Apr 2026 18:09:23 +0000 Subject: [PATCH 2/5] doc: portugese translation deploy/choose.md --- content/pt/docs/collector/deploy/choose.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 content/pt/docs/collector/deploy/choose.md diff --git a/content/pt/docs/collector/deploy/choose.md b/content/pt/docs/collector/deploy/choose.md new file mode 100644 index 000000000000..f71c23d86500 --- /dev/null +++ b/content/pt/docs/collector/deploy/choose.md @@ -0,0 +1,13 @@ +--- +title: Escolha um padrão de implantação de Collector +linkTitle: Escolha um padrão de implantação +build: + list: never +draft: true +toc_hide: true +weight: 100 +--- + +Esta página ajudará você a escolher o padrão de implantação do Collector adequado para o seu caso de uso. + +Veja também: [OpenTelemetry Collector Builder (OCB)](/docs/collector/extend/ocb/). From a90492efa488b042abe206262dfbaebf609e800a Mon Sep 17 00:00:00 2001 From: Rafaela <81582376+GRISONRF@users.noreply.github.com> Date: Tue, 14 Apr 2026 18:24:16 +0000 Subject: [PATCH 3/5] doc: portugese translation to deploy/agent.md and deploy/choose.md --- content/pt/docs/collector/deploy/agent.md | 6 +++--- content/pt/docs/collector/deploy/choose.md | 1 + 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/content/pt/docs/collector/deploy/agent.md b/content/pt/docs/collector/deploy/agent.md index 8cedca0cbca8..62e7093d6d4a 100644 --- a/content/pt/docs/collector/deploy/agent.md +++ b/content/pt/docs/collector/deploy/agent.md @@ -5,7 +5,7 @@ description: Envie sinais para Collectors e, em seguida, exporte para backends aliases: [/docs/collector/deployment/agent] weight: 200 cSpell:ignore: prometheusremotewrite -default_lang_commit: bcca85a165acd5dc0c99b011665c53cb30de5ca5 +default_lang_commit: 6cebc46de450dd44481a8a6f17c9b3d6f04aa0f2 --- No padrão de implantação de agente, os sinais de telemetria podem vir de: @@ -72,7 +72,7 @@ receivers: endpoint: 0.0.0.0:4318 exporters: - prometheusremotewrite: # o exportador PRW, para enviar métricas no backend + prometheusremotewrite: # o exportador PRW, para enviar métricas ao backend endpoint: https://prw.example.com/v1/api/remote_write sending_queue: batch: @@ -94,7 +94,7 @@ receivers: endpoint: 0.0.0.0:4318 exporters: - file: # o Exportador de Arquivo, para graver logs em um arquivo local + file: # o Exportador de Arquivo, para gravar logs em um arquivo local path: ./app42_example.log rotation: diff --git a/content/pt/docs/collector/deploy/choose.md b/content/pt/docs/collector/deploy/choose.md index f71c23d86500..48891a8b1c96 100644 --- a/content/pt/docs/collector/deploy/choose.md +++ b/content/pt/docs/collector/deploy/choose.md @@ -6,6 +6,7 @@ build: draft: true toc_hide: true weight: 100 +default_lang_commit: 4cb7e22f1e45d17854b309efc730499880aa7197 --- Esta página ajudará você a escolher o padrão de implantação do Collector adequado para o seu caso de uso. From 74f5090050d16105ac5722cab535a7f8643fbae1 Mon Sep 17 00:00:00 2001 From: Rafaela <81582376+GRISONRF@users.noreply.github.com> Date: Tue, 14 Apr 2026 18:56:09 +0000 Subject: [PATCH 4/5] pt: deploy and agent after run fix:format --- content/pt/docs/collector/deploy/agent.md | 29 +++++++++++----------- content/pt/docs/collector/deploy/choose.md | 6 +++-- 2 files changed, 19 insertions(+), 16 deletions(-) diff --git a/content/pt/docs/collector/deploy/agent.md b/content/pt/docs/collector/deploy/agent.md index 62e7093d6d4a..288f8605d417 100644 --- a/content/pt/docs/collector/deploy/agent.md +++ b/content/pt/docs/collector/deploy/agent.md @@ -10,28 +10,29 @@ default_lang_commit: 6cebc46de450dd44481a8a6f17c9b3d6f04aa0f2 No padrão de implantação de agente, os sinais de telemetria podem vir de: -- Aplicações [instrumentadas][instrumentation] com um SDK do OpenTelemetry usando - o [OpenTelemetry Protocol (OTLP)][otlp]. +- Aplicações [instrumentadas][instrumentation] com um SDK do OpenTelemetry + usando o [OpenTelemetry Protocol (OTLP)][otlp]. - Collectors usando o exportador OTLP. -Os sinais são enviados para uma instância do [Collector][collector] que executa ao lado -da aplicação ou no mesmo host, como um sidecar ou DaemonSet. +Os sinais são enviados para uma instância do [Collector][collector] que executa +ao lado da aplicação ou no mesmo host, como um sidecar ou DaemonSet. -Cada SDK do lado do cliente ou Collector downstream é configurado com o endereço de uma -instância do Collector: +Cada SDK do lado do cliente ou Collector downstream é configurado com o endereço +de uma instância do Collector: ![Conceito de implantação descentralizada do collector](../../img/otel-agent-sdk.svg) 1. Na aplicação, o SDK é configurado para enviar dados OTLP para um Collector. -1. O Collector é configurado para enviar dados de telemetria para um ou mais backends. +1. O Collector é configurado para enviar dados de telemetria para um ou mais + backends. ## Example -Neste exemplo do padrão de implantação de agente, comece instrumentando manualmente -uma [aplicação Java para exportar métricas][instrument-java-metrics] usando o -SDK Java do OpenTelemetry, incluindo o valor padrão de `OTEL_METRICS_EXPORTER`, -`otlp`. Em seguida, configure o [exportador OTLP][otlp-exporter] com o endereço do -seu Collector. Por exemplo: +Neste exemplo do padrão de implantação de agente, comece instrumentando +manualmente uma [aplicação Java para exportar métricas][instrument-java-metrics] +usando o SDK Java do OpenTelemetry, incluindo o valor padrão de +`OTEL_METRICS_EXPORTER`, `otlp`. Em seguida, configure o [exportador +OTLP][otlp-exporter] com o endereço do seu Collector. Por exemplo: ```shell export OTEL_EXPORTER_OTLP_ENDPOINT=http://collector.example.com:4318 @@ -107,8 +108,8 @@ service: {{% /tab %}} {{< /tabpane >}} -Para explorar esse padrão de ponta a ponta, veja os exemplos em [Java][java-otlp-example] ou -[Python][py-otlp-example]. +Para explorar esse padrão de ponta a ponta, veja os exemplos em +[Java][java-otlp-example] ou [Python][py-otlp-example]. ## Trade-offs {#trade-offs} diff --git a/content/pt/docs/collector/deploy/choose.md b/content/pt/docs/collector/deploy/choose.md index 48891a8b1c96..04ea93866db4 100644 --- a/content/pt/docs/collector/deploy/choose.md +++ b/content/pt/docs/collector/deploy/choose.md @@ -9,6 +9,8 @@ weight: 100 default_lang_commit: 4cb7e22f1e45d17854b309efc730499880aa7197 --- -Esta página ajudará você a escolher o padrão de implantação do Collector adequado para o seu caso de uso. +Esta página ajudará você a escolher o padrão de implantação do Collector +adequado para o seu caso de uso. -Veja também: [OpenTelemetry Collector Builder (OCB)](/docs/collector/extend/ocb/). +Veja também: +[OpenTelemetry Collector Builder (OCB)](/docs/collector/extend/ocb/). From 6fd1c98f6882a27c488991eae82bd560cb2050cd Mon Sep 17 00:00:00 2001 From: Rafaela <81582376+GRISONRF@users.noreply.github.com> Date: Thu, 16 Apr 2026 21:07:06 +0000 Subject: [PATCH 5/5] pt: remove english cSpell ignore --- content/pt/docs/collector/deploy/agent.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/pt/docs/collector/deploy/agent.md b/content/pt/docs/collector/deploy/agent.md index 288f8605d417..ce3e4ecb17dc 100644 --- a/content/pt/docs/collector/deploy/agent.md +++ b/content/pt/docs/collector/deploy/agent.md @@ -4,7 +4,6 @@ linkTitle: Padrão de agente description: Envie sinais para Collectors e, em seguida, exporte para backends aliases: [/docs/collector/deployment/agent] weight: 200 -cSpell:ignore: prometheusremotewrite default_lang_commit: 6cebc46de450dd44481a8a6f17c9b3d6f04aa0f2 ---