Monitor su aplicación móvil Cordova

Nuestro agente de New Relic Cordova monitorea su aplicación móvil Cordova y proporciona información detallada y valiosa sobre el rendimiento, los errores y la experiencia del usuario de su aplicación. El agente incluye todas las características de monitoreo de móviles New Relic que ofrecemos para aplicaciones móviles nativas. Una vez que instale y configure el agente Cordova, podrá:

Capture JavaScript errors Identifique y solucione problemas rápidamente.
Track network requests: Vea cómo interactúa su aplicación con el backend.
Use distributed tracing: Profundice en las excepciones manejadas y encuentre la causa raíz.
Create custom events and metrics: Comprenda cómo interactúa su usuario con su aplicación.

Requisitos de compatibilidad

Antes de instalar el agente Cordova, asegúrese de que su aplicación cumpla con estos requisitos:

Córdoba 7.x o superior
Node.js 6.0 o superior
Herramientas CLI de Córdoba
Una plataforma Android o iOS Cordova para tu proyecto
Fichas de aplicacionesmóviles

(Recomendado) Instalación guiada

Para instalar el agente Cordova, siga nuestra instalación guiada, ubicada directamente en la UI.

Instalación manual

Si necesita instalar el agente manualmente, siga estos pasos:

Crear token(s) de aplicación

Vaya a one.newrelic.com > Browser & Mobile > (choose Android or iOS) y luego complete los pasos de instrumentación en la UI.
Desde Step 4 en la UI, copie los token de la aplicación (uno para iOS y Android, si corresponde).

Agregar el agente de Córdoba

En el directorio de su proyecto Cordova, agregue el agente Cordova a su proyecto usando su herramienta de línea de comando y pegue los token de la aplicación en el argumento --variable:

bash

$# Install from github repository
$cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="YOUR_IOS_APP_TOKEN" --variable ANDROID_APP_TOKEN="YOUR_ANDROID_APP_TOKEN"

(Opcional) Configurar el agente

Agregue la siguiente configuración opcional al argumento --variable , que los llamará al iniciar el agente:

CRASH_REPORTING_ENABLED: activa o desactiva los informes de fallos.
- Los valores posibles son true y false. El valor predeterminado es true.
DISTRIBUTED_TRACING_ENABLED: Habilita o deshabilita la adición de encabezados de rastreo distribuido a las solicitudes de red.
- Los valores posibles son true y false. El valor predeterminado es true.
INTERACTION_TRACING_ENABLED: activa o desactiva el seguimiento de interacción. La instrumentación de trazas todavía se produce, pero no se recolecta ninguna traza. Esto deshabilitará la interacción predeterminada y personalizada.
- Los valores posibles son true y false. El valor predeterminado es true.
DEFAULT_INTERACTIONS_ENABLED: activa o desactiva la interacción predeterminada. La instrumentación de trazas todavía se produce, pero no se recolecta ninguna traza. Esto habilitará o deshabilitará la interacción predeterminada solo mientras la interacción personalizada permanezca habilitada.
- Los valores posibles son true y false. El valor predeterminado es true.
LOGGING_ENABLED: habilita o deshabilita el logging del agente.
- Los valores posibles son true y false. El valor predeterminado es true.
LOG_LEVEL: Especifica el nivel de logs.
- Los valores posibles son ERROR (menos detallado), WARNING INFO, VERBOSE, DEBUG, AUDIT (más detallado).
- El valor predeterminado es INFO en Android y WARNING en iOS.
WEB_VIEW_INSTRUMENTATION (SOLO iOS): habilite (predeterminado) o deshabilite la instrumentación automática de WKWebView.
- Los valores posibles son true y false. El valor predeterminado es true.
COLLECTOR_ADDRESS: Especifica el componente de autoridad URI del extremo de carga de datos de recolección.
CRASH_COLLECTOR_ADDRESS: Especifica el componente de autoridad del URI de carga de datos de fallos.
FEDRAMP_ENABLED: habilite o deshabilite los datos de informes usando diferentes extremos para clientes del gobierno de EE. UU.
- Los valores posibles son true y false. El valor predeterminado es false.
OFFLINE_STORAGE_ENABLED: habilite o deshabilite el almacenamiento de datos sin conexión cuando no haya conexión a Internet disponible.
- Los valores posibles son true y false. El valor predeterminado es true.
NEW_EVENT_SYSTEM_ENABLED: Habilite o deshabilite el uso de nuestro nuevo sistema de eventos más estable para el agente iOS.
- Los valores posibles son true y false. El valor predeterminado es true.
BACKGROUND_REPORTING_ENABLED: Habilita o deshabilita el reporte de eventos en segundo plano cuando la aplicación está en segundo plano.
- Los valores posibles son true y false. El valor predeterminado es false.
Estas opciones solo están disponibles en el agente Cordova v6.2.1 y superior.
Por ejemplo, si desea desactivar los informes de fallos, llame a lo siguiente:
bash
```
$cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="YOUR_IOS_APP_TOKEN" --variable ANDROID_APP_TOKEN="YOUR_ANDROID_APP_TOKEN" --variable CRASH_REPORTING_ENABLED="false"
```

(Solo Ionic Cordova) Configure su framework Ionic

Si está utilizando un framework Ionic, agregue esto al directorio de su proyecto Cordova:

bash

$ionic cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="YOUR_IOS_APP_TOKEN" --variable ANDROID_APP_TOKEN="YOUR_ANDROID_APP_TOKEN"
$npm install @awesome-cordova-plugins/newrelic

Asegúrese de pegar token de su aplicación en appToken = "" en el código anterior. Si implementa su aplicación híbrida en la plataforma iOS y Android, deberá agregar dos tokens separados: uno para iOS y otro para Android.

Desplegar tu aplicación

Luego, implementa tu aplicación. Después de cierta actividad en la aplicación, deberías ver datos en New Relic (pueden pasar algunos minutos después de desplegar tu aplicación).

Personalizar la instrumentación del agente.

¿Necesitas personalizar tu instrumentación del agente? Nuestros métodos públicos de API de SDK móvil le permiten recopilar datos personalizados, configurar ajustes predeterminados y más.

Las siguientes personalizaciones están disponibles para el agente de Cordova.

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 la interacción
Errores de registro	Errores de registro
Registro métrico personalizado.	Registro métrico personalizado
Grabar 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 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
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

Actualizar el agente

Para actualizar la versión de su agente Cordova, ejecute este simple comando:

bash

$cordova plugin update

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

Requisitos de compatibilidad .css-21sua1{background:none;border:none;width:0;padding:0;}

(Recomendado) Instalación guiada

Instalación manual

Crear token(s) de aplicación

Agregar el agente de Córdoba

(Opcional) Configurar el agente

(Solo Ionic Cordova) Configure su framework Ionic

Desplegar tu aplicación

Personalizar la instrumentación del agente.

Actualizar el agente

Requisitos de compatibilidad