Diagnosticar problemas

Nesta página, mostramos uma lista dos problemas mais frequentes que podem ser encontrados ao trabalhar com instâncias do Cloud SQL, bem como os passos a serem seguidos para resolvê-los. Além disso, consulte as páginas Problemas conhecidos, Solução de problemas e Página de suporte.

Ver registros

Para ver informações sobre operações recentes, consulte os registros de operações da instância do Cloud SQL ou os registros de erro do PostgreSQL.

Problemas de conexão

Para ajuda com problemas de conexão, consulte a página Como depurar problemas de conexão ou a seção Conectividade na página de solução de problemas.

Problemas da instância

Backups

Para ter o melhor desempenho com backups, mantenha a quantidade de tabelas em um número razoável.

Para outros problemas de backup, consulte a seção Backups na página de solução de problemas.

Importar e exportar

A conclusão das importações para o Cloud SQL e as exportações para fora dele pode levar muito tempo, dependendo do tamanho dos dados que estão sendo processados. Esse processo pode ter os seguintes impactos:

  • Não é possível interromper uma operação de instância do Cloud SQL de longa duração.
  • Será possível executar apenas uma operação de importação ou exportação por vez para cada instância, e uma importação ou exportação de longa duração bloqueará outras operações, por exemplo, backups automatizados diários. As exportações sem servidor permitem executar outras operações, entre elas a edição de instâncias, importação, failover e desbloqueio de backups automatizados diários.

É possível diminuir o tempo necessário para concluir cada operação usando a função de importação ou exportação do Cloud SQL com lotes menores de dados.

Para exportações, é possível exportar a partir de uma réplica de leitura ou usar a exportação sem servidor, para minimizar o impacto no desempenho do banco de dados e permitir que outras operações sejam executadas na sua instância enquanto uma exportação está em execução.

Para outros problemas de importação e exportação, consulte a seção Importar e exportar na página de solução de problemas.

Espaço em disco

Se sua instância atingir o volume de armazenamento máximo permitido, as gravações no banco de dados falharão. Se você exclui dados, por exemplo, eliminando uma tabela, o espaço é liberado, mas isso não reflete no armazenamento usado relatado da instância. É possível executar o comando VACUUM FULL para recuperar o espaço não utilizado. Observe que as operações de gravação ficam bloqueadas durante a execução do comando de vácuo. Saiba mais.

Estado suspenso

Há vários motivos pelos quais o Cloud SQL pode suspender uma instância, entre os quais:

  • Problemas de faturamento

    Por exemplo, se o cartão de crédito da conta de faturamento do projeto tiver expirado, a instância poderá ser suspensa. Verifique as informações de faturamento de um projeto acessando a página de faturamento do Console do Google Cloud, basta selecionar o projeto e visualizar as informações da conta de faturamento usada no projeto. Depois de resolver o problema de faturamento, a instância retorna ao status executável em algumas horas.

  • Problemas de chave do KMS

    Por exemplo, se a versão da chave do KMS usada para criptografar os dados do usuário na instância do Cloud SQL não estiver presente ou se tiver sido desativada ou destruída. Consulte Como usar chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês).

  • problemas legais

    Por exemplo, uma violação da política de uso aceitável do Google Cloud pode causar a suspensão da instância. Para mais informações, consulte "Suspensões e remoções" nos Termos de Serviço do Google Cloud.

  • Problemas operacionais

    Por exemplo, se uma instância estiver presa em um ciclo de falha (ela falha durante ou logo após a inicialização), o Cloud SQL poderá suspendê-la.

Durante a suspensão de uma instância, é possível continuar visualizando informações sobre ela ou excluí-la, caso a suspensão tenha sido acionada por problemas de faturamento.

Os usuários do Cloud SQL com pacotes de suporte Platinum, Gold ou Silver podem contatar a equipe de suporte diretamente sobre instâncias suspensas. Todos os usuários podem usar a orientação anterior com o fórum google-cloud-sql (em inglês).

Desempenho

Visão geral

O Cloud SQL oferece é compatível com cargas de trabalho de alto desempenho com até 60.000 IOPS sem custo extra por E/S. O desempenho das IOPS e da capacidade depende do tamanho do disco, do número de vCPUs da instância, do tamanho do bloco de E/S, entre outros fatores.

O desempenho da instância também depende da opção de armazenamento e da carga de trabalho.

Saiba mais sobre estas situações:

Mantenha um número razoável de tabelas de banco de dados

As tabelas de banco de dados consomem recursos do sistema. Um grande número pode afetar o desempenho e a disponibilidade da instância e fazer com que a instância perca a cobertura do SLA. Saiba mais.

Ativar registros de consulta

Para registrar consultas lentas do Cloud SQL para PostgreSQL, defina a sinalização log_min_duration_statement. As consultas executadas pelo menos durante o período especificado serão registradas. Se esse valor for especificado sem unidades, ele será usado como milissegundos. Navegue para o Operations Logging para visualizar os registros.

Dicas de desempenho geral

Garanta que a instância não seja restrita pela memória ou CPU. Para cargas de trabalho que exigem alto desempenho, verifique se a instância tem pelo menos 60 GB de memória. Para inserções, atualizações ou exclusões demoradas de banco de dados, verifique os locais do gravador e do banco de dados. O envio de dados por uma longa distância gera latência.

Melhore o desempenho da consulta usando os Insights de consulta.

Para seleções lentas do banco de dados, considere o seguinte:

  • O armazenamento em cache é importante para o desempenho de leitura. Verifique as diversas proporções blks_hit / (blks_hit + blks_read) do coletor de estatísticas do PostgreSQL (em inglês). O ideal é que a proporção esteja acima de 99%. Caso contrário, considere aumentar o tamanho da RAM da instância.
  • Se a carga de trabalho consiste em consultas com uso intensivo de CPU (classificação, expressões regulares, outras funções complexas), a instância fica limitada. Adicione vCPUs.
  • Verifique o local do leitor e do banco de dados. A latência afeta o desempenho de leitura ainda mais do que o desempenho de gravação.
  • Investigue as melhorias de desempenho específicas não relacionadas ao Cloud SQL, como adicionar indexação apropriada, reduzir dados digitalizados e evitar ciclos extras.

Caso observe baixo desempenho na execução de consultas, use EXPLAIN e identifique onde adicionar índices às tabelas para melhorar o desempenho da consulta. Por exemplo, garanta que todos os campos usados como chave JOIN tenham um índice nas duas tabelas.

Resolver problemas

Para outros problemas com o Cloud SQL, consulte a página de solução de problemas.

Mensagens de erro

Para ver mensagens de erro específicas da API, consulte a página de referência Mensagens de erro.

Resolver problemas de chaves de criptografia gerenciadas pelo cliente (CMEK)

As operações de administrador do Cloud SQL (como criação, clonagem ou atualização) podem falhar devido a erros do Cloud KMS e ausência de papéis ou permissões. Motivos comuns de falha incluem uma versão ausente da chave do Cloud KMS, uma versão da chave do Cloud KMS desativada ou destruída, permissões de IAM insuficientes para acessar a versão da chave do Cloud KMS ou a versão da chave do Cloud KMS está em uma região diferente da instância do Cloud SQL. Use a seguinte tabela de solução de problemas para diagnosticar e resolver problemas comuns.

Tabela de solução de problemas de chaves de criptografia gerenciadas pelo cliente

Para este erro... O problema pode ser... Tente o seguinte...
Conta de serviço por produto, por projeto não encontrada O nome da conta de serviço está incorreto. Certifique-se de ter criado uma conta de serviço para o projeto de usuário correto.

ACESSAR A PÁGINA "CONTAS DE SERVIÇO"

Não é possível conceder acesso à conta de serviço A conta de usuário não tem permissão para conceder acesso a esta versão de chave. Adicione a função Administrador da organização em sua conta de usuário ou serviço.

ACESSAR A PÁGINA "CONTAS DE IAM"

A versão da chave do Cloud KMS foi destruída A versão da chave foi destruída. Se a versão da chave for destruída, você não poderá usá-la para criptografar ou descriptografar dados.
A versão da chave do Cloud KMS está desativada A versão da chave está desativada. Reative a versão da chave do Cloud KMS.

ACESSAR A PÁGINA "CHAVES DE CRIPTOGRAFIA"

Permissão insuficiente para usar a chave do Cloud KMS O papel cloudkms.cryptoKeyEncrypterDecrypter está ausente na conta de usuário ou serviço que você está usando para executar operações em instâncias do Cloud SQL ou a versão da chave do Cloud KMS não existe. No projeto do Google Cloud que hospeda a chave, adicione o papel cloudkms.cryptoKeyEncrypterDecrypter à sua conta de usuário ou serviço.

ACESSAR A PÁGINA "CONTAS DE IAM"


Se o papel já tiver sido concedido à sua conta, consulte Como criar uma chave para saber como criar uma nova versão da chave. Consulte a observação.
A chave do Cloud KMS não foi encontrada A versão da chave não existe. Crie uma nova versão de chave. Consulte Como criar uma chave. Consulte a observação.
A instância do Cloud SQL e a versão da chave do Cloud KMS estão em diferentes regiões A versão da chave do Cloud KMS e a instância do Cloud SQL precisam estar na mesma região. Ela não funcionará se a versão da chave do Cloud KMS estiver em uma região global ou em várias regiões. Crie uma versão de chave na mesma região em que você quer criar instâncias. Consulte Como criar uma chave. Consulte a observação.
A versão da chave do Cloud KMS é restaurada, mas a instância ainda está suspensa A versão da chave está desativada ou não concede as permissões adequadas. Reative a versão da chave e conceda o papel cloudkms.cryptoKeyEncrypterDecrypter à conta de usuário ou serviço no projeto do Google Cloud que hospeda a chave.

Tabela de solução de problemas de nova criptografia

Para este erro... O problema pode ser... Tente o seguinte...
A nova criptografia de recursos do CMEK falhou porque a chave do Cloud KMS está inacessível. Verifique se a versão da chave primária está ativada e se a permissão foi concedida corretamente. A versão da chave está desativada ou não concede as permissões adequadas.

Reative a versão da chave do Cloud KMS:

ACESSAR A PÁGINA "CHAVES DE CRIPTOGRAFIA"

No projeto do Google Cloud que hospeda a chave, confirme se o papel cloudkms.cryptoKeyEncrypterDecrypter foi concedido ao usuário ou à conta de serviço:

ACESSAR A PÁGINA "CONTAS DO IAM"

A nova criptografia de recursos do CMEK falhou devido a um erro interno do servidor. Tente de novo mais tarde Há um erro interno do servidor. Tente fazer a criptografia novamente. Para mais informações, consulte Criptografar novamente uma réplica ou instância atual ativada para CMEK