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-proxyhasta que la aplicación reciba un código 200. El extremo de estadoistio-proxyes el siguiente:http://localhost:15020/healthz/readyAgrega 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:
Verifica si hay varios recursos personalizados de puerta de enlace en el clúster:
kubectl api-resources | grep gatewaySalida 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
Si la lista muestra entradas distintas de las puertas de enlace con
apiVersionnetworking.istio.io/v1beta1, usa el nombre completo del recurso o los nombres cortos distintos en el comandokubectl. Por ejemplo, ejecutakubectl get gwokubectl get gateways.networking.istio.ioen lugar dekubectl get gatewaypara 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.
- Identifica el plano de control
- Verifica posibles parámetros de configuración incorrectos
- Verifica el descubrimiento de Pods
- 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
VirtualServicedebe estar en el mismo espacio de nombres que el servicio de GKE de backend. - No coinciden las referencias de la puerta de enlace: El
VirtualServicedebe hacer referencia de forma explícita alGatewaycorrecto. Por ejemplo, si elVirtualServicehace referencia aistio-system/istio-ingressgateway, pero la puerta de enlace está en el espacio de nombresdefault, 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
DestinationRulepara el parámetroloadBalancer(p.ej.,consistentHashoROUND_ROBIN). - Balanceo de cargas de localidad: Verifica si
localityLbSettingestá habilitado. Ten en cuenta que esto no es compatible con el plano de control deTRAFFIC_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
VirtualServiceoDestinationRule) 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
- 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 unBackendServicepor puerto de servicio de Kubernetes. - 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.
- 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: trueen 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 jsonBusca el campo
priorityen 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