Skip to end of metadata
Go to start of metadata

Prerequisites

  • Ensure you have enough disk space to create the logs before starting a logging session.  Log file requests fail if there is not enough disk space available.
  • For the App Agent for .Net, ensure the agent has the same permissions as your site's application pools. For more information, see Troubleshooting Log Issues.

You can download a zip of the log file directory from the UI but you can also find the logs at the following locations:

Agent name

Log file location

App Agent for Java

<agent install directory>/logs/<Node_Name>

App Agent for .Net

Windows Server 2008 and later:

%ProgramData%\AppDynamics\DotNetAgent\Logs

Windows Server 2003:

%AllUsersProfile%\Application Data\AppDynamics\DotNetAgent\Logs

App Agent for PHP

<agent install directory>/logs/

Standalone Machine Agent

<agent install directory>/logs/

Requesting the agent logs is a two-step process

  1.  Start an Agent Logging Session. Here you can start a logging session to see specific AppDynamics logger information in the agent log files. Once the logging session completes you can request the agent log files.
  2.  Request and Download Agent Log Files Follow this procedure to download all the log files, download the output from a specified third-party logger you have installed, or download thread dump samples.

Start an Agent Logging Session

1. On the Agents tab of the Node dashboard, scroll down to the Agent Operations panel.

2. Click Start Agent Logging Session.

The Agent Logging Session window opens.

3. From the drop-down list, click the duration for the logging session.

4. Click the check boxes for the debug logger types to initiate. You can select any number of these logger types. The selected loggers control the type of information the logging session captures.

The following describes the debug logger types available.

Logging Session Type

Description  (What kind of info and when to use this)

Application Wide Configuration

Application configuration changes

BT Registration

Transaction, exit identification, self resolution

Current Time

Requests to synch up the clock skew between the controller and the agent

Events

Changes in application state that are of potential interest

Metric Data

Metric data

Metric Registration

Metric registration

One Way Agent

For system (machine) agent only, information from the capture feature

Request Segment data

Snapshot upload of request segment

System Agent Registration

System (machine) agent registration

System Agent Reregistration

System (machine) agent reregistration

System Agent Polling Handler

System (machine) agent configuration request

Task Execution

Relates to the machine agent where you can create a task to execute on a machine, such as restart application server and run a script

Top Summary Stats

Request to upload the 'most expensive backend' summary

Application Configuration

Configuration change requests

Transient Channel

Activity of transient channel which is used to upload and download instructions for 'JMX console' live data

5. Click Start Agent Logging Session.

Each session type that you clicked appears in the session panel, with a start time and end time based on what you picked in the Duration of logging session to run drop-down list. If you don't see the session you requested, click Refresh.

Request and Download Agent Log Files

When the End Time of the logging session has been reached, you can request the log files. You can also manually take thread dumps from the Agents tab of the node dashboard. When you request the log files, the agent zips the contents of the logs directory and then sends the logs to the controller as a single file for download.

1. On the Agents tab of the Nodes dashboard, scroll down to the Agent Operations panel.

2. Click Request Agent Log Files.

The Request Agent Log Files window opens.

3. By default the agent zips all logs in the agent log directory into one zip file.

    For the AppDynamics Agent for Java or PHP, you can select one of the other options:

4. (Optional) Enter a name for your request. The name you provide identifies your request in the name of the generated zip file. For example, the name CurrentTime produces a zip file named similar to CurrentTime_Node_8000_1390503141046.zip.

5. After the logging session duration expires and the log file has been written to disk, click Request Agent Log Files and the logged request and response output appears in the Controller UI.  You must Request the log files before you can download them.  See Request and Download Thread Dump Samples

The AppDynamics controller processes your request. The status field changes as follows:

  • PENDING - request submitted
  • IN_PROGRESS - request being processed
  • TIMEDOUT - the request was not able to produce the desired result within the time specified in the Collection Interval (ms) field. This problem could occur for reasons such as:
    • The responding server went down.
    • The Internet connection went down.
    • The request parameters sent are incorrect.
  • SUCCESSFUL  - request is ready

If the status is SUCCESSFUL, you can click the file icon to download the zipped agent log files directory.

If the status is PENDING, click Refresh. The zipped agent log files directory can only be downloaded when the status shows as SUCCESSFUL.

Note: If you accidentally request the logs for a node that is not valid, for example IIS is turned off for that node, the request eventually changes to IN_PROGRESS, but does not progress to SUCCESSFUL. You can remove such a request manually by selecting it, right-clicking and selecting Delete Data from the contextual menu.

Request and Download Thread Dump Samples

For App Agents: App Agent for Java and App Agent for PHP

You can request log files and manually take thread dumps from the Agents tab of the node dashboard. Requesting the log files causes the agent log files directory to be zipped up into one file for download convenience.

1. On the Agents tab of the Nodes dashboard, scroll down to the Agent Operations panel.

2. Click Request Agent Log Files.

The Request Agent Log Files window appears.

    By default all logs in the agent log directory for this node are collected into a zip file.

3. Click Thread dump samples, enter the number of samples to collect and the interval at which the samples should be collected.

    The agent takes a thread dump according to the specified collection interval and specified number to collect. After the interval elapses the thread dumps are uploaded by the agent as a zip file.

4. (Optional) Enter a name for your request. The name you provide is used to identify your request in the name of the generated zip file. For example, the name CurrentTime produces a zip file named similar to CurrentTime_Node_8000_1390503141046.zip.

5. After the logging session duration has expired and the log file has been written to disk, click Request Agent Log Files and the logged request and response output appears in the Controller.

    The AppDynamics controller processes your request. The status field changes as follows:

  • PENDING - request submitted
  • IN_PROGRESS - request being processed
  • TIMEDOUT - the request was not able to produce the desired result within the time specified in the Collection Interval (ms) field. This problem could occur for reasons such as:
    • The responding server went down.
    • The Internet connection went down.
    • The request parameters sent are incorrect.
  • SUCCESSFUL  - request is ready

    If the status is SUCCESSFUL, you can double-click a thread dump sample in the list to download the zip file containing the thread dump that you want.

    If the status is PENDING, click Refresh. When the logs are ready, the status changes to SUCCESSFUL. The zipped agent log files directory can only be downloaded when the status shows as SUCCESSFUL.

Note: If you accidentally request the thread dump samples for a node that is not valid, for example IIS is turned off for that node, the request eventually changes to IN_PROGRESS, but does not progress to SUCCESSFUL. You can remove such a request manually by selecting it, right-clicking and selecting Delete Data from the contextual menu.

Submitting Log Files to Support

When submitting log files to AppDynamics Support, ensure you send the entire contents of the agent logs directory available as a zip file for download when you request the agent logs.

Learn More

Overview of Agent Log Files

  • No labels