diff --git a/content/pt/docs/collector/deploy/agent.md b/content/pt/docs/collector/deploy/agent.md new file mode 100644 index 000000000000..ce3e4ecb17dc --- /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 +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 +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 ao 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 gravar 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 diff --git a/content/pt/docs/collector/deploy/choose.md b/content/pt/docs/collector/deploy/choose.md new file mode 100644 index 000000000000..04ea93866db4 --- /dev/null +++ b/content/pt/docs/collector/deploy/choose.md @@ -0,0 +1,16 @@ +--- +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 +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. + +Veja também: +[OpenTelemetry Collector Builder (OCB)](/docs/collector/extend/ocb/).