Configurar alertas para problemas de desempenho

Use os alertas do Performance Monitoring 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 serão 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 Performance Monitoring.

Receber alertas

Receber alertas padrão

Por padrão, o Firebase pode enviar alertas do Performance Monitoring por e-mail.

Para receber alertas do Performance Monitoring com esse mecanismo padrão, é necessária 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. Ou seja, por padrão, todos os membros do projeto receberão um e-mail quando um alerta de desempenho for acionado. Alertas são enviados apenas para membros do projeto com o permissões necessárias para receber alertas e a endereços de e-mail individuais, e não a grupos de contas, como Grupos do Google ou contas do Google Workspace).

Ativar/desativar alertas para sua conta

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

Para ativar ou desativar os alertas do Performance Monitoring, 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 os alertas do Performance Monitoring.

Configurar alertas avançados para serviços de terceiros

Também é possível enviar alertas do Performance Monitoring ao canal de notificação preferido da sua equipe usando o Cloud Functions for 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 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 no Performance Monitoring 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 Performance Monitoring 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 Performance Monitoring 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 Performance Monitoring removerá esse alerta. Para mais informações sobre padrões de URL personalizados, consulte Dados agregados em padrões de URL de cliente.

Se uma dessas condições não for atendida, o Performance Monitoring removerá o alerta.

Configurar um alerta

Para configurar alertas do Performance Monitoring, você precisa 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 ou editor do projeto.

Se ainda não tiver feito isto, adicione o SDK do Performance Monitoring 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. No console do Firebase, acesse a guia Painel do Performance Monitoring e depois selecione o app em que você quer e 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. No console do Firebase, acesse a guia Painel do Performance Monitoring e depois selecione o app em que você quer e 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 de 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 Performance Monitoring recomenda que você configure alertas de frames congelados maiores que 1% e alertas de frames lentos que excedem 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.