Limitação de taxa e comportamento de coleta

Uma solicitação de perfil pode não ser concluída ou não fornecer resultados imediatamente nas seguintes situações:

  • Limitação de taxa: a coleta é limitada para proteger o desempenho do dispositivo (consulte Como funciona a limitação de taxa).
  • Encerramento do app antes da entrega: se o app for fechado ou falhar durante a captura, o sistema vai interromper e salvar o perfil em segundo plano e entregar o resultado na fila na próxima vez que o app for executado (em primeiro ou segundo plano) e registrar um listener global. O sistema retém os resultados não entregues na fila por até sete dias aguardando o registro do listener. Se o app não registrar um listener em sete dias, o resultado na fila será descartado.

  • Outros erros: se a coleta falhar (por exemplo, devido a uma solicitação inválida ou a um erro interno), o ProfilingResult vai informar o código e a mensagem de erro.

Como funciona a limitação de taxa

Como a captura de perfis consome muitos recursos, o ProfilingManager aplica limitação de taxa nos níveis de processo e de sistema para proteger o desempenho do dispositivo e a duração da bateria. Diferentes tipos de perfil têm custos de recursos diferentes, e o sistema rastreia cotas em janelas de tempo contínuas em dois níveis:

  • Limitação de taxa de processamento: rastreia o custo de recursos dos perfis coletados pelo app individual em relação a uma cota por app. Cada app recebe a mesma cota, e a atividade de criação de perfil de outros apps no dispositivo não afeta o limite do seu app. Se o app atingir a cota em qualquer período, as solicitações vão falhar com ERROR_FAILED_RATE_LIMIT_PROCESS.
  • Limitação de taxa do sistema: rastreia o custo combinado de recursos dos perfis coletados em todos os apps no dispositivo em relação a uma cota global compartilhada. Como todos os apps contribuem para esse limite em todo o dispositivo, uma solicitação pode falhar com ERROR_FAILED_RATE_LIMIT_SYSTEM mesmo quando o app não esgotou a própria cota de processos.

Gerenciar o volume de perfis na produção

Como as limitações de taxa no dispositivo dependem do tipo de perfil e da atividade geral do sistema, não tente rastrear ou prever cotas exatas de limitação de taxa local no app. Em vez disso, concentre-se em fazer a solicitação de criação de perfil quando ocorrer uma jornada do usuário ou anomalia relevante e deixe que o ProfilingManager lide com a limitação no dispositivo.

Para maximizar a cobertura no campo e manter os custos de largura de banda de upload e armazenamento gerenciáveis, controle o volume geral do perfil usando plataformas de segmentação e experimentação de população (como configuração remota ou sinalizações de teste A/B):

  • Amostra na sua base de usuários: ative a criação de perfil para uma porcentagem pequena e aleatória de sessões de usuário, em vez de solicitar perfis de todos os usuários em cada execução.
  • Segmentar por coorte: segmente versões específicas de apps, níveis de dispositivos, versões do SO ou regiões em que você está investigando uma regressão (por exemplo, ativando a coleta de heap dumps do Java em dispositivos com pouca RAM que apresentam taxas elevadas de OOM).
  • Segmentar acionadores e solicitações diretas entre usuários: atribua diferentes acionadores de criação de perfil e solicitações diretas de criação de perfil a segmentos de usuários separados para que alguns usuários registrem um perfil enquanto outros registram um perfil diferente. Como todas as capturas em um dispositivo compartilham a mesma cota por app, isolá-las em segmentos de usuários evita que acionadores ou solicitações de maior frequência esgotem a cota necessária para capturas de menor frequência em um único dispositivo.