Você pode usar o monitoramento do Browser no New Relic para adicionar evento personalizado e atributo.
Atributo personalizado
Adicione atributo personalizado a todos os eventos do browser para que você possa consultar ou filtrar seus dados e responder a mais perguntas sobre seu aplicativo.
Evento personalizado
Use o método recordCustomEvent
da API do browser para capturar qualquer evento com atribuição personalizada.
Ações de página
Utilize a API addPageAction
chamada da do browser para capturar eventos, ações, alterações de rota ou qualquer interação final do usuário com seu aplicativo. A chamada addPageAction
adiciona um evento chamado PageAction
que contém o nome da ação, os metadados relacionados à sua página e quaisquer nomes e valores de atributos personalizados que você capturar junto com ela.
Pré-requisitos
Para relatar o evento Custom
, verifique estes pré-requisitos:
Requirement | Comments |
---|---|
Versão do agente | A versão do seu agente de monitoramento de browser deve ser 1.277.0 ou superior. |
Versão do browser do cliente | Para gravar o evento |
Eventos por ciclo |
|
Nomenclatura de evento/atributo, tipo de dados, tamanho | Certifique-se de seguir os requisitos gerais sobre sintaxe de nomenclatura de evento/atributo, tipos de dados e tamanho. |
Para relatar o evento PageAction
, verifique estes pré-requisitos:
Requirement | Comments |
---|---|
Versão do agente | A versão do seu agente de monitoramento do Browser deve ser 593 ou superior. |
Versão do browser do cliente | Para gravar o evento |
Eventos por ciclo |
|
Nomenclatura de evento/atributo, tipo de dados, tamanho | Certifique-se de seguir os requisitos gerais sobre sintaxe de nomenclatura de evento/atributo, tipos de dados e tamanho. |
Criar evento personalizado
Para criar um evento custom
:
- Certifique-se de que o agente browser esteja instalado para seu aplicativo.
- Chame a função
newrelic.recordCustomEvent
na parte relevante do JavaScript do seu aplicativo. - Aguarde alguns minutos para que o aplicativo seja executado e relate o evento
custom
relevante no eventType especificado. - Execute uma consulta NRQL do evento que inclua o atributo
eventType
que você usou para capturar o evento (e qualquer atributo associado que você enviou junto com o evento).
- Por exemplo, se você enviou um evento
custom
com umeventType
deFoo
e um atributo debar: 123
, você poderia executar uma consulta como esta:SELECT * FROM Foo WHERE bar = 123
Criar evento PageAction
Para criar um evento PageAction
:
- Certifique-se de que o agente browser esteja instalado para seu aplicativo.
- Chame a função
newrelic.addPageAction
na parte relevante do JavaScript do seu aplicativo. - Aguarde alguns minutos para que o aplicativo seja executado e relate o evento
PageAction
relevante. - Execute uma consulta NRQL do evento
PageAction
que inclui o atributoactionName
usado para capturar o evento (e quaisquer atributos associados enviados junto com a ação).
- Por exemplo, se você enviou um evento
PageAction
com umactionName
deFoo
e um atributo debar: 123
, você poderia executar uma consulta como esta:SELECT * FROM PageAction WHERE actionName = 'Foo' AND bar = 123
Adicionar atributo personalizado ao evento do browser
Você pode adicionar um atributo personalizado a todos os eventos do browser. Qualquer atributo personalizado que você adicionar usando a API setCustomAttribute
será adicionado a todos os eventos capturados.
Existem duas maneiras de adicionar atributo personalizado:
Considerações importantes e práticas recomendadas incluem:
Você deve monitorar a IA para limitar o número total de tipos de eventos personalizados para aproximadamente cinco. Os tipos de eventos personalizados devem ser usados para encapsular categorias de alto nível. Por exemplo, você pode criar um tipo de evento chamado Gestos que contém muitos eventos com vários propósitos.
Evite usar tipo de evento para nomear eventos personalizados. Crie tipos de eventos para abrigar uma categoria de dados e use atributos dentro dessa categoria para diferenciar eventos. Embora você possa criar vários eventos personalizados, é importante manter seus dados gerenciáveis, limitando o número de tipos de eventos relatados.
Atribuição incluída
Eventos de browser personalizados são decorados com os seguintes atributos, com o objetivo de ajudar você a entender o contexto do ambiente do browser quando o evento ocorreu:
Resolução de problemas
Aqui estão algumas dicas de resolução de problemas:
Problem | Comments |
---|---|
Atributo personalizado faltando | Se seu atributo personalizado não aparecer em eventos |
| Se o seu evento Se os requisitos forem atendidos, verifique se você não está usando nomes de atributos reservados ou valores inválidos. |
| Se o seu evento Se os requisitos forem atendidos, verifique se você não está usando nomes de atributos reservados ou valores inválidos. |