Guia do SDK mobile

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.	Gravar trilhas
Acompanhe um método como uma interação.	Iniciar interação Parar interação Dica Se 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: `query SELECT name FROM Mobile SINCE 7 DAYS AGO`
Nomeie ou renomeie uma interação.	Interação de nome
Defina o ID de build ou versão do seu aplicativo a ser associado à interação.	Definir número de compilação do aplicativo Definir o número da versão do aplicativo
Crie métricas personalizadas.	Registro métrico personalizado
Relatório atributo personalizado e evento.	Existem diversas formas de reportar atributo personalizado e evento: Gravar atributo personalizado Aumentar a contagem de atributos da sessão Remover um atributo Remover todos os atributos Gravar evento personalizado Gravar trilhas Defina o tamanho máximo de um pool de eventos Definir tempo máximo que o agente armazena evento na memória Obtenha o ID de uma sessão atual Defina um ID de usuário personalizado para associar ao evento e ao atributo Para saber mais sobre qual seria o melhor método a ser usado e por quê, consulte Relatório de monitoramento de evento móvel personalizado e atributo.
Rastreie solicitações e falhas de rede personalizadas.	Rastrear solicitações HTTP Rastreie solicitações HTTP com falha
Registre uma exceção tratada como um evento, incluindo o contexto do que aconteceu.	Registrar exceções tratadas
Registre erros.	Erros de registro
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.	Desligue o agente
Habilitar/desabilitar configurações padrão de monitoramento de Mobile.	Habilitar/desabilitar recurso de monitoramento
Execute um relatório de falha de teste.	Relatório de falhas 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
`Activity`	`onCreate` `onCreateView`
`AsyncTask`	`execute` `executeOnExecutor`
`BitmapFactory`	`decodeFile` `decodeResourceStream` `decodeResource` `decodeByteArray` `decodeStream` `decodeFileDescriptor` `decodeResourceStream`
`SQLiteDatabase`	`query` `queryWithFactory` `rawQuery` `rawQueryWithFactory` `insert` `insertOrThrow` `insertWithOnConflict` `replace` `replaceOrThrow` `delete` `update` `updateWithOnConflict` `execSql`
`GSON`	`toJson` `fromJson`
`JSONObject`	`<init>` `toString`
`JSONArray`	`<init>` `toString`

(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
`UIViewController`	`viewDidLoad` `viewWillAppear` `viewDidAppear` `viewWillDisappear` `viewDidDisappear` `viewWillLayoutSubviews` `viewDidLayoutSubviews`
`UIImage`	`imageNamed` `imageWithContentsOfFile` `imageWithData` `imageWithData:scale:` `initWithContentsOfFile:` `initWithData:` `initWithData:scale:`
`NSJSONSerialization`	`JSONObjectWithData:options:error:` `JSONObjectWithStream:options:error:` `dataWithJSONObject:options:error:` `writeJSONObject:toStream:options:error:`
`NSManagedObjectContext`	`executeFetchRequest:error:` `processPendingChanges`

(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.

Esta tradução de máquina é fornecida para sua comodidade.