Insights

O Recomendador usa aprendizado de máquina para fornecer insights detalhados e de alta qualidade. Os insights são descobertas que você pode usar para focar proativamente em padrões importantes no uso de recursos. Use insights independentemente das recomendações. Alguns insights têm links para recomendações e fornecem provas das recomendações associadas.

Esta página descreve os principais conceitos para interpretar e usar insights.

Tipos de insights

Cada insight tem um tipo específico. Os tipos de insight são específicos de um único produto e tipo de recurso do Google Cloud. Cada produto pode ter vários tipos de insight. Eles fornecem um tipo específico de insight para cada recurso diferente.

Cada tipo de insight tem um código exclusivo que identifica o serviço internamente. Use o ID do tipo de insight ao interagir usando os gcloud comandos do recomendador ou as APIs REST ou RPC.

Para mais informações, consulte Tipos de Insight.

Insights

Um insight é uma descoberta gerada por máquina que pode ser vinculada a uma ou mais recomendações. Um insight tem os seguintes atributos principais:

Nome

O nome do insight é armazenado no campo name da entidade Insight. Ele tem o seguinte formato: 

projects/TARGET_PROJECT_ID/locations/LOCATION/insightTypes/INSIGHT_TYPE_ID/insights/INSIGHT_ID

em que:

  • TARGET_PROJECT_ID é o código do projeto em que o insight foi gerado.
  • LOCATION é o local do Google Cloud em que os recursos associados ao insight estão localizados (por exemplo, global ou us-central1-a).
  • INSIGHT_TYPE_ID é o código do tipo de insights totalmente qualificado (por exemplo, google.compute.firewall.Insight).
  • INSIGHT_ID é um código exclusivo para o insight.

Descrição

Este é um resumo legível do insight. Ele está disponível apenas em inglês.

Subtipo do Insight

Cada tipo de insight pode ser compatível com vários subtipos. O esquema de conteúdo é estável para um determinado subtipo.

Conteúdo

Campos estruturados que incluem detalhes de insight. O esquema de conteúdo é determinado pelo tipo de insight e pelo subtipo. Por exemplo, "grantedPermissionsCount": "1000".

Categoria

Assim como os impactos para recomendações, há categorias para insights:

  • COST
  • SECURITY
  • PERFORMANCE

Recursos de destino

Nomes de recursos totalmente qualificados dos recursos do Google Cloud que o insight está segmentando.

Informações de estado

Estado

Os insights passam por várias transições de estado após serem propostas:

  • ACTIVE, que significa que o insight foi gerado, mas nenhuma ação foi tomada em resposta. O conteúdo dos insights ativos é atualizado quando os dados subjacentes são alterados. Os insights ativos podem ser marcados como DISMISSED OU ACCEPTED.
  • ACCEPTED, o que significa que alguma ação foi realizada com base no insight. Os insights são aceitos quando uma recomendação associada é marcada como CLAIMED, SUCCEEDED ou FAILED. Os insights também podem ser aceitos diretamente. O conteúdo dos insights aceitos é imutável. Os insights aceitos são retidos por 90 dias a partir do momento da alteração do estado.
  • DISMISSED, o que significa que o insight foi dispensado sem nenhuma ação com base nele. O conteúdo de insights dispensados é atualizado quando os dados subjacentes são alterados.

Metadados de estado

Ao marcar diretamente um insight diretamente, você pode incluir metadados adicionais sobre a operação com metadados de estado. Os metadados são especificados como pares key:value. As atualizações no campo de metadados do estado substituem todos os metadados de estado atuais.

ETag

Uma etag é uma impressão digital exclusiva que identifica o estado atual de um insight. Sempre que o insight é alterado, um novo valor de etag é atribuído.
Para alterar o estado do insight, é necessário fornecer o etag do insight atual. Isso garante que todas as operações sejam realizadas somente se o insight não tiver sido alterado desde a última vez que você o recuperou.

Gravidade

A gravidade de um insight indica a probabilidade de um dos impactos a seguir:

  • Uma interrupção (impacto no desempenho)
  • Um comprometimento (impacto na segurança)
  • Um gasto excessivo (impacto no custo)
  • Um gerenciamento incorreto (impacto na capacidade de gereamento)

Esse campo vem com os valores CRITICAL, HIGH, MEDIUM e LOW com LOW definido como a gravidade padrão. Cada tipo de insight pode ter a própria estratégia de gravidade definida.

Hora da última atualização

O horário da última atualização indica a atualização dos dados usados para gerar o insight.

Período de observação

O período de observação é o período que leva à informação. Os dados de origem usados para gerar o insight terminam em last_refresh_time e começam em last_refresh_time menos observation_period.

Referência da recomendação

Referência a uma recomendação associada (em inglês). As referências vinculam insights às recomendações associadas. Esse campo fica vazio quando não há recomendações derivadas do insight.