エージェントログ情報を使用して、AppDynamics アプリケーション エージェントに局所的な問題のトラブルシューティングを行うことができます。

コントローラから .NET マイクロサービス エージェントで生成されたログファイルにアクセスすることはできません。

このページでは、エージェントログの機能について説明します。コントローラ UI でエージェントログの操作にアクセスするには、[Node Dashboard > Agents > App Server Agent > Agent Operations] に移動します。

権限

エージェントスレッドダンプまたはエージェントデバッグログを要求する場合、ユーザに Agent Advanced Operation 権限が必要です。

エージェントログファイルとスレッドダンプサンプルの取得

ログファイルを要求すると、エージェントからコントローラにログディレクトリの内容がZIPファイルとして送信されます。ここから、そのZIPファイルをローカルマシンにダウンロードできます。

ログセッションには、次のようなエージェント固有の考慮事項が適用されます。

  • データベースエージェント、Java エージェント、または PHP エージェントの場合、すべてのログを取得するか、以下のその他の方法を選択できます。
    • 特定のロガーから一定の期間、設定されたレベルで出力します。[Logger Name] フィールドでは、com.singularity、com.singularity.tm、com.singularity.tm.jdbc などのエージェントロガー名、またはエージェントロガー名に一致するパターンを指定します。サポートされているロガーの一覧については、「Java対応環境」を参照してください。
    • スレッドダンプのサンプル。エージェントは、指定された収集間隔と指定された収集する数に従って、スレッドダンプを実行します。収集間隔を過ぎると、エージェントはスレッドダンプを zip ファイルとしてアップロードします。 
  • Node.jsエージェントの場合、プロキシログを使用できます。
  • Python エージェントの場合、[All logs in the logs directory] を選択すると、プロキシログとエージェントログの両方が取得されます。エージェントログには、エージェント構成ファイルに記録されるように構成されたログメッセージが含まれます。詳細については、Pythonエージェント設定を参照してください。

ステータスが PENDING のときは、[Refresh] をクリックしてステータスフィールドを更新できます。リクエストに成功したら、ステータスに示されたとおりに、リクエストのエージェントオペレーション名を右クリックし、Download Dataを選択します。リクエストの名前を入力して、その名前を生成されたZIPファイルの先頭に追加します。たとえば、CurrentTime という名前のリクエストでは CurrentTime_Node_8000_1390503141046.zip のような名前の zip ファイルが生成されます。

リクエストのステータスに SUCCESSFUL が表示されない場合、タイムアウトした可能性があります。リクエストは、そのパラメータが正しくない場合やサーバが使用できない場合にタイムアウトすることがあります。この場合は、リクエストを右クリックして、[Delete Data] を選択し、リクエストをもう一度試してください。  

エージェントログセッションの開始

Java およびデータベースエージェントの場合は、特定のタイプのログ情報を含むログ情報を生成できます。Node.js および Python エージェントの場合は、プロキシからのログ情報のみが生成されます。   

  1. ログセッションを開始する前に、ログを作成するのに十分なディスク領域があることを確認します。使用可能なディスク領域が不足している場合、ログファイルのリクエストは失敗します。必要なディスク領域は、アプリケーションのアクティビティによって異なります。必要な容量が不明な場合は、最短の期間でエージェント ログ セッションを実行してみて、モニタ対象マシンのディスク領域を注意してモニタします。 
  2. [Agent Operations] パネルの [Start Agent Logging Session] をクリックします。

  3. ログセッションの期間と開始するデバッグロガーのタイプを選択します。ロガーのタイプによって、次のオプションを使用してキャプチャされる情報のタイプが決まります。

    ログセッションの種類

    情報の種類

    アプリケーション全体の構成

    アプリケーション構成の変更

    ビジネストランザクションの登録

    トランザクション、イグジットID、自己分析

    現在の時刻

    コントローラとエージェント間のクロックスキューの同期更新を要求

    イベント

    潜在的に関心のあるアプリケーション状態の変化

    メトリックデータ

    メトリックデータ

    メトリックの登録

    メトリックの登録

    One Wayエージェント

    システム（マシン）エージェントのみ、キャプチャ機能からの情報

    セグメントデータのリクエスト

    リクエストセグメントのスナップショットをアップロード

    システムエージェントの登録

    システム（マシン）エージェントの登録

    システムエージェントの再登録

    システム（マシン）エージェントの再登録

    システムエージェントポーリングハンドラ

    システム（マシン）エージェント構成の要求

    タスクの実行

    アプリケーションサーバの再起動やスクリプトの実行など、マシンで実行されるタスクを作成できるマシンエージェント関連

    トップサマリ統計

    「最も高価なバックエンド」サマリのアップロードをリクエスト

    アプリケーション構成

    構成の変更リクエスト

    一時的チャネル

    JMX コンソールライブデータのインストラクションのアップロードおよびダウンロードに使用される一時的チャネルのアクティビティ

  4. [Start Agent Logging Session] をクリックします。ログセッションの選択したDurationに基づく開始時刻と終了時刻とともに、選択した各セッションタイプが [Session] パネルに表示されます。

サポートへのログファイルの送信

ログファイルを AppDynamics サポートに送信する場合は、エージェント ログ ディレクトリの内容すべてを送信し、エージェントログをリクエストする際に ZIP ファイルとして直接ダウンロードできるようにしてください。