---
title: DS diagnostic tools
description: The bin/ds-debug.sh script lets you obtain diagnostic information for any DS pod running in your cluster. It also lets you perform several cleanup and recovery operations on DS pods.
component: forgeops
version: 2026.3
page_id: forgeops:troubleshoot:debug-tools
canonical_url: https://docs.pingidentity.com/forgeops/2026.3/troubleshoot/debug-tools.html
llms_txt: https://docs.pingidentity.com/forgeops/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
keywords: ["Troubleshooting", "Kubernetes", "Directory Server"]
section_ids:
  ds-debug: Debug script
---

# DS diagnostic tools

## Debug script

The bin/ds-debug.sh script lets you obtain diagnostic information for any DS pod running in your cluster. It also lets you perform several cleanup and recovery operations on DS pods.

Run bin/ds-debug.sh -h to refer to the command's syntax.

The following bin/ds-debug.sh subcommands provide diagnostic information:

| Subcommand   | Diagnostics                                                   |
| ------------ | ------------------------------------------------------------- |
| status       | Server details, connection handlers, backends, and disk space |
| rstatus      | Replication status                                            |
| idsearch     | All the DNs in the `ou=identities` branch                     |
| monitor      | All the directory entries in the `cn=monitor` branch          |
| list-backups | A list of the backups associated with a DS instance           |

The bin/ds-debug.sh purge command purges all the backups associated with a DS instance.
