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 errores de Cloud Run. Personalized Service Health publica todos los incidentes de Cloud Run que provienen de la infraestructura subyacente de Google Cloud para identificar las interrupciones del servicio de Google Cloud que afectan tus proyectos. También debes considerar configurar alertas en los eventos de Personalized Service Health. Para obtener información sobre los incidentes que afectan a todos los Google Cloud servicios, consulta el panel de Google Cloud 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 encontrando errores incluso después de seguir los pasos de la guía de solución de problemas, comunícate con el equipo de asistencia.

Genera registros correctos 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 registros de manera que correlaciones los registros de contenedores con un registro de solicitudes.

Con los registros correlacionados, puedes identificar la solicitud que necesita un análisis adicional, 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 Cómo escribir 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 specifiques, 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 la instancia.

Filtrar una instancia te permite depurar problemas de rendimiento específicos relacionados con los inicios en frío o el aumento de la latencia. Estos problemas también podrían estar vinculados a variables declaradas en un alcance global, cuando el valor se vuelve a usar 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 Google Cloud, ve a la página Explorador de registros:

    Ir al Explorador de registros

  2. Selecciona un proyecto Google Cloud 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.

Cómo resolver 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 automáticamente en Cloud Monitoring sin necesidad de configuración.

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

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

      Ir a Cloud Run

    2. Selecciona el servicio o los trabajos de la lista.

    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 la solicitud.

    Para obtener una lista de todas las métricas disponibles de Cloud Run y detalles más detallados, consulta las métricas deGoogle Cloud 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 de Cloud Logging con los seguimientos de Cloud Trace. Para obtener más información, consulta Cómo realizar la 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 segmentado para las solicitudes. Si no generas esos registros, podría aparecer como un problema de latencia que se origina en un servicio de Cloud Run.

    Además, deberías considerar evaluar los aumentos repentinos de latencia en el contexto del intervalo de tiempo elegido. La importancia de un aumento repentino es relativa; un aumento repentino grande en un período pequeño puede ser despreciable en un período 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 con la asistencia de Gemini

Puedes obtener ayuda potenciada por IA en el chat de Gemini Cloud Assist para analizar registros y solucionar errores. 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 consola de Google Cloud, 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 consola de Google Cloud.

    Ir a Cloud Run

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

  5. Haz clic en spark Abrir o cerrar 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, ve a la página que muestra tu recurso antes de formularla para proporcionar contexto. Cuando se genera una respuesta, Gemini incluye información sobre la página y el proyecto de la consola actuales.

  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 explicarme este mensaje de error que veo en los registros de mi contenedor de Cloud Run?" Sin un mensaje de error específico en la instrucción, el resultado proporciona orientación para solucionar problemas relacionados con mensajes de error comunes de los registros de contenedores de Cloud Run.
    "¿Puedes explicarme este mensaje de error que veo en los 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 abordarlo.
    "¿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 en 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: