Rastreamento automático de contêiner HTML5 - Mobile Platform as a Service: Central de Documentação do Alibaba Cloud

Ao usar o contêiner Nebula do mPaaS para carregar uma página HTML5, o sistema coleta automaticamente estatísticas sobre ações de carregamento e desempenho, além de capturar exceções. Esse processo facilita o rastreamento de dados de carregamento de páginas HTML5. Este tópico descreve como integrar a função de rastreamento automático do contêiner Nebula e visualizar os dados coletados.

Pré-requisitos

Para integrar a função de rastreamento automático de contêiner HTML5 do mPaaS, certifique-se de que:

Você criou um aplicativo no console do mPaaS.
Você concluiu as etapas para adicionar o SDK e o projeto cliente integrou o NebulaLogging.framework.

Procedimento

Inicialize as configurações

Para integrar a função de rastreamento automático do contêiner Nebula, ative o monitoramento de rastreamento HTML5 durante a inicialização do contêiner.

// Monitoring delegation. Add automatic HTML5 container tracking.
 NBLogConfigurationGet().shouldInjectSPMJS=YES;
 #ifdef DEBUG
 NBLogConfigurationGet().enableConsoleLog = YES;
 #endif
 [NBLogServiceGet() start];
 [[NBMonitor defaultMonitor] setDelegate:NBLogServiceGet()];

Após ativar o monitoramento de rastreamento HTML5, o contêiner Nebula coletará automaticamente estatísticas sobre ações de carregamento, desempenho e exceções sempre que uma página HTML5 for carregada. Existem dois métodos para visualizar esses dados, conforme o cenário:
- Visualizar logs do cliente: consulte os dados de rastreamento locais diretamente no dispositivo. Esta modalidade é ideal para solução de problemas durante a fase de desenvolvimento do aplicativo. Consulte Visualizar logs do cliente.
- Visualizar logs do servidor: analise os dados reais de rastreamento gerados por usuários online. Recomendado para diagnóstico em ambiente de produção após o lançamento do aplicativo. Consulte Visualizar logs do servidor.

Visualizar logs do cliente

Após o carregamento de uma página HTML5, pesquise a palavra-chave [h5log] no console do Xcode para obter informações essenciais sobre o rastreamento do carregamento da página, conforme ilustrado na figura a seguir.

A tabela abaixo lista as principais informações incluídas nos dados de rastreamento do contêiner HTML5 exibidos no console do Xcode.

SeedId	Exemplo	Descrição
bizType	`webapp`	Tipo de log. Incluído no nome do arquivo de log local.
seedId	`H5_AL_SESSION_FROM_NATIVE`	ID de rastreamento exclusivo. Para mais detalhes, consulte Conjuntos de rastreamento do contêiner HTML5.
head	`HD-VM`	Modelo de log. Consulte Rastreamento de desempenho.
params	`https://www.baidu.com`	URL da página atual.

	`currentTimestamp=1553072784000`	Parâmetro personalizado, como timestamp e status de carregamento da página.

-	Parâmetro personalizado, como a posição de elementos na página.
`^url=https://www.baidu.com^referer=MPH5DemoVC^viewId` `=MPH5DemoVC^refviewId=MPHomeViewController^token=` `A994169ddd50640fa262dbc2dfebb2bb3^h5SessionToken=` `db4db9cfd83521aa2bc31a2e5a6df30e/td>`	Informações de rastreamento: Inclui ID do pacote offline, número da versão do pacote offline, URL carregada pela página HTML5 atual, nome da classe VC e token da página atual.
formatter	`header = "HD-VM"`	Mesma descrição do campo head.

Para visualizar o conteúdo completo de um registro de log no console do Xcode, localize o arquivo cujo nome começa com bizType no diretório Library/log dentro do sandbox e pesquise a palavra-chave seedId.

Visualizar logs do servidor

Para analisar os dados de rastreamento do contêiner HTML5 de um usuário online, pesquise as informações pela funcionalidade Reprodução de logs no console do mPaaS.

server log

Conjuntos de rastreamento do contêiner HTML5

O seedId identifica exclusivamente os dados de rastreamento automático medidos pelo contêiner HTML5. Existem três tipos de conjuntos de rastreamento, classificados conforme o método de carregamento da página HTML5.

Conjunto de rastreamento para abertura de URLs online

SeedId	Descrição
H5_AL_SESSION_FROM_NATIVE	O contêiner foi iniciado.
H5_AL_PAGE_START	Início do carregamento da página.
H5_AL_NETWORK_START	A página começou a enviar requisições de rede.
H5_OPEN_PAGE_FINISH	Carregamento da página concluído.
H5_AL_PAGE_APPEAR	Primeira aparição da página.
H5_AL_JSAPI_SENDEVENT	Uma página invocou uma JSAPI.
H5_AL_JSAPI_NOTFOUND	Falha na chamada de JSAPI na página HTML5.
H5_TITLEBAR_BACK_BT	Toque no botão Voltar da barra de navegação.
H5_PAGE_PERFORMANCE	Medição do desempenho de carregamento da página.

Conjunto de rastreamento para abertura de páginas de pacotes offline

SeedId	Descrição
H5_APP_REQUEST	Solicitação de informações do pacote offline.
H5_APP_LOAD_DATASOURCE	Carregamento das informações do pacote offline.
H5_AL_SESSION_FROM_NATIVE	O contêiner foi iniciado.
H5_APP_DOWNLOAD	Download de um pacote offline.
H5_APP_UNZIP	Descompactação de um pacote offline.
H5_APP_POOL	Operações no pool de informações de gerenciamento de pacotes, incluindo adição, exclusão e modificação de dados.
H5_APP_VERIFY	Verificação de assinatura de um pacote offline.
H5_AL_SESSION_VERIFYTAR_FAIL	Falha na verificação de assinatura do pacote offline.
H5_AL_PAGE_START	Início do carregamento da página.
H5_AL_SESSION_MAP_SUCCESS	Carregamento bem-sucedido de um pacote offline local.
H5_AL_SESSION_FALLBACK	Falha ao carregar o pacote offline local. Uma função de fallback é executada para solicitar a página online.
H5_OPEN_PAGE_FINISH	Carregamento da página concluído.
H5_AL_PAGE_APPEAR	Primeira aparição da página.

Conjunto de rastreamento de exceções

seedId	Descrição
H5_AL_NETWORK_PERFORMANCE_ERROR	Exceção na requisição de recurso.
H5_PAGE_ABNORMAL	Exceção na página.
H5_AL_PAGE_JSERROR	Exceção de JS.
H5_AL_JSAPI_RESULT_ERROR	Exceção de JSAPI.