Mostrar eventos em um painel

Neste documento, descrevemos como configurar um painel para mostrar anotações de eventos. Um evento é uma atividade, como uma implantação ou uma falha, que afeta a operação de um sistema. Mostrar anotações de evento pode ajudar você a correlacionar dados de diferentes fontes ao solucionar um problema.

Sobre as anotações de eventos

É possível mostrar eventos na maioria dos painéis listados no Página Painéis do console do Google Cloud. 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 configurar os tipos de evento que são mostrados por um painel ou em uma guia Observabilidade, use o console do Google Cloud. No caso dos painéis que você cria, classificados como personalizados, também é possível usar a API Cloud Monitoring.

A menos que você use a API Cloud Monitoring ou realize uma ação para salvar seus seleções de tipo de evento, suas seleções se aplicarão somente a sua sessão atual. Quando você usa o console do Google Cloud, a ação de fixar as seleções salva elas.

Para obter uma lista de tipos de eventos, referências de solução de problemas e outras informações, consulte a página Tipos de evento.

Os tipos de evento a seguir podem estar ativados em um painel ou Guia Observabilidade, mesmo que você não tenha selecionado nenhum tipo de evento:

Quando um tipo de evento é adicionado automaticamente, ele é um tipo de evento recomendado. Você pode deixar esses tipos de evento no estado recomendado, salvá-los no JSON do painel ou descartá-los, o que remove a recomendação. Para determinar quais tipos de evento serão salvos, expanda o menu Selecionar tipos de evento e abra a seção Fixadas.

Como os eventos são identificados

Os painéis consultam diferentes fontes de dados para identificar os eventos para mostrar no seu painel:

  • Os eventos de alerta são identificados e monitoramento. Eventos de alerta mostram quando incidentes foram abertos.

  • Os eventos do Personalized Service Health são identificados pela consultas que o Monitoring envia para a API Service Health. Esses eventos indicam quando há uma interrupção em um serviço do Google Cloud.

  • Todos os outros tipos de eventos são identificados analisando as entradas de registro que passar pelos coletores do Cloud Logging no projeto do Google Cloud. Essas entradas de registro incluem as geradas pelo seu projeto e aqueles encaminhados para seu projeto. Para receber notificações quando um desses eventos ocorrer, crie uma política de alertas com base em registros. Na política de alertas, use as consultas fornecidos na página Tipos de evento.

Como os eventos são mostrados

À medida que todos os eventos ocorrem, os gráficos no painel são com anotações. Os eventos identificados na análise de entradas de registro são mostrados referência de tempo. Em contrapartida, os eventos do Service Health são mostrados um horário de início e, em seguida, o plano de fundo do gráfico é alterado durante do evento. Esses eventos também exibem um ícone de coração.

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:

Gráfico mostrando anotações de evento informativo e de aviso.

Como mostrado na captura de tela anterior, a dica para um evento inclui informações como as seguintes:

  • Nome do evento.
  • Data e hora de início do evento.
  • Para eventos do Service Health, os ícones que mostram o número dos 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 uma página com mais informações informações sobre o evento. Por exemplo, ela pode abrir a Análise de registros, para exibir as entradas de registro, ou abrir a página de detalhes para um evento do Service Health.

Os filtros do painel, que limitam os dados mostrados por um painel, geralmente filtram dados e eventos de séries temporais.

Antes de começar

  • Para ter as permissões necessárias para visualizar e mostrar eventos em painéis e para criar políticas de alertas, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

    • Consultar e criar painéis e políticas de alertas: Editor do Monitoring (roles/monitoring.editor).
    • Confira e mostre eventos identificados nas entradas de registro de acesso sem dados que foram criadas no seu projeto do Google Cloud: Leitor de registros (roles/logging.viewer).
    • Acesse e mostre os eventos identificados nas entradas de registro criadas no seu projeto do Google Cloud: Leitor de registros particulares (roles/logging.privateLogViewer).
    • Veja eventos do Service Health: Leitor do Custom Service Health (roles/servicehealth.viewer)

    Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

    Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

  • Para mostrar eventos do Service Health nos seus e ative a API Service Health:

    Ative a API

Mostrar eventos

Nesta seção, descrevemos como configurar um painel ou uma guia Observabilidade. para mostrar eventos.

Configurar painéis para mostrar eventos

Esta seção descreve como configurar painéis listados em a página Painéis do console do Google Cloud para mostrar eventos.

Para obter uma lista de tipos de eventos, referências de solução de problemas e consultas que podem ser usadas com a Análise de registros ou com políticas de alertas com base em registros, consulte a página Tipos de evento.

Console

Para mostrar eventos em um painel, faça o seguinte:

  1. No console do Google Cloud, acesse a página  Painéis:

    Ir para Painéis

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

  2. Selecione o painel que você quer acessar.

  3. Na barra de ferramentas do painel, verifique se O botão Eventos está ativado.

    Se o botão de alternância Eventos não for exibido, o painel de controle não podem mostrar eventos.

  4. Clique em Selecionar tipos de evento e escolha os tipos painel seja exibido e, em seguida, execute um dos seguintes procedimentos:

    • Se você estiver visualizando um painel personalizado e quiser salvar seu tipo de evento seleções e clique em Fixar selecionados. Se o salvamento automático estiver desativado em seu painel de controle, vá para a barra de ferramentas do painel e Clique em Salvar.

      Ao fixar suas seleções, você modifica a definição JSON do mais avançado. Portanto, quando o painel for reaberto, suas seleções são carregados e o painel mostra anotações para os tipos de evento.

    • Caso contrário, clique em OK.

    Depois de atualizar a lista de tipos de eventos a serem exibidos, O Cloud Monitoring emite consultas, o que leva alguns instantes, e adiciona as anotações aos gráficos do painel.

  5. Para visualizar um resumo de um evento ou acessar links para informações adicionais, use o ponteiro para ativar a dica.

API

Para configurar um painel personalizado para mostrar eventos, Inclua um campo annotations no objeto Dashboard. O campo annotations contém uma instância de um objeto DashboardAnnotations. que contém dois campos:

  • O campo defaultResourceName lista os padrões do painel para os projetos do Google Cloud para pesquisar eventos. Se você não especificar esse campo, seu projeto selecionado é pesquisado.

  • Uma matriz de objetos EventAnnotation. Cada contém o seguinte:

    • Um campo displayName, que permite definir o rótulo na para alternar eventos específicos. Quando esse campo não é especificado ou quando o valor deste campo é uma string vazia, o nome padrão do evento é mostrado.
    • Um campo enabled, que controla o valor do botão de alternância do evento. Quando true, o botão fica na posição on, e os eventos são mostrados no painel. Quando false, o botão fica na posição off.
    • Um campo eventType, que contém um valor do EventType enumeração.
    • Um campo filter, que permite especificar uma consulta a ser anexada ao uma consulta específica do evento. Quando o valor desse campo é uma string vazia, a consulta específica do evento é usada.
    • Um campo resourceNames, que permite definir uma lista de projetos do Google Cloud para pesquisar eventos. Quando esse campo for uma matriz vazia, o projeto selecionado será pesquisado.

Veja a seguir um exemplo de objeto annotations para uma atualização de cluster evento. O campo filter neste exemplo restringe os eventos a um cluster específico:

"annotations": {
  "defaultResourceNames": [],
  "eventAnnotations": [
    {
      "displayName": "",
      "enabled": true,
      "eventType": "GKE_CLUSTER_UPDATE",
      "filter": "resource.labels.cluster_name=my-cluster",
      "resourceNames": []
    }
  ]
}

Para informações detalhadas sobre como usar a API Cloud Monitoring para criar painéis, consulte Criar e gerenciar painéis por API e Exemplo: ativar eventos nos painéis.

Configure a guia Observabilidade para mostrar eventos

Esta seção descreve como configurar a observabilidade para mostrar eventos. Alguns serviços, como Compute Engine e Google Kubernetes Engine, forneça uma guia Observabilidade que exiba métricas e dados de registro.

Console

Se quiser configurar a guia Observabilidade para mostrar eventos, faça o seguinte:

  1. Acesse a guia Observabilidade de um serviço ou produto.

    Por exemplo, acesse a página Clusters do Kubernetes e depois Selecione a guia Observabilidade. Da mesma forma, acesse o Cargas de trabalho do Kubernetes ou à página de detalhes de um instância de máquina virtual (VM) e selecione a guia Observabilidade.

  2. Verifique se o menu Painel está definido como Predefinido. Não é possível exibir eventos em painéis personalizados.

  3. Na barra de ferramentas, clique em Selecionar eventos. e preencha a caixa de diálogo.

    Depois de atualizar a lista de eventos a serem mostrados, as consultas são emitidas para recuperar os dados do evento, e o painel é atualizado.

    Quando o botão Selecionar eventos não aparece a guia não pode ser configurada para exibir eventos.

API

Indisponível.

Mais detalhes do evento

Quando você visualiza um gráfico que mostra anotações de eventos, use os links fornecidos na dica para acessar informações imprecisas ou inadequadas.

Para acessar detalhes sobre um evento específico, clique em Visualizar.

A página do console do Google Cloud aberta pelo botão Visualizar é determinada pelo o tipo de evento. Por exemplo, para um evento de verificação de tempo de atividade, esse botão abre o painel da verificação de tempo de atividade. Para um tipo de rede tipo de evento, a Análise de registros poderá ser aberta.

Criar políticas de alerta

Quando eventos são identificados pela análise das entradas de registro que pelos coletores do Cloud Logging no projeto do Google Cloud, pode ser notificado quando esses eventos ocorrerem por Como configurar um alerta com base em registros. Consulta de políticas de alertas com base em registros as entradas de registro conforme elas são recebidas. Quando a consulta retorna um valor um incidente é criado e notificações são enviadas.

Console

Para criar um alerta com base em registros, faça o seguinte:

  1. Se você não configurou um canal de notificação, faça o seguinte:

    1. No console do Google Cloud, acesse a página  Alertas:

      Acessar Alertas

      Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

    2. Clique em Editar canal de notificação.
    3. Acesse o tipo de canal de notificação que você quer configurar. Clique em Adicionar novo e preencha a caixa de diálogo.

  2. No console do Google Cloud, acesse a página Análise de registros:

    Acessar a Análise de registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.

  3. Na barra de ferramentas, selecione Criar alerta.

  4. Digite um nome para a política de alertas e clique em Próxima.

  5. Na seção Definir entradas de registro para alertas, Insira uma consulta ou atualize a consulta que foi copiada do painel Consulta. quando você selecionar Criar alerta.

    Para cada tipo de evento, a página Tipos de evento lista uma adequada para uso em uma política de alertas com base em registros.

  6. Preencha a caixa de diálogo e clique em Salvar.

API

Para criar uma política de alertas com base em registros usando a API Cloud Monitoring: faça o seguinte:

  1. Identifique a consulta a ser incluída na condição do e a política de alertas. Para cada tipo de evento, os A página Tipos de evento lista uma adequada para uso em uma política de alertas com base em registros.

  2. Crie o arquivo JSON que contém a representação do alerta política. Para obter mais informações sobre esta etapa e um exemplo, consulte Projetar a política de alertas.

  3. Invoque o método de API alertPolicies.create. Por exemplo, é possível emitir gcloud alpha monitoring policies create kubectl.

Ocultar eventos

Console

Para ocultar todos os eventos, na barra de ferramentas do painel, verifique se a opção Eventos está desativada.

Para ocultar um tipo de evento, desative o botão de alternância desse tipo posição

API

Para ocultar um tipo de evento em um painel personalizado, encontre a Objeto EventAnnotation para o tipo de evento. e defina o campo enabled como false.

Para informações detalhadas sobre como usar a API Cloud Monitoring, consulte Criar e gerenciar painéis por API.

A seguir