Resuelve los problemas de administración del tráfico en Cloud Service Mesh

En esta sección, se explican los problemas comunes de Cloud Service Mesh y cómo solucionarlos. Si necesitas asistencia adicional, consulta Obtén asistencia.

Errores de conexión del servidor de la API en los registros de istiod

Istiod no puede comunicarse con apiserver si ves errores similares a los siguientes:

error k8s.io/client-go@v0.18.0/tools/cache/reflector.go:125: Failed to watch *crd.IstioSomeCustomResource`…dial tcp 10.43.240.1:443: connect: connection refused

Puedes usar la string de expresión regular /error.*cannot list resource/ para encontrar este error en los registros.

Por lo general, este error es transitorio y si accediste a los registros del proxy mediante kubectl, es posible que el problema ya esté resuelto. Por lo general, este error se debe a eventos que hacen que el servidor de la API no esté disponible temporalmente, como cuando se reinicia un servidor de la API que no se encuentra en una configuración de alta disponibilidad para un cambio de actualización o de ajuste de escala automático.

El contenedor istio-init falla

Este problema puede ocurrir cuando las reglas de iptables del Pod no se aplican al espacio de nombres de red del Pod. Esto puede deberse a lo siguiente:

  • Una instalación de istio-cni incompleta
  • Permisos insuficientes de pods de cargas de trabajo (falta el permiso CAP_NET_ADMIN)

Si usas el complemento de CNI de Istio, verifica que hayas seguido las instrucciones por completo. Verifica que el contenedor istio-cni-node esté listo y revisa los registros. Si el problema persiste, establece una shell segura (SSH) en el nodo host y busca en los registros del nodo los comandos nsenter para ver si hay algún error presente.

Si no usas el complemento de CNI de Istio, verifica que el Pod de la carga de trabajo tenga el permiso CAP_NET_ADMIN, que el inyector de sidecar configura de forma automática.

Se rechazó la conexión después de que se inició el Pod

Cuando se inicia un Pod y connection refused intenta conectarse a un extremo, el problema puede ser que el contenedor de la aplicación se inició antes del contenedor isto-proxy. En este caso, el contenedor de la aplicación envía la solicitud a istio-proxy, pero la conexión se rechaza porque istio-proxy aún no escucha en el puerto.

En ese caso, puede hacer lo siguiente:

  • Modifica el código de inicio de tu aplicación para realizar solicitudes continuas al extremo de estado istio-proxy hasta que la aplicación reciba un código 200. El extremo de estado istio-proxy es el siguiente:

    http://localhost:15020/healthz/ready
    
  • Agrega un mecanismo de solicitud de reintento a la carga de trabajo de tu aplicación.

La lista de puertas de enlace muestra resultados vacíos

Síntoma: Cuando enumeras las puertas de enlace con kubectl get gateway --all-namespaces después de crear correctamente una puerta de enlace de Cloud Service Mesh, el comando devuelve No resources found.

Este problema puede ocurrir en GKE 1.20 y versiones posteriores, ya que el controlador de puerta de enlace de GKE instala de forma automática el recurso Gateway.networking.x-k8s.io/v1alpha1 de GKE en clústeres. Para solucionar el problema, haz lo siguiente:

  1. Verifica si hay varios recursos personalizados de puerta de enlace en el clúster:

    kubectl api-resources | grep gateway
    

    Salida de ejemplo:

    gateways                          gw           networking.istio.io/v1beta1            true         Gateway
    gatewayclasses                    gc           networking.x-k8s.io/v1alpha1           false        GatewayClass
    gateways                          gtw          networking.x-k8s.io/v1alpha1           true         Gateway

  2. Si la lista muestra entradas distintas de las puertas de enlace con apiVersion networking.istio.io/v1beta1, usa el nombre completo del recurso o los nombres cortos distintos en el comando kubectl. Por ejemplo, ejecuta kubectl get gw o kubectl get gateways.networking.istio.io en lugar de kubectl get gateway para asegurarte de que se muestren las puertas de enlace de Istio.

Para obtener más información sobre este problema, consulta Puertas de enlace de Kubernetes y Puertas de enlace de Istio.

El proxy de Envoy se bloquea durante la inicialización

Si los registros de depuración indican que el proxy de Envoy se detiene durante la inicialización, puedes usar el siguiente comando para identificar qué está bloqueando el proceso:

kubectl -n <ns> -c istio-proxy exec -it POD_NAME -- /usr/local/bin/pilot-agent request POST /init_dump

Soluciona problemas de errores de respuesta HTTP 5xx

Es posible que encuentres errores de respuesta HTTP 5xx cuando accedas a las aplicaciones a través de la puerta de enlace de entrada de Istio. Sigue estos pasos para diagnosticar y resolver el problema.

  1. Identifica el plano de control
  2. Verifica posibles parámetros de configuración incorrectos
  3. Verifica el descubrimiento de Pods
  4. Analiza los registros de acceso

Identificar el plano de control

Determina la versión y la configuración del plano de control, ya que las diferentes versiones pueden influir en los procesos de diagnóstico. Para verificar el estado del plano de control administrado, ejecuta el siguiente comando:

gcloud container fleet mesh describe --project PROJECT_ID

Un estado ACTIVE indica que el plano de control administrado se ejecuta con normalidad.

Verifica posibles parámetros de configuración incorrectos

Las configuraciones incorrectas comunes pueden provocar fallas de enrutamiento:

  • No coinciden los espacios de nombres: El VirtualService debe estar en el mismo espacio de nombres que el servicio de GKE de backend.
  • No coinciden las referencias de la puerta de enlace: El VirtualService debe hacer referencia de forma explícita al Gateway correcto. Por ejemplo, si el VirtualService hace referencia a istio-system/istio-ingressgateway, pero la puerta de enlace está en el espacio de nombres default, el tráfico no se enrutará correctamente.

Verifica el descubrimiento de pods

Asegúrate de que la malla descubra correctamente el Pod de la aplicación:

istioctl proxy-config endpoints POD_NAME

Analiza los registros de acceso

Habilita los registros de acceso para determinar si los errores se originan en la aplicación de backend o en el proxy. Los campos clave incluyen RESPONSE_FLAGS, UPSTREAM_LOCAL_ADDRESS y RESPONSE_CODE.

Si los registros indican errores ascendentes, realiza una prueba de curl directa al servicio de GKE desde un Pod en el mismo espacio de nombres. Si la solicitud curl devuelve el mismo error 5xx, el problema se origina en la aplicación de backend.

Soluciona problemas con los certificados SSL

Los errores de certificado SSL en la puerta de enlace de entrada de Istio pueden deberse a certificados vencidos, discordancias de protocolo o parámetros de configuración de secretos incorrectos.

Identifica errores de SSL

Revisa los registros del Pod de la puerta de enlace de entrada de Istio:

kubectl logs -l app=istio-ingressgateway -n GATEWAY_NAMESPACE

Verifica certificados y claves

Asegúrate de que el certificado y la clave privada sean válidos y coincidan con los hashes MD5:

openssl x509 -noout -modulus -in CERTIFICATE.CRT | openssl md5
openssl rsa -noout -modulus -in PRIVATE_KEY | openssl md5

Confirma que el certificado no haya vencido y que el nombre común (CN) o el nombre alternativo del sujeto (SAN) coincidan con el dominio.

Verifica el protocolo TLS y la configuración del Secret

Verifica la versión de TLS y los conjuntos de algoritmos de cifrado en la CRD Gateway. Asegúrate de que el secreto de Kubernetes que contiene el certificado y la clave esté en el mismo espacio de nombres que la puerta de enlace de Ingress y que el credentialName coincida con el nombre del secreto.

Soluciona problemas de tiempos de espera intermitentes en extremos externos

Pueden producirse tiempos de espera intermitentes cuando se realizan solicitudes a extremos externos (como NLB de terceros) que se resuelven en varias direcciones IP.

Causa potencial: Resolución de ServiceEntry

Si spec.resolution se establece en DNS, Istio usa un "DNS estricto", que balancea las cargas en todas las direcciones IP resueltas. Algunos NLB no admiten esta opción.

Solución

Para resolver este problema, establece la resolución en DNS_ROUND_ROBIN en ServiceEntry.

Soluciona problemas de tiempos de espera o picos de latencia escalonados

Pueden producirse tiempos de espera intermitentes, errores 503 con marcas de respuesta UF o aumentos repentinos de latencia cuando se registran varios clústeres en la misma flota.

Causa potencial: Detección de extremos entre clústeres mal configurada

La administración automática habilita el descubrimiento de extremos entre clústeres (multicluster_mode: connected) de forma predeterminada. Cuando varios clústeres de la misma flota tienen esta opción habilitada, se balancea la carga del tráfico entre ellos, lo que agota el tiempo de espera si no se configuran las reglas de firewall de la nube privada virtual (VPC) entre los clústeres.

Solución

Para resolver este problema, inhabilita el descubrimiento de extremos de varios clústeres en clústeres independientes o abre reglas de firewall de Pod a Pod. Para obtener más detalles, consulta Tiempos de espera entre clústeres, latencia alta o tráfico inesperado entre clústeres.

Soluciona problemas de distribución de tráfico desigual

Si el tráfico no se distribuye de manera uniforme entre los Pods de la aplicación, verifica lo siguiente:

  • Estado de los Pods: Asegúrate de que todos los Pods de la aplicación estuvieran en buen estado durante el desequilibrio.
  • Algoritmo de balanceo de cargas: Revisa la configuración de DestinationRule para el parámetro loadBalancer (p.ej., consistentHash o ROUND_ROBIN).
  • Balanceo de cargas de localidad: Verifica si localityLbSetting está habilitado. Ten en cuenta que esto no es compatible con el plano de control de TRAFFIC_DIRECTOR.

Soluciona problemas de propagación de servicios y cuotas

Si los servicios o las configuraciones de red nuevos no se reflejan en la malla, es posible que se deba a que se alcanzaron las cuotas de recursos en el proyecto de flota.

Síntomas

  • Las opciones de configuración de red (como VirtualService o DestinationRule) no se envían a los proxies sidecar.
  • Los servicios nuevos aparecen como "invisibles" para la malla, a pesar de estar definidos correctamente.

Pasos para identificar y resolver problemas

  1. Verifica las cuotas de recursos: Comprueba si el proyecto de la flota alcanzó su cuota para los recursos de BackendService. Para ello, verifica la cuota de servicios de backend de Traffic Director interno global en el proyecto de la flota. Por lo general, Cloud Service Mesh crea un BackendService por puerto de servicio de Kubernetes.
  2. Revisa las limitaciones de escalamiento: Asegúrate de que tu configuración se mantenga dentro de las limitaciones de escalamiento admitidas para Cloud Service Mesh.
  3. Aumenta las cuotas: Si se alcanzaron las cuotas, solicita un aumento para el recurso afectado en el proyecto de flota para restablecer la propagación normal del servicio.

Soluciona problemas de la evaluación de VirtualService

Si una VirtualService no se comporta como se espera, recuerda que las rutas se evalúan en el orden en que se enumeran. Cuando tienes varios servicios virtuales para el mismo host, sus rutas se combinan. Las rutas de los servicios virtuales "más antiguos" se priorizan y, por lo tanto, se colocan antes de las rutas de los "más nuevos" en la lista combinada. Esto refuerza la regla de "primera coincidencia".

Soluciona problemas del balanceo de cargas de localidad

De forma predeterminada, el balanceo de cargas de localidad dirige el tráfico de los clientes a los extremos de la misma zona (la zona principal o prioridad 0). Envoy solo enruta el tráfico a las zonas de conmutación por error (prioridad 1 o superior) cuando los extremos de la zona principal están en mal estado o no están disponibles.

Si no escalas tus extremos para controlar toda la carga zonal o si prefieres dividir el tráfico entre zonas, realiza una de las siguientes acciones:

  • Escala los Pods en las zonas respectivas para controlar la carga de tráfico local.
  • Inhabilita el parámetro de configuración de balanceo de cargas de localidad.

Identificar la configuración del balanceo de cargas de localidad

El balanceo de cargas de localidad se basa en las etiquetas de topología de nodos para agrupar los extremos. Para verificar las etiquetas de los nodos y comprobar la configuración, usa los siguientes comandos:

  • Verifica las etiquetas de topología de los nodos:

    kubectl get nodes -o custom-columns=NAME:.metadata.name,\
        REGION:.metadata.labels."topology\\.kubernetes\\.io/region",\
        ZONE:.metadata.labels."topology\\.kubernetes\\.io/zone"
    
  • Para las DestinationRules de GKE, inspecciona la configuración de localidad:

    kubectl get destinationrule DESTINATION_RULE_NAME -o yaml
    

    Busca localityLbSetting: enabled: true en el resultado.

  • Para verificar los extremos, las prioridades y el estado del proxy de Envoy, haz lo siguiente:

    istioctl proxy-config endpoints POD_NAME.NAMESPACE \
        --cluster "outbound|PORT||SERVICE_FQDN" -o json
    

    Busca el campo priority en la configuración del extremo.

  • Para ver la configuración detallada de los clústeres activos, haz lo siguiente:

    istioctl proxy-config cluster POD_NAME.NAMESPACE \
        --fqdn SERVICE_FQDN -o json