Configurar e enviar alertas personalizados para canais de notificação personalizados

O Firebase oferece alertas padrão do Crashlytics. Consulte a página de visão geral de alertas. No entanto, esses alertas padrão e os canais de notificação podem não ser suficientes para suas necessidades.

Nesses casos, você pode usar o Cloud Monitoring para enviar alertas personalizados a canais de notificação personalizados com base nos dados do Crashlytics (e, opcionalmente, dados de sessões do Firebase) que você exportou para Cloud Logging.

Para usar Cloud Monitoring em alertas personalizados, configure uma política de alertas, que descreve as circunstâncias em que você quer receber alertas e como quer ser notificado.

Por exemplo, se a taxa ficar abaixo de um limite específico, o Cloud Monitoring poderá enviar uma mensagem de alerta personalizada para um endereço de e-mail específico ou postar em um serviço de terceiros, como Discord, Slack ou Jira. Também é possível personalizar totalmente as informações enviadas no alerta, como incluir links diretos úteis no console do Firebase ou informações específicas da empresa para solução de problemas.

Na documentação do Google Cloud, saiba mais sobre Cloud Monitoring e alertas, incluindo preços.

Pré-requisitos

1. Verifique se o projeto do Firebase está no plano de preços do Blaze de pagamento por uso.

2. Configure a exportação para o Cloud Logging de dados do Crashlytics e, opcionalmente, de sessões do Firebase.

3. Configure canais de notificação.

Configurar uma política de alertas

Estas são instruções gerais. Para instruções detalhadas, consulte a documentação do Google Cloud (por exemplo: Criar políticas de alertas de limite de métrica ou Usar o PromQL para criar políticas de alertas).

Ao executar consultas, você pode configurar um alerta com base em registros ou em SQL:

• Configurar um alerta baseado em registros:

  1. Execute uma consulta em Logs Explorer.

  2. Clique no botão Adicionar alerta que aparece.

  3. Siga as instruções na tela para adicionar um alerta com base em registros.

• Configurar um alerta com base em SQL:

  1. Execute uma consulta na Análise de dados de registros.

  2. Clique no botão Adicionar alerta que aparece.

  3. Siga as instruções na tela para adicionar um alerta baseado em SQL.

Como alternativa, é possível configurar alertas para suas métricas com base em registros usando a ferramenta de configuração de políticas no console Google Cloud, em que você pode escolher uma das seguintes opções:

• Builder: A interface do console oferece um fluxo de trabalho guiado para criar a política de alertas.

• PromQL: Você fornece uma consulta PromQL para sua política de alertas.

  Exemplo de consulta PromQL

  Por exemplo, digamos que você tenha criado duas métricas com base em registros para os dados de sessões do Firebase e do Crashlytics exportado:

  • Uma métrica chamada firebase/crashlytics_events com um rótulo de errorType, e é definida como:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

  • Outra métrica chamada firebase/session_events com um rótulo de eventType, e é definida como:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

  Confira um exemplo de consulta PromQL usando essas métricas com base em registros para alertar quando a taxa de sessões sem falhas cair abaixo de 70%:

  1 - (sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/crashlytics_events", errorType="FATAL"}[5m])) /
  sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/session_events", eventType="SESSION_START"}[5m]))
  ) < 0.7