Troubleshooting

Common Issues Classification

  1. Cluster Creation Failure
  2. Master-Slave Switch Exception
  3. Backup Restoration Failure
  4. Missing Monitoring Metrics
  5. Connection Pool Issues
  6. Resource Insufficiency Issues

Troubleshooting Tools

Check Cluster Status

kubectl get postgresql <cluster-name> -o yaml

Check Pod Logs

kubectl logs <pod-name> -c postgres

View Events

kubectl get events --sort-by=.metadata.creationTimestamp

Check Storage

kubectl get pvc
kubectl describe pvc <pvc-name>

Diagnostic Process

  1. Confirm Kubernetes cluster status
  2. Check PostgreSQL Operator logs
  3. Check the CRD status of the target cluster
  4. Inspect the status and logs of related Pods
  5. Validate storage configuration
  6. Check network connectivity
  7. Review monitoring metrics

Get Help

If you are unable to resolve the issue, please collect the following information and contact the support team:

  1. Cluster name and namespace
  2. Time of the issue occurrence
  3. Relevant log files
  4. Cluster configuration information
  5. Record of operation steps