From d061fde85639bf62337eeffc00c011317b2a7de4 Mon Sep 17 00:00:00 2001 From: shukawam Date: Sun, 19 Jan 2025 13:10:05 +0900 Subject: [PATCH 1/2] #5982 Addressed the translation omissions --- content/ja/docs/concepts/components.md | 2 +- .../ja/docs/languages/exporters/intro.md | 110 ++++++++++++++++++ 2 files changed, 111 insertions(+), 1 deletion(-) create mode 100644 layouts/shortcodes/ja/docs/languages/exporters/intro.md diff --git a/content/ja/docs/concepts/components.md b/content/ja/docs/concepts/components.md index 469982f946ba..2c56a4fc9165 100644 --- a/content/ja/docs/concepts/components.md +++ b/content/ja/docs/concepts/components.md @@ -59,7 +59,7 @@ OpenTelemetryの意欲的なゴールは、すべての一般的なライブラ ### エクスポーター {#exporters} -{{% docs/languages/exporters/intro %}} +{{% ja/docs/languages/exporters/intro %}} ### ゼロコード計装 {#zero-code-instrumentation} diff --git a/layouts/shortcodes/ja/docs/languages/exporters/intro.md b/layouts/shortcodes/ja/docs/languages/exporters/intro.md new file mode 100644 index 000000000000..6c230f1fcca6 --- /dev/null +++ b/layouts/shortcodes/ja/docs/languages/exporters/intro.md @@ -0,0 +1,110 @@ +{{/* cSpell:ignore cond */ -}} [OpenTelemetry Collector](/docs/collector/)にテレメトリーを送信し、正しくエクスポートされることを確認してください。本番環境でコレクターを使用することはベストプラクティスです。テレメトリーを可視化するために、[Jaeger](https://jaegertracing.io/)、[Zipkin](https://zipkin.io/)、 +[Prometheus](https://prometheus.io/)、または[ベンダー固有](/ecosystem/vendors/)のようなバックエンドにエクスポートしてください。 + +{{ $lang := .Get 0 | default "" -}} + +{{ $name := "" -}} + +{{ if $lang -}} + +{{ $name = (index $.Site.Data.instrumentation $lang).name -}} + +## 使用可能なエクスポーター {#available-exporters} + +レジストリには、[{{ $name }} 用のエクスポーターのリスト][reg]が含まれています。 + +{{ else -}} + +レジストリには、[言語固有のエクスポーターのリスト][reg]が含まれています。 + +{{ end -}} + +エクスポーターの中でも、[OpenTelemetry Protocol (OTLP)][OTLP]エクスポーターは、OpenTelemetryのデータモデルを考慮して設計されており、OTelデータを情報の損失なく出力します。さらに、多くのテレメトリデータを扱うツールがOTLPに対応しており（例えば、[Prometheus]、[Jaeger]やほとんどの[ベンダー]）、必要なときに高い柔軟性を提供します。OTLPについて詳細に学習したい場合は、[OTLP仕様][OTLP]を参照してください。 + +[Jaeger]: /blog/2022/jaeger-native-otlp/ +[OTLP]: /docs/specs/otlp/ +[Prometheus]: + https://prometheus.io/docs/prometheus/latest/feature_flags/#otlp-receiver +[ベンダー]: /ecosystem/vendors/ + +[reg]: /ecosystem/registry/?component=exporter&language={{ $lang }} + +{{ if $name -}} + +This page covers the main OpenTelemetry {{ $name }} exporters and how to set +them up. + +{{ end -}} + +{{ $l := cond (eq $lang "dotnet") "net" $lang }} +{{ with $.Page.GetPage (print "/docs/zero-code/" $l "/configuration" ) }} + + + +{{ end -}} + +{{/* + below list needs to grow until all languages are updated to a consistent structure. + */ -}} + +{{ if in (slice "python" "js" "java" "cpp" "dotnet") $lang -}} + +## OTLP + +### Collector Setup + + + +To try out and verify your OTLP exporters, you can run the collector in a docker +container that writes telemetry directly to the console. + +In an empty directory, create a file called `collector-config.yaml` with the +following content: + +```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] +``` + +Now run the collector in a docker container: + +```shell +docker run -p 4317:4317 -p 4318:4318 --rm -v $(pwd)/collector-config.yaml:/etc/otelcol/config.yaml otel/opentelemetry-collector +``` + +This collector is now able to accept telemetry via OTLP. Later you may want to +[configure the collector](/docs/collector/configuration) to send your telemetry +to your observability backend. + +{{ end -}} From 8c8b1d3ba8af28cbe36915f8900b7c4f4d2b1a9d Mon Sep 17 00:00:00 2001 From: shukawam Date: Sun, 19 Jan 2025 22:56:54 +0900 Subject: [PATCH 2/2] #5982 Addressed the review comments --- layouts/shortcodes/ja/docs/languages/exporters/intro.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/layouts/shortcodes/ja/docs/languages/exporters/intro.md b/layouts/shortcodes/ja/docs/languages/exporters/intro.md index 6c230f1fcca6..d3ec39bcdbf8 100644 --- a/layouts/shortcodes/ja/docs/languages/exporters/intro.md +++ b/layouts/shortcodes/ja/docs/languages/exporters/intro.md @@ -1,4 +1,4 @@ -{{/* cSpell:ignore cond */ -}} [OpenTelemetry Collector](/docs/collector/)にテレメトリーを送信し、正しくエクスポートされることを確認してください。本番環境でコレクターを使用することはベストプラクティスです。テレメトリーを可視化するために、[Jaeger](https://jaegertracing.io/)、[Zipkin](https://zipkin.io/)、 +{{/* cSpell:ignore cond */ -}} [OpenTelemetryコレクター](/docs/collector/)にテレメトリーを送信し、正しくエクスポートされることを確認してください。本番環境でコレクターを使用することはベストプラクティスです。テレメトリーを可視化するために、[Jaeger](https://jaegertracing.io/)、[Zipkin](https://zipkin.io/)、 [Prometheus](https://prometheus.io/)、または[ベンダー固有](/ecosystem/vendors/)のようなバックエンドにエクスポートしてください。 {{ $lang := .Get 0 | default "" -}} @@ -19,7 +19,7 @@ {{ end -}} -エクスポーターの中でも、[OpenTelemetry Protocol (OTLP)][OTLP]エクスポーターは、OpenTelemetryのデータモデルを考慮して設計されており、OTelデータを情報の損失なく出力します。さらに、多くのテレメトリデータを扱うツールがOTLPに対応しており（例えば、[Prometheus]、[Jaeger]やほとんどの[ベンダー]）、必要なときに高い柔軟性を提供します。OTLPについて詳細に学習したい場合は、[OTLP仕様][OTLP]を参照してください。 +エクスポーターの中でも、[OpenTelemetry Protocol (OTLP)][OTLP]エクスポーターは、OpenTelemetryのデータモデルを考慮して設計されており、OTelデータを情報の損失なく出力します。さらに、多くのテレメトリデータを扱うツールがOTLPに対応しており（たとえば、[Prometheus]、[Jaeger]やほとんどの[ベンダー]）、必要なときに高い柔軟性を提供します。OTLPについて詳細に学習したい場合は、[OTLP仕様][OTLP]を参照してください。 [Jaeger]: /blog/2022/jaeger-native-otlp/ [OTLP]: /docs/specs/otlp/