Troubleshooting a Kubernetes deployment
- Last Updated: March 9, 2026
- 2 minute read
- Hybrid Data Pipeline
- Version 4.6
- Documentation
When you deploy a Kubernetes cluster using the Hybrid Data Pipeline Helm chart, you can use kubectl to investigate and troubleshoot issues with the deployment. The following sections describe using kubectl to review Kubernetes resources, monitor the status of pods, and access pod logs.
- For information on recovering the PostgreSQL primary PVC, see Recovering the PostgreSQL primary PVC.
- For more information about how to troubleshoot in Kubernetes, refer to A visual guide on troubleshooting Kubernetes deployments.
Review Kubernetes resources
A number of Kubernetes resources are created as part of a Hybrid Data Pipeline Helm chart deployment. You may use the following commands to see what resources have been created.
Use the following command to get a list of all Kubernetes objects.
kubectl --namespace namespace-value get all
Use the following command to list the ConfigMaps for the namespace.
kubectl --namespace namespace-value get configmaps
Use the following command to list the Secrets for the namespace. This should include Secrets for Hybrid Data Pipeline credentials, system database credentials, and TLS certificate information.
kubectl --namespace namespace-value get secrets
Use the following command to list PersistentVolumeClaims for the cluster.
kubectl --namespace namespace-value get persistentvolumeclaims
Use the following command to list the PersistentVolumes for the cluster.
kubectl --namespace namespace-value get persistentvolumes
Use the following command to view the state of the ingress you are using.
kubectl --namespace namespace-value get ingress
Review the status of Kubernetes pods
The Hybrid Data Pipeline Helm chart specifies the creation of pods for the Hybrid Data Pipeline server and a PostgreSQL system database, and AGIC ingress. The following commands show you to retrieve a list of the pods associated with each of these services.
Use the following command to list the pods for the Hybrid Data Pipeline server.
kubectl --namespace namespace-value get pods --selector app=hdp-server-app
Use the following command to list the pods for the PostgreSQL database.
kubectl --namespace namespace-value get pods --selector app.kubernetes.io/name=postgresql
Use the following command to list the pods for AGIC ingress.
kubectl --namespace namespace-value get pods --selector app.kubernetes.io/name=ingress-appgw
Access Kubernetes pod logs
You may use the following commands to access the pod logs for the Hybrid Data Pipeline server, a PostgreSQL system database, and AGIC ingress.
User the following command to retrieve the logs for the Hybrid Data Pipeline server pods.
kubectl --namespace namespace-value logs --selector app=hdp-server-app
User the following command to retrieve the logs for PostgreSQL database pods.
kubectl --namespace namespace-value logs --selector app.kubernetes.io/name=postgresql
User the following command to retrieve the logs for AGIC pods.
kubectl --namespace namespace-value logs --selector app.kubernetes.io/name=ingress-appgw