Skip to content
135 changes: 135 additions & 0 deletions content/pt/docs/collector/deploy/agent.md
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.
Comment thread
GRISONRF marked this conversation as resolved.
Outdated

Cada SDK do lado do cliente ou Collector downstream é configurado com o endereço
Comment thread
GRISONRF marked this conversation as resolved.
Outdated
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.
Comment thread
GRISONRF marked this conversation as resolved.
Outdated

## Example
Comment thread
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:
Comment thread
GRISONRF marked this conversation as resolved.
Outdated

{{< tabpane text=true >}} {{% tab Traces %}}
Comment thread
GRISONRF marked this conversation as resolved.
Outdated

```yaml
receivers:
otlp: # o receptor OTLP para onde o app envia traces
Comment thread
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 %}}
Comment thread
GRISONRF marked this conversation as resolved.
Outdated

```yaml
receivers:
otlp: # o receptor OTLP para o qual o app envia métricas
Comment thread
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
Comment thread
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
Comment thread
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
Comment thread
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}
Comment thread
GRISONRF marked this conversation as resolved.
Outdated

Aqui estão os principais prós e contras de usar um collector no modo agente:
Comment thread
GRISONRF marked this conversation as resolved.
Outdated

Prós:

- Fácil de começar
Comment thread
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
Comment thread
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
16 changes: 16 additions & 0 deletions content/pt/docs/collector/deploy/choose.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
title: Escolha um padrão de implantação de Collector
Comment thread
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.
Comment thread
GRISONRF marked this conversation as resolved.
Outdated

Veja também:
[OpenTelemetry Collector Builder (OCB)](/docs/collector/extend/ocb/).
Loading