Use alertas de velocidade para notificar sua equipe quando algum erro individual estiver causando um problema urgente no app. Para o Crashlytics, um problema é um conjunto de falhas semelhantes ou eventos em que o app não está respondendo (ANR).
O que aciona um alerta?
Os alertas de velocidade são acionados quando um problema no app ultrapassa determinados limites que você configura no console do Firebase.
Você define o limite dos alertas de velocidade de acordo com uma porcentagem de usuários e o número mínimo de usuários que foram impactados pela falha ou ANR. É possível definir o valor limite de porcentagem entre 0% e 100% das sessões. O limite mínimo de usuários pode ser definido como qualquer número maior ou igual a 10. Por padrão, o limite do alerta de velocidade é definido como 1% das sessões e 25 usuários.
Um alerta é acionado se, durante um período de 30 minutos, todas as seguintes condições forem verdadeiras:
- Um problema em um app ultrapassa o limite de porcentagem definido e o número mínimo de usuários definido para esse app.
- O app tem pelo menos 10 usuários nesse período.
- Não houve nenhum alerta prévio para o problema no app nessa versão.
Configurar limites de alerta de velocidade
Para configurar os limites de alerta de velocidade, é necessário ter
a permissão firebasecrashlytics.config.update. Os papéis a seguir incluem essa permissão obrigatória por padrão:
Administrador do Firebase Crashlytics,
Administrador do Firebase Quality,
Administrador do Firebase ou
Proprietário ou Editor do projeto.
Configure limites de alerta de velocidade para cada um dos apps registrados. Cada aplicativo pode ter um limite diferente.
Faça login no console Firebase e selecione seu projeto.
Clique em e selecione Configurações do projeto. Selecione a guia Alertas.
Acesse o card de alertas Crashlytics e selecione a guia Alertas de velocidade.
Configure os limites de alerta para o app.
Receber alertas
Receber alertas padrão
Por padrão, o Firebase pode enviar alertas do Crashlytics por e-mail. Os alertas e as regressões de velocidade também podem ser vistos no console do Firebase.
Você precisa da permissão firebase.projects.update para receber alertas do Crashlytics usando
esse padrão. Estes papéis incluem a permissão
necessária por padrão:
Administrador do Firebase ou
Proprietário ou Editor do projeto.
Por padrão, quando um alerta do Crashlytics for acionado, um e-mail será enviado para todos os membros do projeto que tenham as permissões necessárias para receber alertas.
Ativar ou desativar alertas para sua conta
Para sua própria conta, é possível ativar ou desativar os alertas do Crashlytics sem afetar outros membros do projeto. Você ainda precisa das permissões necessárias para receber alertas.
Faça login no console Firebase e selecione seu projeto.
Clique em e selecione Configurações do projeto. Selecione a guia Alertas.
Acesse o card de alertas Crashlytics e selecione a guia Alertas de velocidade.
Defina a preferência da conta para alertas do Crashlytics.
Configurar alertas básicos para serviços de terceiros
Para alertas do Crashlytics, o Firebase oferece um mecanismo para enviar alertas a estes serviços terceirizados: Slack, Jira ou PagerDuty.
Configure essas opções básicas de alertas usando os fluxos de trabalho orientados na guia Integrações nas
Configurações do projeto. Selecione qual configuração é usada para apps individuais e configure o destino de outros alertas no card Crashlytics da guia "Alertas" nas
Configurações do projeto .
Se você quiser mais controle e personalização para enviar alertas a qualquer serviço de terceiros (não limitado apenas ao Slack, Jira ou PagerDuty), confira a seção Configurar alertas avançados para serviços de terceiros em que são descritas as opções avançadas de alerta.
Configurar alertas avançados para serviços terceirizados
É possível enviar alertas do Crashlytics ao canal de notificação preferido da sua equipe usando o Cloud Functions for Firebase. Por exemplo, é possível criar uma função que capture um evento de alerta para alertas de velocidade e publique as informações dele em um serviço terceirizado, como Discord, Slack ou Jira. Com esse mecanismo avançado de alertas, as informações enviadas ao serviço terceirizado podem ser totalmente personalizadas. Por exemplo, é possível incluir links diretos no console do Firebase ou adicionar informações específicas da empresa para a 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:
- Configure um ambiente de desenvolvimento para Node.js ou Python.
- Instale e faça login na CLI do Firebase.
- 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.