Skip to content
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

[pt] Translate shortcode snippets /languages/exporters #5593

Open
wants to merge 14 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/pt/docs/concepts/components.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ Para mais informações, consulte

### Exporters {#exporters}

{{% docs/languages/exporters/intro %}}
{{% pt/docs/languages/exporters/intro %}}

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

Expand Down
2 changes: 1 addition & 1 deletion content/pt/docs/languages/go/exporters.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ default_lang_commit: 5e2a0b43c1f9f42824a024206e797cf7041ed9db
cSpell:ignore: otlplog otlploggrpc otlploghttp otlpmetric otlpmetricgrpc otlpmetrichttp otlptrace otlptracegrpc otlptracehttp promhttp stdoutlog stdouttrace
---

{{% docs/languages/exporters/intro go %}}
{{% pt/docs/languages/exporters/intro go %}}

## Console

Expand Down
101 changes: 101 additions & 0 deletions layouts/shortcodes/pt/docs/languages/exporters/intro.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,101 @@
{{/* cSpell:ignore cond */ -}} Envie dados de telemetria para o [OpenTelemetry Collector](/docs/collector/) para garantir que estes dados serão exportados corretamente. A utilização de um Collector em ambientes produtivos é a melhor prática. Para visualizar os dados de telemetria que foram gerados, realize a exportação para um ou mais _backends_ como [Jaeger](https://jaegertracing.io/), [Zipkin](https://zipkin.io/),
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
[Prometheus](https://prometheus.io/), ou um backend
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
[específico de um fornecedor](/ecosystem/vendors/).

{{ $lang := .Get 0 | default "" -}}

{{ $name := "" -}}

{{ if $lang -}}

{{ $name = (index $.Site.Data.instrumentation $lang).name -}}

## Exportadores disponíveis {#available-exporters}

O registro oferece uma [lista de exportadores para {{ $name }}][reg].

{{ else -}}

O registro oferece uma [lista de exportadores específicos para a linguagem][reg].
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved

{{ end -}}

Entre os exportadores, os exportadores do [OpenTelemetry Protocol (OTLP)][OTLP] são projetados tendo em mente o modelo de dados do OpenTelemetry, emitindo dados OTel sem qualquer perda de informação. Além disso, muitas ferramentas que operam com dados de telemetria suportam o formato OTLP (como [Prometheus][Prometheus], [Jaeger][Jaeger] e a maioria dos [fornecedores][vendors]), proporcionando um alto grau de flexibilidade quando necessário. Para saber mais sobre o OTLP, consulte a [Especificação do OTLP][OTLP].

[Jaeger]: /blog/2022/jaeger-native-otlp/
[OTLP]: /docs/specs/otlp/
[Prometheus]:
https://prometheus.io/docs/prometheus/latest/feature_flags/#otlp-receiver
[vendors]: /ecosystem/vendors/

[reg]: /ecosystem/registry/?component=exporter&language={{ $lang }}

{{ if $name -}}

Esta página reúne informações sobre os principais exportadores do OpenTelemetry {{ $name }} e como configurá-los.

{{ end -}}

{{ $l := cond (eq $lang "dotnet") "net" $lang }}
{{ with $.Page.GetPage (print "/docs/zero-code/" $l "/configuration" ) }}

<div class="alert alert-info" role="alert"><h4 class="alert-heading">Nota</h4>

Caso você esteja utilizando [instrumentação sem código](/docs/zero-code/{{ $l }}), você poderá aprender a configurar os exporters através do [Guia de Configurações](/docs/zero-code/{{ $l }}/configuration/).

</div>

{{ end -}}

{{/*
below list needs to grow until all languages are updated to a consistent structure.
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
*/ -}}

{{ if in (slice "python" "js" "java" "cpp" "dotnet") $lang -}}

## OTLP

### Configuração do Collector {#collector-setup}

<div class="alert alert-info" role="alert"><h4 class="alert-heading">Nota</h4>

Caso já possua um coletor ou _backend_ OTLP configurado, poderá pular para [configurar as dependências do exportador OTLP](#otlp-dependencies) para a sua aplicação.

</div>

Para testar e validar os seus exportadores OTLP, é possível executar o Collector em um contêiner Docker que escreve os dados diretamente no console.

Em uma pasta vazia, crie um arquivo chamado `collector-config.yaml` e adicione o seguinte conteúdo:

```yaml
receivers:
otlp:
protocols:
grpc:
endpoint: 0.0.0.0:4317
http:
endpoint: 0.0.0.0:4318
exporters:
debug:
verbosity: detailed
service:
pipelines:
traces:
receivers: [otlp]
exporters: [debug]
metrics:
receivers: [otlp]
exporters: [debug]
logs:
receivers: [otlp]
exporters: [debug]
```

Em seguida, execute o Collector em um contêiner Docker através do seguinte comando:

```shell
docker run -p 4317:4317 -p 4318:4318 --rm -v $(pwd)/collector-config.yaml:/etc/otelcol/config.yaml otel/opentelemetry-collector
```

Em alguns instantes, o Collector estará disponível para receber dados de telemetria via OTLP. Mais tarde, você também poderá querer [configurar o Collector](/docs/collector/configuration) para enviar os seus dados de telemetria para o seu _backend_ de observabilidade.
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
{{ end -}}
19 changes: 19 additions & 0 deletions layouts/shortcodes/pt/docs/languages/exporters/jaeger.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
## Jaeger

### Configuração do Backend {#jaeger-backend-setup}

O [Jaeger](https://www.jaegertracing.io/) suporta nativamente o OTLP para receber dados de telemetria. O Jaeger pode ser executado através de um contêiner Docker com uma UI acessível através da porta 16686 e OTLP habilitados nas portas 4317 e 4318:
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved

```shell
docker run --rm \
-e COLLECTOR_ZIPKIN_HOST_PORT=:9411 \
-p 16686:16686 \
-p 4317:4317 \
-p 4318:4318 \
-p 9411:9411 \
jaegertracing/all-in-one:latest
```

### Uso {#jaeger-usage}

Siga as instruções para configurar os [exportadores OTLP](#otlp-dependencies).
11 changes: 11 additions & 0 deletions layouts/shortcodes/pt/docs/languages/exporters/outro.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{{ $lang := .Get 0 -}} {{ $spanExporterInterfaceUrl := .Get 1 }}

## Exportadores personalizados {#custom-exporters}

Por fim, também é possível escrever o seu próprio exportador. Para mais informações, consulte [SpanExporter Interface na documentação da API]({{ $spanExporterInterfaceUrl }}).

## Agrupamento de Trechos e Registros de Log {#batching-span-and-log-records}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Agrupamento de Trechos e Registros de Log {#batching-span-and-log-records}
## Agrupamento de trechos e registros de log {#batching-span-and-log-records}


O SDK do OpenTelemetry fornece um conjunto de processadores de Trechos e Registros de Log padrão, que permitem emitir Trechos um-a-um ("simples") ou em lotes. O uso de agrupamentos é recomendado, mas caso não deseje agrupar seus Trechos ou Registros de Log, é possível utilizar um processador simples da seguinte forma:
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved

{{ .Inner }}
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
## Prometheus

Para enviar dados de métricas para o [Prometheus](https://prometheus.io/), é possível
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved
[ativar o OTLP Receiver do Prometheus](https://prometheus.io/docs/prometheus/latest/feature_flags/#otlp-receiver)
e utilizar o [exportador OTLP](#otlp) ou utilizar o exportador do Prometheus, um `MetricReader` que inicia um servidor HTTP e coleta métricas, serializando para o formato de texto do Prometheus sob demanda.
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved

### Configuração do Backend {#prometheus-setup}

<div class="alert alert-info" role="alert"><h4 class="alert-heading">Nota</h4>

Caso já possua o Prometheus ou um backend compatível com Prometheus configurado, poderá pular esta seção e configurar as dependências do exportador [Prometheus](#prometheus-dependencies) ou [OTLP](#otlp-dependencies) para a sua aplicação.
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved

</div>

É possível executar o [Prometheus](https://prometheus.io) em um contêiner Docker acessível na porta `9090` através das seguintes instruções:

Em uma pasta vazia, crie um arquivo chamado `prometheus.yml` e adicione o seguinte conteúdo:

```yaml
scrape_configs:
- job_name: dice-service
scrape_interval: 5s
static_configs:
- targets: [host.docker.internal:9464]
```

Em seguida, execute o Prometheus em um contêiner Docker que ficará acessível na porta `9090` através do seguinte comando:

```shell
docker run --rm -v ${PWD}/prometheus.yml:/prometheus/prometheus.yml -p 9090:9090 prom/prometheus --enable-feature=otlp-write-receive
```

<div class="alert alert-info" role="alert"><h4 class="alert-heading">Nota</h4>

Ao utilizar o OTLP Receiver do Prometheus, certifique-se de definir o endpoint OTLP das métricas em sua aplicação para `http://localhost:9090/api/v1/otlp`.

Nem todos os ambientes Docker suportam `host.docker.internal`. Em alguns casos, será necessário alterar o valor `host.docker.internal` para `localhost` ou o endereço de IP de sua máquina.

</div>
15 changes: 15 additions & 0 deletions layouts/shortcodes/pt/docs/languages/exporters/zipkin-setup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
## Zipkin

### Configuração do Backend {#zipkin-setup}

<div class="alert alert-info" role="alert"><h4 class="alert-heading">Nota</h4>

Caso já possua o Zipkin ou um backend compatível com Zipkin configurado, poderá pular esta seção e configurar as [dependências do exportador Zipkin](#zipkin-dependencies) para a sua aplicação.
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved

</div>

É possível executar o [Zipkin][Zipkin](https://zipkin.io/) em um contêiner Docker através do seguinte comando:

```shell
docker run --rm -d -p 9411:9411 --name zipkin openzipkin/zipkin
```