Troubleshooting
Common athena-operator failure checks, log paths, and namespace gotchas.
Check The Basics
kubectl config current-context
kubectl get nodesOperator Logs
If the operator runs in-cluster:
kubectl logs -n athena-operator-system deploy/athena-operator -fIf it runs locally, inspect the terminal running:
go run ./cmd/athena-operator"expected exactly 1 AthenaGateway"
If more than one AthenaGateway exists, related resources such as AthenaClient and AthenaApiKey should set spec.gatewayRef.
Secret Namespace Gotchas
Secrets are namespaced, so the referenced resource and the secret have to line up correctly:
AthenaGateway.spec.adminKeySecretRefmust be in the gateway target namespaceAthenaClient.spec.pgUriSecretRefmust be in theAthenaClientnamespaceAthenaApiKey.spec.writeSecretRefmust be in theAthenaApiKeynamespace
Kubernetes Events
kubectl get events -A --sort-by=.lastTimestampSee What Kubernetes Actually Created
Gateway workload:
kubectl get deploy,svc -n athena-system
kubectl get pods -n athena-system -l app.kubernetes.io/name=athena-gatewayOperator workload:
kubectl get deploy,pods -n athena-operator-system