Participe do Firebase Summit on-line e presencialmente em 18 de outubro de 2022. Veja como o Firebase pode ajudar. Usando essa plataforma, é possível acelerar o desenvolvimento de apps, lançar seu aplicativo com confiança e fazer o escalonamento facilmente. Inscreva-se agora

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 os alertas do Monitoramento de desempenho para notificar os membros do projeto se as alterações de código ou solicitações de rede estiverem prejudicando o desempenho do 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 usa 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 condições a seguir forem verdadeiras:

  • O Firebase registrou pelo menos 100 amostras do trace _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 condições a seguir 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 alerta anteriormente gerado para o mesmo limite na versão mais recente do seu aplicativo.
  • (Somente para a Web) Não houve 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 condições a seguir 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 ultrapassou 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 alerta anteriormente levantado 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 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 app na última hora.
  • O valor agregado da métrica ultrapassou o limite definido durante a última hora:
    • frames 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 de 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 ultrapassou 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 ultrapassou o limite definido e o percentil configurado
  • Não houve alerta anteriormente levantado 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

Os alertas do Monitoramento de desempenho são enviados por meio de notificações por e-mail.

Para receber 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:

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

O Monitoramento de Desempenho valida os 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ê tem 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 Dados agregados em padrões de URL do cliente .

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

Ativar/desativar alertas para sua própria conta

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

No console do Firebase, no canto superior direito, acesse Alertas do Firebase > Configurações e defina sua preferência de conta para alertas do Monitoramento de desempenho.

Configurar um alerta

Para configurar alertas do Monitoramento de desempenho, você deve ter a permissão firebaseperformance.config.update . Os seguintes papéis incluem essa permissão obrigatória por padrão: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin e proprietário ou editor do projeto .

Se você ainda não tiver 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 dos 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 você 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 você deseja definir um alerta e localize a linha aplicável.

  4. Na extremidade direita da linha, abra o menu Overflow ( ) 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 os percentis padrão, consulte Acompanhar as principais métricas em seu painel .

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

  1. Acesse a guia Painel de monitoramento de desempenho no console do Firebase e selecione o aplicativo para o qual você 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 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 os percentis padrão, consulte Acompanhar 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 corresponder primeiro 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 significativo e eficaz 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 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.

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 frames lentos e congelados. O Monitoramento de Desempenho recomenda que você configure alertas para quadros congelados maiores que 1% e que você configure alertas para quadros lentos que ultrapassem 5%. Você descobrirá que esses valores estão presentes como as configurações padrão durante a configuração do alerta de desempenho. Para saber mais sobre frames lentos ou congelados excessivos e outras práticas recomendadas de desempenho de aplicativos, consulte as orientações do Google Play .