Ionic Capacitor モバイル アプリを監視する

アプリケーショントークンを作成する

1. one.newrelic.com > Browser & Mobile > (choose Android or iOS)に移動し、UI でインストゥルメンテーションの手順を完了します。
2. UI のStep 4から、アプリケーション トークン (該当する場合、iOS と Android 用の 1 つ) をコピーします。

Capacitor エージェントを追加する

プロジェクト ディレクトリで、コマンド ライン ツールを使用して 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 の両方のプラットフォームにデプロイした場合は、2 つの個別のトークン (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で、 NewRelicプラグインをandroid/app/build.gradleファイルの先頭に適用します。

   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 にデータが表示されるはずです (アプリのデプロイ後、数分かかる場合があります)。