Skip to content

Commit d8e7328

Browse files
authored
[pt] Translate shortcode snippets /languages/exporters (#5593)
1 parent 28464a1 commit d8e7328

File tree

7 files changed

+231
-2
lines changed

7 files changed

+231
-2
lines changed

content/pt/docs/concepts/components.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ Para mais informações, consulte
7575

7676
### Exporters {#exporters}
7777

78-
{{% docs/languages/exporters/intro %}}
78+
{{% pt/docs/languages/exporters/intro %}}
7979

8080
### Instrumentação sem código {#zero-code-instrumentation}
8181

content/pt/docs/languages/go/exporters.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ default_lang_commit: 5e2a0b43c1f9f42824a024206e797cf7041ed9db
77
cSpell:ignore: otlplog otlploggrpc otlploghttp otlpmetric otlpmetricgrpc otlpmetrichttp otlptrace otlptracegrpc otlptracehttp promhttp stdoutlog stdouttrace
88
---
99

10-
{{% docs/languages/exporters/intro go %}}
10+
{{% pt/docs/languages/exporters/intro go %}}
1111

1212
## Console
1313

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,122 @@
1+
{{/* cSpell:ignore cond */ -}} Envie dados de telemetria para o
2+
[OpenTelemetry Collector](/docs/collector/) para garantir que estes dados sejam
3+
exportados corretamente. A utilização de um Collector em ambientes de produção é
4+
a melhor prática. Para visualizar os dados de telemetria que foram gerados,
5+
exporte-os para um _backend_ como [Jaeger](https://jaegertracing.io/),
6+
[Zipkin](https://zipkin.io/), [Prometheus](https://prometheus.io/), ou um
7+
_backend_ [específico de um fornecedor](/ecosystem/vendors/).
8+
9+
{{ $lang := .Get 0 | default "" -}}
10+
11+
{{ $name := "" -}}
12+
13+
{{ if $lang -}}
14+
15+
{{ $name = (index $.Site.Data.instrumentation $lang).name -}}
16+
17+
## Exportadores disponíveis {#available-exporters}
18+
19+
O registro oferece uma [lista de exportadores para {{ $name }}][reg].
20+
21+
{{ else -}}
22+
23+
O registro oferece uma [lista de exportadores específicos de linguagem][reg].
24+
25+
{{ end -}}
26+
27+
Entre os exportadores, os exportadores do [OpenTelemetry Protocol (OTLP)][OTLP]
28+
são projetados tendo em mente o modelo de dados do OpenTelemetry, emitindo dados
29+
OTel sem qualquer perda de informação. Além disso, muitas ferramentas que operam
30+
com dados de telemetria suportam o formato OTLP (como [Prometheus][Prometheus],
31+
[Jaeger][Jaeger] e a maioria dos [fornecedores][vendors]), proporcionando um
32+
alto grau de flexibilidade quando necessário. Para saber mais sobre o OTLP,
33+
consulte a [Especificação do OTLP][OTLP].
34+
35+
[Jaeger]: /blog/2022/jaeger-native-otlp/
36+
[OTLP]: /docs/specs/otlp/
37+
[Prometheus]:
38+
https://prometheus.io/docs/prometheus/latest/feature_flags/#otlp-receiver
39+
[vendors]: /ecosystem/vendors/
40+
41+
[reg]: /ecosystem/registry/?component=exporter&language={{ $lang }}
42+
43+
{{ if $name -}}
44+
45+
Esta página reúne informações sobre os principais exportadores do OpenTelemetry
46+
{{ $name }} e como configurá-los.
47+
48+
{{ end -}}
49+
50+
{{ $l := cond (eq $lang "dotnet") "net" $lang }}
51+
{{ with $.Page.GetPage (print "/docs/zero-code/" $l "/configuration" ) }}
52+
53+
<div class="alert alert-info" role="alert"><h4 class="alert-heading">Nota</h4>
54+
55+
Caso você esteja utilizando [instrumentação sem
56+
código](/docs/zero-code/{{ $l }}), você poderá aprender a configurar os
57+
exporters através do [Guia de
58+
Configurações](/docs/zero-code/{{ $l }}/configuration/).
59+
60+
</div>
61+
62+
{{ end -}}
63+
64+
{{/*
65+
a lista a seguir precisa crescer até que todas as línguas sejam atualizadas para uma estrutura consistente.
66+
*/ -}}
67+
68+
{{ if in (slice "python" "js" "java" "cpp" "dotnet") $lang -}}
69+
70+
## OTLP
71+
72+
### Configuração do Collector {#collector-setup}
73+
74+
<div class="alert alert-info" role="alert"><h4 class="alert-heading">Nota</h4>
75+
76+
Caso já possua um coletor ou _backend_ OTLP configurado, poderá pular para
77+
[configurar as dependências do exportador OTLP](#otlp-dependencies) para a sua
78+
aplicação.
79+
80+
</div>
81+
82+
Para testar e validar os seus exportadores OTLP, é possível executar o Collector
83+
em um contêiner Docker que escreve os dados diretamente no console.
84+
85+
Em uma pasta vazia, crie um arquivo chamado `collector-config.yaml` e adicione o
86+
seguinte conteúdo:
87+
88+
```yaml
89+
receivers:
90+
otlp:
91+
protocols:
92+
grpc:
93+
endpoint: 0.0.0.0:4317
94+
http:
95+
endpoint: 0.0.0.0:4318
96+
exporters:
97+
debug:
98+
verbosity: detailed
99+
service:
100+
pipelines:
101+
traces:
102+
receivers: [otlp]
103+
exporters: [debug]
104+
metrics:
105+
receivers: [otlp]
106+
exporters: [debug]
107+
logs:
108+
receivers: [otlp]
109+
exporters: [debug]
110+
```
111+
112+
Em seguida, execute o Collector em um contêiner Docker através do seguinte
113+
comando:
114+
115+
```shell
116+
docker run -p 4317:4317 -p 4318:4318 --rm -v $(pwd)/collector-config.yaml:/etc/otelcol/config.yaml otel/opentelemetry-collector
117+
```
118+
119+
Este Collector agora é capaz receber dados de telemetria via OTLP. Mais tarde,
120+
você também poderá [configurar o Collector](/docs/collector/configuration) para
121+
enviar os seus dados de telemetria para o seu _backend_ de observabilidade.
122+
{{ end -}}
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
## Jaeger
2+
3+
### Configuração do Backend {#jaeger-backend-setup}
4+
5+
O [Jaeger](https://www.jaegertracing.io/) suporta nativamente o OTLP para
6+
receber dados de rastros. O Jaeger pode ser executado através de um contêiner
7+
Docker com uma UI acessível através da porta 16686 e OTLP habilitados nas portas
8+
4317 e 4318:
9+
10+
```shell
11+
docker run --rm \
12+
-e COLLECTOR_ZIPKIN_HOST_PORT=:9411 \
13+
-p 16686:16686 \
14+
-p 4317:4317 \
15+
-p 4318:4318 \
16+
-p 9411:9411 \
17+
jaegertracing/all-in-one:latest
18+
```
19+
20+
### Uso {#jaeger-usage}
21+
22+
Siga as instruções para configurar os [exportadores OTLP](#otlp-dependencies).
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
{{ $lang := .Get 0 -}} {{ $spanExporterInterfaceUrl := .Get 1 }}
2+
3+
## Exportadores personalizados {#custom-exporters}
4+
5+
Por fim, também é possível escrever o seu próprio exportador. Para mais
6+
informações, consulte [SpanExporter Interface na documentação da
7+
API]({{ $spanExporterInterfaceUrl }}).
8+
9+
## Agrupamento de trechos e registros de log {#batching-span-and-log-records}
10+
11+
O SDK do OpenTelemetry fornece um conjunto de processadores padrão de trechos e
12+
registros de log, que permitem emitir trechos um-a-um ("simples") ou em lotes. O
13+
uso de agrupamentos é recomendado, mas caso não deseje agrupar seus trechos ou
14+
registros de log, é possível utilizar um processador simples da seguinte forma:
15+
16+
{{ .Inner }}
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
## Prometheus
2+
3+
Para enviar dados de métricas para o [Prometheus](https://prometheus.io/), você
4+
pode
5+
[ativar o OTLP Receiver do Prometheus](https://prometheus.io/docs/prometheus/latest/feature_flags/#otlp-receiver)
6+
e utilizar o [exportador OTLP](#otlp) ou você pode utilizar o exportador do
7+
Prometheus, um `MetricReader` que inicia um servidor HTTP e coleta métricas,
8+
serializando para o formato de texto do Prometheus sob demanda.
9+
10+
### Configuração do Backend {#prometheus-setup}
11+
12+
<div class="alert alert-info" role="alert"><h4 class="alert-heading">Nota</h4>
13+
14+
Caso já possua o Prometheus ou um _backend_ compatível com Prometheus
15+
configurado, poderá pular esta seção e configurar as dependências do exportador
16+
[Prometheus](#prometheus-dependencies) ou [OTLP](#otlp-dependencies) para a sua
17+
aplicação.
18+
19+
</div>
20+
21+
É possível executar o [Prometheus](https://prometheus.io) em um contêiner Docker
22+
acessível na porta `9090` através das seguintes instruções:
23+
24+
Em uma pasta vazia, crie um arquivo chamado `prometheus.yml` e adicione o
25+
seguinte conteúdo:
26+
27+
```yaml
28+
scrape_configs:
29+
- job_name: dice-service
30+
scrape_interval: 5s
31+
static_configs:
32+
- targets: [host.docker.internal:9464]
33+
```
34+
35+
Em seguida, execute o Prometheus em um contêiner Docker que ficará acessível na
36+
porta `9090` através do seguinte comando:
37+
38+
```shell
39+
docker run --rm -v ${PWD}/prometheus.yml:/prometheus/prometheus.yml -p 9090:9090 prom/prometheus --enable-feature=otlp-write-receive
40+
```
41+
42+
<div class="alert alert-info" role="alert"><h4 class="alert-heading">Nota</h4>
43+
44+
Ao utilizar o OTLP Receiver do Prometheus, certifique-se de definir o endpoint
45+
OTLP das métricas em sua aplicação para `http://localhost:9090/api/v1/otlp`.
46+
47+
Nem todos os ambientes Docker suportam `host.docker.internal`. Em alguns casos,
48+
será necessário alterar o valor `host.docker.internal` para `localhost` ou o
49+
endereço de IP de sua máquina.
50+
51+
</div>
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
## Zipkin
2+
3+
### Configuração do Backend {#zipkin-setup}
4+
5+
<div class="alert alert-info" role="alert"><h4 class="alert-heading">Nota</h4>
6+
7+
Caso já possua o Zipkin ou um _backend_ compatível com Zipkin configurado,
8+
poderá pular esta seção e configurar as
9+
[dependências do exportador Zipkin](#zipkin-dependencies) para a sua aplicação.
10+
11+
</div>
12+
13+
É possível executar o [Zipkin][Zipkin](https://zipkin.io/) em um contêiner
14+
Docker através do seguinte comando:
15+
16+
```shell
17+
docker run --rm -d -p 9411:9411 --name zipkin openzipkin/zipkin
18+
```

0 commit comments

Comments
 (0)