Supervisa y soluciona problemas con la asistencia de IA

En este documento, se describe cómo puedes usar la asistencia de IA para supervisar y solucionar problemas de tus recursos de Cloud SQL. Puedes usar las herramientas de solución de problemas asistida por IA de Cloud SQL y Gemini Cloud Assist para solucionar problemas de consultas lentas y solucionar problemas de carga alta de la base de datos.

Limitaciones

Se aplican las siguientes limitaciones a la solución de problemas asistida por IA en Cloud SQL:

  • La solución de problemas asistida por IA no es compatible con los siguientes parámetros de configuración de Cloud SQL:
  • La detección de anomalías en las consultas solo está disponible para las instancias de la edición Enterprise Plus de Cloud SQL.

Antes de comenzar

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

    Después de configurar Gemini Cloud Assist, el servicio puede tardar unos minutos en propagarse. Espera a que se complete la propagación antes de habilitar la solución de problemas asistida por IA en Cloud SQL.

  2. Asegúrate de que tu instancia sea de la edición Cloud SQL Enterprise Plus.
  3. Asegúrate de que tu instancia de Cloud SQL use la arquitectura de red nueva.
  4. Habilita las estadísticas de consultas para la edición Cloud SQL Enterprise Plus y la edición Cloud SQL Enterprise.
  5. MYSQL_VERSION.R20250304.00_01 o una versión posterior debe estar instalada en la instancia de Cloud SQL para MySQL. Para obtener más información sobre cómo aplicar versiones de mantenimiento a una instancia, consulta Información sobre el mantenimiento en instancias de Cloud SQL.

Roles y permisos requeridos

Para obtener los permisos que necesitas para usar la solución de problemas asistida por IA, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto que aloja la instancia de Cloud SQL:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para usar la solución de problemas asistida por IA. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para usar la solución de problemas asistida por IA:

  • databaseinsights.performanceIssues.detect
  • databaseinsights.performanceIssues.investigate

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener más información sobre los roles y permisos necesarios para usar las investigaciones de Gemini Cloud Assist, consulta Soluciona problemas con las investigaciones de Gemini Cloud Assist.

Habilita la solución de problemas asistida por IA

Cuando habilitas la solución de problemas asistida por IA para tu instancia de Cloud SQL, Cloud SQL puede analizar el rendimiento de tus bases de datos y detectar anomalías en la ejecución de tus consultas. Cuando Cloud SQL detecta anomalías en el rendimiento de las consultas o identifica una carga alta del sistema, la solución de problemas asistida por IA te ayuda a analizar la situación con evidencia y proporciona recomendaciones.

Para habilitar la solución de problemas asistida por IA en tu instancia de Cloud SQL, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. En el campo Configuración, haz clic en Editar configuración.
  4. En la sección Personaliza tu instancia, expande Estadísticas de consultas.
    1. Si aún no está seleccionada, elige Habilitar Estadísticas de consultas.
    2. Solo para la edición Cloud SQL Enterprise Plus, si aún no está seleccionada, elige Habilitar las funciones de Enterprise Plus.
  5. Solo para la edición Enterprise Plus de Cloud SQL, selecciona Habilitar la solución de problemas asistida por IA. En el caso de las instancias de Cloud SQL Enterprise, la solución de problemas con la asistencia de IA solo está disponible si habilitas Gemini Cloud Assist.
  6. Haz clic en Guardar.
  7. Para obtener los mejores resultados, espera 24 horas después de habilitar la solución de problemas asistida por IA en la consola de Google Cloud para permitir que Cloud SQL cree un modelo de referencia del rendimiento promedio de tu instancia, base de datos y consultas.

Debes reiniciar la instancia. Para obtener más información sobre cómo habilitar las Estadísticas de consultas para la edición Cloud SQL Enterprise Plus, consulta Usa las Estadísticas de consultas para mejorar el rendimiento de las consultas.

Abrir Gemini Cloud Assist

Para usar Gemini Cloud Assist con Cloud SQL, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. En el panel de navegación, selecciona Estadísticas de consultas.
  4. Para abrir el panel de Cloud Assist, haz clic en Abrir o cerrar el chat de Gemini Cloud Assist.
  5. En el panel de Cloud Assist, ingresa una instrucción que describa la información que te interesa.
  6. Después de ingresar la instrucción, haz clic en Enviar instrucción.

    Gemini devuelve una respuesta a tu instrucción en función de la información de la última hora.

Soluciona problemas de consultas lentas

Para usar la asistencia de IA y solucionar problemas de consultas lentas, ve al panel de Estadísticas de consultas de tu instancia de Cloud SQL en la consola de Google Cloud .

Tabla de consultas principales

Puedes comenzar a solucionar problemas de consultas lentas con la asistencia de IA en la sección Tabla de consultas principales del panel Estadísticas de consultas.

Cloud SQL puede ayudarte a identificar qué consultas se ejecutan con más lentitud que el promedio durante un período de detección específico. Después de seleccionar un período en el panel Estadísticas de consultas, Cloud SQL verifica si alguna consulta se ejecuta más lento que el promedio con un período de detección de 24 horas antes del final del período seleccionado.

Cuando ajustas el filtro de intervalo de tiempo del gráfico Carga de la base de datos o cualquier otro filtro, como la base de datos o el usuario, Cloud SQL actualiza la tabla de consultas principales y vuelve a ejecutar la detección de anomalías según la lista nueva de consultas y un período de detección actualizado.

En el caso de las instancias de la edición Enterprise Plus de Cloud SQL, ocurre lo siguiente cuando Cloud SQL detecta una anomalía:

Si una consulta se ejecuta más lento de lo esperado, se muestra un ícono de Advertencia warning_spark. Cuando haces clic en cualquiera de los íconos, se usa Gemini Cloud Assist para ayudar a analizar la ejecución de la consulta y ofrece observaciones sobre lo que podría haber causado cualquier problema. En función de estas observaciones, Gemini Cloud Assist genera una hipótesis que puede ayudarte a abordar el problema.

Para solucionar problemas de consultas lentas en la tabla Consultas principales en el panel Estadísticas de consultas, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. En el menú de navegación de SQL, haz clic en Estadísticas de consultas.
  4. En el gráfico Consultas ejecutadas, usa el filtro Período para seleccionar 1 hora, 6 horas, 1 día, 7 días, 30 días o un intervalo personalizado.
  5. En la tabla Consultas principales, en la pestaña Consultas, revisa la lista de consultas de tu base de datos.
  6. Si aparece un ícono de Advertencia warning_spark junto al valor de Tiempo de ejecución promedio (ms) de una consulta, Cloud SQL detectó una anomalía en el rendimiento de la consulta. Cloud SQL verifica si hay anomalías en el período de 24 horas que transcurre antes del final del período que seleccionaste.
  7. Haz clic en el ícono de Advertencia warning_spark.
  8. En el diálogo La consulta es más lenta de lo habitual, haz clic en Nueva investigación para comenzar a solucionar problemas con la asistencia de IA de Gemini Cloud Assist. Después de unos dos minutos, se abrirá el panel Detalles de la investigación con las siguientes secciones:
    • Problema. Una descripción del problema que se está investigando, incluidas las horas de inicio y finalización de la investigación.
    • Observaciones. Una lista de observaciones sobre el problema. Por ejemplo, pueden incluir detalles de contención de bloqueo, como una proporción de espera de bloqueo más larga de lo esperado para la consulta.
    • Hipótesis. Una lista de acciones recomendadas por la IA que puedes realizar para ayudar a solucionar la consulta de ejecución lenta.

  9. Si quieres ver todas las investigaciones asociadas con la consulta, en el diálogo La consulta es más lenta de lo habitual, haz clic en Ver todas las investigaciones. Se abrirá la página de Gemini Cloud Assist, en la que podrás ver todas las investigaciones que se están ejecutando y las que ya se completaron. Puedes filtrar la página por proyecto o etiqueta, por ejemplo, para encontrar la investigación específica que necesitas.

    Como alternativa, para ver todas las investigaciones anteriores, haz clic en el ícono de Notificaciones y, luego, selecciona una notificación asociada con cualquier investigación para abrir la página de Gemini Cloud Assist.

  10. Como alternativa, si quieres investigar la latencia de cualquier consulta, completa los siguientes pasos:
    1. Identifica la consulta específica que quieres investigar.
    2. En la columna Acciones, haz clic en el ícono Acciones asociado con esa consulta.
    3. Selecciona Investigar la latencia en el menú para ejecutar una investigación de Gemini Cloud Assist.

Detalles de la consulta

También puedes solucionar problemas de una consulta lenta con la asistencia de IA desde la página Detalles de la consulta.

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. Haz clic en Estadísticas de consultas para abrir el panel de Estadísticas de consultas.
  4. En el panel Estadísticas de consultas, haz clic en la consulta que deseas ver en Consultas principales. Aparecerá la página Detalles de la consulta.
  5. En el caso de la edición Enterprise Plus de Cloud SQL, si Cloud SQL detecta una anomalía en la consulta, aparecerán uno o más de los siguientes indicadores en la página Detalles de la consulta:
    • Un mensaje en la pantalla de detalles que dice This query is slower than usual y una opción Investigar

    • Un mensaje en el gráfico Latencia de las consultas que dice Query slower than usual. Si aparece este mensaje, haz clic en el botón Investigar para comenzar a solucionar problemas con la asistencia de IA de Gemini Cloud Assist.

      Después de unos dos minutos, se abrirá el panel Detalles de la investigación con las siguientes secciones:

      • Problema. Una descripción del problema que se está investigando, incluidas las horas de inicio y finalización de la investigación.
      • Observaciones. Una lista de observaciones sobre el problema. Por ejemplo, pueden incluir detalles de contención de bloqueo, como una proporción de espera de bloqueo más larga de lo esperado para la consulta.
      • Hipótesis. Es una lista de acciones recomendadas por la IA que puedes realizar para ayudar a solucionar la consulta de ejecución lenta.
  6. Opcional: Usa el filtro de intervalo de tiempo para seleccionar 1 hora, 6 horas, 1 día, 7 días, 30 días o un intervalo personalizado. Cuando ajustas el filtro de intervalo de tiempo de la página Detalles de la consulta o cualquier otro filtro, como Base de datos o Usuario, Cloud SQL vuelve a ejecutar la detección de anomalías.
  7. Si Cloud SQL no detecta una anomalía en la consulta, puedes ejecutar un análisis en la consulta haciendo clic en el botón Investigar de la tarjeta Latencia de la consulta.

Analiza la latencia de las consultas

Con la asistencia de IA, puedes analizar y solucionar problemas relacionados con los detalles de la latencia de tus consultas.

Período del análisis

El período de análisis consta de las 24 horas que ocurren antes del final del intervalo de tiempo que seleccionas en el gráfico Carga de la base de datos del panel Estadísticas de consultas o la página Detalles de la consulta. Cloud SQL usa este período para comparar las métricas de referencia con las métricas recuperadas durante el período de la anomalía.

En la página Detalles de la consulta, para la edición Cloud SQL Enterprise Plus, si Cloud SQL detectó una anomalía con la consulta, después de seleccionarla en el panel Estadísticas de consultas, Cloud SQL realiza un análisis de rendimiento de referencia para la consulta con las últimas 24 horas desde el final de la anomalía. Si Cloud SQL no detectó una anomalía con la consulta y vuelve a ejecutar la detección de anomalías en la consulta, Cloud SQL usa 48 horas antes del final del período seleccionado como el modelo de rendimiento para el período de análisis.

Período de detección de anomalías

El período de anomalía detectado solo se aplica a las instancias de la edición Enterprise Plus de Cloud SQL.

El período de anomalía detectado representa un período en el que Cloud SQL encuentra un cambio anómalo en el rendimiento de las consultas. Cloud SQL usa el rendimiento de referencia medido para la consulta durante el período de análisis.

Si Cloud SQL detecta varias anomalías en una consulta dentro de un período seleccionado, usa la última anomalía detectada.

Ejemplos de instrucciones de rendimiento de consultas

También puedes usar Gemini Cloud Assist para ingresar instrucciones que te ayuden a mejorar el rendimiento de tus consultas. Gemini Cloud Assist responde preguntas sobre la instancia y la base de datos de Cloud SQL seleccionadas.

Instrucción Tipo de respuesta
¿Cuáles son las consultas principales por latencia en mi base de datos?
    Resúmenes de consultas ordenadas por latencia. Gemini limita la respuesta según el filtro de intervalo de tiempo seleccionado en el gráfico de carga de la base de datos de Estadísticas de consultas.
¿Cuál es la consulta más lenta en esta instancia de base de datos? Orientación para identificar la consulta más lenta por latencia.

Soluciona problemas de carga alta de la base de datos

Si accedes al panel de Estadísticas de consultas en la consola de Google Cloud , puedes analizar tu base de datos y solucionar problemas de eventos cuando tu sistema experimenta una carga de base de datos más alta que el promedio. Cloud SQL usa las 24 horas de datos que se producen antes del período seleccionado para calcular la carga esperada de tu base de datos. Puedes analizar los motivos de los eventos de carga más altos y la evidencia detrás de la reducción del rendimiento. Cloud SQL también proporciona recomendaciones para optimizar tu base de datos y mejorar el rendimiento.

Para usar la asistencia de IA y solucionar problemas de carga alta de la base de datos, ve a la página Descripción general de la instancia o al panel Estadísticas de consultas en la consola de Google Cloud .

Página de descripción general de la instancia

Soluciona problemas de carga alta de la base de datos con la asistencia de IA en la página Descripción general de la instancia siguiendo estos pasos:

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. En la página Descripción general, en el menú Gráfico, selecciona una métrica para la base de datos. Puedes seleccionar cualquier métrica, por ejemplo, Uso de CPU.
  4. Opcional: Para seleccionar un período de análisis específico, usa el filtro Período y elige 1 hora, 6 horas, 1 día, 7 días, 30 días o un período personalizado.

    Puedes acercar secciones específicas del gráfico en las que notes áreas de carga alta que quieras analizar. Por ejemplo, un área de carga alta podría mostrar niveles de uso de CPU más cercanos al 100%. Para acercar, puedes hacer clic y seleccionar una parte del gráfico.

    Haz clic en el botón Investigar el rendimiento para comenzar a solucionar problemas de carga alta de la base de datos con la asistencia de IA de Gemini Cloud Assist.

    Después de unos dos minutos, se abrirá el panel Detalles de la investigación con las siguientes secciones:

    • Problema. Una descripción del problema que se está investigando, incluidas las horas de inicio y finalización de la investigación.
    • Observaciones. Una lista de observaciones sobre el problema. Por ejemplo, pueden incluir detalles de contención de bloqueo, como una proporción de espera de bloqueo más larga de lo esperado para la consulta.
    • Hipótesis. Es una lista de acciones recomendadas por la IA que puedes realizar para ayudar a solucionar la consulta de ejecución lenta.

Panel de Estadísticas de consultas

Soluciona problemas de carga alta de la base de datos con la asistencia de IA en el panel de Estadísticas de consultas siguiendo estos pasos:

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. Haz clic en Estadísticas de consultas para abrir el panel de Estadísticas de consultas.
  4. Opcional: Usa el filtro Período para seleccionar 1 hora, 6 horas, 1 día, 7 días, 30 días o un período personalizado.

    5. Puedes acercar secciones específicas del gráfico en las que notes áreas de mayor carga de la base de datos por tiempo de ejecución de la consulta. Para acercar, puedes hacer clic y seleccionar una parte del gráfico.

    En el gráfico de carga de la base de datos, haz clic en el botón Investigar rendimiento para comenzar a solucionar problemas de carga alta de la base de datos con la asistencia de IA de Gemini Cloud Assist.

    Después de unos dos minutos, se abrirá el panel Detalles de la investigación con las siguientes secciones:

    • Problema. Una descripción del problema que se está investigando, incluidas las horas de inicio y finalización de la investigación.
    • Observaciones. Una lista de observaciones sobre el problema. Por ejemplo, pueden incluir detalles de contención de bloqueo, como una proporción de espera de bloqueo más larga de lo esperado para la consulta.
    • Hipótesis. Es una lista de acciones recomendadas por la IA que puedes realizar para ayudar a solucionar la consulta de ejecución lenta.

Analiza la carga alta de la base de datos

Con la asistencia de IA, puedes analizar y solucionar problemas relacionados con los detalles de la carga de tu base de datos.

Período del análisis

Cloud SQL analiza tu base de datos durante el período que seleccionas en el gráfico de carga de la base de datos desde el panel Estadísticas de consultas o la página Descripción general de la instancia. Si seleccionas un período de menos de 24 horas, Cloud SQL analiza todo el período. Si seleccionas un período superior a 24 horas, Cloud SQL selecciona solo las últimas 24 horas del período para el análisis.

Para calcular el análisis de rendimiento de referencia de tu base de datos, Cloud SQL incluye 24 horas de un período de referencia en su período de análisis. Si el período que seleccionaste ocurre en un día que no es lunes, Cloud SQL usa un período de referencia de las 24 horas anteriores al período que seleccionaste. Si el período seleccionado ocurre un lunes, Cloud SQL usa un período de referencia del séptimo día anterior al período seleccionado.

Análisis de métricas

Cuando Cloud SQL inicia el análisis, verifica si hay cambios significativos en las diversas métricas, incluidas, entre otras, las siguientes:

  • Consultas por segundo (QPS)
  • CPU
  • Memoria
  • E/S de disco

Cloud SQL compara los datos agregados de referencia de tu base de datos con los datos de rendimiento de tu período de análisis. Si Cloud SQL detecta un cambio significativo en el umbral de una métrica clave, indica una posible situación con tu base de datos. La situación identificada podría explicar la causa raíz de la carga alta en tu base de datos durante el período seleccionado.

Recomendaciones

Cuando Gemini Cloud Assist completa el análisis, la sección Hipótesis del panel Detalles de la investigación enumera estadísticas prácticas para ayudar a solucionar el problema.

En algunas situaciones, según el análisis, es posible que no haya una recomendación.

Ejemplos de instrucciones de rendimiento del sistema

También puedes usar Gemini Cloud Assist para ingresar instrucciones y recopilar información sobre el rendimiento de tu sistema. Gemini Cloud Assist responde preguntas sobre la instancia de Cloud SQL seleccionada.

Instrucción Tipo de respuesta
¿Cuántas entradas de registro de errores hay para esta instancia de base de datos en los últimos 7 días?
  • Es un resumen de las entradas de registro agrupadas por su tipo de gravedad. Gemini limita la respuesta según el filtro de período seleccionado en el gráfico de rendimiento de la instancia.
  • Orientación para identificar y ordenar las consultas por latencia
¿Cuál fue el uso de CPU de esta instancia de base de datos alrededor de las 2 p.m. de hoy? Son los resultados de las métricas en el rango de porcentaje para el uso de CPU dentro del intervalo de tiempo.

Soluciona problemas de conectividad

Puedes comenzar a solucionar problemas de conectividad con Gemini Cloud Assist o iniciar una investigación cuando se produzcan errores de conexión. La asistencia de IA evalúa varias fuentes para identificar por qué un cliente puede tener problemas cuando intenta conectarse a una base de datos de Cloud SQL.

Investiga problemas de conectividad

Para usar la asistencia de IA para solucionar problemas de conectividad, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. En el panel Resuelve problemas de bases de datos con la solución de problemas asistida por IA, haz clic en Explorar investigaciones.
  4. En la ventana Opciones de investigación, busca la sección Uso de la conexión.
  5. Opcional: Selecciona un período de análisis específico con el filtro Período, ya sea de 1 hora, 6 horas, 1 día, 7 días o un período personalizado.
  6. Haga clic en Investigar.

    Gemini inicia un análisis automatizado de los metadatos, los registros y la configuración de red de tu instancia. Una vez que se complete el análisis, en el panel Detalles de la investigación, se mostrarán las siguientes secciones:

    • Problema: Es un resumen de la falla de conectividad, incluidos los recursos afectados y las marcas de tiempo.
    • Observaciones: Evidencia recopilada a partir de indicadores, como cuando una base de datos alcanzó su límite de max_connections o las conexiones simultáneas activas se compararon datos mediante referencia cruzada con los metadatos de la instancia. La evidencia se puede usar para determinar si un pico de tráfico o las sesiones no cerradas podrían ser la causa del tiempo de inactividad de la instancia.
    • Hipótesis: Son las causas raíz y los pasos de corrección generados por IA.

Ejemplos de instrucciones sobre problemas de conectividad

También puedes usar Gemini Cloud Assist para solucionar problemas de conectividad entre un cliente y tu instancia de Cloud SQL.

Instrucción Tipo de respuesta
¿Por qué veo errores de conexión? Gemini evalúa las conexiones a tu base de datos y recomienda mejoras, como habilitar la agrupación de conexiones administrada.

Obtén recomendaciones de índices

Puedes obtener recomendaciones de índices de Cloud SQL en Estadísticas de consultas. Para obtener más información sobre cómo obtener recomendaciones de índices, consulta Usa el asesor de índices.

Ejemplos de instrucciones de recomendación de índices

Usa Gemini Cloud Assist para obtener más información sobre cómo usar índices en tus bases de datos. Gemini Cloud Assist responde preguntas sobre la instancia de Cloud SQL seleccionada.

Instrucción Tipo de respuesta
Muestra las recomendaciones de índices para las consultas ejecutadas en los últimos 7 días. Orientación sobre los tipos de consultas que se pueden beneficiar de un índice.

Supervisa las consultas activas

Usa el panel de Estadísticas de consultas para supervisar las consultas activas y, si es necesario, finalizar los procesos de larga duración. Para obtener más información, consulta Supervisa las consultas activas.

Ejemplos de instrucciones de consultas activas

Usa Gemini Cloud Assist para obtener más información sobre las consultas que causan una latencia o una carga de CPU altas. Gemini Cloud Assist responde preguntas sobre la instancia de Cloud SQL seleccionada.

Instrucción Tipo de respuesta
¿Cuáles son las consultas principales que se ejecutan actualmente en mi base de datos? Orientación para encontrar las consultas de mayor duración y que consumen más recursos.

¿Qué sigue?