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
:
# Install from github repositorycordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="{ios-app-token}" --variable ANDROID_APP_TOKEN="{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
yfalse
. El valor predeterminado estrue
.
- Los valores posibles son
DISTRIBUTED_TRACING_ENABLED
: Habilita o deshabilita la adición de encabezados de rastreo distribuido a las solicitudes de red.- Los valores posibles son
true
yfalse
. El valor predeterminado estrue
.
- Los valores posibles son
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
yfalse
. El valor predeterminado estrue
.
- Los valores posibles son
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
yfalse
. El valor predeterminado estrue
.
- Los valores posibles son
LOGGING_ENABLED
: habilita o deshabilita el logging del agente.- Los valores posibles son
true
yfalse
. El valor predeterminado estrue
.
- Los valores posibles son
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 yWARNING
en iOS.
- Los valores posibles son
WEB_VIEW_INSTRUMENTATION
(SOLO iOS): habilite (predeterminado) o deshabilite la instrumentación automática de WKWebView.- Los valores posibles son
true
yfalse
. El valor predeterminado estrue
.
- Los valores posibles son
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
yfalse
. El valor predeterminado esfalse
.
- Los valores posibles son
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
yfalse
. El valor predeterminado estrue
.
- Los valores posibles son
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
yfalse
. El valor predeterminado estrue
.
- Los valores posibles son
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
yfalse
. El valor predeterminado esfalse
.
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:
cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="{ios-app-token}" --variable ANDROID_APP_TOKEN="{android-app-token}" --variable CRASH_REPORTING_ENABLED="false"- Los valores posibles son
(Solo Ionic Cordova) Configure su framework Ionic
Si está utilizando un framework Ionic, agregue esto al directorio de su proyecto Cordova:
$ionic cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="{ios-app-token}" --variable ANDROID_APP_TOKEN="{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. | |
Seguimiento de un método como una interacción. | |
Errores de registro | |
Registro métrico personalizado. | |
Grabar atributo personalizado y evento. | Hay varias formas de reportar atributo personalizado y evento:
|
Realice un seguimiento de las solicitudes y fallas de la red personalizada. | |
Apague el agente. | |
Activa/desactiva la configuración predeterminada de monitoreo de móviles. | |
Ejecute un informe de fallo de prueba. |
Actualizar el agente
Para actualizar la versión de su agente Cordova, ejecute este simple comando:
cordova plugin update