Monitorar e resolver problemas com a assistência da IA

Neste documento, descrevemos como usar a assistência de IA para monitorar e resolver problemas dos recursos do Cloud SQL. Use as ferramentas de solução de problemas assistidas por IA do Cloud SQL e do Gemini Cloud Assist para resolver problemas de consultas lentas e resolver problemas de alta carga do banco de dados.

Limitações

As seguintes limitações se aplicam à solução de problemas assistida por IA no Cloud SQL:

  • A solução de problemas assistida por IA não é compatível com as seguintes configurações do Cloud SQL:
  • A detecção de anomalias de consulta está disponível apenas para instâncias da edição Cloud SQL Enterprise Plus.

Antes de começar

  1. Verifique se o Gemini Cloud Assist está configurado para sua conta de usuário e projeto do Google Cloud .

    Depois de configurar o Gemini Cloud Assist, o serviço pode levar alguns minutos para ser propagado. Aguarde a conclusão da propagação antes de ativar a solução de problemas assistida por IA no Cloud SQL.

  2. Verifique se a instância é do Cloud SQL Enterprise Plus.
  3. Verifique se a instância do Cloud SQL está usando a nova arquitetura de rede.
  4. Ative o Query Insights para as edições Cloud SQL Enterprise Plus e Cloud SQL Enterprise.
  5. A versão MYSQL_VERSION.R20250304.00_01 ou mais recente precisa estar instalada na instância do Cloud SQL para MySQL. Para mais informações sobre como aplicar versões de manutenção a uma instância, consulte Sobre a manutenção em instâncias do Cloud SQL.

Papéis e permissões necessárias

Para receber as permissões necessárias para usar a solução de problemas assistida por IA, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto que hospeda a instância do Cloud SQL:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para usar a solução de problemas assistida por IA. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para usar a solução de problemas assistida por IA:

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

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para mais informações sobre os papéis e as permissões necessários para usar as investigações do Gemini Cloud Assist, consulte Resolver problemas com as investigações do Gemini Cloud Assist.

Ativar a solução de problemas assistida por IA

Quando você ativa a solução de problemas assistida por IA na instância do Cloud SQL, o Cloud SQL pode analisar o desempenho dos bancos de dados e detectar anomalias na execução das consultas. Quando o Cloud SQL detecta anomalias no desempenho das consultas ou identifica uma carga alta no sistema, a solução de problemas assistida por IA ajuda você a analisar a situação com evidências e fornece recomendações.

Para ativar a solução de problemas assistida por IA na instância do Cloud SQL, faça o seguinte:

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. No bloco Configuração, clique em Editar configuração.
  4. Na seção Personalizar sua instância, expanda Query Insights.
    1. Selecione Ativar o Query Insights, se ainda não estiver selecionado.
    2. Somente para a edição Cloud SQL Enterprise Plus, se ainda não estiver selecionada, selecione Ativar recursos do Enterprise Plus.
  5. Somente para a edição Cloud SQL Enterprise Plus, selecione Ativar a solução de problemas assistida por IA. Para instâncias do Cloud SQL Enterprise, a solução de problemas com a assistência de IA só está disponível se você ativar o Gemini Cloud Assist.
  6. Clique em Salvar.
  7. Para melhores resultados, aguarde 24 horas depois de ativar a solução de problemas assistida por IA no console do Google Cloud para que o Cloud SQL crie uma referência do desempenho médio da instância, do banco de dados e das consultas.

Sua instância precisa ser reiniciada. Para mais informações sobre como ativar o Query Insights para a edição Cloud SQL Enterprise Plus, consulte Usar o Query Insights para melhorar o desempenho de consultas.

Abrir o Gemini Cloud Assist

Para usar o Gemini Cloud Assist com o Cloud SQL, faça o seguinte:

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. No painel de navegação, selecione Query Insights.
  4. Para abrir o painel do Cloud Assist, clique em Abrir ou fechar o chat do Gemini Cloud Assist.
  5. No painel do Cloud Assist, insira um comando que descreva as informações em que você tem interesse.
  6. Depois de inserir o comando, clique em Enviar comando.

    O Gemini retorna uma resposta ao seu comando com base nas informações da última hora.

Resolver problemas de consultas lentas

Para usar a assistência de IA na solução de problemas de consultas lentas, acesse o painel Query Insights da instância do Cloud SQL no console do Google Cloud .

Tabela das consultas mais frequentes

É possível começar a resolver problemas de consultas lentas com a assistência de IA na seção Tabela de principais consultas do painel Query Insights.

O Cloud SQL pode ajudar a identificar quais consultas estão com desempenho mais lento do que a média durante um período de detecção específico. Depois de selecionar um período no painel do Query Insights, o Cloud SQL verifica se alguma consulta está sendo executada mais lentamente do que a média usando um período de detecção de 24 horas antes do final do período selecionado.

Quando você ajusta o filtro de período do gráfico Carga do banco de dados ou qualquer outro filtro, como banco de dados ou usuário, o Cloud SQL atualiza a tabela de consultas principais e executa novamente a detecção de anomalias com base na nova lista de consultas e em um período de detecção atualizado.

Para instâncias da edição Cloud SQL Enterprise Plus, o seguinte ocorre quando o Cloud SQL detecta uma anomalia:

Se uma consulta estiver sendo executada mais lentamente do que o esperado, um ícone de Aviso warning_spark será exibido. Ao clicar em um dos ícones, o Gemini Cloud Assist é usado para ajudar a analisar a execução da consulta e oferece observações sobre o que pode ter causado o problema. Com base nessas observações, o Gemini Cloud Assist gera uma hipótese que pode ajudar você a resolver o problema.

Para resolver problemas de consultas lentas na tabela Principais consultas no painel do Query Insights, faça o seguinte:

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. No menu de navegação do SQL, clique em Query Insights.
  4. No gráfico Consultas executadas, use o filtro Período para selecionar 1 hora, 6 horas, 1 dia, 7 dias, 30 dias ou um período personalizado.
  5. Na tabela Principais consultas, na guia Consultas, analise a lista de consultas do banco de dados.
  6. Se um ícone de Aviso warning_spark aparecer ao lado do valor de Tempo médio de execução (ms) de uma consulta, o Cloud SQL detectou uma anomalia no desempenho da consulta. O Cloud SQL verifica se há anomalias no período de 24 horas que ocorre antes do final do período selecionado.
  7. Clique no ícone Aviso warning_spark.
  8. Na caixa de diálogo A consulta está mais lenta do que o normal, clique em Nova investigação para começar a resolver problemas com a assistência de IA do Gemini Cloud Assist. Após cerca de dois minutos, o painel Detalhes da investigação é aberto com as seguintes seções:
    • Problema. Uma descrição do problema que está sendo investigado, incluindo os horários de início e término da investigação.
    • Observações. Uma lista de observações sobre o problema. Por exemplo, isso pode incluir detalhes de contenção de bloqueio, como uma proporção de espera de bloqueio maior do que o esperado para a consulta.
    • Hipóteses. Uma lista de ações recomendadas pela IA para ajudar a resolver a consulta lenta.

  9. Se você quiser ver todas as investigações associadas à consulta, na caixa de diálogo A consulta está mais lenta que o normal, clique em Ver todas as investigações. A página Gemini Cloud Assist é aberta, onde você pode conferir todas as investigações em andamento e concluídas. É possível filtrar a página por projeto ou rótulo, por exemplo, para encontrar a investigação específica de que você precisa.

    Como alternativa, para ver todas as investigações anteriores, clique no ícone Notificações e selecione uma notificação associada a qualquer investigação para abrir a página do Gemini Cloud Assist.

  10. Como alternativa, se você quiser investigar a latência de qualquer consulta, siga estas etapas:
    1. Identifique a consulta específica que você quer investigar.
    2. Na coluna Ações, clique no ícone Ações associado a essa consulta.
    3. Selecione Investigar latência no menu para executar uma investigação do Gemini Cloud Assist.

Detalhes da consulta

Também é possível resolver problemas de uma consulta lenta com a assistência de IA na página Detalhes da consulta.

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. Clique em Query Insights para abrir o painel Query Insights.
  4. No painel Query Insights, clique na consulta em Principais consultas que você quer visualizar. A página Detalhes da consulta é exibida.
  5. Para a edição Cloud SQL Enterprise Plus, se o Cloud SQL detectar uma anomalia na consulta, um ou mais dos seguintes indicadores vão aparecer na página Detalhes da consulta:
    • Uma mensagem na tela de detalhes que diz This query is slower than usual e uma opção Investigar.

    • Uma mensagem no gráfico Latência da consulta que diz Query slower than usual. Se essa mensagem aparecer, clique no botão Investigar para iniciar a solução de problemas com a assistência de IA do Gemini Cloud Assist.

      Após cerca de dois minutos, o painel Detalhes da investigação é aberto com as seguintes seções:

      • Problema. Uma descrição do problema que está sendo investigado, incluindo o horário de início e término da investigação.
      • Observações. Uma lista de observações sobre o problema. Por exemplo, isso pode incluir detalhes de contenção de bloqueio, como uma proporção de espera de bloqueio maior do que o esperado para a consulta.
      • Hipóteses. Uma lista de ações recomendadas pela IA para ajudar a resolver a consulta lenta.
  6. Opcional: use o filtro de período para selecionar 1 hora, 6 horas, 1 dia, 7 dias, 30 dias ou um período personalizado. Quando você ajusta o filtro de período da página Detalhes da consulta ou qualquer outro filtro, como Banco de dados ou Usuário, o Cloud SQL executa novamente a detecção de anomalias.
  7. Se o Cloud SQL não detectar uma anomalia na consulta, ainda será possível executar uma análise nela clicando no botão Investigar no card Latência da consulta.

Analisar a latência da consulta

Com a assistência de IA, é possível analisar e solucionar problemas nos detalhes da latência da consulta.

Período da análise

O período de análise consiste nas 24 horas que ocorrem antes do final do período selecionado no gráfico Carga do banco de dados do painel Query Insights ou na página Detalhes da consulta. O Cloud SQL usa esse período para comparar as métricas de referência com as métricas recuperadas durante o período da anomalia.

Na página Detalhes da consulta, para a edição Cloud SQL Enterprise Plus, se o Cloud SQL tiver detectado uma anomalia na consulta, depois que você selecionar a consulta no painel Query Insights, o Cloud SQL vai realizar uma análise de desempenho de referência para a consulta usando as últimas 24 horas a partir do fim da anomalia. Se o Cloud SQL não tiver detectado uma anomalia na consulta e executar a detecção de anomalias na consulta novamente, ele usará 48 horas antes do final do período selecionado como referência de desempenho para o período de análise.

Período da anomalia detectada

O período de anomalia detectado é aplicável apenas às instâncias da edição Cloud SQL Enterprise Plus.

O período de anomalia detectado representa um período em que o Cloud SQL encontra uma mudança anômala no desempenho da consulta. O Cloud SQL usa o desempenho de referência medido para a consulta durante o período de análise.

Se o Cloud SQL detectar várias anomalias em uma consulta em um período selecionado, ele usará a última anomalia detectada.

Exemplos de comandos de desempenho de consulta

Você também pode usar o Gemini Cloud Assist para inserir comandos que ajudam a melhorar o desempenho das suas consultas. O Gemini Cloud Assist responde a perguntas sobre a instância e o banco de dados do Cloud SQL selecionados.

Comando Tipo de resposta
Quais são as principais consultas por latência no meu banco de dados?
    Resumos de consultas classificados por latência. O Gemini define o escopo da resposta pelo filtro de período selecionado no gráfico de carga do banco de dados do Query Insights.
Qual é a consulta mais lenta nesta instância de banco de dados? Orientações sobre como identificar a consulta mais lenta por latência.

Resolver problemas de alta carga do banco de dados

Ao acessar o painel Query Insights no console do Google Cloud , é possível analisar o banco de dados e resolver problemas de eventos quando o sistema tiver uma carga de banco de dados maior do que a média. O Cloud SQL usa as 24 horas de dados que ocorrem antes do período selecionado para calcular a carga esperada do banco de dados. É possível analisar os motivos dos eventos de carga mais alta e as evidências por trás da redução de desempenho. O Cloud SQL também oferece recomendações para otimizar o banco de dados e melhorar o desempenho.

Para usar a assistência de IA na solução de problemas de alta carga do banco de dados, acesse a página Visão geral da instância ou o painel Query Insights no console do Google Cloud .

Página de visão geral da instância

Resolva problemas de alta carga do banco de dados com a assistência de IA na página Visão geral da instância seguindo estas etapas:

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. Na página Visão geral, no menu Gráfico, selecione uma métrica para o banco de dados. É possível selecionar qualquer métrica, por exemplo, Uso da CPU.
  4. Opcional: para selecionar um período de análise específico, use o filtro Período para selecionar 1 hora, 6 horas, 1 dia, 7 dias, 30 dias ou um período personalizado.

    É possível aumentar o zoom em seções específicas do gráfico em que você percebe áreas de alta carga que quer analisar. Por exemplo, uma área de alta carga pode exibir níveis de uso da CPU mais próximos de 100%. Para aumentar o zoom, clique e selecione uma parte do gráfico.

    Clique no botão Investigar desempenho para começar a resolver problemas de alta carga de banco de dados com a assistência de IA do Gemini Cloud Assist.

    Após cerca de dois minutos, o painel Detalhes da investigação é aberto com as seguintes seções:

    • Problema. Uma descrição do problema que está sendo investigado, incluindo o horário de início e término da investigação.
    • Observações. Uma lista de observações sobre o problema. Por exemplo, isso pode incluir detalhes de contenção de bloqueio, como uma proporção de espera de bloqueio maior do que o esperado para a consulta.
    • Hipóteses. Uma lista de ações recomendadas pela IA para ajudar a resolver a consulta lenta.

Painel do Query Insights

Resolva problemas de alta carga do banco de dados com a assistência de IA no painel do Query Insights seguindo estas etapas:

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. Clique em Query Insights para abrir o painel Query Insights.
  4. Opcional: use o filtro Período para selecionar 1 hora, 6 horas, 1 dia, 7 dias, 30 dias ou um período personalizado.

    5. É possível ampliar seções específicas do gráfico em que você percebe áreas de maior carga do banco de dados por tempo de execução da consulta. Para aumentar o zoom, clique e selecione uma parte do gráfico.

    No Gráfico de carga do banco de dados, clique no botão Investigar desempenho para começar a resolver problemas de alta carga do banco de dados com a assistência de IA do Gemini Cloud Assist.

    Após cerca de dois minutos, o painel Detalhes da investigação é aberto com as seguintes seções:

    • Problema. Uma descrição do problema que está sendo investigado, incluindo o horário de início e término da investigação.
    • Observações. Uma lista de observações sobre o problema. Por exemplo, isso pode incluir detalhes de contenção de bloqueio, como uma proporção de espera de bloqueio maior do que o esperado para a consulta.
    • Hipóteses. Uma lista de ações recomendadas pela IA para ajudar a resolver a consulta lenta.

Analisar a alta carga do banco de dados

Com a assistência de IA, é possível analisar e resolver problemas relacionados aos detalhes da carga do banco de dados.

Período da análise

O Cloud SQL analisa o banco de dados no período selecionado no gráfico de carga do banco de dados no painel Query Insights ou na página Visão geral da instância. Se você selecionar um período inferior a 24 horas, o Cloud SQL analisará todo o período. Se você selecionar um período maior que 24 horas, o Cloud SQL selecionará apenas as últimas 24 horas do período para análise.

Para calcular a análise de desempenho de referência do banco de dados, o Cloud SQL inclui 24 horas de um período de referência no período de análise. Se o período selecionado ocorrer em um dia que não seja segunda-feira, o Cloud SQL vai usar um período de referência de 24 horas anteriores ao período selecionado. Se o período selecionado ocorrer em uma segunda-feira, o Cloud SQL vai usar um período de referência do 7º dia anterior ao período selecionado.

Análise de métricas

Quando o Cloud SQL inicia a análise, ele verifica se há mudanças significativas nas várias métricas, incluindo, mas não se limitando ao seguinte:

  • Consultas por segundo (QPS)
  • CPU
  • Memória
  • E/S de disco

O Cloud SQL compara os dados agregados de referência do banco de dados com os dados de performance da janela de tempo de análise. Se o Cloud SQL detectar uma mudança significativa no limite de uma métrica importante, ele vai indicar uma possível situação com o banco de dados. A situação identificada pode explicar uma causa raiz para a alta carga no banco de dados durante o período selecionado.

Recomendações

Quando o Gemini Cloud Assist conclui a análise, a seção Hipóteses do painel Detalhes da investigação lista insights úteis para ajudar a corrigir o problema.

Em algumas situações, com base na análise, pode não haver uma recomendação.

Exemplos de comandos de desempenho do sistema

Você também pode usar o Gemini Cloud Assist para inserir comandos e coletar informações sobre o desempenho do sistema. O Gemini Cloud Assist responde a perguntas sobre a instância do Cloud SQL selecionada.

Comando Tipo de resposta
Quantas entradas de registro de erros existem para esta instância de banco de dados nos últimos 7 dias?
  • Resumo das entradas de registro agrupadas por tipo de gravidade. O Gemini define o escopo da resposta pelo filtro de período selecionado no gráfico de desempenho da instância.
  • Orientações sobre como identificar e classificar consultas por latência.
Qual foi a utilização da CPU para esta instância de banco de dados por volta das 14h de hoje? Resultados de métricas em porcentagem para uso da CPU no intervalo de tempo.

Solução de problemas de conectividade

Para começar a resolver problemas de conectividade, use o Gemini Cloud Assist ou inicie uma investigação quando ocorrerem erros de conexão. A Assistência de IA avalia várias fontes para identificar por que um cliente pode encontrar problemas ao tentar se conectar a um banco de dados do Cloud SQL.

Investigar problemas de conectividade

Para usar a assistência de IA na solução de problemas de conectividade, faça o seguinte:

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. No painel Resolver problemas de banco de dados com a solução de problemas assistida por IA, clique em Analisar investigações.
  4. Na janela Opções de investigação, procure a seção Uso da conexão.
  5. Opcional: selecione um período de análise específico usando o filtro Período, que pode ser de 1 hora, 6 horas, 1 dia, 7 dias ou um período personalizado.
  6. Clique em Investigar.

    O Gemini inicia uma análise automatizada dos metadados, registros e configuração de rede da instância. Depois que a análise for concluída, o painel Detalhes da investigação vai mostrar as seguintes seções:

    • Problema: um resumo da falha de conectividade, incluindo recursos afetados e carimbos de data/hora.
    • Observações: evidências coletadas de indicadores, como quando um banco de dados atinge o limite de max_connections ou conexões simultâneas ativas comparadas com metadados de instância. As evidências podem ser usadas para determinar se um pico de tráfego ou sessões não encerradas podem ser a causa do tempo de inatividade da instância.
    • Hipóteses: causas raiz e etapas de correção geradas com IA.

Exemplos de comandos para problemas de conectividade

Também é possível usar o Gemini Cloud Assist para resolver problemas de conectividade entre um cliente e sua instância do Cloud SQL.

Comando Tipo de resposta
Por que estou vendo erros de conexão? O Gemini avalia as conexões com seu banco de dados e recomenda melhorias, como ativar o pool de conexões gerenciado.

Receber recomendações de índice

É possível receber recomendações de índice do Cloud SQL no Query Insights. Para mais informações sobre como receber recomendações de índice, consulte Usar o consultor de índice.

Exemplos de comandos de recomendação de índice

Use o Gemini Cloud Assist para saber mais sobre como usar índices nos seus bancos de dados. O Gemini Cloud Assist responde a perguntas sobre a instância do Cloud SQL selecionada.

Comando Tipo de resposta
Mostra recomendações de índice para consultas executadas nos últimos 7 dias. Orientações sobre os tipos de consultas que podem se beneficiar de um índice.

Monitorar consultas ativas

Use o painel Query Insights para monitorar consultas ativas e, se necessário, encerrar processos de longa duração. Para mais informações, consulte Monitorar consultas ativas.

Exemplos de comandos de consulta ativa

Use o Gemini Cloud Assist para saber mais sobre consultas que causam alta latência ou carga de CPU. O Gemini Cloud Assist responde a perguntas sobre a instância selecionada do Cloud SQL.

Comando Tipo de resposta
Quais são as principais consultas em execução no meu banco de dados? Orientações sobre como encontrar as consultas mais longas e que consomem mais recursos.

A seguir