Cisco
Login
Search
Software Secure Workload
Activity Configure

Deploy Software Agents on Workloads Frequently Asked Questions Agent Troubleshooting Tool

Last updated: Jun 09, 2025

Agent Troubleshooting Tool

Agent troubleshooting tool allows you to troubleshoot common issues with your Agents in a Windows environment. This tool is a PowerShell script with several parameters that allows you to troubleshoot different aspects of your Agents. Following PowerShell parameters can be used to troubleshoot different aspects of the Agents:

  • -agentHealth: This option checks the health of your Agents and reports any issues that need to be addressed.

  • -agentRegistration: This option allows you to check for any known issues with agent registration.

  • -agentUpgrade: This option allows you to check for any known issues with agent upgrades.

  • -enforcementHealth: This option checks the overall enforcement health and ensures the latest policies are programmed.

  • -collectLogs: This option collects debug logs, which can be analyzed for further troubleshooting.

To run the Agent troubleshooting tool script, follow these steps:

Procedure

1

Open Windows (PowerShell) as an Administrator.
2

Navigate to the CSW installation directory (The default location of this directory is: "C:\Program Files\Cisco Tetration").
3

Run the script using the following command:

.\AgentTroubleshooting.ps1

For example, to check the health of your Agents, run the script with the -agentHealth parameter: 

.\AgentTroubleshooting.ps1 -agentHealth

Previous topic Agent operations Next topic External Orchestrators in Secure Workload