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 app 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 app 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.
  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.

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/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 superior direito do console do Firebase, acesse alertas do Firebase.
  2. Em seguida, acesse Configurações e defina a preferência da conta para alertas do Crashlytics.

Configurar alertas básicos para serviços terceirizados

Para alertas do Crashlytics, o Firebase oferece um mecanismo para enviar alertas a estes serviços terceirizados: Slack, Jira ou PagerDuty. Configure as opções básicas de alerta usando os fluxos de trabalho indicados 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 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:

  1. 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.
  2. 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.