Guía de SDK móvil

Utilice la API de llamada New Relic Mobile SDK para personalizar y ampliar los datos que su aplicación móvil informa a New Relic.

Si bien nuestra solución ofrece una potente recopilación de datos lista para usar, es posible que necesites personalizar y ampliar los datos que tu aplicación móvil informa a New Relic. Por ejemplo, puede utilizar la API de llamada del SDK público para:

Inicia y detiene la traza de interacción del evento en tu aplicación móvil
Registro métrico personalizado
Enviar atributo personalizado y evento
El seguimiento de solicitudes de red de la biblioteca no se admite automáticamente
Establecer ID personalizados para sesiones de usuario

Empezar

Asegúrese de tener instalado el último agente móvil.
Seleccione una personalización de la siguiente tabla y siga la documentación del método.

Personalizaciones disponibles

La siguiente tabla enumera los métodos SDK compatibles para personalizar la instrumentación del agente móvil. Seleccione un método para ver ejemplos de sintaxis y uso para cada tipo de agente.

Si quieres...	Utilice este método
Registre la ruta de navegación para rastrear la actividad de la aplicación que puede ser útil para resolver problemas.	Registro de ruta de navegación
Seguimiento de un método como una interacción.	Iniciar interacción Detener interacción Sugerencia Si utiliza estos métodos, la interacción instrumentada no aparecerá en la página de interacción , pero aún se pueden encontrar con una consulta NRQL, como por ejemplo: `SELECT name FROM Mobile SINCE 7 DAYS AGO`
Nombrar o cambiar el nombre de una interacción.	Nombre interacción
Configure el ID de compilación o la versión de su aplicación para que se asocie con la interacción.	Establecer el número de compilación de la aplicación Establecer el número de versión de la aplicación
Crear métrica personalizada.	Registro métrico personalizado
Informe atributo personalizado y evento.	Hay varias formas de reportar atributo personalizado y evento: Grabar atributo personalizado Incrementar el recuento de atributos de sesión Eliminar un atributo Eliminar todos los atributos Grabar evento personalizado Registro de ruta de navegación Establecer el tamaño máximo de un grupo de eventos Establecer el tiempo máximo que el agente almacena el evento en la memoria Obtener el ID de una sesión actual Establezca una ID de usuario personalizada para asociar con evento y atributo Para obtener más información sobre cuál sería el mejor método a utilizar y por qué, consulte Informe monitoreo de móviles evento personalizado y atributo.
Realice un seguimiento de las solicitudes y fallas de la red personalizada.	Seguimiento de solicitudes HTTP Seguimiento de solicitudes HTTP fallidas
Registre una excepción manejada como un evento, incluido el contexto de lo que sucedió.	Registro de excepciones manejadas
Errores de registro.	Errores de registro
Nombre de la actividad durante el tiempo de lanzamiento de la aplicación.	Establecer actividad objetivo de tiempo de lanzamiento de la aplicación
Apague el agente.	Cerrar el agente
Activa/desactiva la configuración predeterminada de monitoreo de móviles.	Activar/desactivar la característica de monitoreo
Ejecute un informe de fallo de prueba.	Informe de fallos de prueba

Usando la API del SDK móvil

(Android) Métodos instrumentados automáticamente

La instrumentación automática es una de las características más convenientes del agente Android. Sin embargo, si interfiere con el método que se está trazando, agregue @SkipTrace al método y el agente lo omitirá durante la instrumentación en tiempo de compilación.

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`
`Log`	`d // debug` `w // warning` `i // info` `v // verbose` `e // error`

(iOS) Métodos instrumentados automáticamente

La instrumentación automática es una de las características más convenientes del agente iOS. Está habilitado de forma predeterminada. Para deshabilitarlo, configure los indicadores de características NRFeatureFlag_DefaultInteractions y NRFeatureFlag_InteractionTracing.

La siguiente tabla enumera las clases y métodos instrumentados automáticamente en el 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) Envío de atributos personalizados y eventos

Al informar atributos personalizados y eventos, utilice los métodos del SDK dentro del objeto NewRelic .

Los métodos que devuelven BOOL resultados devuelven YES si tienen éxito o NO si la operación no se completó. Estos métodos están disponibles en las versiones 5.0.0 o superiores del agente iOS de New Relic.

El SDK puede almacenar hasta 128 atributos personalizados definidos por el usuario a la vez. Si intenta almacenar más de 128 atributos, el SDK devuelve NO.

Al nombrar un atributo personalizado, le recomendamos que utilice el formato más simple necesario, como usar atributo de una sola palabra y sin espacios. Por ejemplo, My Custom Attribute debe tener el formato myCustomAttribute.

Al denominar métrica personalizada:

Evite emplear los caracteres / ] [ | * al nombrar cosas.
Evite los caracteres de varios bytes.

Te ofrecemos esta traducción automática para facilitar la lectura.