Este documento descreve os tipos de evento que podem ser mostrados como anotações nos gráficos. Um evento é uma atividade, como uma reinicialização ou uma falha, que afeta a operação de um sistema. Mostrar eventos pode ajudar na correlação dados de diferentes fontes ao solucionar problemas um problema.
Para cada evento, são exibidos links para referências ou documentação de solução de problemas fornecido, além de informações sobre como consultar o evento. Por exemplo, quando os eventos são identificados pela análise dos registros, uma consulta adequada para uso com a Análise de registros ou com uma política de alertas for fornecida.
Para adicionar anotações aos seus gráficos, configure o painel ou a guia que exibe o gráfico. Por exemplo, é possível configurar a maioria dos painéis listados na página Painéis do console do Google Cloud para mostrar eventos. Da mesma forma, você pode configurar algumas guias de Observabilidade específicas do serviço, como as do Compute Engine e do Google Kubernetes Engine, para mostrar eventos. Para informações de configuração, consulte Mostrar eventos em um painel.
A captura de tela a seguir ilustra um gráfico que mostra diversos eventos identificados pela análise de entradas de registro e um Evento do Service Health:
Cada anotação pode listar vários eventos. Na captura de tela anterior, um evento de uma implantação do GKE é listado.
Tipos de evento de alerta
Esta seção descreve os tipos de evento de alerta que podem ser mostrados em uma mais avançado.
Alerta aberto
Os eventos abertos de alerta ajudam você a correlacionar os dados do gráfico com quando incidentes abertos. Um evento de alerta aberto é mostrado quando o seguinte é verdadeiro:
- O incidente correspondente foi aberto durante o período especificado pelo painel.
- O incidente correspondente não é encerrado.
Não são feitas anotações para incidentes abertos fora do o período especificado pelo painel não são exibidos. Da mesma forma, O evento de alerta aberto não é mostrado quando o incidente correspondente foi aberto e fechado dentro do período especificado pelo painel.
A dica para um evento de alerta aberto inclui o seguinte:
- Nome da política de alertas.
- Informações de resumo, quando disponíveis. Por exemplo, este podem incluir o limite e o valor medido.
- A duração do incidente e a data e hora quando o incidente foi aberto.
- Rótulos de métricas e recursos. A dica pode não mostrar todos os rótulos.
- Um botão Ver, que abre a página Detalhes do incidente.
Tipos de evento do Google Kubernetes Engine
Esta seção descreve os tipos de evento do Google Kubernetes Engine que podem ser mostrados em um painel.
Carga de trabalho do GKE que recebeu patch ou foi atualizada
Esse tipo de evento ajuda a resolver problemas do GKE a implantação da carga de trabalho ou alterações de statefulset, porque esses eventos podem se correlacionar regressões de desempenho ou outros problemas de desempenho. Esse tipo de evento é mostrado quando uma carga de trabalho é criada, atualizada ou excluída.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
resource.type=k8s_cluster protoPayload.methodName=( io.k8s.apps.v1.deployments.create OR io.k8s.apps.v1.deployments.patch OR io.k8s.apps.v1.deployments.update OR io.k8s.apps.v1.deployments.delete OR io.k8s.apps.v1.deployments.deletecollection OR io.k8s.apps.v1.statefulsets.create OR io.k8s.apps.v1.statefulsets.patch OR io.k8s.apps.v1.statefulsets.update OR io.k8s.apps.v1.statefulsets.delete OR io.k8s.apps.v1.statefulsets.deletecollection OR io.k8s.apps.v1.daemonsets.create OR io.k8s.apps.v1.daemonsets.patch OR io.k8s.apps.v1.daemonsets.update OR io.k8s.apps.v1.daemonsets.delete OR io.k8s.apps.v1.daemonsets.deletecollection ) -protoPayload.authenticationInfo.principalEmail="system:addon-manager" -protoPayload.request.metadata.namespace=(kube-system OR gmp-system OR gmp-public OR gke-gmp-system)
Para mais informações, consulte Visão geral da implantação de cargas de trabalho e Consultar métricas de observabilidade.
Falha de um pod do GKE
Esse tipo de evento ajuda a identificar e resolver problemas Falha no pod do GKE. As falhas no pod podem ser causadas por esgotamento da memória ou um erro de aplicativo. Esse tipo de evento é exibido quando uma das seguintes situações ocorre:
- O status do pod é
CrashLoopBackoff
- O pod é encerrado com um código de saída diferente de zero.
- O pod é encerrado com uma condição de falta de memória.
- O pod é removido.
- Falha na sondagem de prontidão/ativação.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
( log_id(events) ( (resource.type=k8s_pod jsonPayload.reason=(BackOff OR Unhealthy OR Killing OR Evicted)) OR (resource.type=k8s_node jsonPayload.reason=OOMKilling) ) severity=WARNING ) OR ( log_id(cloudaudit.googleapis.com%2Factivity) resource.type=k8s_cluster (protoPayload.methodName=io.k8s.core.v1.pods.eviction.create OR (protoPayload.methodName=io.k8s.core.v1.pods.delete protoPayload.response.status.containerStatuses.state.terminated.exitCode:* -protoPayload.response.status.containerStatuses.state.terminated.exitCode=0 ) ) )
Para informações sobre solução de problemas, consulte Solução de problemas: CrashLoopBackOff.
Falha ao programar um pod do GKE
Esse tipo de evento ajuda a identificar e resolver problemas quando os pods não podem ser programados em um nó. Esse tipo de evento é mostrado quando há falha na programação de pods por um destes motivos:
- CPU do nó insuficiente.
- Memória de nó insuficiente.
- Nenhum nó para taints ou tolerâncias.
- Nós no limite máximo de pods.
- O pool de nós está no tamanho máximo.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
( log_id(events) resource.type=k8s_pod jsonPayload.reason=(NotTriggerScaleUp OR FailedScheduling) ) OR ( log_id(container.googleapis.com/cluster-autoscaler-visibility) resource.type=k8s_cluster jsonPayload.noDecisionStatus.noScaleUp:* )
Para informações sobre solução de problemas, consulte Solução de problemas: pod não programável
Falha ao criar um contêiner do GKE
Esse tipo de evento ajuda a identificar e solucionar problemas para criar um contêiner do GKE. A criação de contêineres pode falhar devido a como falhas nas montagens de volume ou na extração de imagens.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
log_id(events) resource.type=k8s_pod jsonPayload.reason=(Failed OR FailedMount) severity=WARNING
Para informações sobre solução de problemas, consulte Solução de problemas: ImagePullBackOff e ErrImagePull.
Escalonar verticalmente automático de pods
Esse evento dá visibilidade aos redimensionamentos do escalonador automático horizontal de pods, aumentar ou diminuir o número de pods em execução para uma carga de trabalho. Para mais informações, consulte Escalonamento automático horizontal de pods.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
resource.type=k8s_cluster log_id(events) jsonPayload.involvedObject.kind=HorizontalPodAutoscaler jsonPayload.reason=SuccessfulRescale
Escalonar verticalmente automático de cluster
Este evento mostra quando o escalonador automático do cluster faz o escalonamento vertical ou reduzir o número de nós em um pool de nós do cluster. Para mais informações, consulte Sobre o escalonamento automático de clusters e Como visualizar eventos do escalonador automático de clusters.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
(resource.type=k8s_cluster log_id(container.googleapis.com%2Fcluster-autoscaler-visibility) jsonPayload.decision:*)
Criação e exclusão de clusters
Este evento acompanha a criação e a exclusão cluster do GKE ações. Para mais informações, consulte Crie um cluster do Autopilot, Como criar um cluster zonal Como excluir um cluster.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
resource.type=gke_cluster log_id(cloudaudit.googleapis.com%2Factivity) protoPayload.methodName=( google.container.v1alpha1.ClusterManager.CreateCluster OR google.container.v1beta1.ClusterManager.CreateCluster OR google.container.v1.ClusterManager.CreateCluster OR google.container.v1alpha1.ClusterManager.DeleteCluster OR google.container.v1beta1.ClusterManager.DeleteCluster OR google.container.v1.ClusterManager.DeleteCluster ) operation.first=true
Atualização do cluster
Esse evento monitora atualizações de clusters do GKE. As atualizações incluem os upgrades automáticos das versões do plano de controle, bem como os upgrades e mudanças na configuração do cluster. Para mais informações, consulte Como fazer upgrade manual de um cluster ou pool de nós e Upgrades padrão de cluster.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
resource.type=gke_cluster log_id(cloudaudit.googleapis.com%2Factivity) ( protoPayload.methodName=( google.container.internal.ClusterManagerInternal.PatchCluster OR google.container.internal.ClusterManagerInternal.UpdateClusterInternal OR google.container.internal.ClusterManagerInternal.UpdateCluster ) ) OR ( protoPayload.methodName=( google.container.v1beta1.ClusterManager.UpdateCluster OR google.container.v1.ClusterManager.UpdateCluster ) operation.first=true ) protoPayload.metadata.operationType=(UPGRADE_MASTER OR REPAIR_CLUSTER OR UPDATE_CLUSTER)
Atualização do pool de nós
Este evento rastreia atualizações do pool de nós do GKE. As atualizações incluem pool de nós automático bem como upgrades manuais, alterações de configuração e redimensionamentos. Para mais informações, consulte Como fazer upgrade manual de um cluster ou pool de nós e Upgrades padrão de cluster.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
resource.type=gke_nodepool log_id(cloudaudit.googleapis.com%2Factivity) ( protoPayload.methodName=( google.container.internal.ClusterManagerInternal.UpdateClusterInternal OR google.container.internal.ClusterManagerInternal.RepairNodePool ) ) OR ( protoPayload.methodName=( google.container.v1beta1.ClusterManager.UpdateNodePool OR google.container.v1.ClusterManager.UpdateNodePool OR google.container.v1beta1.ClusterManager.SetNodePoolSize OR google.container.v1.ClusterManager.SetNodePoolSize OR google.container.v1beta1.ClusterManager.SetNodePoolManagement OR google.container.v1.ClusterManager.SetNodePoolManagement OR google.container.v1beta1.ClusterManager.SetNodePoolAutoscaling OR google.container.v1.ClusterManager.SetNodePoolAutoscaling ) operation.first=true )
Tipos de evento do Cloud Run
Nesta seção, descrevemos os tipos de evento do Cloud Run que podem ser mostrados em um painel.
Implantação do Cloud Run
Esse tipo de evento ajuda a identificar e resolver problemas Falhas na implantação do Cloud Run. A implantação pode falhar por alguns motivos como conta de serviço excluídas, permissões incorretas, a importação de contêiner falhou ou foi iniciado um contêiner.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
log_id(cloudaudit.googleapis.com%2Factivity) resource.type=cloud_run_revision protoPayload.methodName=google.cloud.run.v1.Services.ReplaceService
Para informações sobre solução de problemas, consulte Solução de problemas: problemas do Cloud Run.
Tipos de evento do Cloud SQL
Nesta seção, descrevemos os tipos de evento do Cloud SQL que podem ser mostrados em um painel.
Failover do Cloud SQL
Esse tipo de evento ajuda a identificar quando ocorrem failovers manuais ou automáticos. Um failover ocorre quando há uma falha em uma instância ou zona e a instância de espera se torna a nova instância principal. Durante um failover, O Cloud SQL muda automaticamente para dados de disponibilização da instância de espera.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
resource.type=cloudsql_database ( ( log_id(cloudaudit.googleapis.com%2Factivity) protoPayload.methodName=cloudsql.instances.failover operation.last=true ) OR ( log_id(cloudaudit.googleapis.com%2Fsystem_event) protoPayload.methodName=cloudsql.instances.autoFailover ) )
Para mais informações, consulte Sobre a alta disponibilidade
Iniciar ou parar o Cloud SQL
Esse tipo de evento ajuda a identificar que uma instância do Cloud SQL foi iniciado, interrompido ou reiniciado. Quando uma instância é interrompida, todas as conexões, arquivos abertos e operações em execução também são interrompidas.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
log_id(cloudaudit.googleapis.com%2Factivity) resource.type=cloudsql_database protoPayload.methodName=cloudsql.instances.update operation.last=true protoPayload.metadata.intents.intent=(START_INSTANCE OR STOP_INSTANCE)
Para mais informações, consulte Sobre alta disponibilidade e Inicie, interrompa e reinicie instâncias.
Armazenamento do Cloud SQL
Esse tipo de evento ajuda a identificar eventos relacionados ao armazenamento do Cloud SQL, incluindo quando o armazenamento do banco de dados está cheio e quando um banco de dados é encerrado devido a para atingir a capacidade de armazenamento. Bancos de dados com capacidade de armazenamento e sem capacidade de armazenamento o armazenamento automático ativado pode ser desativado para evitar a corrupção de dados.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
resource.type=cloudsql_database ( ( (log_id(cloudsql.googleapis.com%2Fpostgres.log) OR log_id(cloudsql.googleapis.com%2Fmysql.err)) textPayload=~"No space left on device" severity=(ERROR OR EMERGENCY) ) OR ( log_id(cloudaudit.googleapis.com%2Fsystem_event) protoPayload.methodName=cloudsql.instances.databaseShutdownOutOfStorage ) )
Tipos de evento do Compute Engine
Nesta seção, descrevemos os tipos de evento do Compute Engine que podem ser mostrados em um painel.
Encerramentos de máquina virtual
Esse tipo de evento ajuda a identificar encerramentos de máquina virtual (VM), incluindo redefinições e interrupções acionadas manualmente, encerramentos do SO convidado, encerramentos de manutenção e erros de host.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
resource.type=gce_instance ( ( log_id(cloudaudit.googleapis.com%2Factivity) protoPayload.methodName=( beta.compute.instances.reset OR v1.compute.instances.reset OR beta.compute.instances.stop OR v1.compute.instances.stop ) operation.first=true ) OR ( log_id(cloudaudit.googleapis.com%2Fsystem_event) protoPayload.methodName=( compute.instances.hostError OR compute.instances.guestTerminate OR compute.instances.terminateOnHostMaintenance ) ) )
Para mais informações, consulte Iniciar e interromper uma VM e Como solucionar problemas de desligamento e reinicializações da VM
Falha ao iniciar a instância de VM
Esse evento acompanha falhas na inicialização de instâncias de VMs do Compute Engine. O evento mostra falhas na inicialização devido a esgotamento de estoque, esgotamento do espaço IP, cota excedida, ou erros de integridade de VM protegida.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
resource.type=gce_instance ( ( log_id(cloudaudit.googleapis.com%2Factivity) protoPayload.methodName=(beta.compute.instances.insert OR v1.compute.instances.insert) protoPayload.status.message=(ZONE_RESOURCE_POOL_EXHAUSTED OR IP_SPACE_EXHAUSTED OR QUOTA_EXCEEDED) ) OR ( log_id(compute.googleapis.com%2Fshielded_vm_integrity) severity="ERROR" ) )
Erro do SO convidado da instância de VM
Esse evento acompanha erros específicos do SO convidado da instância de VM do Compute Engine como gravado pelos registros do console serial. Os erros rastreados são: disco cheio, arquivo falha na montagem do sistema e falhas na inicialização que ativam o modo de emergência do Linux.
Para que esses eventos fiquem visíveis, você precisa ativar a geração de registros de saída da porta serial para
o Cloud Logging definindo serial-port-logging-enable=true
na VM ou
os metadados do projeto. Para mais informações, consulte
Como ativar e desativar a geração de registros de saída da porta serial.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
resource.type=gce_instance log_id(serialconsole.googleapis.com%2Fserial_port_1_output) textPayload=~("No space left on device" OR "Failed to mount" OR "You are in emergency mode")
Atualização do grupo gerenciado de instâncias
Esse tipo de evento ajuda a identificar quando seu grupo gerenciado de instâncias (MIG) foi atualizado. Por exemplo, VMs foram adicionadas ou removidas, ou o limite de tamanho foi atualizado. Para mais informações, consulte Aplicar atualizações de configuração de VM automaticamente em um MIG.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
resource.type=gce_instance_group_manager log_id(cloudaudit.googleapis.com%2Factivity) operation.first=true protoPayload.methodName=(beta.compute.instanceGroupManagers.patch OR v1.compute.instanceGroupManagers.patch)
Para mais informações, consulte Trabalhar com instâncias gerenciadas e Como solucionar problemas de grupos gerenciados de instâncias.
Escalonador automático de grupo de instâncias gerenciadas
Esse evento rastreia decisões de escalonamento tomadas pelo escalonador automático de um MIG. Essas decisões podem incluir alterações no tamanho recomendado para um MIG, ou uma mudança no status do próprio escalonador automático. Para mais informações, consulte Escalonamento automático de grupos de instâncias.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
resource.type=autoscaler log_id(cloudaudit.googleapis.com%2Fsystem_event) protoPayload.methodName=(compute.autoscalers.resize OR compute.autoscalers.changeStatus)
Tipos de evento do Personalized Service Health
Esta seção descreve os tipos do Personalized Service Health que podem ser exibidos em um painel.
Incidente do Google Cloud
Ao solucionar problemas, você pode querer diferenciar de falhas causadas por um serviço de sua propriedade e outra causada por um serviço do Google Cloud que você usa. Quando você ativa do Personalized Service Health em um painel; é possível conferir interrupções ou eventos de integridade do serviço para serviços do Google Cloud. Para uma lista dos serviços integrados Service Health, consulte Produtos do Google compatíveis.
Ao contrário de outros tipos de evento, os incidentes do Google Cloud não são identificados pela análise as entradas de registro. Se quiser receber notificações quando esses eventos ocorrerem, criar uma política de alertas. É possível selecionar uma política de alertas pré-configurada usando as opções na página Painel do Service Health. Para mais informações, consulte Guia de início rápido: configurar um alerta.
O Monitoring identifica incidentes do Google Cloud emitindo uma solicitação à API Service Health e filtrando resposta a incidentes relevantes para os dados que você está visualizando. A solicitação tem a seguinte configuração:
A enumeração
Relevance
está definida comoRELATED
,IMPACTED
ouPARTIALLY_RELATED
. Essa restrição garante que apenas seu painel exibe eventos dos serviços do Google Cloud que seu o projeto do Google Cloud está usando.A enumeração
DetailedState
não está definida comoFALSE_POSITIVE
.
As anotações do Service Health são exibidas com um horário de início e uma duração. A duração é mostrada alterando a cor do plano de fundo do gráfico. Dica referente a um incidente do Google Cloud identifica o seguinte:
- O serviço do Google Cloud.
- Se o incidente está aberto ou resolvido.
- Data e hora de início do evento.
- Ícones que mostram o número de produtos e locais afetados. Para listar os produtos ou locais afetados, coloque o cursor sobre o o ícone correspondente.
- Um botão Visualizar que, quando selecionado, abre a página de detalhes do o incidente.
Para mais informações sobre como enviar uma solicitação ao a API Service Health, consulte Verifique se há interrupções com o Service Health.
Para informações sobre solução de problemas, consulte Resolva problemas comuns no Service Health.
Tipos de evento de verificação de tempo de atividade
Esta seção descreve os tipos de evento de verificação de tempo de atividade que podem ser exibidos em uma mais avançado.
Falha na verificação de tempo de atividade
Esse tipo de evento ajuda a identificar falhas na verificação de tempo de atividade de ou várias regiões.
Se você quiser criar uma política de alertas com base em registros para esse tipo de evento, use a seguinte consulta:
log_id(monitoring.googleapis.com%2Fuptime_checks) ( resource.type=uptime_url OR resource.type=gce_instance OR resource.type=gae_app OR resource.type=k8s_service OR resource.type=servicedirectory_service OR resource.type=cloud_run_revision OR resource.type=aws_ec2_instance OR resource.type=aws_elb_load_balancer ) labels.uptime_result_type=UptimeCheckResult severity=NOTICE
Para informações sobre solução de problemas, consulte Resolver problemas de monitores sintéticos e verificações de tempo de atividade.
A seguir
Para saber como mostrar eventos nos painéis, consulte Mostrar eventos em um painel.