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 で表示する方法を参照してください。