# エクスポーター > テレメトリデータの処理とエクスポート --- LLMS index: [llms.txt](/llms.txt) --- [OpenTelemetryコレクター](/docs/collector/)にテレメトリーを送信し、正しくエクスポートされることを確認してください。本番環境でコレクターを使用することはベストプラクティスです。テレメトリーを可視化するために、[Jaeger](https://jaegertracing.io/)、[Zipkin](https://zipkin.io/)、 [Prometheus](https://prometheus.io/)、または[ベンダー固有](/ecosystem/vendors/)のようなバックエンドにエクスポートしてください。 ## 使用可能なエクスポーター {#available-exporters} レジストリには、[JavaScript 用のエクスポーターのリスト][reg]が含まれています。エクスポーターの中でも、[OpenTelemetry Protocol (OTLP)][OTLP]エクスポーターは、OpenTelemetryのデータモデルを考慮して設計されており、OTelデータを情報の損失なく出力します。さらに、多くのテレメトリーデータを扱うツールがOTLPに対応しており（たとえば、[Prometheus][]、[Jaeger][]やほとんどの[ベンダー][vendors]）、必要なときに高い柔軟性を提供します。 OTLPについて詳細に学習したい場合は、[OTLP仕様][OTLP]を参照してください。 [Jaeger]: /blog/2022/jaeger-native-otlp/ [OTLP]: /docs/specs/otlp/ [Prometheus]: https://prometheus.io/docs/prometheus/2.55/feature_flags/#otlp-receiver [reg]: [vendors]: /ecosystem/vendors/ このページでは、主要なOpenTelemetry JavaScript エクスポーターとその設定方法について説明します。

Note

[ゼロコード計装]()を使用している場合は、[設定ガイド]()に従ってエクスポーターの設定方法を学ぶことができます。

## OTLP {#otlp} ### コレクターのセットアップ {#collector-setup}

Note

OTLPコレクターまたはバックエンドがすでにセットアップされている場合は、このセクションをスキップして、アプリケーション用の[OTLPエクスポーター依存関係のセットアップ](#otlp-dependencies)に進むことができます。

OTLPエクスポーターを試し、検証するために、テレメトリーを直接コンソールに書き込むDockerコンテナでコレクターを実行できます。空のディレクトリで、以下の内容で`collector-config.yaml`というファイルを作成します。 ```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] ``` 次に、Docker コンテナでコレクターを実行します。 ```shell docker run -p 4317:4317 -p 4318:4318 --rm -v $(pwd)/collector-config.yaml:/etc/otelcol/config.yaml otel/opentelemetry-collector ``` このコレクターは、OTLPを介してテレメトリーを受け取ることができるようになりました。後で、テレメトリーを監視バックエンドに送信するために[コレクターを設定](/docs/collector/configuration)することもできます。 {{__hugo_ctx/}} ## 依存関係 {#otlp-dependencies} テレメトリーデータをOTLPエンドポイント（[OpenTelemetry Collector](#collector-setup)、[Jaeger](#jaeger)、[Prometheus](#prometheus)など）に送信したい場合、データを転送するために3つの異なるプロトコルから選択できます。 - [HTTP/protobuf](https://www.npmjs.com/package/@opentelemetry/exporter-trace-otlp-proto) - [HTTP/JSON](https://www.npmjs.com/package/@opentelemetry/exporter-trace-otlp-http) - [gRPC](https://www.npmjs.com/package/@opentelemetry/exporter-trace-otlp-grpc) まず、プロジェクトの依存関係として対応するエクスポーターパッケージをインストールします。

npm install --save @opentelemetry/exporter-trace-otlp-proto \
  @opentelemetry/exporter-metrics-otlp-proto

npm install --save @opentelemetry/exporter-trace-otlp-http \
  @opentelemetry/exporter-metrics-otlp-http

npm install --save @opentelemetry/exporter-trace-otlp-grpc \
  @opentelemetry/exporter-metrics-otlp-grpc

## Node.jsでの使用法 {#usage-with-nodejs} 次に、OTLPエンドポイントを指すようにエクスポーターを設定します。たとえば、[Getting Started](/docs/languages/js/getting-started/nodejs/)の`instrumentation.ts`（またはJavaScriptを使用する場合は`instrumentation.js`）ファイルを以下のように更新して、OTLP（`http/protobuf`）経由でトレースとメトリクスをエクスポートできます。

/*instrumentation.ts*/
import * as opentelemetry from '@opentelemetry/sdk-node';
import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-proto';
import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-proto';
import { PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';

const sdk = new opentelemetry.NodeSDK({
  traceExporter: new OTLPTraceExporter({
    // オプション - デフォルトのURLはhttp://localhost:4318/v1/traces
    url: '<your-otlp-endpoint>/v1/traces',
    // オプション - 各リクエストで送信されるカスタムヘッダーのコレクション、デフォルトは空
    headers: {},
  }),
  metricReader: new PeriodicExportingMetricReader({
    exporter: new OTLPMetricExporter({
      url: '<your-otlp-endpoint>/v1/metrics', // urlはオプションで省略可能 - デフォルトはhttp://localhost:4318/v1/metrics
      headers: {}, // 各リクエストで送信されるカスタムヘッダーを含むオプションのオブジェクト
    }),
  }),
  instrumentations: [getNodeAutoInstrumentations()],
});
sdk.start();

/*instrumentation.js*/
const opentelemetry = require('@opentelemetry/sdk-node');
const {
  getNodeAutoInstrumentations,
} = require('@opentelemetry/auto-instrumentations-node');
const {
  OTLPTraceExporter,
} = require('@opentelemetry/exporter-trace-otlp-proto');
const {
  OTLPMetricExporter,
} = require('@opentelemetry/exporter-metrics-otlp-proto');
const { PeriodicExportingMetricReader } = require('@opentelemetry/sdk-metrics');

const sdk = new opentelemetry.NodeSDK({
  traceExporter: new OTLPTraceExporter({
    // オプション - デフォルトのURLはhttp://localhost:4318/v1/traces
    url: '<your-otlp-endpoint>/v1/traces',
    // オプション - 各リクエストで送信されるカスタムヘッダーのコレクション、デフォルトは空
    headers: {},
  }),
  metricReader: new PeriodicExportingMetricReader({
    exporter: new OTLPMetricExporter({
      url: '<your-otlp-endpoint>/v1/metrics', // urlはオプションで省略可能 - デフォルトはhttp://localhost:4318/v1/metrics
      headers: {}, // 各リクエストで送信されるカスタムヘッダーを含むオプションのオブジェクト
      concurrencyLimit: 1, // 保留中のリクエストのオプション制限
    }),
  }),
  instrumentations: [getNodeAutoInstrumentations()],
});
sdk.start();

## ブラウザでの使用法 {#usage-in-the-browser} ブラウザベースのアプリケーションでOTLPエクスポーターを使用する場合、以下の点に注意する必要があります。 1. エクスポートにgRPCを使用することはサポートされていません 2. Webサイトの[Content Security Policies][]（CSP）がエクスポートをブロックする可能性があります 3. [Cross-Origin Resource Sharing][]（CORS）ヘッダーがエクスポートの送信を許可しない可能性があります 4. コレクターをパブリックインターネットに公開する必要がある場合があります以下では、適切なエクスポーターの使用、CSPとCORSヘッダーの設定、およびコレクターを公開する際に取るべき予防措置について説明します。 ### HTTP/JSONまたはHTTP/protobufでOTLPエクスポーターを使用 {#use-otlp-exporter-with-httpjson-or-httpprotobuf} [OpenTelemetry Collector Exporter with gRPC][]はNode.jsでのみ動作するため、[OpenTelemetry Collector Exporter with HTTP/JSON][]または[OpenTelemetry Collector Exporter with HTTP/protobuf][]の使用に制限されます。 [OpenTelemetry Collector Exporter with HTTP/JSON][]を使用している場合は、エクスポーターの受信側（コレクターまたはオブザーバビリティバックエンド）が`http/json`を受け入れることを確認し、ポートを4318に設定して適切なエンドポイントにデータをエクスポートしていることを確認してください。 ### CSPの設定 {#configure-csps} WebサイトでContent Security Policies（CSP）を使用している場合は、OTLPエンドポイントのドメインが含まれていることを確認してください。コレクターエンドポイントが`https://collector.example.com:4318/v1/traces`の場合、以下のディレクティブを追加します。 ```text connect-src collector.example.com:4318/v1/traces ``` CSPがOTLPエンドポイントを含んでいない場合、エンドポイントへのリクエストがCSPディレクティブに違反していることを示すエラーメッセージが表示されます。 ### CORSヘッダーの設定 {#configure-cors-headers} Webサイトとコレクターが異なるオリジンでホストされている場合、ブラウザがコレクターへのリクエストをブロックする可能性があります。 Cross-Origin Resource Sharing（CORS）のための特別なヘッダーを設定する必要があります。 OpenTelemetry Collectorは、httpベースのレシーバーがWebブラウザからのトレースを受け入れるために必要なヘッダーを追加する[機能][a feature]を提供しています。 ```yaml receivers: otlp: protocols: http: include_metadata: true cors: allowed_origins: - https://foo.bar.com - https://*.test.com allowed_headers: - Example-Header max_age: 7200 ``` ### コレクターの安全な公開 {#securely-expose-your-collector} Webアプリケーションからテレメトリーを受信するには、エンドユーザーのブラウザがコレクターにデータを送信できるようにする必要があります。 Webアプリケーションがパブリックインターネットからアクセス可能な場合、コレクターもすべての人がアクセス可能にする必要があります。コレクターを直接公開するのではなく、その前にリバースプロキシ（NGINX、Apache HTTP Server、...）を配置することをお勧めします。リバースプロキシは、SSL オフロード、適切なCORSヘッダーの設定、およびWebアプリケーション固有の多くの機能を処理できます。以下では、人気のあるNGINX Webサーバーの設定例を示します。 ```nginx server { listen 80 default_server; server_name _; location / { # プリフライトリクエストの処理 if ($request_method = 'OPTIONS') { add_header 'Access-Control-Max-Age' 1728000; add_header 'Access-Control-Allow-Origin' 'name.of.your.website.example.com' always; add_header 'Access-Control-Allow-Headers' 'Accept,Accept-Language,Content-Language,Content-Type' always; add_header 'Access-Control-Allow-Credentials' 'true' always; add_header 'Content-Type' 'text/plain charset=UTF-8'; add_header 'Content-Length' 0; return 204; } add_header 'Access-Control-Allow-Origin' 'name.of.your.website.example.com' always; add_header 'Access-Control-Allow-Credentials' 'true' always; add_header 'Access-Control-Allow-Headers' 'Accept,Accept-Language,Content-Language,Content-Type' always; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_pass http://collector:4318; } } ``` ## コンソール {#console} 計装をデバッグしたり、開発環境でローカルに値を確認したりするために、テレメトリーデータをコンソール（標準出力）に書き込むエクスポーターを使用できます。 [Getting Started の Node.js](/docs/languages/js/getting-started/nodejs/)または[手動計装](/docs/languages/js/instrumentation)ガイドに従った場合、コンソールエクスポーターはすでにインストールされています。 `ConsoleSpanExporter`は[`@opentelemetry/sdk-trace-node`](https://www.npmjs.com/package/@opentelemetry/sdk-trace-node)パッケージに含まれており、`ConsoleMetricExporter`は[`@opentelemetry/sdk-metrics`](https://www.npmjs.com/package/@opentelemetry/sdk-metrics)パッケージに含まれています。 ## Jaeger {#jaeger} ### バックエンドのセットアップ {#jaeger-backend-setup} [Jaeger](https://www.jaegertracing.io/)は、トレースデータを受信するためにOTLPをネイティブでサポートしています。UIがポート16686でアクセス可能で、OTLPがポート4317と4318で有効になったDockerコンテナでJaegerを実行できます。 ```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 ``` ### 使用方法 {#jaeger-usage} [OTLPエクスポーター](#otlp-dependencies)をセットアップするための手順に従ってください。 {{__hugo_ctx/}} ## Prometheus {#prometheus} メトリクスデータを[Prometheus](https://prometheus.io/)に送信するには、[PrometheusのOTLPレシーバーを有効にして](https://prometheus.io/docs/guides/opentelemetry/#enable-the-otlp-receiver)[OTLPエクスポーター](#otlp)を使用するか、Prometheusエクスポーターを使用できます。 Prometheusエクスポーターは、メトリクスを収集しリクエストに応じてPrometheusテキスト形式にシリアライズするHTTPサーバーを起動する`MetricReader`です。 ### バックエンドのセットアップ {#prometheus-setup}

注意

すでにPrometheusまたはPrometheus互換のバックエンドをセットアップしている場合は、このセクションをスキップして、アプリケーション用の[Prometheus](#prometheus-dependencies)または[OTLP](#otlp-dependencies)エクスポーターの依存関係をセットアップしてください。

[Prometheus](https://prometheus.io)をDockerコンテナで実行し、ポート`9090`でアクセスできるようにするには、以下の手順に従ってください。以下の内容で`prometheus.yml`というファイルを作成します。 ```yaml scrape_configs: - job_name: dice-service scrape_interval: 5s static_configs: - targets: [host.docker.internal:9464] ``` UIがポート`9090`でアクセス可能なDockerコンテナでPrometheusを実行します。 ```shell docker run --rm -v ${PWD}/prometheus.yml:/prometheus/prometheus.yml -p 9090:9090 prom/prometheus --web.enable-otlp-receiver ```

注意

PrometheusのOTLPレシーバーを使用する場合は、アプリケーションでメトリクス用のOTLPエンドポイントを`http://localhost:9090/api/v1/otlp`に設定してください。すべてのDocker環境が`host.docker.internal`をサポートしているわけではありません。場合によっては、`host.docker.internal`を`localhost`またはマシンのIPアドレスに置き換える必要があるかもしれません。

{{__hugo_ctx/}} ## 依存関係 {#prometheus-dependencies} アプリケーションの依存関係として[エクスポーターパッケージ](https://www.npmjs.com/package/@opentelemetry/exporter-prometheus)をインストールします。 ```shell npm install --save @opentelemetry/exporter-prometheus ``` エクスポーターを使用し、Prometheusバックエンドにデータを送信するようにOpenTelemetry設定を更新します。

import * as opentelemetry from '@opentelemetry/sdk-node';
import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
import { PrometheusExporter } from '@opentelemetry/exporter-prometheus';

const sdk = new opentelemetry.NodeSDK({
  metricReader: new PrometheusExporter({
    port: 9464, // オプション - デフォルトは9464
  }),
  instrumentations: [getNodeAutoInstrumentations()],
});
sdk.start();

const opentelemetry = require('@opentelemetry/sdk-node');
const {
  getNodeAutoInstrumentations,
} = require('@opentelemetry/auto-instrumentations-node');
const { PrometheusExporter } = require('@opentelemetry/exporter-prometheus');
const { PeriodicExportingMetricReader } = require('@opentelemetry/sdk-metrics');
const sdk = new opentelemetry.NodeSDK({
  metricReader: new PrometheusExporter({
    port: 9464, // オプション - デフォルトは9464
  }),
  instrumentations: [getNodeAutoInstrumentations()],
});
sdk.start();

上記の設定により、でメトリクスにアクセスできます。 PrometheusまたはPrometheusレシーバーを持つOpenTelemetry Collectorが、このエンドポイントからメトリクスをスクレイプできます。 ## Zipkin {#zipkin} ### バックエンドのセットアップ {#zipkin-setup}

注意

すでにZipkinまたはZipkin互換のバックエンドをセットアップしている場合は、このセクションをスキップして、アプリケーション用の[Zipkinエクスポーターの依存関係](#zipkin-dependencies)をセットアップしてください。

以下のコマンドを実行して、[Zipkin](https://zipkin.io/)をDockerコンテナで実行できます。 ```shell docker run --rm -d -p 9411:9411 --name zipkin openzipkin/zipkin ``` {{__hugo_ctx/}} ## 依存関係 {#zipkin-dependencies} トレースデータを[Zipkin](https://zipkin.io/)に送信するには、`ZipkinExporter`を使用できます。アプリケーションの依存関係として[エクスポーターパッケージ](https://www.npmjs.com/package/@opentelemetry/exporter-zipkin)をインストールします。 ```shell npm install --save @opentelemetry/exporter-zipkin ``` エクスポーターを使用し、Zipkinバックエンドにデータを送信するようにOpenTelemetry設定を更新します。

import * as opentelemetry from '@opentelemetry/sdk-node';
import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
import { ZipkinExporter } from '@opentelemetry/exporter-zipkin';

const sdk = new opentelemetry.NodeSDK({
  traceExporter: new ZipkinExporter({}),
  instrumentations: [getNodeAutoInstrumentations()],
});
sdk.start();

const opentelemetry = require('@opentelemetry/sdk-node');
const {
  getNodeAutoInstrumentations,
} = require('@opentelemetry/auto-instrumentations-node');
const { ZipkinExporter } = require('@opentelemetry/exporter-zipkin');

const sdk = new opentelemetry.NodeSDK({
  traceExporter: new ZipkinExporter({}),
  instrumentations: [getNodeAutoInstrumentations()],
});

## カスタムエクスポーター {#custom-exporters} 最後に、独自のエクスポーターを作成することもできます。詳細については、[APIドキュメントのSpanExporterインターフェイス](https://open-telemetry.github.io/opentelemetry-js/interfaces/_opentelemetry_sdk-trace-base.SpanExporter.html)を参照してください。 ## スパンとログレコードのバッチ処理 {#batching-span-and-log-records} OpenTelemetry SDKは、スパンを1つずつ発行する（「シンプル」）か、バッチで発行するかを選択できるデフォルトのスパンプロセッサーとログレコードプロセッサーのセットを提供しています。バッチ処理の使用が推奨されますが、スパンやログレコードをバッチ処理したくない場合は、かわりに以下のようにシンプルプロセッサーを使用できます。 {{__hugo_ctx/}}

/*instrumentation.ts*/
import * as opentelemetry from '@opentelemetry/sdk-node';
import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';

const sdk = new NodeSDK({
  spanProcessors: [new SimpleSpanProcessor(exporter)],
  instrumentations: [getNodeAutoInstrumentations()],
});
sdk.start();

/*instrumentation.js*/
const opentelemetry = require('@opentelemetry/sdk-node');
const {
  getNodeAutoInstrumentations,
} = require('@opentelemetry/auto-instrumentations-node');

const sdk = new opentelemetry.NodeSDK({
  spanProcessors: [new SimpleSpanProcessor(exporter)],
  instrumentations: [getNodeAutoInstrumentations()],
});
sdk.start();

[content security policies]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ [cross-origin resource sharing]: https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS [opentelemetry collector exporter with grpc]: https://www.npmjs.com/package/@opentelemetry/exporter-trace-otlp-grpc [opentelemetry collector exporter with http/protobuf]: https://www.npmjs.com/package/@opentelemetry/exporter-trace-otlp-proto [opentelemetry collector exporter with http/json]: https://www.npmjs.com/package/@opentelemetry/exporter-trace-otlp-http [a feature]: https://github.com/open-telemetry/opentelemetry-collector/blob/main/config/confighttp/README.md