Personalizar alertas de velocidade

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.

O que aciona um alerta?

Os alertas de velocidade são acionados quando um problema no aplicativo ultrapassa um limite definido no Console do Firebase.

Você define o limite dos alertas de velocidade de acordo com uma porcentagem de sessões de usuários que foram impactadas por uma falha. É possível definir um valor limite entre 0,1% e 1% das sessões. Por padrão, o limite do alerta de velocidade é definido como 1%.

Um alerta é acionado se, durante um período de uma hora, as seguintes afirmações se aplicarem ao seu caso:

  • Um problema em um app ultrapassa o limite definido para esse aplicativo.
  • O aplicativo tem 250 sessões nesse período de tempo.
  • Não houve nenhum alerta prévio para o problema no aplicativo.

Atualizar o limite dos alertas

Para atualizar os alertas de velocidade, é preciso 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 um limite dos alertas de velocidade em cada um dos aplicativos registrados. Cada aplicativo pode ter um limite diferente.

  1. No Console do Firebase, acesse o painel do Crashlytics.
  2. Na parte de cima da página, selecione um app na lista suspensa de apps.
  3. Na barra superior do painel Problemas, abra o menu flutuante () e selecione Configurações de alerta de velocidade.
  4. Siga as instruções na tela para configurar o limite do 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.

É necessário ter a permissão firebase.projects.update para receber alertas do Crashlytics usando esse padrão. Os papéis a seguir incluem essa permissão, necessária por padrão: Administrador do Firebase ou Proprietário ou Editor do projeto.

Por padrão, todos os membros do projeto (que tenham as permissões necessárias para receber alertas) receberão um e-mail quando um alerta do Crashlytics for acionado.

Ativar/desativar alertas para sua conta

Para sua própria conta, é possível ativar/desativar os alertas do Crashlytics sem afetar outros membros do projeto. Você ainda precisa das permissões necessárias para receber alertas.

Para ativar ou desativar os alertas do Crashlytics, siga estas etapas:

  1. No canto de cima direito do Console do Firebase, acesse Alertas do Firebase.
  2. Em seguida, acesse Configurações e defina a preferência da conta para os alertas do Crashlytics.

Configurar alertas básicos para serviços de terceiros

Para alertas do Crashlytics, o Firebase oferece um mecanismo para enviar alertas aos seguintes serviços de terceiros: Slack, Jira ou PagerDuty. Configure essas opções básicas de alertas usando os fluxos de trabalho solicitados na guia Integrações 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 de terceiros

É possível enviar alertas do Crashlytics para o canal de notificação preferido da sua equipe usando o Cloud Functions para Firebase. 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, é possível personalizar totalmente as informações enviadas ao serviço de terceiros. Por exemplo, é possível incluir links diretos úteis no Console do Firebase ou adicionar informações específicas da empresa sobre solução de problemas.

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

  1. Configure o Cloud Functions para Firebase, que inclui as seguintes tarefas:

    1. Configure um ambiente de desenvolvimento para Node.js ou Python.
    2. Instalar e fazer login na CLI do Firebase.
    3. Inicializar o Cloud Functions para Firebase usando a CLI do Firebase.
  2. Criar e implantar uma função que capture um evento de alerta no Crashlytics e processe o payload do evento (por exemplo, publica as informações de alerta em uma mensagem no Discord).

Para saber mais sobre todos os eventos de alerta do Crashlytics que você pode capturar, acesse a documentação de referência para Alertas do Crashlytics.