OpenTelemetry Instana および Node.js アプリケーションの監視

• Instana のホストエージェントをインストールしてください。
• OpenTelemetry の設定 SDK for Node.js

パッケージをインストールするには、次のコマンドを実行してください：

npm i @opentelemetry/exporter-metrics-otlp-http @opentelemetry/exporter-trace-otlp-http @opentelemetry/propagator-instana @opentelemetry/resource-detector-instana @opentelemetry/resources @opentelemetry/sdk-metrics --save

実際に動作する完全な例については、 「エージェントベースの HTTP の例」 を参照してください。

...
          const { OTLPTraceExporter } = require('@opentelemetry/exporter-trace-otlp-http');
          const { OTLPMetricExporter } = require('@opentelemetry/exporter-metrics-otlp-http');
          const { PeriodicExportingMetricReader } = require('@opentelemetry/sdk-metrics');
          const { instanaAgentDetector } = require('@opentelemetry/resource-detector-instana');
          const { processDetector, envDetector } = require('@opentelemetry/resources');
          const { InstanaPropagator } = require('@opentelemetry/propagator-instana');

          const instanaAgentHost = 'http://127.0.0.1:4318';

          const instanaReader = new PeriodicExportingMetricReader({
            exportIntervalMillis: 1000 * 10,
            exporter: new OTLPMetricExporter({
              url: `${otlpEndpoint}/v1/metrics`
            })
          });

          const sdk = new opentelemetry.NodeSDK({
            resourceDetectors: [envDetector, processDetector, instanaAgentDetector],
            traceExporter: new OTLPTraceExporter({
              url: `${otlpEndpoint}/v1/traces`
            }),
            propagator: new InstanaPropagator(),
            metricReader: instanaReader,
            instrumentations: ...
          });

• OpenTelemetry の設定 SDK for Node.js
• 「 OTLP 」のアクセプターであるサーバーレスエンドポイントを選択し、エンドポイントを URL に設定 INSTANA_ENDPOINT_URL します。
• エージェントキー を取得し、それをエージェントキーに設定 INSTANA_AGENT_KEY します。

以下のパッケージをインストールするには、次のコマンドを実行してください：

npm i @opentelemetry/exporter-metrics-otlp-grpc @opentelemetry/exporter-trace-otlp-grpc @opentelemetry/propagator-instana @opentelemetry/sdk-metrics --save

実際に動作する完全な例については、 「Serverless OpenTelemetry OTLP 形式の例」 を参照してください。

...
          const { OTLPTraceExporter } = require('@opentelemetry/exporter-trace-otlp-grpc');
          const { OTLPMetricExporter } = require('@opentelemetry/exporter-metrics-otlp-grpc');
          const { PeriodicExportingMetricReader } = require('@opentelemetry/sdk-metrics');
          const { InstanaPropagator } = require('@opentelemetry/propagator-instana');

          const otlpEndpoint = process.env.INSTANA_ENDPOINT_URL;
          const metadata = new grpc.Metadata();
          metadata.set('x-instana-key', process.env.INSTANA_AGENT_KEY);

          const instanaReader = new PeriodicExportingMetricReader({
            exportIntervalMillis: 1000 * 10,
            exporter: new OTLPMetricExporter({
              url: otlpEndpoint,
              metadata
            })
          });

          const sdk = new opentelemetry.NodeSDK({
            traceExporter: new OTLPTraceExporter({
              url: otlpEndpoint,
              metadata
            }),
            propagator: new InstanaPropagator(),
            metricReader: instanaReader,
            instrumentations: [...]
          });

          ...

• OpenTelemetry をインストールしてください SDK for Node.js
• OTLP のアクセプタエンドポイントを選択し、エンドポイントを URL に設定 INSTANA_ENDPOINT_URL します。
• エージェントキー を取得し、それをエージェントキーに設定 INSTANA_AGENT_KEY します。

次のコマンドを実行して、以下のパッケージをインストールしてください：

npm i @instana/opentelemetry-exporter@ @opentelemetry/propagator-instana --save

実際に動作する完全な例については、 「Serverless OpenTelemetry Instana 形式の例」 を参照してください。

...
          const { InstanaExporter } = require('@instana/opentelemetry-exporter');
          const { InstanaPropagator } = require('@opentelemetry/propagator-instana');

          /*
           * If you have not provided the agent key and the serverless endpoint URL via environment variables:
           * const instanaTraceExporter = new InstanaExporter({ agentKey: 'agent_key', endpointUrl: 'endpoint_url' });
           */
          const instanaTraceExporter = new InstanaExporter();

          const sdk = new opentelemetry.NodeSDK({
            ...
            traceExporter: instanaTraceExporter,
            propagator: new InstanaPropagator(),
            instrumentations: [...]
          });

OpenTelemetry プロパゲーターをインストールするには、次のコマンドを実行してください：

npm install --save @opentelemetry/propagator-instana@

OpenTelemetry プロパゲーターを有効にするには、次のコマンドを実行してください：

...
          const { InstanaPropagator } = require('@opentelemetry/propagator-instana');
          // ...

          new opentelemetry.NodeSDK({
            ...
            propagator: new InstanaPropagator(),
            ...
          });

OpenTelemetry サンプラーをインストールするには、次のコマンドを実行してください：

npm install --save @instana/opentelemetry-sampler@

@opentelemetry/propagator-instanaこのサンプラーは、パッケージと組み合わせて使用する必要があります。

const { InstanaPropagator } = require('@opentelemetry/propagator-instana');
          const { InstanaAlwaysOnSampler } = require('@instana/opentelemetry-sampler');

          const sdk = new opentelemetry.NodeSDK({
            ...
            propagator: new InstanaPropagator(),
            sampler: new InstanaAlwaysOnSampler()
            ...
          });

          ...

OpenTelemetry リソース検出ツールをインストールするには、次のコマンドを実行してください：

npm install --save @opentelemetry/resource-detector-instana

import {
            Resource,
            processDetector,
            envDetector,
          } from "@opentelemetry/resources";
          import { SemanticResourceAttributes } from "@opentelemetry/semantic-conventions";
          import { NodeSDK } from "@opentelemetry/sdk-node";
          import { instanaAgentDetector } from "@opentelemetry/resource-detector-instana";

          const globalResource = new Resource({
             [SemanticResourceAttributes.SERVICE_NAME]: "TestService",
          });

          const sdk = new NodeSDK({
             resourceDetectors: [envDetector, processDetector, instanaAgentDetector]
             resource: globalResource,
          });

          ...

さらに、以下の環境変数を設定することもできます：

• INSTANA_RETRY_TIMEOUT_MS: リソース検出機能は、 Instana エージェントへの接続を試みる際、3回の再試行を行います。 この値は、再試行間のタイムアウト時間です。 (デフォルト: 1000)
• INSTANA_AGENT_TIMEOUT_MS: Instana エージェントへの接続時のクライアントタイムアウト。 (デフォルト: 3000)