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 Google Cloud subyacente para identificar las interrupciones del servicio Google Cloud 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 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 tu 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

Es más fácil solucionar problemas de tu recurso de Cloud Run si tienes buenos registros para la depuración. Debes escribir los registros de manera que correlacionen los registros de tu contenedor 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 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 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.

Cómo 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 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 de 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 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 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 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 registre. 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 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 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 usar el chat de Gemini Cloud Assist para analizar registros y solucionar problemas de 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 ahorra tiempo y esfuerzo valiosos.

Para usar Gemini Cloud Assist desde la Google Cloud consola, 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 proyecto Google Cloud 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.

    Ir a Cloud Run

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

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

    Se abrirá el panel de Gemini.

  6. Si es necesario, haz clic en Aceptar si aceptas 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 de la consola y el proyecto actuales.

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

    En la siguiente tabla, se proporcionan algunos ejemplos de instrucciones 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 explicar 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. ¿A qué podría deberse?" 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 proyecto Google Cloud se inhabilitó de forma administrativa a nivel del sistema. Proporciona los pasos para investigar más a fondo la causa.
    "¿Por qué puedo acceder a mi servicio de Cloud Run desde un navegador si configuré ingress=internal?" 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 que funciona 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 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 clasificadas sobre las posibles causas raíz y, luego, te proporciona los próximos pasos recomendados. También puedes transferir estos resultados a un caso de asistencia para proporcionar contexto valioso que te ayude a resolver el problema más rápido. Google Cloud

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 a tu problema en la documentación de Cloud Run, sigue estos pasos: