Introducción a la solución de problemas de Cloud Run

En esta página, se describen las estrategias comunes de solución de problemas para los errores de Cloud Run. Personalized Service Health publica todos los incidentes de Cloud Run que se originan en la infraestructura Cloud de Confiance by S3NS subyacente para identificar las interrupciones del servicio Cloud de Confiance by S3NS que afectan tus proyectos. También debes considerar configurar alertas sobre los eventos de Personalized Service Health. Para obtener información sobre los incidentes que afectan a todos los servicios de Cloud de Confiance by S3NS , consulta el panel de Cloud de Confiance by S3NS Service Health.

Consulta las siguientes secciones de la guía de solución de problemas de Cloud Run para resolver problemas relacionados con tu recurso de Cloud Run:

Estrategias para solucionar problemas de Cloud Run

En las siguientes secciones, se explica cómo puedes aplicar estrategias generales de solución de problemas para resolver el error. Si sigues teniendo problemas incluso después de seguir los pasos de la guía de solución de problemas, consulta Próximos pasos.

Genera registros adecuados con Cloud Logging

Solucionar problemas de tu recurso de Cloud Run es más fácil si tienes buenos registros para la depuración. Debes escribir los registros de manera que correlacionen los registros de contenedores con un registro de solicitudes.

Con los registros correlacionados, puedes identificar la solicitud que necesita más análisis, encontrar el registro de la solicitud y analizar la causa raíz del problema. Para obtener más información sobre cómo escribir registros, consulta Escribe registros de contenedores.

Investiga instancias con el Explorador de registros

Cada registro de solicitud en Cloud Run contiene un campo instanceId que identifica una instancia que controla tu solicitud. Según el valor de simultaneidad que especifiques, una sola instancia puede controlar varias solicitudes al mismo tiempo.

Cuando tienes varias instancias que emiten registros a la vez, debes filtrar tus instancias para identificar las solicitudes secuenciales que provocan una falla en una instancia.

Filtrar una instancia te permite depurar problemas de rendimiento específicos relacionados con inicios en frío o latencias mayores. Estos problemas también podrían estar vinculados a variables declaradas en un alcance global, cuando el valor se reutiliza en solicitudes simultáneas posteriores. Un ejemplo de esto es cuando creas un solo objeto global de grupo de conexiones para la instancia y, luego, lo usas en varias solicitudes.

Para filtrar una instancia específica en el Explorador de registros, sigue estos pasos:

  1. En la consola de Cloud de Confiance , ve a la página Explorador de registros:

    Ve al Explorador de registros

  2. Selecciona un proyecto Cloud de Confiance by S3NS existente en la parte superior de la página o crea un proyecto nuevo.

  3. Selecciona el recurso Revisión de Cloud Run para un servicio o Trabajo de Cloud Run para un trabajo.

  4. Expande una entrada de registro para filtrar por una instancia específica.

  5. Haz clic en el valor del ID de la instancia y selecciona Mostrar entradas coincidentes.

Mientras investigas las instancias, puedes usar las investigaciones de Gemini Cloud Assist para obtener estadísticas adicionales sobre tus registros. Para obtener más información sobre las diferentes formas de iniciar una investigación con el Explorador de registros, consulta Soluciona problemas con las Investigaciones de Gemini Cloud Assist en la documentación de Gemini.

Cómo resolver latencias de solicitudes inesperadas

Si tienes problemas de latencia, haz lo siguiente:

  1. Verifica si la latencia afecta todas las solicitudes a tu recurso de Cloud Run o solo un pequeño porcentaje. Cloud Run se integra automáticamente en Cloud Monitoring sin necesidad de configuración o instalación.

    Para ver las métricas de latencia de solicitudes individuales, sigue estos pasos:

    1. En la consola de Cloud de Confiance , ve a la página de Cloud Run:

      Ir a Cloud Run

    2. Selecciona un servicio o un trabajo de las listas disponibles en la navegación de la izquierda.

    3. Haz clic en la pestaña MÉTRICAS para mostrar el panel de Latencias de solicitudes.

    Para ver las métricas de latencia en Cloud Monitoring, selecciona Revisión de Cloud Run > Request_latencies > Latencia de solicitud en la lista Métricas.

    Para obtener una lista de todas las métricas disponibles de Cloud Run y detalles más detallados, consulta Cloud de Confiance by S3NS métricas en Cloud Monitoring.

  2. Identifica la solicitud con latencia alta para comprender la fuente de la latencia. Puedes usar Cloud Trace o Cloud Logging para comprender cuánto tiempo tardó una solicitud en particular.

    Para identificar las solicitudes con alta latencia con Cloud Logging, aplica el filtro traceSampled=true para correlacionar los registros en Cloud Logging con los seguimientos en Cloud Trace. Para obtener más información, consulta Integración con Cloud Logging.

    A veces, las dependencias, como las solicitudes a otros servicios, pueden causar problemas de latencia. Para identificar esas solicitudes, debes tener un registro explícito que las segmente. Si no generas esos registros, podría parecer que hay un problema de latencia que se origina en un servicio de Cloud Run.

    Además, debes considerar la evaluación de los picos de latencia en el contexto del período elegido. La importancia de un pico es relativa; un pico grande en una ventana pequeña podría ser insignificante en una ventana más grande, y viceversa. Por lo tanto, el período afecta significativamente la interpretación de los datos de latencia.

  3. Intenta aumentar la cantidad de instancias mínimas para reducir la latencia de las solicitudes entrantes y evitar los inicios en frío. También debes considerar modificar tu código fuente y ajustar la configuración de escalamiento para limitar la cantidad de conexiones a un servicio de respaldo.

    Para obtener más información, consulta Optimiza el rendimiento.

Soluciona problemas de conectividad

Si tu servicio de Cloud Run tiene problemas de conectividad, considera estas estrategias y herramientas para diagnosticar el problema:

  • Archivo adicional de PCAP: Para un análisis más detallado a nivel de la red, implementa un archivo adicional de PCAP junto con tu servicio de Cloud Run. Este contenedor sidecar realiza una captura de paquetes con tcpdump dentro del mismo espacio de nombres de red. El sidecar se desacopla del contenedor de entrada principal y no requiere ninguna modificación para realizar una captura de paquetes. Los sidecars también usan sus propios recursos, lo que evita que tcpdump compita con los recursos que asignas al servicio principal.

  • Pruebas de conectividad y estadísticas de red para revisiones de Cloud Run y funciones de Cloud Run: Realiza verificaciones automatizadas en la ruta de red entre tu recurso de Cloud Run y un extremo. Esto te ayuda a encontrar errores de configuración que podrían bloquear el tráfico hacia o desde tu recurso de Cloud Run cuando te conectas a una instancia de VM, una dirección IP o un servicio administrado por Google.

  • Revisa los registros de tu recurso de Cloud Run: Los registros muestran mensajes de error sobre problemas de conexión, como fallas, tiempos de espera o conexiones rechazadas. Estos registros suelen revelar si el problema de conexión se debe a tu aplicación o a la red.

¿Qué sigue?

Si no encuentras una solución a tu problema en la documentación de Cloud Run, sigue estos pasos: