Esta página fornece dicas de solução de problemas para usar os recursos e as ferramentas do Monitoramento de desempenho.
Primeiras verificações para a solução de problemas
As duas verificações a seguir são práticas recomendadas gerais para qualquer pessoa antes da solução de problemas.
1. Verificar se há eventos de desempenho nas mensagens de registro
Verifique suas mensagens de registro para confirmar que o SDK do Monitoramento de desempenho está captando eventos de desempenho.
Como ver se há eventos de desempenho nas mensagens de registro
Ative a geração de registros de depuração da seguinte maneira:
- No Xcode (versão mínima 12.2), selecione Product > Scheme > Edit scheme.
- Selecione Run no menu à esquerda e depois a guia Arguments.
- Na seção Arguments Passed on Launch, adicione
-FIRDebugEnabled.
Verifique se há mensagens de erro nas mensagens de registro.
O Monitoramento de desempenho marca as mensagens de registro com
Firebase/Performancepara que você possa filtrá-las.Verifique os seguintes tipos de registros que indicam que o Monitoramento de desempenho está registrando eventos de desempenho:
Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URLLogging network request trace: URL
Clique no URL para ver seus dados no Console do Firebase. Pode levar alguns instantes até que os dados sejam atualizados no painel.
Se o app não estiver registrando eventos de desempenho, veja as dicas de solução de problemas.
2. Verificar o Painel de status do Firebase
Verifique o Painel de status do Firebase caso haja uma interrupção conhecida no Firebase ou no Monitoramento de desempenho.
Primeiros passos com o Monitoramento de desempenho
Se você está começando a usar o Monitoramento de desempenho (iOS | Android | Web), as dicas a seguir podem ajudar com problemas que envolvem a detecção do SDK pelo Firebase ou a exibição dos primeiros dados de desempenho no Console do Firebase.
O SDK foi adicionado ao app, mas o console ainda pede para adicioná-lo
O Firebase pode detectar se você adicionou o SDK do Monitoramento de desempenho ao seu app quando ele recebe informações de eventos (como interações) do aplicativo. O painel Desempenho do Console do Firebase costuma exibir a mensagem "SDK detectado" em até 10 minutos após iniciar o app. Em seguida, o painel exibirá os dados iniciais processados em 30 minutos.
Se já tiverem passado mais de 10 minutos desde que você adicionou a última versão do SDK ao app e ainda não tiver visto nenhuma alteração, verifique suas mensagens de registro para conferir se o Monitoramento de desempenho está registrando eventos. Realize as etapas apropriadas, conforme descrito abaixo, para solucionar problemas de uma mensagem atrasada de detecção de SDK.
O app está registrando eventos: etapas de solução de problemas
Se você ainda estiver desenvolvendo localmente, tente gerar mais eventos para a coleta de dados:
Continue desenvolvendo o app usando um simulador ou dispositivo de teste.
Gere eventos alternando o plano de fundo e o primeiro plano do app várias vezes. Interaja com o app navegando pelas telas e/ou acionando solicitações de rede.
Verifique se o arquivo de configuração do Firebase (
Google-Service-Info.plist) foi adicionado corretamente ao app e se você não o modificou. Especificamente, verifique o seguinte:O nome do arquivo de configuração não está anexado com caracteres adicionais, como
(2).O arquivo de configuração está na raiz do seu projeto do XCode e adicionado aos destinos corretos.
O ID do app iOS (
GOOGLE_APP_ID) no Firebase listado no arquivo de configuração está correto no seu app. Encontre o ID do app no cartão Seus apps das settings Configurações do projeto.
Se algo parecer errado com o arquivo de configuração no seu app, tente o seguinte:
Exclua o arquivo de configuração atual do app.
Siga estas instruções para fazer o download de um novo arquivo de configuração e adicioná-lo ao seu app iOS.
Se o SDK estiver registrando eventos e tudo estiver configurado corretamente, mas você ainda não estiver vendo a mensagem de detecção do SDK (após duas horas), entre em contato com o suporte do Firebase.
O app não está registrando eventos: etapas de solução de problemas
Verifique se o SDK do Monitoramento de desempenho não está desativado. Para isso, use uma das seguintes sinalizações no arquivo
Info.plist:firebase_performance_collection_enabledfirebase_performance_collection_deactivated
Verifique se o Monitoramento de desempenho não está desativado no ambiente de execução (Swift | Obj-C).
Se você não encontrar nada desativado no seu app, entre em contato com o suporte do Firebase.
O console informa que o SDK foi detectado, mas nenhum dado é exibido
O Monitoramento de desempenho processa dados de eventos de desempenho antes de exibi-los no painel Desempenho.
Se já tiverem passado mais de 24 horas desde que a mensagem "SDK detectado" apareceu e você ainda não estiver vendo dados, verifique o Painel de status do Firebase caso haja uma interrupção conhecida. Se não houver interrupção, entre em contato com o suporte do Firebase.
Como solucionar problemas gerais
Se você tiver adicionado o SDK e estiver usando o Monitoramento de desempenho no app, as dicas a seguir poderão ajudar com problemas gerais que envolvem recursos e ferramentas do Monitoramento de desempenho.
O aplicativo não está registrando eventos de desempenho
Se você não estiver vendo eventos de desempenho nas mensagens de registro, tente estas etapas de solução de problemas:
Verifique se o SDK do Monitoramento de desempenho não está desativado. Para isso, use uma das seguintes sinalizações no arquivo
Info.plist:firebase_performance_collection_enabledfirebase_performance_collection_deactivated
Verifique se o Monitoramento de desempenho não está desativado no ambiente de execução (Swift | Obj-C).
Se você não encontrar nada desativado no seu app, entre em contato com o suporte do Firebase.
Faltam dados de traces de tela no painel de desempenho
Se você não tiver dados para traces de renderização de tela, tente as etapas de solução de problemas a seguir:
Faltam dados de traces personalizados no painel de desempenho
Você está vendo os dados de desempenho dos traces coletados automaticamente, mas não dos traces de código personalizados? Realize estas etapas de solução de problemas:
Verifique a configuração de traces de código personalizados instrumentados com a API Trace, principalmente o seguinte:
- Os nomes dos traces de código e métricas personalizados precisam cumprir os seguintes
requisitos: nenhum espaço em branco no início ou no final, nenhum sublinhado
(
_) no início e tamanho máximo de 32 caracteres. - Todos os traces precisam ser iniciados e interrompidos. Os traces que não forem iniciados, que não forem interrompidos ou que forem interrompidos antes de ser iniciados não serão registrados.
- Os nomes dos traces de código e métricas personalizados precisam cumprir os seguintes
requisitos: nenhum espaço em branco no início ou no final, nenhum sublinhado
(
Verifique as mensagens de registro para confirmar se o Monitoramento de desempenho está registrando os traces de código personalizados esperados.
Se o Monitoramento de desempenho estiver registrando eventos, mas nenhum dado for exibido após 24 horas, entre em contato com o suporte do Firebase.
Faltam dados de solicitação de rede no painel de desempenho
Se estiverem faltando dados de solicitação de rede, tente as seguintes etapas de solução de problemas:
Verifique a incompatibilidade da biblioteca de rede. O Monitoramento de desempenho coleta automaticamente as métricas de solicitações de rede que usam as seguintes bibliotecas de rede:
- Para Swift: URLSession e URLConnection
- Para Objective-C: NSURLSession e NSURLConnection
É possível adicionar o monitoramento personalizado para solicitações de rede.
Dependendo do comportamento do código e das bibliotecas de rede usadas pelo código, o Monitoramento de desempenho só pode gerar relatórios sobre solicitações de rede concluídas. Isso significa que as conexões HTTP/S que ficaram abertas talvez não sejam registradas.
Os dados de solicitação de rede não são agregados conforme esperado
Saiba mais sobre como o Monitoramento de desempenho agrega dados de solicitação de rede em padrões de URL.
Você também pode testar os padrões de URL personalizados.
Perguntas frequentes
Quando clico nas guias No dispositivo ou Rede no console, a página é redirecionada automaticamente para a parte inferior da guia Painel. Como faço para ver os traces que estavam nessas páginas?
Redesenhamos a seção "Monitoramento de desempenho" do Console do Firebase para que a guia Painel exiba as principais métricas e todos os traces em um só lugar.
Em breve, removeremos as guias No dispositivo e Rede. Assim, agora, ao clicar em uma dessas guias, direcionamos você para o novo local para ver todos os traces (a tabela de traces, que está na parte inferior do Painel).
Essa tabela tem as mesmas informações que as guias No dispositivo e Rede, além de alguns recursos extras, incluindo a capacidade de classificar os traces com base na variação percentual de uma métrica específica. Para visualizar todas as métricas e os dados de um trace específico, clique no nome do trace na tabela de traces.
Veja seus traces nestas subguias da tabela:
- Traces de solicitação de rede (prontos para uso e personalizados): subguia Solicitações de rede
- Traces de código personalizados: subguia Traces personalizados
- Traces de inicialização do app, de app em primeiro plano e de app em segundo plano: subguia Traces personalizados
- Traces de renderização da tela: subguia Renderização de tela
- Traces de carregamento da página: subguia Carregamento de página
Para saber mais sobre a tabela de traces e como visualizar métricas e dados, acesse a página de visão geral do console (iOS | Android | Web).
Ainda é possível navegar para as guias No dispositivo e Rede clicando em um nome na tabela de traces (que direciona você para a página de métricas do trace) e, em seguida, na localização atual na parte superior da tela.
Os dados do Monitoramento de desempenho estão levando mais tempo do que o esperado para serem exportados ao BigQuery. Isso não deveria acontecer em tempo real?
Se você tiver ativado a integração do BigQuery com o Monitoramento de desempenho do Firebase, os dados serão exportados para o BigQuery entre 12 e 24 horas após o fim do dia (Horário do Pacífico).
Por exemplo, os dados de 19 de abril estarão disponíveis no BigQuery em 20 de abril entre às 12h e meia-noite (todas as datas e horas são do Horário do Pacífico).
Processamento e exibição de dados quase em tempo real
O que são os dados de desempenho "quase em tempo real"?
O Monitoramento de desempenho do Firebase processa os dados de desempenho coletados à medida que eles chegam, o que resulta em dados quase em tempo real no Console do Firebase. Usamos o termo "quase em tempo real" porque os dados processados são exibidos no console alguns minutos após a coleta.
Para aproveitar o processamento de dados quase em tempo real, verifique se o app usa uma versão de SDK compatível com tempo real.
Como faço para ter dados de desempenho quase em tempo real sobre meu app?
Para aproveitar o processamento de dados quase em tempo real, veja se o app usa uma versão do SDK do Monitoramento de desempenho compatível com o processamento de dados em tempo real.
Estas são as versões do SDK compatíveis:
- iOS: v7.3.0 ou posterior
- Android: v19.0.10 ou posterior (ou a BoM do Android para Firebase v26.1.0 ou posterior)
- Web: v7.14.0 ou posterior
Sempre recomendamos o uso da versão mais recente do SDK, mas qualquer uma das opções acima permitirá que o Monitoramento de desempenho processe os dados quase em tempo real.
Quais versões do SDK do Monitoramento de desempenho são consideradas compatíveis com os dados em tempo real?
Estas são as versões do SDK compatíveis:
- iOS: v7.3.0 ou posterior
- Android: v19.0.10 ou posterior (ou a BoM do Android para Firebase v26.1.0 ou posterior)
- Web: v7.14.0 ou posterior
Sempre recomendamos o uso da versão mais recente do SDK, mas qualquer uma das opções acima permitirá que o Monitoramento de desempenho processe os dados quase em tempo real.
E se eu não atualizar o app para usar uma versão do SDK compatível com o processamento em tempo real?
Se o app não usar uma versão do SDK compatível com esse processamento, ainda será possível ver todos os dados de desempenho dele no Console do Firebase. No entanto, a exibição dos dados de desempenho será atrasada em cerca de 36 horas a partir do momento da coleta.
Eu fiz a atualização para uma versão do SDK compatível com o processamento em tempo real, mas alguns usuários ainda utilizam versões antigas do app. Continuarei vendo os dados de desempenho desses usuários no Console do Firebase?
Sim. Você verá os dados de desempenho de todos os usuários independentemente da versão do SDK utilizada por uma instância do app.
No entanto, se você estiver analisando dados recentes (menos de 36 horas), os dados exibidos serão de usuários de instâncias do app usando uma versão do SDK compatível com tempo real. Já os dados não recentes incluirão informações de desempenho de todas as versões do app.
Como entrar em contato com o suporte do Firebase
Ao entrar em contato com o suporte do Firebase, sempre inclua o ID do app do Firebase. Você encontra o ID do app do Firebase no cartão Seus apps das settings Configurações do projeto.