Ionic Capacitor 모바일 앱을 모니터링하세요

애플리케이션 토큰 만들기

1. one.newrelic.com > Browser & Mobile > (choose Android or iOS) 으로 이동한 후 UI에서 측정, 로그 단계를 완료하세요.
2. UI의 Step 4 에서 애플리케이션 토큰(해당하는 경우 iOS 및 Android용 토큰)을 복사합니다.

커패시터 에이전트 추가

프로젝트 디렉터리에서 명령줄 도구를 사용하여 프로젝트에 Capacitor 에이전트를 추가합니다.

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

커패시터 구성

1. main.ts (Angular 또는 Vue) 또는 index.tsx (React)에서 앱 초기화 시 Capacitor 에이전트를 시작합니다.

2. 다음 코드를 추가하세요.

   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,
   });

   카피

   위 코드의 appToken = "" 에 애플리케이션 토큰을 붙여넣었는지 확인하세요. iOS 및 Android 플랫폼 모두에 하이브리드 앱을 배포한 경우 iOS용 토큰과 Android용 토큰 두 개를 추가해야 합니다.

(Android만 해당) Android 기반 앱을 모니터링하는 경우 다음 단계를 따르세요.

1. New Relic 기본 Android 에이전트를 설치합니다.

2. Gradle 플러그인을 적용하려면 다음 변경 사항을 추가하세요.

   프로젝트에서 플러그인 DSL을 사용하는 경우 이 스니펫을 추가하세요.

   android/app/build.gradle 에서 :

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

   카피

   또는 프로젝트가 오래된 경우 다음 스니펫을 추가하여 구형 newrelic 플러그인 ID를 사용할 수 있습니다.

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

   카피

   android/app/build.gradle 에서 android/app/build.gradle 파일의 맨 위에 NewRelic 플러그인을 적용합니다.

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

   카피

3. AndroidManifest.xml 파일에서 다음 권한을 추가하세요.

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

   카피

4. 패키지를 자동으로 연결하려면 프로젝트를 다시 빌드하십시오.

   bash

   카피

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

앱 배포

그런 다음 앱을 배포합니다. 앱 활동이 끝나면 New Relic에 데이터가 표시됩니다(앱을 배포한 후 몇 분 정도 걸릴 수 있음).