Relatório de monitoramento de evento Mobile personalizado e atributo
Por padrão, o New Relic coleta alguns dados de eventos do seu aplicativo mobile para o New Relic, como interação, sessões, falhas e erros de solicitação. Porém, você também pode criar seu próprio atributo personalizado e evento para consultas e análises mais detalhadas.
Criar atributo personalizado e evento
Você pode criar um atributo personalizado em nível de sessão para evento padrão usando o SDK do agente mobile. Por exemplo, para registrar um atributo username para alguma parte do seu aplicativo iOS ou Android, você usaria a APIsetAttribute. Esses atributos são informações relacionadas à sessão e são compartilhados por vários tipos de eventos móveis.
Você também pode criar tipos de eventos personalizados totalmente novos e atribuir a eles seu próprio atributo personalizado usando a APIrecordCustomEvent.
Para ajudar na análise de falhas, você pode usar o SDK para criar eventos MobileBreadcrumb e MobileHandledException . Esses eventos ficam disponíveis para consulta e também são exibidos na interface crash trilha de evento.
Para mais informações sobre criação de atributo personalizado e evento personalizado, veja:
Aqui estão alguns exemplos de uso de NRQL para consultar evento e atributo de seu aplicativo mobile:
Para rastrear compras no seu aplicativo, use recordCustomEvent para criar um tipo de evento (como "UserAction") e associar atributos como "nome" (com valor "Purchase"), preço, quantidade e SKU.
Dica
Por motivos de desempenho, você deve limitar o número total de tipos de eventos a talvez um ou dois. O parâmetro recordCustomEventeventType deve ser usado para categorias de alto nível. Por exemplo, você pode criar um tipo de eventoGestures e, em seguida, criar vários nomes de eventos personalizados diferentes no tipo de evento Gesture .
New Relic reporta um evento customizado de tipo UserAction e nome Purchase, que permite consultar todas as compras realizadas em seu aplicativo no último dia:
SELECT * from UserAction where name = 'Purchase' since 1 day ago
Replace deprecated recordEvent method:
A partir do agente Android versão 5.12.0 e do agente iOS versão 5.12.0, use o método recordCustomEvent para criar esses eventos personalizados. Se você substituiu o método recordEvent obsoleto para seu evento personalizado, certifique-se de substituir também sua consulta NRQL correspondente pelo novo formato.
Procure consultas usadas com o método recordEvent , como:
SELECT * from Mobile where category = 'Custom' and name = 'Purchase' since 1 day ago
Substitua-os pelo formato de consulta usado com recordCustomEvent:
SELECT * from UserAction where name = 'Purchase' since 1 day ago
Você pode criar um atributo personalizado para rastrear um identificador de usuário personalizado em toda a sessão e, em seguida, consultar todas as interações desse usuário. Para adicionar um atributo para userId, chame o método setUserId :
Com este atributo, você pode usar uma cláusula WHERE para ver todas as ações realizadas por esse username no último dia:
SELECT * from Mobile WHERE userId = 'jsmith' since 1 day ago
Você pode criar um atributo personalizado para rastrear o ID de uma loja durante a sessão e, em seguida, consultar todas as interações dessa loja. Para adicionar um atributo para storeId, chame o método setAttribute :
Com este atributo, você pode usar uma cláusula WHERE para ver todas as ações realizadas por esse storeId no último dia:
SELECT * from Mobile WHERE storeId = 'NY0531' since 1 day ago
Você pode usar o atributo personalizado para rastrear o número de vezes que uma ação específica ocorre em sua aplicação. Por exemplo, você pode acompanhar o número de vezes que um botão foi clicado ou o número de vezes que um nível foi concluído em um jogo.
Para acompanhar a conclusão de um nível de jogo, chame incrementAttribute sem nenhum valor especificado. Isso cria um atributo com um valor padrão de 1:
Ao consultar, use este atributo level para filtrar seus dados. Por exemplo, se você tiver um atributo username e level , use a função max() para encontrar o nível mais alto que o usuário alcançou:
SELECT max(level) from Mobile where username = 'jsmith'
Por padrão, o New Relic transmite dados de eventos em qualquer uma destas situações:
Uma sessão está em andamento há 600 segundos.
A sessão do aplicativo termina em segundo plano.
O aplicativo trava.
Se o aplicativo travar, a New Relic coleta o atributo e o evento daquela sessão. (No iOS, isso acontecerá na próxima vez que o aplicativo for lançado). Você pode então usar o NRQL para consultar e analisar os dados do evento e do atributo.
Para definir o tempo máximo (em segundos) que o agente armazenará o evento na memória, consulte Definir tempo máximo de buffer.
Considerações de privacidade
Caso pretenda recolher dados pessoais através de atributo personalizado, consulte a sua equipa de privacidade ou jurídica. Certifique-se de seguir as obrigações da sua organização em relação a avisos e regulamentos de consentimento.