Primeiros passos com o Monitoramento de desempenho para iOS

Antes de começar

Adicione o Firebase ao seu projeto do iOS, caso ainda não tenha feito.

Etapa 1: adicionar o Monitoramento de desempenho ao seu app

  1. Abra o podfile que você criou para o projeto (ou execute pod init para criar um). Em seguida, adicione a seguinte linha na seção de destino:

    pod 'Firebase/Performance'
  2. No diretório do seu podfile, execute o seguinte comando para instalar o SDK do Monitoramento de desempenho:

    pod install
  3. Abra o arquivo .xcworkspace usando o Xcode.

  4. Importe o módulo do Firebase no UIApplicationDelegate:

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  5. Configure uma instância compartilhada do FirebaseApp, normalmente no método application:didFinishLaunchingWithOptions: do seu app:

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  6. Recompile o app.

O Firebase agora está monitorando traces de duração automáticos e solicitações de rede HTTP/S automáticas.

Etapa 2: gerar eventos de desempenho para a exibição inicial de dados

O Firebase pode detectar se você adicionou o SDK ao seu app quando ele recebe informações de eventos (como interações) do app. Se você ainda estiver desenvolvendo localmente, interaja com o app a fim de gerar eventos para a detecção do SDK, bem como coleta e processamento inicial de dados.

  1. Continue desenvolvendo o app usando um simulador ou dispositivo de teste.

  2. Gere eventos alternando o app entre o plano de fundo e o primeiro plano várias vezes, interagindo com o app ao navegar pelas telas e/ou acionando solicitações de rede.

  3. Acesse a seção Desempenho do Console do Firebase para ver se a plataforma detectou o SDK.

    Se você não vir a mensagem "SDK detectado", veja as dicas de solução de problemas.

  4. O Monitoramento de desempenho processa dados de eventos de desempenho antes de exibi-los no painel Desempenho. Você verá seus dados iniciais em até 24 horas depois de ver a mensagem de detecção do SDK.

    Se você não vir uma exibição dos seus dados iniciais, veja as dicas de solução de problemas.

Etapa 3: (opcional) ver se há eventos de desempenho nas mensagens de registro

  1. Ative a geração de registros de depuração da seguinte maneira:

    1. No Xcode (versão mínima 10.3), selecione Product > Scheme > Edit scheme.
    2. Selecione Run no menu à esquerda e depois a guia Arguments.
    3. Na seção Arguments Passed on Launch, adicione -FIRDebugEnabled.
  2. Verifique se há mensagens de erro nas mensagens de registro.

  3. O Monitoramento de desempenho marca as mensagens de registro com Firebase/Performance para que você possa filtrá-las.

  4. Verifique os seguintes tipos de registro que indicam que o Monitoramento de desempenho está registrando eventos de desempenho:

    • Logging trace metric: trace-name
    • Logging network request trace: url

Se o app não estiver registrando eventos de desempenho, veja as dicas de solução de problemas.

Etapa 4 (opcional): adicionar monitoramento personalizado para código específico

Crie traces personalizados para monitorar dados de desempenho associados a um código específico no app.

Os traces personalizados permitem avaliar quanto tempo leva para que seu app conclua uma tarefa específica ou um conjunto de tarefas, como carregar um conjunto de imagens ou consultar seu banco de dados. A métrica padrão de um trace personalizado é a duração, mas também é possível adicionar métricas personalizadas, como ocorrências em cache e avisos de memória.

No código, você define o início e o fim de um trace personalizado (e adiciona as métricas personalizadas desejadas) usando a API fornecida pelo SDK do Monitoramento de desempenho.

Veja Adicionar monitoramento personalizado para códigos específicos de aplicativo para saber mais sobre esses recursos e como adicioná-los ao seu aplicativo.

Etapa 5: implantar seu app e analisar os resultados

Depois de validar o Monitoramento de desempenho usando o simulador Xcode e um ou mais dispositivos de teste, você será capaz de implantar a versão atualizada do seu app para os usuários.

Você pode monitorar os dados de desempenho no painel Desempenho do Console do Firebase.

Problemas conhecidos

  • O Monitoramento de desempenho tem problemas de compatibilidade conhecidos com o GTMSQLite. Recomendamos não usar o Monitoramento de desempenho com apps que usam GTMSQLite.
  • O swizzling de métodos após chamar FirebaseApp.configure() pode interferir no SDK do Monitoramento de desempenho.
  • Problemas conhecidos no simulador de iOS 8.0 a 8.2 impedem o Monitoramento de desempenho de capturar eventos de desempenho. Esses problemas são corrigidos no simulador de iOS 8.3 e versões posteriores.
  • As conexões estabelecidas com backgroundSessionConfiguration da NSURLSession terão tempos de conexão mais longos do que o esperado. Essas conexões são executadas fora do processo, e o tempo reflete os eventos de retorno de chamada em processo.

A seguir