Configurar alertas para problemas de desempenho

Use alertas do Monitoramento de desempenho para notificar os membros do projeto se alterações no código ou solicitações de rede estiverem prejudicando o desempenho do seu aplicativo.

Você pode configurar e personalizar alertas para seu aplicativo, que notificam quando o desempenho de um evento ultrapassa um limite definido.

O que aciona um alerta?

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

hora de início do aplicativo

Ao configurar um alerta para o horário de início do aplicativo, o alerta será acionado se todas as condições a seguir forem verdadeiras:

  • O Firebase registrou pelo menos 100 amostras do rastreamento _app_start da versão mais recente do seu aplicativo na última hora.
  • A duração do rastreamento _app_start excedeu o limite definido do aplicativo durante a última hora e para o percentil configurado.
  • Não houve nenhum alerta gerado anteriormente para o mesmo limite na versão mais recente do seu aplicativo.

rastreamentos de código personalizados

Ao configurar um alerta para uma métrica de rastreamento de código customizada, o alerta será acionado se todas as condições a seguir forem verdadeiras:

  • O Firebase registrou pelo menos 100 amostras de rastreamento de código personalizado para a versão mais recente do seu aplicativo na última hora.
  • A duração do rastreamento excedeu o limite definido pelo aplicativo durante a última hora e para o percentil configurado.
  • (Somente para iOS+ e Android) Nenhum alerta foi gerado anteriormente para o mesmo limite na versão mais recente do seu aplicativo.
  • (Somente para Web) Não houve nenhum alerta gerado anteriormente para o mesmo limite nos últimos três dias .

solicitações de rede

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

  • O Firebase registrou pelo menos 100 amostras que correspondiam ao padrão de URL em todas as versões do seu aplicativo na última hora.
  • 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 : (somente para iOS+/Android) o valor agregado ficou abaixo do limite definido em todos os usuários
  • Não houve nenhum alerta emitido anteriormente para o mesmo limite nos últimos 3 dias .

renderização de tela

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

  • O Firebase registrou pelo menos 100 amostras de renderização de tela para a versão mais recente do seu aplicativo na última hora.
  • O valor agregado da métrica ultrapassou o limite definido durante a última hora:
    • quadros congelados : o valor agregado excedeu o limite definido
    • quadros lentos : o valor agregado excedeu o limite definido
  • Não houve nenhum alerta gerado anteriormente para o mesmo limite na versão mais recente do seu aplicativo.

carregamentos de página

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

  • O Firebase registrou pelo menos 100 amostras de carregamento da página do seu aplicativo na última hora.
  • O valor agregado da métrica ultrapassou o limite definido durante a última hora e para o percentil configurado:
    • primeiro atraso de entrada : o valor agregado excedeu o limite definido e o percentil configurado
    • primeira pintura com conteúdo : o valor agregado excedeu o limite definido e o percentil configurado
    • primeira pintura : o valor agregado excedeu o limite definido e o percentil configurado
  • Não houve nenhum alerta emitido anteriormente para o mesmo limite nos últimos 3 dias .

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

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

Receba alertas

Receba alertas padrão

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

Para receber alertas do Monitoramento de desempenho por meio desse mecanismo padrão, você deve ter a permissão firebaseperformance.config.update . As seguintes funções incluem esta permissão necessária por padrão:

Os alertas e suas configurações abrangem todo o projeto. Isso significa que, por padrão, cada membro do projeto (que não seja um grupo de e-mail e tenha as permissões necessárias para receber alertas) receberá um e-mail quando um alerta de desempenho for acionado.

Ative/desative alertas para sua própria conta

Para sua própria conta, você pode ativar/desativar alertas de monitoramento de desempenho sem afetar outros membros do projeto. Observe que você ainda precisa das permissões necessárias para receber alertas.

Para ativar ou desativar os alertas do Monitoramento de desempenho, siga estas etapas:

  1. No console do Firebase, no canto superior direito, vá para Alertas do Firebase .
  2. Então vá para Configurações e defina sua preferência de conta para alertas de monitoramento de desempenho.

Configure alertas avançados para serviços de terceiros

Você também pode enviar alertas do Monitoramento de desempenho para o canal de notificação preferido da sua equipe usando o Cloud Functions para Firebase. Por exemplo, você pode escrever uma função que capture um evento de alerta para um horário de início lento do aplicativo e publique as informações de alerta em um serviço de terceiros, como Discord, Slack ou Jira.

Para configurar recursos avançados de alertas 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. Instale e faça login na CLI do Firebase.
    3. Inicialize o Cloud Functions para Firebase usando a CLI do Firebase.
  2. Escreva e implante uma função que capture um evento de alerta do Monitoramento de desempenho e lide com a carga útil do evento (por exemplo, publique as informações de alerta em uma mensagem no Discord).

Para saber mais sobre todos os eventos de alerta de desempenho que você pode capturar, acesse a documentação de referência para 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 são considerados válidos se uma das seguintes situações for verdadeira:

  • O alerta é criado para um ID de recurso para o qual 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ê terá 90 dias para enviar dados desse padrão. Se nenhum dado for enviado dentro do período de 90 dias, o Monitoramento de Desempenho removerá esse alerta. Para obter mais informações sobre padrões de URL personalizados, consulte Agregar dados em padrões de URL do cliente .

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

Configurar um alerta

Para configurar alertas do Monitoramento de desempenho, você deve ter a permissão firebaseperformance.config.update . As seguintes funções incluem essa permissão necessária por padrão: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin e Proprietário ou Editor do projeto .

Se ainda não tiver feito isso, adicione o SDK do Monitoramento de desempenho mais recente ao seu aplicativo. Para obter mais informações, consulte os guias de primeiros passos para as plataformas Web , Android , Apple e Flutter .

Em cada um dos seus aplicativos registrados, use a tabela Traces ou o boletim do Dashboard para configurar um alerta para cada métrica que você deseja monitorar. Cada aplicativo pode ter um conjunto diferente de alertas, cada um com um limite diferente (ou não ter nenhum alerta).

Configurar um alerta na tabela Traces

  1. Vá para a guia Painel de monitoramento de desempenho no console do Firebase e selecione o aplicativo para o qual deseja configurar um alerta.

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

  3. Selecione a guia do tipo de rastreamento para o qual deseja definir um alerta e localize a linha aplicável.

  4. Na extremidade direita da linha, abra o menu flutuante ( ) e selecione Configurações de alerta .

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

Configurar um alerta no boletim do Dashboard

  1. Vá para a guia Painel de monitoramento de desempenho no console do Firebase e selecione o aplicativo para o qual deseja configurar um alerta.

  2. Na guia Boletim, localize o cartão de métrica para o qual você deseja configurar um alerta.

  3. No cartão de métrica desejado, abra o Menu Overflow ( ) e selecione Configurações de alerta .

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

Melhores práticas para definir um alerta de desempenho

Solicitações de rede

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

Configure alertas para seus padrões de URL personalizados

Recomendamos configurar alertas para quaisquer padrões de URL personalizados que você configurou. Como o Firebase tenta primeiro corresponder uma solicitação a um padrão de URL personalizado, solicitações semelhantes são mapeadas de forma mais consistente para o mesmo padrão de URL. Isso torna os alertas para 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 seu aplicativo.

Configure alertas para padrões de URL automáticos

Ao configurar um alerta para um padrão de URL automático, certifique-se de que o padrão de URL automático se estabilizou por alguns dias. Lembre-se de que os padrões automáticos de URL podem mudar com o tempo e as configurações de alerta não são transferidas para novos padrões de URL. Isso pode resultar em alertas incorretos ou ausentes para os padrões de seu interesse. Você também pode considerar a criação de um padrão de URL personalizado para garantir que esse padrão seja estável.

Carregamento de páginas da web

Para saber os limites recomendados para medir métricas da web, consulte a documentação Core Web Vitals .

Renderizações de tela

Para garantir uma experiência ideal com o aplicativo, as sessões do usuário não devem ter frames lentos e congelados. O Monitoramento de Desempenho recomenda que você configure alertas para quadros congelados superiores a 1% e que configure alertas para quadros lentos superiores a 5%. Você descobrirá que esses valores estão presentes como configurações padrão durante a configuração do alerta de desempenho. Para saber mais sobre frames excessivamente lentos ou congelados e outras práticas recomendadas de desempenho de aplicativos, consulte as orientações do Google Play .