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
- Descrição
- Subtipo do Insight
- Conteúdo
- Categoria
- Recursos de destino
- Informações de estado
- Etag
- Gravidade
- Hora da última atualização
- Período de observação
- Referência de recomendação
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
onde:
- 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
ouus-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
State
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 comoDISMISSED
OUACCEPTED
.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 comoCLAIMED
,SUCCEEDED
ouFAILED
. 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.