Instana の OpenTelemetry デモから Node.js アプリケーションを監視する

「 OpenTelemetry 」デモを使用すると、 Node.js アプリケーションに自動的に計測機能を追加し、 Instana エージェントを通じて Instana にメトリクスやトレースを送信することができます。 これらのメトリクス、トレース、およびログデータは、 Instana のUIで確認できます。 「 OpenTelemetry 」コレクター node.js エージェントを使用して、 Node.js-based アプリケーション(「フロントエンド」)に計測機能を追加する方法については、以下の例を参照してください:

このアプリケーションは、ユーザー向けのUIと、UIやその他のクライアントから利用される API を提供します。 このアプリケーションは Next.JS を基盤としており、 React のWebベースのUIと API のルーティングを提供します。 アプリケーションは2つのレイヤーで構成されている:

  • OTELウェブストアのコンポーネントをレンダリングするクライアント側アプリケーション。
  • API レイヤー。これは、RESTエンドポイントを公開することで、クライアントとバックエンドサービスを接続します。 OpenTelemetry の統合を開始するには、以下の手順例を参照してください:

前提条件

作業を始める前に、以下の技術がインストールされていることを確認してください:

  • Docker
  • Docker Compose v2.0.0 またはそれ以降

アプリケーションをローカルにデプロイする

アプリケーションをデプロイするには、プロジェクトのルート・ディレクトリで以下のコマンドを実行する:

git clone https://github.com/open-telemetry/opentelemetry-demo.git
cd opentelemetry-demo/
docker compose run --service-ports -e NODE_ENV=development --volume $(pwd)/src/frontend:/app --volume $(pwd)/pb:/app/pb --user node --entrypoint sh frontend

ルート・レベルで Docker Compose を実行すると、必要なバックエンド・サービスがすべてインストールされる。

次に、コンテナ内で以下のコマンドを実行する:

npm run dev

コマンドを実行したら、 http://localhost:8080/ でアプリケーションにアクセスする。

Instana のUIでメトリクスを確認する

Instana のUIでは、メトリクス、トレース、ログなどの OpenTelemetry のデータを確認できます。 詳細については、 「 OpenTelemetry 」デモ・アプリケーションによって生成された「 OpenTelemetry 」のメトリクス・データを「 Instana 」UI で表示する方法を参照してください。

注: データの閲覧を開始する前に、サービスからデータを収集できるよう、 Instana のバックエンドとエージェントを適切に設定する必要があります。