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
ProfilingResultvai 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_SYSTEMmesmo 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.