Troubleshooting Discovery Agent - AWS Application Discovery Service

Troubleshooting Discovery Agent

This page covers troubleshooting the Discovery Agent on Linux and Microsoft Windows.

Troubleshooting Discovery Agent on Linux

If you encounter problems while installing or using the Discovery Agent on Linux, consult the following guidance about logging and configuration. When helping to troubleshoot potential issues with the agent or its connection to the Application Discovery Service, AWS Support often requests these files.

  • Log files

    Log files for Discovery Agent are located in the following directory.

    /var/log/aws/discovery/

    Log files are named to indicate whether they are generated by the main daemon, the automatic upgrader, or the installer.

     

  • Configuration files

    Configuration files for Discovery Agent version 2.0.1617.0 or newer are located in the following directory.

    /etc/opt/aws/discovery/

    Configuration files for versions of Discovery Agent before 2.0.1617.0 are located in the following directory.

    /var/opt/aws/discovery/
  • For instructions on how to remove older versions of the Discovery Agent, see Prerequisites for Discovery Agent.

Troubleshooting Discovery Agent on Microsoft Windows

If you encounter problems while installing or using the AWS Application Discovery Agent on Microsoft Windows, consult the following guidance about logging and configuration. AWS Supportoften requests these files when helping to troubleshoot potential issues with the agent or its connection to the Application Discovery Service.

  • Installation logging

    In some cases, the agent install command appears to fail. For example, a failure can appear with the Windows Services Manager showing that the discovery services are not being created. In this case, add /log install.log to the command to generate a verbose installation log.

  • Operational logging

    On Windows Server 2008 and later, agent log files can be found under the following directory.

    C:\ProgramData\AWS\AWS Discovery\Logs

    On Windows Server 2003, agent log files can be found under the following directory.

    C:\Documents and Settings\All Users\Application Data\AWS\AWS Discovery\Logs

    Log files are named to indicate whether generated by the main service, automatic upgrades, or the installer.

     

  • Configuration file

    On Windows Server 2008 and later, the agent configuration file can be found at the following location.

    C:\ProgramData\AWS\AWS Discovery\config

    On Windows Server 2003, the agent configuration file can be found at the following location.

    C:\Documents and Settings\All Users\Application Data\AWS\AWS Discovery\config
  • For instructions on how to remove earlier versions of the Discovery Agent, see Prerequisites for Discovery Agent.