Node.js エージェントのインストール

エージェントをインストールするには、アプリケーションのディレクトリでインストールコマンドを実行してから、アプリケーションにエージェントモジュールを追加するための require コマンドを追加します。

Node.js 0.8.1 ~ 0.8.18 を使用している場合は、インストールコマンドを実行する前に、「Node.js 0.8.1 から 0.8.18 までのユーザーエージェントを設定」を参照してください。

npm経由でのインストール

Node.js エージェントのどのバージョンがご使用のコントローラと互換性があるかを判断するには、「 エージェントとコントローラの互換性」を参照してください。

最新のエージェントをインストールするには、以下のコマンドを実行します。

CODE
npm install appdynamics@next

インストールしたいNode.jsエージェントの具体的なバージョンがわかっている場合は、それを指定できます。

CODE
npm install appdynamics@<x.y.z>

npm 5 を使用している場合は、package-lock=false を設定してロックファイルを無効にする必要があります。

Node.js v6 に付属している npm のバージョンは、エージェントの 4.5.12 以降のバージョンで使用されているインストール後スクリプトを自動実行しません。最新の Node.js バージョンを使用することを推奨します。

Node.js v6 を使用する必要がある場合は、エージェントをインストールする前に npm を更新する必要があります。

CODE
npm install -g npm
npm install appdynamics

Requireステートメントの追加

他の require ステートメントの前に、アプリケーションのソースコードの最初の行として次の require ステートメントを貼り付けます。次に、変数を設定用の値に置き換えます。アカウント名とアクセスキーを検索するには、[Settings] [設定(Settings)] アイコン を選択してから、[License] を選択します。

JSON
require("appdynamics").profile({
controllerHostName: '<controller host name>',
controllerPort: <controller port number>,
controllerSslEnabled: false,  // Set to true if controllerPort is SSL
accountName: '<AppDynamics_account_name>',
accountAccessKey: '<AppDynamics_account_key>', //required
applicationName: 'your_app_name',
tierName: 'choose_a_tier_name',
nodeName: 'choose_a_node_name'
});

設定に関する参照情報、および使用可能なその他の設定については、「Node.js設定参考資料」を参照してください。

require を配置できます

この場合、ポイントオブエントリ ソース ファイルの変更が必要な場合があります。エージェントへのコールを発信するファイルに対して を実行するために 1 行変更するだけです。例:。

requireステートメントをコードの最初の行として配置できない場合は、ステートメントを他の場所に挿入できますが、インストゥルメント化する必要のあるコアまたはサードパーティ製モジュールのrequire()の前に置く必要があります。

警告: エージェントをロードするために使用するソースファイルが ES6 モジュールの場合は、require("appdynamics").profile({ ... }) ではなく、import appdynamics from "appdynamics"; appdynamics.profile({ ... }) を使用します。

構成のテスト

インストールを確認するには、アプリケーションを再起動して負荷をかけます。構成で指定したビジネスアプリケーションのフローマップに新しいノードが表示されます。