-
Notifications
You must be signed in to change notification settings - Fork 1.8k
[pt] Translate deploy/agent.md and deploy/choose.md
#9649
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
Merged
vitorvasc
merged 10 commits into
open-telemetry:main
from
GRISONRF:pt-localize-collector-deploy
Apr 28, 2026
+152
−0
Merged
Changes from 6 commits
Commits
Show all changes
10 commits
Select commit
Hold shift + click to select a range
083cb5a
portuguese translation to deploy/agent.md
GRISONRF 94cecbd
doc: portugese translation deploy/choose.md
GRISONRF a90492e
doc: portugese translation to deploy/agent.md and deploy/choose.md
GRISONRF 74f5090
pt: deploy and agent after run fix:format
GRISONRF 6fd1c98
pt: remove english cSpell ignore
GRISONRF e9dc8be
Merge branch 'main' into pt-localize-collector-deploy
vitorvasc 421b3c4
pt: deploy/agent and choose translation fix
GRISONRF 96a7817
pt: deploy and agent after run fix:format
GRISONRF 1dd3d2b
fix: formatting and submodule pinning
GRISONRF 3deeca3
Merge branch 'main' into pt-localize-collector-deploy
vitorvasc File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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 | ||
| 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]. | ||
| - 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 | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
| de uma instância do Collector: | ||
|
|
||
|  | ||
|
|
||
| 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. | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
|
|
||
| ## Example | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
|
|
||
| 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: | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
|
|
||
| {{< tabpane text=true >}} {{% tab Traces %}} | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
|
|
||
| ```yaml | ||
| receivers: | ||
| otlp: # o receptor OTLP para onde o app envia traces | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
| 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 %}} | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
|
|
||
| ```yaml | ||
| receivers: | ||
| otlp: # o receptor OTLP para o qual o app envia métricas | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
| protocols: | ||
| http: | ||
| endpoint: 0.0.0.0:4318 | ||
|
|
||
| exporters: | ||
| prometheusremotewrite: # o exportador PRW, para enviar métricas ao backend | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
| 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 | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
| protocols: | ||
| http: | ||
| endpoint: 0.0.0.0:4318 | ||
|
|
||
| exporters: | ||
| file: # o Exportador de Arquivo, para gravar logs em um arquivo local | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
| 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} | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
|
|
||
| Aqui estão os principais prós e contras de usar um collector no modo agente: | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
|
|
||
| Prós: | ||
|
|
||
| - Fácil de começar | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
| - 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 | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
|
|
||
| [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 | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,16 @@ | ||
| --- | ||
| title: Escolha um padrão de implantação de Collector | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
| linkTitle: Escolha um padrão de implantação | ||
| build: | ||
| list: never | ||
| 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. | ||
|
GRISONRF marked this conversation as resolved.
Outdated
|
||
|
|
||
| Veja também: | ||
| [OpenTelemetry Collector Builder (OCB)](/docs/collector/extend/ocb/). | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.