Nuestro agente New Relic Ionic Capacitor monitorea su aplicación móvil Ionic Capacitor y proporciona información profunda y valiosa sobre el rendimiento, los errores y la experiencia del usuario de su aplicación. El agente incluye automáticamente los agentes nativos de New Relic para proporcionar monitoreo de móviles y visibilidad del rendimiento. Una vez que instale y configure el agente, 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.
Para obtener más información, consulte el agente New Relic Ionic Capacitor en Github.
Requisitos de compatibilidad
Antes de instalar el agente, asegúrese de que su aplicación cumpla estos requisitos:
(Recomendado) Instalación guiada
Para instalar el agente, 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 condensador
En el directorio de su proyecto, agregue el agente Capacitor a su proyecto usando su herramienta de línea de comando:
$npm install @newrelic/newrelic-capacitor-plugin$npx cap sync
Configurar el condensador
Inicie el agente Capacitor en la inicialización de su aplicación en
main.ts
(Angular o Vue) oindex.tsx
(React).Agregue el siguiente código:
import { NewRelicCapacitorPlugin, NREnums, AgentConfiguration } from '@newrelic/newrelic-capacitor-plugin';import { Capacitor } from '@capacitor/core';var appToken;if(Capacitor.getPlatform() === 'ios') {appToken = '<IOS-APP-TOKEN>';} else {appToken = '<ANDROID-APP-TOKEN>';}if(Capacitor.getPlatform() === 'ios') {appToken = '<IOS-APP-TOKEN>';} else {appToken = '<ANDROID-APP-TOKEN>';}let agentConfig : AgentConfiguration = {//Android Specific// Optional:Enable or disable collection of event data.analyticsEventEnabled: true,// Optional:Enable or disable crash reporting.crashReportingEnabled: true,// Optional:Enable or disable interaction tracing. Trace instrumentation still occurs, but no traces are harvested. This will disable default and custom interactions.interactionTracingEnabled: true,// Optional:Enable or disable reporting successful HTTP requests to the MobileRequest event type.networkRequestEnabled: true,// Optional:Enable or disable reporting network and HTTP request errors to the MobileRequestError event type.networkErrorRequestEnabled: true,// Optional:Enable or disable capture of HTTP response bodies for HTTP error traces, and MobileRequestError events.httpResponseBodyCaptureEnabled: true,// Optional:Enable or disable agent logging.loggingEnabled: true,// Optional:Specifies the log level. Omit this field for the default log level.// Options include: ERROR (least verbose), WARNING, INFO, VERBOSE, AUDIT (most verbose).logLevel: NREnums.LogLevel.INFO,// iOS Specific// Optional:Enable/Disable automatic instrumentation of WebViewswebViewInstrumentation: true,// Optional:Set a specific collector address for sending data. Omit this field for default address.// collectorAddress: "",// Optional:Set a specific crash collector address for sending crashes. Omit this field for default address.// crashCollectorAddress: "",// Optional:Enable or disable sending JS console logs to New Relic.sendConsoleEvents: true,// Optional:Enable or disable reporting data using different endpoints for US government clients//fedRampEnabled: false,// Optional: Enable or disable offline data storage when no internet connection is available.offlineStorageEnabled: true,// iOS Specific// Optional: Enable or disable Background Reporting.backgroundReportingEnabled: true,// iOS Specific// Optional: Enable or disable to use our new, more stable event system for iOS agent.newEventSystemEnabled: true}NewRelicCapacitorPlugin.start({appKey:appToken, agentConfiguration:agentConfig})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.
(Solo Android) Si está monitoreando una aplicación nativa de Android, siga estos pasos:
Agregue los siguientes cambios para aplicar el complemento Gradle:
Si su proyecto emplea DSL complementario, agregue este fragmento:
En
android/app/build.gradle
:plugins {id "com.android.application"id "kotlin-android"id "com.newrelic.agent.android" version "7.5.1" //<-- include this}O, si su proyecto es más antiguo, puede usar el ID del complemento legacy
newrelic
agregando este fragmento:buildscript {...repositories {...mavenCentral()}dependencies {...classpath "com.newrelic.agent.android:agent-gradle-plugin:7.5.1"}}En
android/app/build.gradle
, aplique el complementoNewRelic
en la parte superior del archivoandroid/app/build.gradle
:apply plugin: "com.android.application"apply plugin: 'newrelic' // <-- include thisEn su archivo
AndroidManifest.xml
, agregue las siguientes licencias:<uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />Para vincular automáticamente el paquete, reconstruya su proyecto:
bash$# Android apps$ionic capacitor run android$# iOS apps$ionic capacitor run ios
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 Capacitor.
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. | |
Registre errores personalizados. | |
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. |