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

はじめに

このドキュメントでは、AppDynamics Node.js Agentをインストールして構成し、Node.jsアプリケーションのパフォーマンスメトリックを監視する方法について説明します。

前提条件

要　件

セットアップを続行するには、次の条件を満たしていることを確認してください。

• Node.jsおよびExpressフレームワークに精通していること

• GitHubリンクに存在するアプリケーションを使用するか、関連情報セクションから

• 環境変数とアプリケーション構造の基本的な知識

• AppDynamics SaaSまたはオンプレミスコントローラへのアクセス

• APIアクセスクレデンシャル（アカウント名、アクセスキー、コントローラのホスト/ポート）

使用するコンポーネント

本書の情報は、次のソフトウェアのバージョンに基づくものです。

• Node.js v18.x 

• AppDynamics Node.jsエージェント24.x

• AppDynamics Controller （オンプレミスまたはSaaS）

• Related informationセクションにGitHubリンクがあり、アプリケーションが完全に実行されます

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されたものです。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

バックグラウンド情報

AppDynamics Node.js Agentを使用すると、Node.jsアプリケーションをインストルメント化して監視できます。ビジネストランザクションデータ、バックエンド応答時間、メモリ使用量、およびCPUメトリックをキャプチャし、AppDynamics Controllerに送信します。

メトリックを正しく収集するには、他のユーザアプリケーションモジュールをロードする前にエージェントを初期化する必要があります。エージェントはHTTP(S)を介してコントローラと通信します。正常に機能するには、コントローラのホスト、ポート、およびアクセスキーの詳細が必要です。

設定

ヒント：設定スニペットで、すべての変数を実際のAppDynamics Controllerの詳細に置き換えてください。

ステップ1：エージェントのインストール

NPMを使用してAppDynamics Node.js Agentをインストールします。

npm install appdynamics --save

ステップ2：コードへの設定の埋め込み

メインファイル（app.jsまたはindex.js）の最上部で、他のモジュールの前にコードを追加します。

require("appdynamics").profile({
    controllerHostName: 'ControllerURL',
    controllerPort: ControllerPort, 
    controllerSslEnabled: true,  // Set to true if controllerPort is SSL
    accountName: 'accountName',
    accountAccessKey: 'accountAccessKey', // required
    applicationName: 'Hello_World_NodeJS', // Change the name of application
    tierName: 'Hello_World_NodeJS_Tier', // Change the name of tier
    nodeName: 'Hello_World_NodeJS_Node', //// Change the name of node

});

ステップ3：アプリケーションロジックの追加

const express = require('express');
const app = express();
const port = 3000;

app.get('/', (req, res) => {
  res.send('Hello World!');
});

app.listen(port, () => {
  console.log(`Example app listening on port ${port}`);
});

確認

ステップ1：アプリを起動する

node app.js

• アプリケーションに負荷をかける

ステップ2: AppDynamicsダッシュボードに移動

• AppDynamicsコントローラーにログインします

• Applications > Hello_World_NodeJSの順に移動します。

• 5分以内にメトリックとフローマップを検索

トラブルシュート

関連情報

AppDynamicsドキュメント

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

GitHub Node.js AppDynamicsデモ

サポートが必要な場合

質問がある場合、または問題が発生した場合は、次の詳細情報を含むasupport チケットを作成してください。

• エラーの詳細またはスクリーンショット：特定のエラーメッセージまたは問題のスクリーンショットを提供します。
• 使用コマンド：問題が発生したときに実行していたコマンドを正確に指定します。
• ノードエージェントログ：/tmp/appd/*/logs/からエージェントログ（生成された場合）を提供します。