---
title: Troubleshooting
description: Kubernetes deployments are multi-layered and often complex.
component: forgeops
version: 2026.1
page_id: forgeops:troubleshoot:overview
canonical_url: https://docs.pingidentity.com/forgeops/2026.1/troubleshoot/overview.html
---

# Troubleshooting

Kubernetes deployments are multi-layered and often complex.

Errors and misconfigurations can crop up in a variety of places. Performing a logical, systematic search for the source of a problem can be daunting.

Before you troubleshoot, verify your ForgeOps version:

```
$ cd /path/to/forgeops
$ ./bin/forgeops version
```

Here are some techniques you can use to troubleshoot problems with ForgeOps deployments:

| Problem                                                                                 | Troubleshooting Technique                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Some pods don't start.                                                                  | Review [Kubernetes logs and other diagnostics](pods.html). Verify if your cluster is resource-constrained. Check for under configured clusters by using the `kubectl describe nodes` and `kubectl get events -w` commands. Pods killed without of memory (OOM) conditions indicate that your cluster is under configured. Make sure that you're using [tested versions of third-party software](sw-versions.html). [Stage your installation](staged-deployment.html). Install Ping Identity Platform components separately, instead of installing all the components with a single command. Staging your installation lets you make sure each component works correctly before installing the next component. |
| All the pods have started, but you can't reach the services running in them.            | Make sure you don't have any [ingress issues](ingress.html).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| AM doesn't work as expected.                                                            | [Set the AM logging level](https://community.forgerock.com/t/how-to-enabling-and-modifying-logging-level-in-forgeops-7-3-for-am/3133), recreate the issue, and analyze the AM log files. [Turn on audit logging in AM.](https://community.forgerock.com/t/how-to-enable-and-modify-audit-logging-in-am-and-idm-for-forgeops-7-3/3263/1)                                                                                                                                                                                                                                                                                                                                                                       |
| IDM doesn't work as expected.                                                           | [Set the IDM logging level](https://community.forgerock.com/t/how-to-enabling-and-modifying-logging-level-in-forgeops-7-3-for-idm/3152), recreate the issue, and analyze the IDM log files. [Turn on audit logging in IDM.](https://community.forgerock.com/t/how-to-enable-and-modify-audit-logging-in-am-and-idm-for-forgeops-7-3/3263/1)                                                                                                                                                                                                                                                                                                                                                                   |
| Your JVM crashed with an out of memory error, or you suspect that you've a memory leak. | [Collect and analyze Java thread dumps and heap dumps](https://support.pingidentity.com/s/article/How-do-I-collect-Java-thread-dumps-and-heap-dumps-for-troubleshooting-a-ForgeOps-deployment).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Changes you've made to ForgeOps's Kustomize files don't work as expected.               | [Fully expand the Kustomize output](kustomize.html), and then examine the output for unintended effects.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Your minikube deployment doesn't work.                                                  | Make sure that you don't have a problem with [virtual hardware requirements](minikube.html).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| You're having name resolution or other DNS issues.                                      | Use diagnostic tools in the [debug tools container](debug-tools.html#debug-tools-container).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| You want to run DS utilities without disturbing a DS pod.                               | Use the [bin/ds-debug.sh script](debug-tools.html#ds-debug) or DS tools in the [debug tools container](debug-tools.html#debug-tools-container).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| You want to keep the `amster` pod running to diagnose AM configuration issues.          | Use the [forgeops amster command](amster.html).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| You want to troubleshoot AM configuration upgrade issues.                               | Use the [config --no-upgrade option](am-no-upgrade.html).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| The `kubectl` command requires too much typing.                                         | Enable [kubectl tab autocompletion](tab-completion.html).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |