Node.jsのエージェントレス監視(パブリック・プレビュー)
Instana のサーバーレスコレクター を使用すると、 Instana ホストエージェントをインストールすることなく、サーバー上の Node.js アプリケーションを監視できます。 Instana が npm パッケージを提供していないサーバーレス環境についても、監視を行うことができます。
AWS Lambda、 AWS Fargate、または Google Cloud での Node.js の監視に関する詳細については、 「監視オプション 」を参照してください。
制限
現在、 Instana のサーバーレスコレクターパッケージでは、以下の機能はサポートされていません:
- AutoProfile
- メトリック収集
準備
インストールされている Node.js のバージョンを確認し、 Instana のサーバーレスコレクターと互換性があることを確認してください。 詳細については、 「対応している Node.js のバージョン」 をご覧ください。
モニタリングの設定
Node.js アプリケーションの監視を設定するには、以下の手順を実行します:
サーバーレスコレクターをインストール、有効化、および設定した後、 Instana のUIでトレースを確認できます。 詳しくは EUMの相関図を参照。
サーバーレス・コレクターのインストール
サーバーレス・コレクターをインストールするには、以下のコマンドを実行する:
npm install --save @instana/serverless-collector@latest
サーバーレスコレクターの起動
サーバーレスコレクターがインストールされたら、アプリケーション内でアクティベートする。
CommonJS
アプリケーションが CommonJS,を使用している場合は、以下のいずれかの方法でサーバーレス・コレクターをアクティブにする:
NODE_OPTIONS
この方法でサーバーレス・コレクターを有効にするには、以下のコマンドを実行する:
ENV NODE_OPTIONS="--require ./node_modules/@instana/serverless-collector/src/index.js"
手動 require
この方法でサーバーレス・コレクターを有効にするには、以下のコマンドを実行する:
// Do not use () at the end!
require('@instana/serverless-collector');
// All other require statements must be done after the serverless collector is initialized.
// const express = require('express');
ECMAScript
アプリケーションがECMAScriptを使用している場合は、以下のようにサーバーレス・コレクターを有効にする:
次のコマンドを実行してください( Node.js、 18.19 以降):
ENV NODE_OPTIONS="--import ./node_modules/@instana/serverless-collector/esm-register.mjs"
Node.jsの起動コマンドを実行するときにloadフラグを含めることもできる。
サーバーレスコレクターの設定
サーバーレスコレクターのインストールと有効化が完了したら、収集したスパンを Instana バックエンドに送信するように、サーバーレスコレクターを設定する必要があります。
収集したスパンを Instana バックエンドに送信するようにサーバーレスコレクターを設定するには、以下の環境変数を設定してください:
INSTANA_ENDPOINT_URL: サーバーのリージョンに対応するサーバーレス監視エンドポイントをコピーし、それを環境INSTANA_ENDPOINT_URL変数として設定してください。INSTANA_AGENT_KEY: 「 Instana 」UIのナビゲーションメニューから、 「その他 」>「 エージェント 」>「 エージェントのインストール」 をクリックします。 サーバーレスプラットフォームを選択し、表示されたキーをコピーして、環境INSTANA_AGENT_KEY変数として設定してください。
エンドユーザー監視(EUM)の相関分析
サーバレスコレクタをインストールし、アクティベートし、設定に成功すると、デフォルトでトレースが有効になります。 Instana のバックエンド相関関係を確認するには、 Instana のUIで次の手順を実行してください:
- ウェブサイトを作成する フロントエンド用に。
- Node.js アプリケーションの設定が完了し、実行中でトラフィックを受信している状態になったら、 Instana のUIで [Applications] > [Services] に移動し、ダッシュボードにトレースが表示されていることを確認してください。
- Instana のUIにあるナビゲーションメニューから、 「Webサイトとモバイルアプリ」 をクリックし、ご自身のWebサイトを選択してください。
- ウェブサイトのダッシュボードで、[ HTTP Requests] > [Analyze HTTP Requests]をクリックします。
- 特定のリクエストを選択してバックエンドのトレースを表示します。