Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Configurar alertas para problemas de desempenho

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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

Você pode configurar e personalizar alertas para seu aplicativo, que o 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 por você para um percentil especificado (se aplicável) no Firebase console. Os alertas são acionados somente se seu aplicativo usar uma versão do SDK compatível em tempo real .

hora de início do aplicativo

Quando você configura um alerta para a hora de início do aplicativo, o alerta é acionado se todas as seguintes condições forem verdadeiras:

  • O Firebase registrou pelo menos 100 amostras do rastreamento _app_start para a 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 alerta gerado anteriormente para o mesmo limite na versão mais recente do seu aplicativo.

rastreamentos de código personalizados

Quando você configura um alerta para uma métrica de rastreamento de código personalizado, o alerta é acionado se todas as seguintes condições forem verdadeiras:

  • O Firebase registrou pelo menos 100 amostras do 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 do aplicativo durante a última hora e para o percentil configurado.
  • (Somente para iOS+ e Android) Não houve nenhum alerta 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 3 dias .

solicitações de rede

Quando você configura um alerta para uma métrica de solicitação de rede, o alerta é acionado se todas as seguintes condições forem verdadeiras:

  • O Firebase registrou pelo menos 100 amostras correspondentes 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 gerado anteriormente para o mesmo limite nos últimos 3 dias .

renderização de tela

Quando você configura um alerta para uma métrica de renderização de tela, o alerta é acionado se todas as seguintes condições 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 alerta gerado anteriormente para o mesmo limite na versão mais recente do seu aplicativo.

carregamentos de página

Quando você configura um alerta para uma métrica de carregamento de página, o alerta é acionado se todas as condições a seguir forem verdadeiras:

  • O Firebase registrou pelo menos 100 amostras do 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 de 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 gerado 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.

Receber alertas

Obter alertas padrão

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

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

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

Ativar/desativar 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 de monitoramento de desempenho, siga estas etapas:

  1. No console do Firebase, no canto superior direito, vá para Firebase alerts .
  2. Em seguida, 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 de monitoramento de desempenho para o canal de notificação preferido de sua equipe, usando o Cloud Functions para Firebase. Por exemplo, você pode escrever uma função que captura um evento de alerta para o tempo de início lento do aplicativo e publica as informações de 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. Baixe Node.js e npm.
    2. Instale e faça login na Firebase CLI.
    3. Inicialize o Cloud Functions para Firebase usando a Firebase CLI.
  2. Escreva e implante uma função que capture um evento de alerta do Monitoramento de desempenho e manipule a carga útil 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 você pode capturar, acesse a documentação de referência para alertas de monitoramento de desempenho .

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

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 condições for verdadeira:

  • O alerta é criado para uma ID de recurso para a 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 para esse 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 de monitoramento de desempenho, você deve ter a permissão firebaseperformance.config.update . As funções a seguir incluem essa permissão obrigatória por padrão: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin e Project Owner ou Editor .

Caso ainda não tenha feito isso, adicione o SDK de monitoramento de desempenho mais recente ao seu aplicativo. Para obter mais informações, consulte os guias de introdução para as plataformas Web , Android , Apple e Flutter .

Em cada um de seus aplicativos registrados, use a tabela Traces ou o cartão de relatório 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. Acesse 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 Overflow ( ) e selecione Alert settings .

  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 os percentis padrão, consulte Acompanhe as principais métricas em seu painel .

Configurar um alerta no cartão de relatório do painel

  1. Acesse 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 Cartão de relatório, localize o cartão de métrica para o qual deseja configurar um alerta.

  3. No cartão de métrica desejado, abra o menu Overflow ( ) e selecione Alert settings .

  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 os percentis padrão, consulte Acompanhe as principais métricas em seu painel .

Práticas recomendadas 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 qualquer padrão de URL personalizado 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 maneira 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 tenha se estabilizado por alguns dias. Lembre-se de 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 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.

carregamentos de página da web

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

renderizações de tela

Para garantir uma experiência de aplicativo ideal, as sessões do usuário devem estar livres de quadros lentos e congelados. O Monitoramento de desempenho recomenda que você configure alertas para quadros congelados maiores que 1% e que configure alertas para quadros lentos que excedam 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 quadros excessivamente lentos ou congelados e outras práticas recomendadas de desempenho de aplicativos, consulte as orientações do Google Play .