diff --git a/content/pt/docs/concepts/components.md b/content/pt/docs/concepts/components.md index 4d7e8ef256ee..e174532299e7 100644 --- a/content/pt/docs/concepts/components.md +++ b/content/pt/docs/concepts/components.md @@ -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} diff --git a/content/pt/docs/languages/go/exporters.md b/content/pt/docs/languages/go/exporters.md index 5393d851d0a6..cd38be3fa9be 100644 --- a/content/pt/docs/languages/go/exporters.md +++ b/content/pt/docs/languages/go/exporters.md @@ -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 diff --git a/layouts/shortcodes/pt/docs/languages/exporters/intro.md b/layouts/shortcodes/pt/docs/languages/exporters/intro.md new file mode 100644 index 000000000000..7e784ce441e0 --- /dev/null +++ b/layouts/shortcodes/pt/docs/languages/exporters/intro.md @@ -0,0 +1,101 @@ +{{/* cSpell:ignore cond */ -}} Envie dados de telemetria para o [OpenTelemetry Collector](/docs/collector/) para garantir que estes dados sejam exportados corretamente. A utilização de um Collector em ambientes de produção é a melhor prática. Para visualizar os dados de telemetria que foram gerados, exporte-os para um _backend_ como [Jaeger](https://jaegertracing.io/), [Zipkin](https://zipkin.io/), +[Prometheus](https://prometheus.io/), ou um _backend_ +[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 de linguagem][reg]. + +{{ 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" ) }} + + + +{{ end -}} + +{{/* + a lista a seguir precisa crescer até que todas as línguas sejam atualizadas para uma estrutura consistente. + */ -}} + +{{ if in (slice "python" "js" "java" "cpp" "dotnet") $lang -}} + +## OTLP + +### Configuração do Collector {#collector-setup} + + + +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 +``` + +Este Collector agora é capaz receber dados de telemetria via OTLP. Mais tarde, você também poderá [configurar o Collector](/docs/collector/configuration) para enviar os seus dados de telemetria para o seu _backend_ de observabilidade. +{{ end -}} diff --git a/layouts/shortcodes/pt/docs/languages/exporters/jaeger.md b/layouts/shortcodes/pt/docs/languages/exporters/jaeger.md new file mode 100644 index 000000000000..88dea3270713 --- /dev/null +++ b/layouts/shortcodes/pt/docs/languages/exporters/jaeger.md @@ -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 rastros. 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: + +```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). diff --git a/layouts/shortcodes/pt/docs/languages/exporters/outro.md b/layouts/shortcodes/pt/docs/languages/exporters/outro.md new file mode 100644 index 000000000000..d165d875c0f7 --- /dev/null +++ b/layouts/shortcodes/pt/docs/languages/exporters/outro.md @@ -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} + +O SDK do OpenTelemetry fornece um conjunto de processadores padrão de trechos e registros de log, 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: + +{{ .Inner }} diff --git a/layouts/shortcodes/pt/docs/languages/exporters/prometheus-setup.md b/layouts/shortcodes/pt/docs/languages/exporters/prometheus-setup.md new file mode 100644 index 000000000000..30220f15fe2d --- /dev/null +++ b/layouts/shortcodes/pt/docs/languages/exporters/prometheus-setup.md @@ -0,0 +1,39 @@ +## Prometheus + +Para enviar dados de métricas para o [Prometheus](https://prometheus.io/), você pode +[ativar o OTLP Receiver do Prometheus](https://prometheus.io/docs/prometheus/latest/feature_flags/#otlp-receiver) +e utilizar o [exportador OTLP](#otlp) ou você pode 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. + +### Configuração do Backend {#prometheus-setup} + + + +É 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 +``` + + diff --git a/layouts/shortcodes/pt/docs/languages/exporters/zipkin-setup.md b/layouts/shortcodes/pt/docs/languages/exporters/zipkin-setup.md new file mode 100644 index 000000000000..b6e469681633 --- /dev/null +++ b/layouts/shortcodes/pt/docs/languages/exporters/zipkin-setup.md @@ -0,0 +1,15 @@ +## Zipkin + +### Configuração do Backend {#zipkin-setup} + + + +É 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 +```