Recopila registros de Anthos Service Mesh

En las siguientes secciones, se explica cómo recopilar los diversos registros de Anthos Service Mesh para solucionar problemas o comunicarse con el equipo de Atención al cliente de Google.

Recopila registros con la herramienta de informes de errores

Anthos Service Mesh proporciona una herramienta automatizada de informes de errores que recopila los registros de diagnóstico relevantes y te permite adjuntar los registros a un ticket de Atención al cliente de Google.

Antes de comenzar, asegúrate de que tu contexto de kubeconfig esté configurado en el clúster de destino.

Verifica tu contexto con el siguiente comando:

kubectl config current-context

Inicia la recopilación de registros

Para iniciar la recopilación de registros, ejecuta la herramienta de informe de errores con el siguiente comando:

istioctl bug-report

Sube tu archivo de depuración

La herramienta crea un archivo de los registros y la configuración de la malla en el directorio de trabajo. Puedes descomprimir el archivo y usar las guías de solución de problemas para intentar solucionar el problema por tu cuenta. Sin embargo, si tienes un paquete de asistencia, puedes comunicarte con el equipo de Asistencia de Google Cloud, que te proporcionará más pasos para subir de forma segura el archivo de registro.

Importante: Los registros de archivo pueden contener información de identificación personal (PII) o información privada sobre tus certificados de seguridad. Verifica las leyes locales, las políticas y procedimientos de tu organización para controlar o enviar esa información sensible de manera externa.

Recopila manualmente los registros de Anthos Service Mesh

En lugar de usar la herramienta de informe de errores de Anthos Service Mesh, en esta sección, se explica cómo recopilar manualmente todos los registros relevantes.

Registros de acceso de Envoy

Los registros de acceso al proxy de Envoy contienen información detallada que es útil para la solución de problemas. Sin embargo, debes habilitarlos y configurar el nivel de detalle correcto.

Si deseas obtener detalles para interpretar el contenido del registro, consulta Interpreta los registros de Envoy.

Habilita o inhabilita los registros de Envoy

A fin de habilitar los registros de acceso del proxy de Envoy, configura un archivo de superposición para Anthos Service Mesh en el clúster o un ConfigMap para Anthos Service Mesh administrado.

Aumenta el detalle del registro

Para aumentar temporalmente el nivel de detalle de los registros, usa el siguiente comando. Esta configuración se deshace cuando se vuelve a crear el Pod.

kubectl -n NAMESPACE exec POD_NAME -c istio-proxy -- curl -X POST http://localhost:15000/logging?level=info

Escribe los registros de Envoy en una carpeta

Para recopilar los registros de acceso del proxy de Envoy y almacenarlos en una carpeta, usa el siguiente comando:

kubectl logs -l app=APPLICATION_NAME -c istio-proxy > /FILE_PATH

Consulta Obtén los registros de acceso de Envoy para obtener más información.

Registros de Kubernetes

Kubernetes genera varios registros que contienen información sobre el comportamiento de los componentes de Istio, como istiod, puerta de enlace de entrada y proxies. Puedes revisar estos registros para ver si hay errores, lo que podría reducir el permiso de las posibles causas de un problema.

Captura los registros de istiod mediante el siguiente comando:

kubectl -n istio-system logs $(kubectl -n istio-system get pods -lapp=istiod -oname) > ./LOGS_FOLDER/istiod.log

Captura los registros de la puerta de enlace de entrada de Istio con el siguiente comando:

kubectl -n istio-system logs $(kubectl -n istio-system get pods -lapp=istio-ingressgateway -oname) > /FILE_PATH

Captura los registros del proxy de Istio con el siguiente comando:

kubectl -n WORKLOAD_NAMESPACE logs POD_NAME -c istio-proxy > ./LOGS_FOLDER/proxy.log

Volcado de configuración de Kubernetes

Esta información permite a los usuarios sin acceso directo al clúster ver el estado de varios recursos e identificar posibles problemas de configuración. El siguiente comando escribe la configuración de Kubernetes en un archivo YAML:

for namespace in "istio-system" "ns1" "ns2"; do kubectl get -oyaml deploy,statefulset,job,ingress,endpoints,configmap,event,secret,service,istio-io > ./LOGS_FOLDER/kubernetes.log; done

Volcado de memoria de Envoy

Los volcados de memoria de Envoy no suelen ser útiles para los usuarios finales. Sin embargo, es posible que el equipo de Atención al cliente de Google te solicite que los recopiles como parte del proceso de solución de problemas con los siguientes pasos.

Importante: Los volcados de memoria pueden contener información de identificación personal (PII) o información privada sobre tus certificados de seguridad. Consulta las leyes locales y las políticas y procedimientos de la organización sobre cómo manejar o enviar esa información sensible de forma externa.

Advertencia: La configuración de un volcado de núcleo de Envoy es una configuración para todo el nodo. Esta función solo debe habilitarse para la depuración y, luego, desactivarse cuando hayas terminado la depuración. Los volcados de núcleo de Envoy no deben dejarse a largo plazo.

Para configurar el kernel a fin de escribir volcados de núcleo de Envoy en un directorio con permisos de escritura, haz lo siguiente:

1. Agrega la etiqueta sidecar.istio.io/enableCoreDump=true a un Pod.

2. Reinicia el Pod para habilitar los volcados principales de Envoy.

3. Copia el volcado del núcleo del Pod.

Configuración del proxy de Envoy

La configuración detallada del proxy Envoy contiene detalles adicionales que podrían ser útiles para solucionar problemas. Puedes recopilar esta información con el siguiente comando. En este ejemplo, ENDPOINT es uno de los siguientes (se muestra en orden de importancia):

• /certs
• /clusters
• /listeners
• /config_dump
• /memory
• /server_info
• /stats/prometheus
• /runtime

kubectl exec -i POD_NAME -c istio-proxy -n NAMESPACE curl 127.0.0.1:15000/ENDPOINT > out.log