Configurar alertas avançados para canais de notificação personalizados

O Firebase oferece duas opções para configurar e enviar alertas a canais de notificação personalizados.

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

Você pode usar o Cloud Monitoring para enviar alertas totalmente personalizados a canais de notificação personalizados com base nos dados do Crashlytics e (opcionalmente) nas informações de sessões do Firebase que você exportou para o Cloud Logging.
Enviar alertas padrão do Crashlytics para canais de notificação personalizados

É possível usar o Cloud Functions para enviar os alertas Crashlytics padrão a canais de notificação personalizados.

(Recomendado) 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

Verifique se o projeto do Firebase está no plano de preços do Blaze de pagamento por uso.
Configure a exportação para o Cloud Logging de dados do Crashlytics e, opcionalmente, de sessões do Firebase.
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
```

Enviar alertas padrão do Crashlytics para canais de notificação personalizados

O Firebase oferece alertas Crashlytics padrão. Consulte a lista na página de visão geral das opções de alerta. No entanto, as informações nesses alertas padrão e nos canais de notificação podem não ser suficientes para suas necessidades.

Nesses casos, você pode usar Cloud Functions for Firebase para enviar esses alertas Crashlytics padrão a canais de notificação personalizados. Por exemplo, é possível criar uma função que capture um evento de alerta para alertas de velocidade e publique as informações do alerta em um serviço de terceiros, como Discord, Slack ou Jira.

Com esse mecanismo de alerta avançado, também é possível personalizar as informações enviadas ao serviço de terceiros. Por exemplo, além das informações padrão fornecidas pelo Firebase, você também pode incluir links diretos úteis no console do Firebase ou informações específicas da empresa sobre solução de problemas.

Para configurar recursos avançados de alerta usando o Cloud Functions for Firebase, siga estas etapas:

Configure o Cloud Functions para Firebase, que inclui as seguintes tarefas:
1. Configure um ambiente de desenvolvimento para Node.js ou Python.
2. Instale e faça login na CLI do Firebase.
3. Inicialize o Cloud Functions for Firebase usando a CLI do Firebase.
Crie e implante uma função que capture um evento de alerta do Crashlytics e processe o payload do evento, por exemplo, que poste as informações de alerta em uma mensagem do Discord.

Para saber mais sobre todos os eventos de alerta do Crashlytics que podem ser capturados, acesse a documentação de referência dos alertas do Crashlytics.

Saiba mais sobre como processar alertas do Crashlytics usando o Cloud Functions for Firebase