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 Google Cloud subyacente para identificar las Google Cloud 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 Google Cloud servicios, consulta el Google Cloud 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 Google Cloud 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. Google Cloud

  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 Google Cloud 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 Google Cloud 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.

Soluciona problemas con la asistencia de Gemini

Puedes usar el chat de Gemini Cloud Assist para analizar registros y solucionar problemas. Con la asistencia de Gemini, puedes identificar y resolver errores rápidamente aprovechando las capacidades de análisis de registros de la herramienta, lo que te permite ahorrar tiempo y esfuerzo valiosos.

Para usar Gemini Cloud Assist desde la Google Cloud consola de, haz lo siguiente:

  1. Asegúrate de que Gemini Cloud Assist esté configurado para tu Google Cloud cuenta de usuario y proyecto.

  2. Configura tu entorno de desarrollo de Cloud Run en tu Google Cloud proyecto y asegúrate de tener los permisos de implementación adecuados.

  3. Ve a la página de Cloud Run en la Google Cloud consola de.

    Ir a Cloud Run

  4. En la barra de herramientas de la consola, selecciona un Google Cloud proyecto. Usa un proyecto asociado con un ID del proyecto que enviaste después de que se te otorgó acceso a Gemini Cloud Assist.

  5. Haz clic en el ícono de chispa Abrir o cerrar el chat de IA de Gemini.

    Se abrirá el panel de Gemini.

  6. Si es necesario, haz clic en Aceptar si estás de acuerdo con las condiciones.

  7. Si tienes una pregunta sobre una aplicación específica, proporciona contexto. Para ello, ve a la página que muestra tu recurso antes de hacer la pregunta. Cuando genera una respuesta, Gemini incluye información sobre la página y el proyecto actuales de la consola.

  8. Ingresa una instrucción en el panel de Gemini.

    En la siguiente tabla, se proporcionan algunas instrucciones de ejemplo para usar Gemini Cloud Assist con Cloud Run.

    Instrucción Tipo de respuesta
    "¿Puedes explicar este mensaje de error que veo en los registros de contenedores de Cloud Run?" Sin un mensaje de error específico en la instrucción, el resultado proporciona orientación para solucionar problemas de mensajes de error comunes de registros de contenedores de Cloud Run.
    "¿Puedes explicar este mensaje de error que veo en mis registros de mi servicio de Cloud Run?

    HTTP 429 The request was aborted because there was no available instance. The Cloud Run service might have reached its maximum container instance limit or the service was otherwise not able to scale to incoming requests. This might be caused by a sudden increase in traffic, a long container startup time or a long request processing time."    		 Explicación del mensaje de error de Cloud Run y cómo abordar el error.
    "¿Cómo corrijo el siguiente mensaje de error cuando implemento mi servicio de Cloud Run?

    HTTP 404: Not found     		Causas comunes del error y cómo solucionarlo.
    "Mi servicio de Cloud Run sigue fallando. ¿Qué podría estar causando esto?" Enfoque para investigar la causa y cómo abordar el problema.
    "¿Cómo sé si un error 5XX que apareció en los registros se debió a una interrupción del servicio de infraestructura de Google?" Pasos para determinar la causa del error 5XX.
    "¿Cómo identifico la causa de este error: com.google.apps.framework.request.BadRequestException Project PROJECT has serving status SYSTEM_DISABLED and cannot be modified?" Sugiere que el Google Cloud proyecto se inhabilitó de forma administrativa a nivel del sistema. Proporciona pasos para investigar la causa más a fondo.
    "¿Por qué puedo acceder a mi servicio de Cloud Run desde un navegador si configuré ingress=internal?" Una explicación del comportamiento esperado cuando se configura el parámetro ingress como internal. Incluye otras situaciones en las que el acceso podría parecer funcionar desde tu navegador.

Obtén más información en los vínculos siguientes:

Usa las investigaciones de Gemini Cloud Assist

Además del chat interactivo, Gemini Cloud Assist puede realizar análisis más automatizados y detallados a través de las investigaciones de Gemini Cloud Assist. Esta función se integra directamente en flujos de trabajo como el Explorador de registros y es una poderosa herramienta de análisis de causa raíz.

Cuando inicias una investigación desde un error o un recurso específico, Gemini Cloud Assist analiza registros, configuraciones y métricas. Usa estos datos para producir observaciones e hipótesis clasificadas sobre las posibles causas raíz y, luego, te proporciona los próximos pasos recomendados. Si tienes un paquete de asistencia, también puedes transferir los resultados de la investigación a un Google Cloud caso de asistencia, lo que proporciona contexto adicional que puede ayudar a resolver tu caso más rápido.

Para los servicios o las funciones implementadas desde el código fuente, las investigaciones también pueden proporcionar sugerencias de corrección de código en la pestaña "Fuente" de la consola de Cloud Run para ayudarte a resolver problemas de compilación e implementación.

Para obtener más información sobre las diferentes formas de iniciar una investigación, consulta Soluciona problemas con las investigaciones de Gemini Cloud Assist en la documentación de Gemini.

¿Qué sigue?

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