Monitor seu aplicativo móvel Ionic Capacitor

Crie um(s) token(s) de aplicativo

1. Acesse one.newrelic.com > Browser & Mobile > (choose Android or iOS) e conclua as etapas de instrumentação na interface.
2. Em Step 4 na interface, copie o(s) token(s) do aplicativo (um para iOS e Android, se aplicável).

Adicione o agente Capacitor

No diretório do seu projeto, adicione o agente Capacitor ao seu projeto usando sua ferramenta de linha de comando:

$
npm install @newrelic/newrelic-capacitor-plugin
$
npx cap sync

Configurar o capacitor

1. Inicie o agente Capacitor na inicialização do seu aplicativo em main.ts (Angular ou Vue) ou index.tsx (React).

2. Adicione o seguinte 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,
   });

   Copiar

   Certifique-se de colar o(s) token(s) do seu aplicativo em appToken = "" no código acima. Se você implantar seu aplicativo híbrido nas plataformas iOS e Android, precisará adicionar dois tokens separados: um para iOS e outro para Android.

(Somente Android) Se você estiver monitorando um aplicativo nativo do Android, siga estas etapas:

1. Instale o agente Android nativo do New Relic.

2. Adicione as seguintes alterações para aplicar o plug-in Gradle:

   Se o seu projeto estiver usando plug-in DSL, adicione este trecho:

   Em android/app/build.gradle:

   plugins {
       id "com.android.application"
       id "kotlin-android"
       id "com.newrelic.agent.android" version "7.5.1"  //<-- include this
   }

   Copiar

   Ou, se o seu projeto for mais antigo, você pode usar o ID do plug-in legado newrelic adicionando este trecho:

   buildscript {
     ...
     repositories {
       ...
       mavenCentral()
     }
     dependencies {
       ...
       classpath "com.newrelic.agent.android:agent-gradle-plugin:7.5.1"
     }
   }

   Copiar

   Em android/app/build.gradle, aplique o plug-in NewRelic no topo do arquivo android/app/build.gradle :

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

   Copiar

3. No seu arquivo AndroidManifest.xml , adicione as seguintes permissões:

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

   Copiar

4. Para vincular automaticamente o pacote, reconstrua seu projeto:

   bash

   Copiar

   $
   # Android apps
   $
   ionic capacitor run android
   $
   # iOS apps
   $
   ionic capacitor run ios

Implantar seu aplicativo

Em seguida, implante seu aplicativo. Após alguma atividade no aplicativo, você deverá ver os dados no New Relic (pode levar alguns minutos após implantar seu aplicativo).