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

APMインサイトNode.jsエージェントをインストールするには、次の手順に従ってください。

1. Applications ManagerのWebクライアントで、APMインサイト タブ > ヘルプ カードと移動し、ライセンス キーをコピーします。
2. APMインサイトNode.jsエージェントファイルをエージェントダウンロードページからダウンロードし、Node.jsサーバーで解凍してください。
3. Node.jsアプリケーションを開いてください。
4. NPMにアクセスします（ノード パケット マネージャー：Node Packet Manager）。
5. NPMから次のコマンドで、Node.jsエージェントをインストールします。

   npm install <Node.js-Agent-unzipped-path>/agent_minified

   例：

   npm install /users/joe/agent_minified

   APMインサイト エージェントを、コンピューターに存在するすべてのNode.jsアプリケーションにデプロイする場合は、-gフラグでグローバルのオプションを立ててください。
   

   npm install -g <Node.js-Agent-unzipped-path>/agent_minified

   例：

   npm install -g /users/joe/agent_minified

   これによって、APMインサイトのディレクトリがnode_modulesの下に作成されます。
   
   
6. お客さまNode.jsアプリケーション ソース コードの冒頭に、次の内容を記載してください。変数はお客さまの環境に応じて適宜変更ください。

   require('apminsight')({
licenseKey : '[LICENSE-KEY]',
    appName : '[APPLICATION-NAME]',
    port : [APPLICATION-PORT],
    apmHost: '[APM-HOST-NAME]',
    apmPort: [APM-SSL-PORT]
})

   例：

   require('apminsight')({
    licenseKey : 'APMI_ee42094f83dd841d16b9c56796c22b63bef00ac6918f547280947d1f6c2be1ea',
    appName : 'Insight_NodeJS',
    port : 3000,
    apmHost: 'localhost',
    apmPort: 8443
})

7. プロキシ接続を利用する場合は、代わりに、次のコードを使います。

   require('apminsight')({
    licenseKey : '[LICENSE-KEY]',
    appName : '[APPLICATION-NAME]',
    port : [APPLICATION-PORT],
    apmHost: '[APM-HOST-NAME]',
    apmPort: [APM-SSL-PORT]
    proxyServerHost : '[PROXY-SERVER]',
    proxyServerPort : [PROXY-PORT],
    proxyAuthUser : '[PROXY-USERNAME]',
    proxyAuthPassword : '[PROXY-PASSWORD]'
})

8. ファイルを保存しアプリケーションを再起動してください。

メモ：
1：APMインサイトNode.jsエージェントは、デバッガー モード（--inspect switch）で使うノード プロセスなど、他のプロファイリング ツールと併用できません。
2：アプリケーションでクラスター モジュールを使っている場合は、requireステートメントを、マスター プロセスとワーカー プロセスの双方で置き換えてください。