Monitor la aplicación móvil de Ionic Capacitor

Crear token(s) de aplicación

1. Vaya a one.newrelic.com > Browser & Mobile > (choose Android or iOS) y luego complete los pasos de instrumentación en la UI.
2. 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

1. Inicie el agente Capacitor en la inicialización de su aplicación en main.ts (Angular o Vue) o index.tsx (React).

2. Agregue el siguiente código:

   import {
     NewRelicCapacitorPlugin,
     NREnums,
     AgentConfiguration,
   } from "@newrelic/newrelic-capacitor-plugin";
   import { Capacitor } from "@capacitor/core";
   
   let 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 WebViews
     webViewInstrumentation: 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,
   });

   Copia

   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:

1. Instale el agente nativo de Android de New Relic.

2. 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
   }

   Copia

   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"
     }
   }

   Copia

   En android/app/build.gradle, aplique el complemento NewRelic en la parte superior del archivo android/app/build.gradle :

   apply plugin: "com.android.application"
   apply plugin: 'newrelic' // <-- include this

   Copia

3. En su archivo AndroidManifest.xml , agregue las siguientes licencias:

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

   Copia

4. Para vincular automáticamente el paquete, reconstruya su proyecto:

   bash

   Copia

   $
   # 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).