Configurar alertas para problemas de desempenho

Use os alertas do Monitoramento de desempenho para enviar notificações aos membros do projeto se as alterações no código ou as solicitações de rede estiverem prejudicando o desempenho do app.

É possível configurar e personalizar os alertas para o app. Eles informam quando o desempenho de um evento ultrapassa um limite definido.

O que aciona um alerta?

Um alerta é acionado quando uma métrica do app ultrapassa um limite definido para um percentil especificado (se aplicável) no Console do Firebase. Os alertas vão ser acionados somente se o app usar uma versão compatível e em tempo real do SDK.

Horário de início do app

Ao configurar um alerta para o horário de início do app, ele só vai ser acionado se todas as seguintes condições forem verdadeiras:

  • O Firebase registrou na última hora pelo menos 100 amostras do trace _app_start na versão mais recente do seu app.
  • A duração do trace _app_start excedeu o limite definido pelo app durante a última hora e para o percentil configurado.
  • Não houve nenhum alerta prévio para o mesmo limite na versão mais recente do app.

Traces de código personalizados

Ao configurar um alerta para uma métrica de trace de código personalizado, ele só vai ser acionado se todas as condições a seguir forem verdadeiras:

  • O Firebase registrou na última hora pelo menos 100 amostras do trace de código personalizado na versão mais recente do app.
  • A duração do trace excedeu o limite definido pelo app durante a última hora e para o percentil configurado.
  • Não houve nenhum alerta prévio para o mesmo limite na versão mais recente do seu app (apenas para iOS e Android).
  • Não houve nenhum alerta prévio para o mesmo limite nos últimos três dias (somente na Web).

Solicitações da rede

Ao configurar um alerta para uma métrica de solicitação da rede, ele só vai ser acionado se todas as condições a seguir forem verdadeiras:

  • O Firebase registrou na última hora pelo menos 100 amostras que corresponderam ao padrão de URL em todas as versões do seu app.
  • O valor agregado da métrica ultrapassou o limite definido durante a última hora:
    • tempo de resposta – o valor agregado excedeu o limite definido para o percentil configurado.
    • taxa de sucesso – o valor agregado ficou abaixo do limite definido para todos os usuários (somente para iOS+/Android).
  • Não houve nenhum alerta prévio para o mesmo limite nos últimos três dias.

Renderização da tela

Ao configurar um alerta para uma métrica de renderização de tela, ele só vai ser acionado se todas as condições a seguir forem verdadeiras:

  • O Firebase registrou na última hora pelo menos 100 amostras de renderização de tela da versão mais recente do app.
  • O valor agregado da métrica ultrapassou o limite definido durante a última hora:
    • frames congelados – o valor agregado ultrapassou o limite definido.
    • frames lentos – o valor agregado ultrapassou o limite definido.
  • Não houve nenhum alerta prévio para o mesmo limite na versão mais recente do app.

Carregamentos de página

Ao configurar um alerta para uma métrica de carregamento de página, ele só vai ser acionado se todas as condições a seguir forem verdadeiras:

  • O Firebase registrou na última hora pelo menos 100 amostras de carregamento da página no seu app.
  • O valor agregado da métrica ultrapassou o limite definido durante a última hora e para o percentil configurado:
    • First Input Delay – o valor agregado excedeu o limite definido e o percentil configurado.
    • First Contentful Paint – o valor agregado excedeu o limite definido e o percentil configurado.
    • first paint – o valor agregado excedeu o limite estabelecido e o percentil configurado.
  • Não houve nenhum alerta prévio para o mesmo limite nos últimos três dias.

Saiba mais sobre como configurar alertas, percentis padrão e práticas recomendadas para definir alertas em tipos específicos de traces e métricas.

Os alertas para outras métricas de desempenho ou de integrações do Firebase com o Slack, Jira e o PagerDuty não estão disponíveis nos alertas do Monitoramento de desempenho.

Receber alertas

Receber alertas padrão

Por padrão, o Firebase pode enviar alertas do Monitoramento de desempenho por e-mail.

Para receber essas notificações, você precisa ter a permissão firebaseperformance.config.update. Por padrão, os papéis a seguir incluem essa permissão:

Os alertas e as configurações deles abrangem todo o projeto. Isso significa que, por padrão, todos os membros do projeto que não forem um grupo de e-mails e que tiverem as permissões necessárias para os alertas vão receber um e-mail quando um alerta de desempenho for acionado.

Ativar/desativar os alertas para sua conta

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

Para ativar ou desativar os alertas do Monitoramento de desempenho, siga estas instruções:

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

Configurar alertas avançados para serviços de terceiros

Também é possível enviar alertas do Monitoramento de desempenho para o canal de notificação preferido da sua equipe usando o Cloud Functions para Firebase. Por exemplo, é possível escrever uma função que capture um evento de alerta em tempos de inicialização lento do app e publique as informações do alerta em um serviço de terceiros, como Discord, Slack ou Jira.

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 Monitoramento de desempenho 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 de desempenho que podem ser capturados, acesse a documentação de referência dos alertas do Monitoramento de desempenho.

Remoção automática de alertas inválidos

O Monitoramento de desempenho valida alertas para garantir que os dados sejam válidos e que os alertas estejam em uso ativo. Os alertas serão considerados válidos se uma das seguintes condições for verdadeira:

  • O alerta é criado para um ID de recurso em que o Monitoramento de desempenho recebeu dados nos últimos 90 dias.
  • O alerta foi criado recentemente para um padrão de URL personalizado. Depois de criar um padrão de URL personalizado e configurar um alerta, você tem 90 dias para enviar os dados desse padrão. Se nenhum dado for enviado no período de 90 dias, o Monitoramento de desempenho removerá esse alerta. Para mais informações sobre padrões de URL personalizados, consulte Agregar dados em padrões de URL de cliente.

Se uma dessas condições não for atendida, o Monitoramento de desempenho removerá o alerta.

Configurar um alerta

Para configurar os alertas do Monitoramento de desempenho, é necessário ter a permissão firebaseperformance.config.update. Os papéis a seguir incluem essa permissão necessária por padrão: Administrador de desempenho do Firebase, Administrador de qualidade do Firebase, Administrador do Firebase e Proprietário/editor do projeto.

Primeiro, adicione o SDK do Monitoramento de desempenho mais recente ao seu app. Para mais informações, consulte os guias de iniciação para as plataformas Web, Android, Apple e Flutter.

Em cada um dos apps registrados, use a tabela de Traces ou o card de relatório do painel para configurar um alerta para cada métrica que você quer monitorar. Cada app pode ter um conjunto diferente de alertas, cada um com um limite diferente (ou nenhum alerta).

Configurar um alerta na tabela de Traces

  1. Acesse a guia Painel do Monitoramento de desempenho no Console do Firebase e selecione o app em que você quer configurar um alerta.

  2. Role até a tabela de Traces na parte de baixo da tela.

  3. Selecione a guia do tipo de trace para o qual você quer definir um alerta e encontre a linha aplicável.

  4. No canto direito da linha, abra o menu flutuante () e selecione Configurações de alerta.

  5. Siga as instruções na tela para definir o limite do alerta e o percentil (se aplicável) do app ou para ativar/desativar o alerta. Os percentis padrão são o 90º para Android e iOS e o 75° para a Web. Para saber mais sobre os percentis padrão, consulte Rastrear as principais métricas no painel.

Configurar um alerta no card de relatório do painel

  1. Acesse a guia Painel do Monitoramento de desempenho no Console do Firebase e selecione o app em que você quer configurar um alerta.

  2. Na guia "Card do relatório", localize o card de métricas em que você quer configurar um alerta.

  3. No card de métricas desejado, abra o menu flutuante () e selecione Configurações de alerta.

  4. Siga as instruções na tela para definir o limite do alerta e o percentil (se aplicável) do app ou para ativar/desativar o alerta. Os percentis padrão são o 90º para Android e iOS e o 75° para a Web. Para saber mais sobre os percentis padrão, consulte Rastrear as principais métricas no painel.

Práticas recomendadas para definir alertas de desempenho

Solicitações da rede

O Firebase agrega os dados de solicitações de rede semelhantes nos padrões de URL, que podem ser um dos seguintes:

Configurar alertas para seus padrões de URL personalizados

Recomendamos configurar alertas para qualquer padrão de URL personalizado que você tenha configurado. Como o Firebase primeiro tenta corresponder uma solicitação a um padrão de URL personalizado, as solicitações semelhantes são mapeadas de maneira mais consistente para o mesmo padrão de URL. Isso torna os alertas de um padrão de URL personalizado mais significativos e eficazes para sua equipe, porque você já identificou esse padrão específico de solicitações como importante para o app.

Configurar alertas para padrões de URL automáticos

Ao configurar um alerta para um padrão de URL automático, verifique se ele está estabilizado há alguns dias. Lembre que os padrões de URL automáticos podem mudar com o tempo, e as configurações de alerta não são transferidas para os novos padrões de URL. Isso pode resultar em alertas incorretos ou ausentes nos padrões importantes para você. Outra opção é criar um padrão de URL personalizado para garantir que ele seja estável.

Carregamentos de página da Web

Para saber os limites recomendados para a medição de métricas da Web, consulte a documentação das Principais métricas da Web.

Renderizações da tela

Para garantir uma experiência ideal com app, as sessões do usuário não podem conter frames lentos e congelados. O Monitoramento de desempenho recomenda que você configure alertas para os frames congelados maiores que 1% e alertas para frames lentos que excedam 5%. Esses valores vão estar definidos como padrão durante a configuração do alerta de desempenho. Para saber mais sobre o excesso de frames lentos ou congelados e outras práticas recomendadas de desempenho de apps, consulte as orientações do Google Play.