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ステートメントを、マスター プロセスとワーカー プロセスの双方で置き換えてください。