Recomendador de falta de espaço em disco do Cloud SQL

O recomendador de falta de espaço em disco do Cloud SQL gera recomendações proativamente, o que ajuda a reduzir o risco de inatividade que pode ser causado por falta de espaço em disco nas instâncias. É possível aplicar essas recomendações quando uma instância do Cloud SQL está se aproximando do limite de armazenamento.

Como funciona

O recomendador de falta de espaço em disco do Cloud SQL analisa a tendência de utilização do armazenamento nos últimos 30 dias. Quando uma instância estiver se aproximando de um limite em que seja provável que ela fique sem espaço nos próximos 1 a 30 dias, será gerada uma recomendação sugerindo que você faça o seguinte:

A tabela a seguir lista a recomendação e os insights que o recomendador de falta de espaço em disco do Cloud SQL pode gerar.

Insight Subtipo de insight Recomendação
Com base na tendência de uso do armazenamento atual, a instância provavelmente ficará sem espaço em disco, o que pode resultar em inatividade. TRENDING_OUT_OF_DISK Ative o aumento automático, aumente manualmente a capacidade de armazenamento ou libere espaço em disco

Preços

Este recomendador está no nível de preço padrão do recomendador que está disponível sem custo adicional. Consulte a página de preços de recomendador para mais detalhes sobre os níveis de preços.

Antes de começar

Para visualizar as recomendações e os insights, faça o seguinte:

Descrição Papéis
Ver recomendações recommender.cloudsqlViewer
cloudsql.viewer
Ver e atualizar recomendações recommender.cloudsqlAdmin
cloudsql.editor
cloudsql.admin

Esses papéis fornecem um conjunto de permissões que permitem acessar insights e recomendações.

Para mais informações sobre papéis, consulte Noções básicas sobre papéis e Como conceder permissões do IAM.

ID do recomendador

Estes são os IDs do recomendador de falta de espaço em disco:

  • google.cloudsql.instance.OutOfDiskRecommender
  • google.cloudsql.instance.DiskUsageTrendInsight

Permissões do IAM obrigatórias

Para acessar a lista de recomendações e insights do Cloud SQL, as seguintes permissões são necessárias:

  • recommender.cloudsqlInstanceOutOfDiskRecommendations.get
  • recommender.cloudsqlInstanceOutOfDiskRecommendations.list
  • recommender.cloudsqlInstanceOutOfDiskRecommendations.update
  • recommender.cloudsqlInstanceDiskUsageTrendInsights.get
  • recommender.cloudsqlInstanceDiskUsageTrendInsights.list
  • recommender.cloudsqlInstanceDiskUsageTrendInsights.update

Para saber mais detalhes sobre essas permissões, consulte Controle de acesso ao projeto.

Como visualizar recomendações de falta de espaço em disco

Nesta seção, descrevemos como verificar insights e recomendações de falta de espaço em disco usando o Console do Cloud, a gcloud e a API.

Console

Para visualizar recomendações e insights usando o Console do Cloud, siga as etapas abaixo. Para mais informações, consulte Primeiros passos com o Hub de recomendações.

  1. No Console do Cloud, acesse o Hub de recomendações.

    Acesse o Hub de recomendações

  2. No card Evitar inatividade em instâncias do SQL, clique em Visualizar tudo para visualizar a lista de recomendações.

  3. Clique em uma recomendação na lista para ver os detalhes dessa recomendação para a instância.

  4. Você poderá escolher qualquer uma das seguintes opções:

    • Para acessar a página de visão geral da instância, clique em VER INSTÂNCIA.
    • Se você não quiser aplicar a recomendação, clique em DISPENSAR.

Também é possível ver recomendações diretamente na página de instâncias do Cloud SQL. Para visualizar recomendações de uma instância, siga as etapas abaixo:

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

    Acessar a página "Instâncias" do Cloud SQL

  2. Para ver as recomendações, clique em VER TUDO no banner que exibe o número de instâncias que estão no limite da capacidade ou próximo dele.

  3. Para visualizar os detalhes da recomendação, clique na recomendação correspondente a uma instância na lista. Na página de recomendações correspondente, é possível fazer o seguinte:

    • Para acessar a página de visão geral da instância, clique em VER INSTÂNCIA.
    • Se você não quiser aplicar a recomendação, clique em DISPENSAR.

gcloud

Para visualizar recomendações e insights usando gcloud, siga as etapas abaixo. Para mais informações, consulte Como usar a API - Insights e Como usar a API - Recomendações.

  1. Para listar as recomendações de falta de espaço em disco, execute o seguinte comando:

    gcloud recommender recommendations list \
    --project=PROJECT_ID \
    --location=LOCATION \
    --recommender=google.cloudsql.instance.OutOfDiskRecommender
    

    Substitua:

    • PROJECT_ID: ID do projeto
    • LOCATION: uma região, como us-central1

    Se o comando não retornar nenhuma recomendação, não há discos se aproximando da utilização excessiva, o que também significa que não há insights no momento.

  2. Para listar os insights de todos os discos se aproximando da falta de espaço, execute o seguinte comando:

    gcloud recommender insights list \
    --project=PROJECT_ID \
    --location=LOCATION \
    --recommender=google.cloudsql.instance.DiskUsageTrendInsight
    

    Substitua:

    • PROJECT_ID: ID do projeto
    • LOCATION: uma região, como us-central1

API

Para visualizar recomendações e insights usando a API, siga as etapas abaixo. Para mais informações, consulte Como usar a API - Insights e Como usar a API - Recomendações.

  1. Chame o método recommendations.list:

    GET https://recommender.googleapis.com/v1beta1/projects/PROJECT-ID/locations/LOCATION/recommenders/google.cloudsql.instance.OutOfDiskRecommender/recommendations
    

    Substitua:

    • PROJECT_ID: ID do projeto
    • LOCATION: uma região, como us-central1

    Se a chamada de API não retornar nenhuma recomendação, não há discos se aproximando da utilização excessiva, o que também significa que não há insights no momento.

  2. Chame o método insights.list :

    GET https://recommender.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/insightTypes/google.cloudsql.instance.DiskUsageTrendInsightinsights
    

    Substitua:

    • PROJECT_ID: ID do projeto
    • LOCATION: uma região, como us-central1

A seguir