Node.jsのエージェントレス監視(パブリック・プレビュー)

Instana のサーバーレスコレクター を使用すると、 Instana ホストエージェントをインストールすることなく、サーバー上の Node.js アプリケーションを監視できます。 Instana が npm パッケージを提供していないサーバーレス環境についても、監視を行うことができます。

AWS Lambda、 AWS Fargate、または Google Cloud での Node.js の監視に関する詳細については、 「監視オプション 」を参照してください。

制限

現在、 Instana のサーバーレスコレクターパッケージでは、以下の機能はサポートされていません:

  • AutoProfile
  • メトリック収集

モニタリングの設定

Node.js アプリケーションの監視を設定するには、以下の手順を実行します:

  1. Instana のサーバーレスコレクターをインストールする
  2. サーバーレスコレクターを起動する
  3. サーバーレスコレクターの設定

サーバーレスコレクターをインストール、有効化、および設定した後、 Instana のUIでトレースを確認できます。 詳しくは EUMの相関図を参照。

サーバーレスコレクターの起動

サーバーレスコレクターがインストールされたら、アプリケーション内でアクティベートする。

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 バックエンドに送信するようにサーバーレスコレクターを設定するには、以下の環境変数を設定してください:

  1. INSTANA_ENDPOINT_URL : サーバーのリージョンに対応するサーバーレス監視エンドポイントをコピーし、それを環境 INSTANA_ENDPOINT_URL 変数として設定してください。
  2. INSTANA_AGENT_KEY : 「 Instana 」UIのナビゲーションメニューから、 「その他 」>「 エージェント 」>「 エージェントのインストール」 をクリックします。 サーバーレスプラットフォームを選択し、表示されたキーをコピーして、環境 INSTANA_AGENT_KEY 変数として設定してください。

エンドユーザー監視(EUM)の相関分析

サーバレスコレクタをインストールし、アクティベートし、設定に成功すると、デフォルトでトレースが有効になります。 Instana のバックエンド相関関係を確認するには、 Instana のUIで次の手順を実行してください:

  1. ウェブサイトを作成する フロントエンド用に。
  2. Node.js アプリケーションの設定が完了し、実行中でトラフィックを受信している状態になったら、 Instana のUIで [Applications] > [Services] に移動し、ダッシュボードにトレースが表示されていることを確認してください。
  3. Instana のUIにあるナビゲーションメニューから、 「Webサイトとモバイルアプリ」 をクリックし、ご自身のWebサイトを選択してください。
  4. ウェブサイトのダッシュボードで、[ HTTP Requests] > [Analyze HTTP Requests]をクリックします。
  5. 特定のリクエストを選択してバックエンドのトレースを表示します。