rossoctl:ui-debug

Debug UI issues including API errors, nginx proxy problems, and backend connectivity.

Quick Diagnostics

# Set kubeconfig for your cluster
export KUBECONFIG=~/clusters/hcp/<MANAGED_BY_TAG>-<suffix>/auth/kubeconfig

# Example:
# export KUBECONFIG=~/clusters/hcp/rossoctl-hypershift-custom-uitst/auth/kubeconfig

1. Check Pod Status

kubectl get pods -n rossoctl-system -l 'app in (rossoctl-ui,rossoctl-backend)'

2. Check UI Nginx Logs for 502 Errors

# Recent errors
kubectl logs -n rossoctl-system deployment/rossoctl-ui --tail=100 | grep -E "(502|error|upstream)"

# All logs
kubectl logs -n rossoctl-system deployment/rossoctl-ui --tail=200

3. Check Backend Logs

kubectl logs -n rossoctl-system deployment/rossoctl-backend --tail=100

# Look for API requests (should see 200s for /api/v1/*)
kubectl logs -n rossoctl-system deployment/rossoctl-backend --tail=100 | grep "api/v1"

4. Check Recent Events

kubectl get events -n rossoctl-system --sort-by='.lastTimestamp' | tail -20

Common Issues

502 Bad Gateway - Connection Reset

Symptom: Nginx logs show:

recv() failed (104: Connection reset by peer) while reading response header from upstream
upstream prematurely closed connection while reading response header from upstream

Causes:

1. Backend pod restarting (check events for liveness probe failures)
2. Istio ambient mTLS misconfiguration
3. High CPU on worker nodes causing timeouts

Diagnosis:

# Check if backend was recently restarted
kubectl get events -n rossoctl-system | grep -i "backend\|liveness\|restart"

# Check node CPU
kubectl top nodes

# Check Istio namespace labels
kubectl get namespace rossoctl-system -o yaml | grep -A5 labels

502 Bad Gateway - Istio mTLS Issues

Symptom: Intermittent 502s, some requests work, others fail.

Diagnosis:

# Check if namespace has ambient mode
kubectl get namespace rossoctl-system -o jsonpath='{.metadata.labels.istio\.io/dataplane-mode}'

# Check PeerAuthentication policies
kubectl get peerauthentication -n rossoctl-system -o yaml

# Check if waypoint is deployed (for L7 policies)
kubectl get gateway -n rossoctl-system -l istio.io/waypoint-for

Fix: If mTLS is causing issues between nginx and backend:

# Option 1: Add permissive policy for backend
kubectl apply -f - <<EOF
apiVersion: security.istio.io/v1
kind: PeerAuthentication
metadata:
  name: backend-permissive
  namespace: rossoctl-system
spec:
  selector:
    matchLabels:
      app: rossoctl-backend
  mtls:
    mode: PERMISSIVE
EOF

API Returns Empty or Wrong Data

Diagnosis:

# Test backend API directly (port-forward)
kubectl port-forward -n rossoctl-system svc/rossoctl-backend 8000:8000 &
curl http://localhost:8000/api/v1/namespaces?enabled_only=true

# Check if namespaces have correct labels
kubectl get namespaces -l rossoctl-enabled=true

Auth Config Errors

Symptom: /api/v1/auth/config returns 502 or wrong config.

Diagnosis:

# Check backend env vars
kubectl get deployment rossoctl-backend -n rossoctl-system -o jsonpath='{.spec.template.spec.containers[0].env}' | jq

# Check if ENABLE_AUTH is set correctly
kubectl get deployment rossoctl-backend -n rossoctl-system -o jsonpath='{.spec.template.spec.containers[0].env}' | jq '.[] | select(.name=="ENABLE_AUTH")'

# Check Keycloak connectivity
kubectl get route keycloak -n keycloak -o jsonpath='{.spec.host}'

Verify UI is Working

# Get UI route
UI_HOST=$(kubectl get route rossoctl-ui -n rossoctl-system -o jsonpath='{.spec.host}')

# Test static content
curl -sk "https://$UI_HOST/" | head -20

# Test API through nginx proxy
curl -sk "https://$UI_HOST/api/v1/namespaces?enabled_only=true"
curl -sk "https://$UI_HOST/api/v1/auth/config"

Quick Fixes

Restart Backend

kubectl rollout restart deployment/rossoctl-backend -n rossoctl-system
kubectl rollout status deployment/rossoctl-backend -n rossoctl-system --timeout=60s

Restart UI

kubectl rollout restart deployment/rossoctl-ui -n rossoctl-system
kubectl rollout status deployment/rossoctl-ui -n rossoctl-system --timeout=60s

Check Nginx Config

kubectl exec -n rossoctl-system deployment/rossoctl-ui -- cat /etc/nginx/nginx.conf

Related Skills

• k8s:pods - Pod troubleshooting
• k8s:logs - Log analysis
• k8s:live-debugging - Live cluster debugging