Troubleshoot agents
Information to help you debug issues with DigiCert® agents.
Agent statuses
The status indicates the current state of a DigiCert agent. You can view the status of an agent in DigiCert® Trust Lifecycle Manager in the following ways:
Go to the Discovery & automation tools > Agents page, find the agent in the table, and check the Status column for it. If the Status column does not appear, select the Add Column button on the top-right of the table to add it.
Select an agent from the Discovery & automation tools > Agents table to view the details for it. The agent status is shown in the top section of the details page. For error statuses, look for a top banner with troubleshooting information.
Status | Description |
|---|---|
| The agent stopped working and requires attention. |
| The agent is installed and activated. |
| The agent could not be activated and is not ready for use. |
| Trust Lifecycle Manager lost network connectivity to the agent. |
| The agent is configured for certificate automation on one or more IP/port targets. |
| The agent is ready for use, but has not been configured for certificate automation. |
| The agent requires manual approval, but has not been approved yet. |
| The agent has been temporarily suspended from operation. |
| The agent software is being upgraded. |
Agent debug mode
Use this option to extend the agent logging level. This enables you to capture additional information in the log file to investigate and solve issues in your environment.
Note: Debug mode is disabled by default for agents.
To enable debug mode for an agent:
From the Trust Lifecycle Manager main menu, select Discovery & automation tools > Agents.
Locate the applicable agent in the table. Select the agent Name to move to the details page.
On the agent details page, select the pencil icon on the top-right to access edit mode.
In the Advanced settings section of the agent details, select the Enable debug logging checkbox.
Select the Update button at bottom to apply your changes.
Agent log files
The location of the agent log files depends on the host type and installation directory ({$Install_Path$}) where the agent software was installed.
Host type | Log type | Location of log files |
|---|---|---|
Windows | Agent logs, including web server automation events. | {$Install_Path$}\log |
Windows | Trust Lifecycle Manager plugin manager (TPM) logs for the agent, including certificate delivery events related to Admin web request enrollments. | {$Install_Path$}\tpm\log |
Linux | Agent logs, including web server automation events. | {$Install_Path$}/log |
Linux | Trust Lifecycle Manager plugin manager (TPM) logs for the agent, including certificate delivery events related to | {$Install_Path$}/tpm/log |