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

En esta página se describen las estrategias habituales para solucionar problemas de Cloud Run. Personalized Service Health publica todos los incidentes de Cloud Run que se derivan de la infraestructura Google Cloud subyacente para identificar las interrupciones del servicio Google Cloud que afectan a tus proyectos. También deberías configurar alertas sobre eventos de estado del servicio personalizado. Para obtener información sobre los incidentes que afectan a todos los servicios de Google Cloud , consulta el panel de control Google Cloud Estado del servicio.

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 la sección Pasos siguientes.

Generar registros de calidad con Cloud Logging

Es más fácil solucionar problemas de tu recurso de Cloud Run si tienes buenos registros para depurar. Debes escribir los registros de forma que se correlacionen los registros de tu contenedor con un registro de solicitudes.

Con los registros correlacionados, puede 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 el artículo Escribir registros de contenedores.

Investigar instancias con el explorador de registros

Cada registro de solicitudes de Cloud Run contiene un campo instanceId que identifica una instancia que gestiona tu solicitud. En función del valor de simultaneidad que especifiques, una sola instancia puede gestionar varias solicitudes al mismo tiempo.

Si tienes varias instancias que emiten registros a la vez, debes filtrar las instancias para identificar las solicitudes secuenciales que provocan un fallo en una instancia.

Filtrar una instancia te permite depurar problemas de rendimiento específicos relacionados con los arranques en frío o el aumento de la latencia. Estos problemas también podrían estar vinculados a variables declaradas en un ámbito global, cuando el valor se reutiliza en solicitudes simultáneas posteriores. Por ejemplo, cuando creas un objeto global de grupo de conexiones para la instancia y, después, 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, ve a la página Explorador de registros:

    Ir a Explorador de registros

  2. Selecciona un Google Cloud proyecto en la parte superior de la página o crea uno.

  3. Selecciona el recurso Revisión de Cloud Run de un servicio o Tarea de Cloud Run de una tarea.

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

  5. Haga clic en el valor del ID de instancia y seleccione Mostrar entradas coincidentes.

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

Resolver latencias de solicitudes inesperadas

Si tienes problemas de latencia, haz lo siguiente:

  1. Comprueba 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 con Cloud Monitoring sin necesidad de configurar ni instalar nada.

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

    1. En la Google Cloud consola, 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 de control 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 las solicitudes.

    Para ver una lista de todas las métricas de Cloud Run disponibles y obtener información más detallada, consulta las Google Cloud métricas de Cloud Monitoring.

  2. Identifica la solicitud con una latencia alta para comprender el origen de la latencia. Puedes usar Cloud Trace o Cloud Logging para saber cuánto ha tardado una solicitud concreta.

    Para identificar las solicitudes con una latencia alta mediante Cloud Logging, aplica el filtro traceSampled=true para correlacionar los registros de Cloud Logging con las trazas de 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 provocar problemas de latencia. Para identificar estas solicitudes, debes tener un registro explícito de las solicitudes. Si no generas estos registros, podría parecer que hay un problema de latencia originado en un servicio de Cloud Run.

    Además, debes evaluar los picos de latencia en el contexto del periodo elegido. La importancia de un pico es relativa: un pico grande en una ventana pequeña puede ser insignificante en una ventana más grande, y viceversa. Por lo tanto, el periodo influye significativamente en la interpretación de los datos de latencia.

  3. Prueba a aumentar el número de instancias mínimas para reducir la latencia de las solicitudes entrantes y evitar los arranques en frío. También deberías modificar el código fuente y ajustar la configuración de escalado para limitar el número de conexiones a un servicio de respaldo.

    Para obtener más información, consulta el artículo Optimizar el rendimiento.

Solucionar problemas con la ayuda de Gemini

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

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

  1. Asegúrate de que Gemini Cloud Assist esté configurado en 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 Cloud Run de la Google Cloud consola.

    Ir a Cloud Run

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

  5. Haz clic en spark. Abrir o cerrar el chat de IA de Gemini

    Se abre el panel de Gemini.

  6. Si es necesario, haz clic en Aceptar si estás de acuerdo con los términos.

  7. Si tienes alguna 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 de la consola y el proyecto actuales.

  8. Escribe una petición en el panel Gemini.

    En la siguiente tabla se muestran algunas peticiones de ejemplo para usar Gemini Cloud Assist con Cloud Run.

    Petición Tipo de respuesta
    "¿Puedes explicarme este mensaje de error que aparece en los registros de mi contenedor de Cloud Run?" Si no se incluye un mensaje de error específico en la petición, la salida proporciona instrucciones para solucionar problemas relacionados con mensajes de error habituales de los registros de contenedores de Cloud Run.
    "¿Puedes explicarme este mensaje de error que aparece 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 solucionarlo.
    "¿Cómo puedo solucionar el siguiente mensaje de error al implementar mi servicio de Cloud Run?

    HTTP 404: Not found     		Causas habituales del error y cómo solucionarlo.
    "Mi servicio de Cloud Run falla continuamente. ¿Cuál podría ser la causa?" Enfoque para investigar la causa y cómo abordar el problema.
    "¿Cómo puedo saber si un error 5XX que ha aparecido en los registros se ha debido a una interrupción del servicio de infraestructura de Google?" Pasos para determinar la causa del error 5XX.
    "¿Cómo puedo identificar la causa de este error: com.google.apps.framework.request.BadRequestException Project PROJECT has serving status SYSTEM_DISABLED and cannot be modified?" Indica que el Google Cloud proyecto se ha inhabilitado administrativamente a nivel de sistema. Se indican los pasos para investigar más a fondo la causa.
    "¿Por qué puedo acceder a mi servicio de Cloud Run desde un navegador si he definido ingress=internal?" Explicación del comportamiento esperado al configurar el ajuste ingress en internal. Incluye otros casos en los que parece que se puede acceder desde tu navegador.

Para obtener más información, consulta los siguientes recursos:

Usar Gemini Cloud Assist Investigations

Además de las conversaciones interactivas, Gemini Cloud Assist puede realizar análisis más automatizados y detallados mediante las investigaciones de Gemini Cloud Assist. Esta función se integra directamente en flujos de trabajo como Explorador de registros y es una potente herramienta de análisis de causas raíz.

Cuando inicias una investigación a partir de un error o un recurso específico, Gemini Cloud Assist analiza los registros, las configuraciones y las métricas. Utiliza estos datos para generar observaciones e hipótesis ordenadas sobre las causas raíz probables y, a continuación, te proporciona los pasos que te recomendamos seguir. También puedes transferir estos resultados a un caso de asistencia para proporcionar un contexto valioso que te ayude a resolver el problema más rápidamente. Google Cloud

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

Siguientes pasos

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