|
| 1 | +{{/* cSpell:ignore cond */ -}} [OpenTelemetry Collector](/docs/collector/)にテレメトリーを送信し、正しくエクスポートされることを確認してください。本番環境でコレクターを使用することはベストプラクティスです。テレメトリーを可視化するために、[Jaeger](https://jaegertracing.io/)、[Zipkin](https://zipkin.io/)、 |
| 2 | +[Prometheus](https://prometheus.io/)、または[ベンダー固有](/ecosystem/vendors/)のようなバックエンドにエクスポートしてください。 |
| 3 | + |
| 4 | +{{ $lang := .Get 0 | default "" -}} |
| 5 | + |
| 6 | +{{ $name := "" -}} |
| 7 | + |
| 8 | +{{ if $lang -}} |
| 9 | + |
| 10 | +{{ $name = (index $.Site.Data.instrumentation $lang).name -}} |
| 11 | + |
| 12 | +## 使用可能なエクスポーター {#available-exporters} |
| 13 | + |
| 14 | +レジストリには、[{{ $name }} 用のエクスポーターのリスト][reg]が含まれています。 |
| 15 | + |
| 16 | +{{ else -}} |
| 17 | + |
| 18 | +レジストリには、[言語固有のエクスポーターのリスト][reg]が含まれています。 |
| 19 | + |
| 20 | +{{ end -}} |
| 21 | + |
| 22 | +エクスポーターの中でも、[OpenTelemetry Protocol (OTLP)][OTLP]エクスポーターは、OpenTelemetryのデータモデルを考慮して設計されており、OTelデータを情報の損失なく出力します。さらに、多くのテレメトリデータを扱うツールがOTLPに対応しており(例えば、[Prometheus]、[Jaeger]やほとんどの[ベンダー])、必要なときに高い柔軟性を提供します。OTLPについて詳細に学習したい場合は、[OTLP仕様][OTLP]を参照してください。 |
| 23 | + |
| 24 | +[Jaeger]: /blog/2022/jaeger-native-otlp/ |
| 25 | +[OTLP]: /docs/specs/otlp/ |
| 26 | +[Prometheus]: |
| 27 | + https://prometheus.io/docs/prometheus/latest/feature_flags/#otlp-receiver |
| 28 | +[ベンダー]: /ecosystem/vendors/ |
| 29 | + |
| 30 | +[reg]: /ecosystem/registry/?component=exporter&language={{ $lang }} |
| 31 | + |
| 32 | +{{ if $name -}} |
| 33 | + |
| 34 | +This page covers the main OpenTelemetry {{ $name }} exporters and how to set |
| 35 | +them up. |
| 36 | + |
| 37 | +{{ end -}} |
| 38 | + |
| 39 | +{{ $l := cond (eq $lang "dotnet") "net" $lang }} |
| 40 | +{{ with $.Page.GetPage (print "/docs/zero-code/" $l "/configuration" ) }} |
| 41 | + |
| 42 | +<div class="alert alert-info" role="alert"><h4 class="alert-heading">Note</h4> |
| 43 | + |
| 44 | +If you use [zero-code instrumentation](/docs/zero-code/{{ $l }}), you can learn |
| 45 | +how to set up exporters by following the [Configuration |
| 46 | +Guide](/docs/zero-code/{{ $l }}/configuration/). |
| 47 | + |
| 48 | +</div> |
| 49 | + |
| 50 | +{{ end -}} |
| 51 | + |
| 52 | +{{/* |
| 53 | + below list needs to grow until all languages are updated to a consistent structure. |
| 54 | + */ -}} |
| 55 | + |
| 56 | +{{ if in (slice "python" "js" "java" "cpp" "dotnet") $lang -}} |
| 57 | + |
| 58 | +## OTLP |
| 59 | + |
| 60 | +### Collector Setup |
| 61 | + |
| 62 | +<div class="alert alert-info" role="alert"><h4 class="alert-heading">Note</h4> |
| 63 | + |
| 64 | +If you have a OTLP collector or backend already set up, you can skip this |
| 65 | +section and [setup the OTLP exporter dependencies](#otlp-dependencies) for your |
| 66 | +application. |
| 67 | + |
| 68 | +</div> |
| 69 | + |
| 70 | +To try out and verify your OTLP exporters, you can run the collector in a docker |
| 71 | +container that writes telemetry directly to the console. |
| 72 | + |
| 73 | +In an empty directory, create a file called `collector-config.yaml` with the |
| 74 | +following content: |
| 75 | + |
| 76 | +```yaml |
| 77 | +receivers: |
| 78 | + otlp: |
| 79 | + protocols: |
| 80 | + grpc: |
| 81 | + endpoint: 0.0.0.0:4317 |
| 82 | + http: |
| 83 | + endpoint: 0.0.0.0:4318 |
| 84 | +exporters: |
| 85 | + debug: |
| 86 | + verbosity: detailed |
| 87 | +service: |
| 88 | + pipelines: |
| 89 | + traces: |
| 90 | + receivers: [otlp] |
| 91 | + exporters: [debug] |
| 92 | + metrics: |
| 93 | + receivers: [otlp] |
| 94 | + exporters: [debug] |
| 95 | + logs: |
| 96 | + receivers: [otlp] |
| 97 | + exporters: [debug] |
| 98 | +``` |
| 99 | +
|
| 100 | +Now run the collector in a docker container: |
| 101 | +
|
| 102 | +```shell |
| 103 | +docker run -p 4317:4317 -p 4318:4318 --rm -v $(pwd)/collector-config.yaml:/etc/otelcol/config.yaml otel/opentelemetry-collector |
| 104 | +``` |
| 105 | + |
| 106 | +This collector is now able to accept telemetry via OTLP. Later you may want to |
| 107 | +[configure the collector](/docs/collector/configuration) to send your telemetry |
| 108 | +to your observability backend. |
| 109 | + |
| 110 | +{{ end -}} |
0 commit comments