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 provienen de la infraestructura Cloud de Confiance by S3NS subyacente para identificar las Cloud de Confiance by S3NS interrupciones del servicio que afectan tus proyectos. También deberías considerar configurar alertas sobre los eventos de Personalized Service Health. Para obtener información sobre los incidentes que afectan a todos los Cloud de Confiance by S3NS servicios, consulta el Cloud de Confiance by S3NS panel de 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 de solución de problemas de Cloud Run

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

Genera registros correctos con Cloud Logging

Solucionar problemas de tu recurso de Cloud Run es más fácil si tienes registros correctos para la depuración. Debes escribir 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 seguimiento 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 solicitudes en Cloud Run contiene un instanceId campo 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 conducen a una falla de instancia.

Filtrar una instancia te permite depurar problemas de rendimiento específicos relacionados con inicios en frío o latencias aumentadas. 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 Cloud de Confiance consola de, accede a la página Explorador de registros:

    Ir al Explorador de registros

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

  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 instancia y selecciona Mostrar entradas coincidentes.

Mientras investigas 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.

Resuelve latencias de solicitudes inesperadas

Si tienes problemas con la latencia, haz lo siguiente:

  1. Verifica si la latencia afecta a todas las solicitudes a tu recurso de Cloud Run o solo a un pequeño porcentaje. Cloud Run se integra de forma automática en Cloud Monitoring sin necesidad de configurarlo.

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

    1. En la Cloud de Confiance consola de, ve a la página 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 Latencias de solicitudes.

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

    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 solicitudes con latencia alta 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 en 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 oriente. Si no generas esos registros, podría aparecer como un problema de latencia que se origina en un servicio de Cloud Run.

    Además, debes considerar evaluar los aumentos repentinos de latencia en el contexto del período elegido. La importancia de un aumento repentino es relativa; un aumento repentino grande en un período pequeño podría ser insignificante en un período más grande y viceversa. Por lo tanto, el período afecta de manera significativa 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 deberías 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:

  • Sidecar de PCAP: Para un análisis más profundo a nivel de la red, implementa un sidecar 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 de inteligencia de red para Cloud Run revisiones y funciones de Cloud Run: Realiza verificaciones automáticas en la ruta de red entre tu recurso de Cloud Run y un extremo. Esto te ayuda a encontrar configuraciones incorrectas 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 es con tu aplicación o la red.

¿Qué sigue?

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