Um incidente é um registro de quando a condição de uma política de alertas é atendida. Normalmente, o Cloud Monitoring abre um incidente e envia uma notificação quando um registro correspondente à condição da política de alertas é recebido. No entanto, os incidentes não são criados nas seguintes circunstâncias:
- A política está adiada ou desativada.
- O número de políticas de alertas ou incidentes excede os limites de alertas atuais.
- Outra entrada de registro faz com que a mesma condição seja atendida para um incidente em aberto. Nesse caso, o Monitoring envia outra notificação para o mesmo incidente.
Para cada incidente, o Monitoring cria uma página de Detalhes do incidente que permite gerenciar o incidente e informa dados que podem ajudar a resolver o problema. Por exemplo, a página Detalhes do incidente mostra uma lista de entradas de registro que correspondem à consulta da política de alertas com base em registros. Você também pode encontrar links para incidentes relacionados.
Este documento descreve como encontrar seus incidentes. Também descreve como usar a página Detalhes do incidente para gerenciar incidentes de políticas de alertas com base em registros, que avaliam dados de entradas de registro armazenados em registros individuais no Cloud Logging.
Esse recurso só é compatível com projetos Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
Antes de começar
Para ter as permissões necessárias para visualizar e gerenciar incidentes usando o console Google Cloud , peça ao administrador para conceder a você os seguintes papéis do IAM no seu projeto:
-
Para conferir incidentes usando o console do Google Cloud :
-
Leitor de incidentes do Cloud Console do Monitoring (
roles/monitoring.cloudConsoleIncidentViewer
) -
Leitor de contas do Stackdriver (
roles/stackdriver.accounts.viewer
)
-
Leitor de incidentes do Cloud Console do Monitoring (
-
Gerencie incidentes usando o console Google Cloud :
-
Editor de incidentes do Console do Cloud Monitoring (
roles/monitoring.cloudConsoleIncidentEditor
) -
Leitor de contas do Stackdriver (
roles/stackdriver.accounts.viewer
)
-
Editor de incidentes do Console do Cloud Monitoring (
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.
Para mais informações sobre os papéis do Cloud Monitoring, consulte Controlar o acesso com o Identity and Access Management.
Encontrar incidentes
Para conferir uma lista de incidentes no seu projeto Google Cloud , faça o seguinte:
-
No console Google Cloud , acesse a página notifications Alertas:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
A página Alertas mostra informações sobre suas políticas de alertas, adiamentos e incidentes:
- O painel Resumo lista o número de incidentes abertos.
- O painel Incidentes mostra os incidentes abertos mais recentes. Para listar os incidentes mais recentes na tabela, incluindo aqueles que foram fechados, clique em Mostrar incidentes fechados.
Para conferir os detalhes de um incidente específico, selecione-o na lista.
A página Detalhes do incidente é aberta. Para mais informações sobre a página Detalhes do incidente, consulte a seção Investigar um incidente desta página.
Encontrar incidentes mais antigos
O painel Incidentes na página Alertas mostra os incidentes abertos mais recentes. Para localizar incidentes mais antigos, siga um destes procedimentos:
Para percorrer as entradas na tabela Incidentes, clique em arrow_back_ios Mais recentes ou em arrow_forward_ios Mais antigos.
Para acessar a página Incidentes, clique em Ver todos os incidentes. Na página Incidentes, é possível fazer o seguinte:
- Mostrar incidentes fechados: para listar todos os incidentes na tabela, clique em Mostrar incidentes fechados.
- Filtrar incidentes: para mais informações sobre como adicionar filtros, consulte Filtrar incidentes.
- Confirme ou feche um incidente ou adie a política de alertas dele. Para acessar essas opções, clique em more_vert Mais opções na linha do incidente e faça uma seleção no menu. Para mais informações, consulte Gerenciar incidentes.
Filtrar incidentes
Quando você insere um valor na barra de filtro, apenas os incidentes correspondentes ao filtro são listados na tabela Incidentes. Se você adicionar vários filtros, um incidente será exibido somente se atender a todos os filtros.
Para adicionar um filtro à tabela de incidentes, faça o seguinte:
Na página Incidentes, clique em filter_list Filtrar tabela e selecione uma propriedade de filtro. As propriedades do filtro incluem todas as opções a seguir:
- Estado do incidente
- Nome da política de alertas
- quando o incidente foi aberto ou fechado;
Selecione um valor no menu secundário ou digite um valor na barra de filtro.
Investigar um incidente
A página Detalhes do incidente contém informações que podem ajudar você a identificar a causa de um incidente.
Explorar entradas de registro
Analise as entradas de registro para encontrar padrões e problemas recorrentes relacionados à sua investigação. O painel Registros mostra entradas de registro que correspondem à consulta da sua política de alertas com base em registros.
- Para ver as entradas de registro no Explorador de registros, clique em Ver no Explorador de registros e selecione um projeto de escopo.
- Para abrir o painel de registros no Metrics Explorer, clique em query_stats Explorar dados.
Ver informações complementares
A seção Rótulos mostra os rótulos e valores do recurso monitorado incluídos na entrada de registro que causou o incidente. Essas informações podem ajudar a identificar o recurso monitorado específico que causou o incidente. Para mais informações, consulte Anotar incidentes com rótulos.
A seção Documentação mostra o modelo de documentação para notificações que você forneceu ao criar a política de alertas. Essas informações podem incluir uma descrição do que a política de alertas monitora e dicas para mitigação. Para mais informações, consulte Anotar notificações com documentação definida pelo usuário.
Se você não configurou a documentação para sua política de alertas, o painel Documentação mostra "Nenhuma documentação está configurada".
Confira incidentes relacionados
Para ajudar você a descobrir problemas subjacentes no aplicativo, analise incidentes relacionados a outras condições de políticas de alertas.
A seção Incidentes relacionados mostra uma lista de incidentes que correspondem a uma das seguintes opções:- O incidente foi criado quando uma condição da mesma política de alertas foi atendida.
- O incidente compartilha um rótulo com o incidente mostrado na página Detalhes do incidente.
Gerenciar incidentes
Os incidentes estão em um dos seguintes estados:
error Aberto: a condição da política de alertas com base em registros foi atendida, e o incidente ainda está aberto. Se a mesma condição for atendida novamente e já houver um incidente aberto, um novo incidente não será aberto.
warning Reconhecido: o incidente está aberto e foi marcado manualmente como confirmado. Normalmente, esse status indica que o incidente está sendo investigado.
check_circle Fechado: você encerrou manualmente o incidente, ou ele foi fechado automaticamente após o período de fechamento automático expirar.
Confirmar incidentes
Recomendamos que você marque um incidente como confirmado quando começar a investigar a causa dele.
Para marcar um incidente como confirmado, faça o seguinte:
- No painel Incidentes da página Alertas, clique em Ver todos os incidentes.
Na página Incidentes, encontre o incidente que você quer confirmar e siga um destes procedimentos:
- Clique em more_vert Mais opções e selecione Confirmar.
- Abra a página de detalhes do incidente e clique em Confirmar incidente.
Suspender uma política de alertas
Para impedir que o Monitoring crie incidentes e envie notificações durante um período específico, adie a política de alertas relacionada. Quando você adia uma política de alertas, os incidentes relacionados a ela permanecem abertos, mas não causam mais notificações. Os incidentes são fechados com base na duração do fechamento automático da política de alertas.
Para criar uma suspensão de um incidente que você está visualizando, faça o seguinte:
Na página Detalhes do incidente, clique em Adiar política.
Selecione a duração da soneca. Depois de selecionar a duração, o adiamento começa imediatamente.
Você também pode adiar uma política de alertas na página Incidentes. Para isso, encontre o incidente que você quer adiar, clique em more_vert Mais opções e selecione Adiar. É possível adiar as políticas de alertas durante interrupções para evitar mais notificações durante o processo de solução de problemas.
Fechar incidentes
É possível permitir que o Monitoring feche um incidente ou encerrar o incidente.
O Monitoring fecha automaticamente um incidente quando a duração do fechamento automático da política de alertas expira. Por padrão, a duração do fechamento automático é de 7 dias. A duração mínima de fechamento automático é de 30 minutos.
A duração do fechamento automático especifica o tempo que precisa decorrer, sem uma repetição da causa do incidente, antes que ele seja fechado. Por isso, quando um incidente está aberto e a causa dele ocorre novamente, ele pode ficar aberto por mais tempo do que a duração do fechamento automático.
Para fechar um incidente, faça o seguinte:
- No painel Incidentes da página Alertas, clique em Ver todos os incidentes.
Na página Incidentes, encontre o incidente que você quer fechar e siga um destes procedimentos:
- Clique em more_vert Ver mais e selecione Fechar incidente
- Abra a página Detalhes do incidente e clique em Fechar incidente.
Se você vir a mensagem Unable to close incident
, tente novamente depois de alguns
minutos. Não é possível fechar um novo incidente imediatamente porque as condições
que causaram o incidente ainda são consideradas ativas pelo sistema
de alertas.
Retenção e limites de dados
Para informações sobre limites e o período de retenção de incidentes, consulte Limites para alertas.
A seguir
- Para criar e gerenciar políticas de alertas com a API Cloud Monitoring ou pela linha de comando, consulte Gerenciar políticas de alertas por API.