Use a chamada de API do SDK New Relic Mobile para personalizar e estender os dados que seu aplicativo móvel reporta para a New Relic.
Embora nossa solução ofereça uma poderosa coleta de dados pronta para uso, talvez você precise personalizar e estender os dados que seu aplicativo móvel reporta para a New Relic. Por exemplo, você pode usar a chamada de API pública do SDK para:
- Inicie e pare o rastreamento da interação do evento em seu aplicativo móvel
- Registro métrico personalizado
- Enviar atributo personalizado e evento
- Rastrear solicitações de rede da biblioteca não suportadas automaticamente
- Definir IDs personalizados para sessões de usuário
Iniciar
- Certifique-se de ter o agente móvel mais recente instalado.
- Selecione uma customização na tabela abaixo e siga a documentação do método.
Personalizações disponíveis
A tabela abaixo lista os métodos SDK suportados para personalizar sua instrumentação de agente móvel. Selecione um método para visualizar exemplos de sintaxe e uso para cada tipo de agente.
Se você quiser... | Use este método |
---|---|
Registre trilhas para rastrear a atividade do aplicativo que pode ser útil para a resolução de problemas de travamento. | |
Acompanhe um método como uma interação. | Iniciar interação Parar interação DicaSe você utilizar esses métodos, o instrumento interação não aparecerá na página de interação , mas ainda poderá ser encontrado com uma consulta NRQL, como:
|
Nomeie ou renomeie uma interação. | |
Defina o ID de build ou versão do seu aplicativo a ser associado à interação. | |
Crie métricas personalizadas. | |
Relatório atributo personalizado e evento. | Existem diversas formas de reportar atributo personalizado e evento:
|
Rastreie solicitações e falhas de rede personalizadas. | |
Registre uma exceção tratada como um evento, incluindo o contexto do que aconteceu. | |
Registre erros. | |
Atividade de nome para o horário de lançamento do aplicativo. | Definir tempo de lançamento do aplicativo e atividade de destino |
Desligue o agente. | |
Habilitar/desabilitar configurações padrão de monitoramento de Mobile. | |
Execute um relatório de falha de teste. |
Usando a API do SDK móvel
(Android) Métodos de instrumento automaticamente
A instrumentação automática é um dos recursos mais convenientes do agente Android. No entanto, se interferir no método que está sendo rastreado, adicione @SkipTrace
ao método e o agente irá ignorá-lo durante a instrumentação em tempo de compilação.
Classes | Methods |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(iOS) Métodos de instrumento automático
A instrumentação automática é um dos recursos mais convenientes do agente iOS. Ele está habilitado por padrão. Para desabilitar configure os flags de recurso NRFeatureFlag_DefaultInteractions
e NRFeatureFlag_InteractionTracing
.
A tabela abaixo lista as classes e métodos do instrumento automaticamente no agente iOS.
Classes | Methods |
---|---|
|
|
|
|
|
|
|
|
(iOS) Envio de atributo personalizado e evento
Ao reportar atributo personalizado e evento, utilize os métodos SDK dentro do objeto NewRelic
.
Os métodos que retornam resultados BOOL
retornam YES
se forem bem-sucedidos ou NO
se a operação não for concluída. Esses métodos estão disponíveis nas versões 5.0.0 ou superior do agente iOS da New Relic.
O SDK pode armazenar até 128 atributos personalizados definidos pelo usuário por vez. Se você tentar armazenar mais de 128 atributos, o SDK retornará NO
.
Ao nomear um atributo personalizado, recomendamos usar o formato mais simples necessário, como usar uma palavra atributo e sem espaços. Por exemplo, My Custom Attribute
deve ser formatado como myCustomAttribute
.
Ao nomear métrica personalizada:
- Evite usar os caracteres
/ ] [ | *
ao nomear coisas. - Evite caracteres multibyte.