モバイルモニタリング設定の構成

New Relic の iOS エージェントには、エージェントのデフォルトの動作を変更するための構成設定が用意されています。デフォルト設定に変更を加えた場合は、アプリ トークンを呼び出した直後に必ず機能フラグを追加してください。例えば：

• 目的 C:

  コピー

• [NewRelic startWithApplicationToken:]

  コピー

• 迅速：

  NewRelic.start(withApplicationToken:)

  コピー

  機能フラグの有効化・無効化

  機能フラグを構成するには、で定義されている次のメソッドを使用します。 NewRelic.h:

  iOS言語	手順
  Objective-C	Objective-C では、これらの機能はビットマスクされているため、 |を使用して複数の機能を同時に有効または無効にすることができます。 機能フラグを有効にする。 +[NewRelic enableFeatures:(NRMAFeatureFlags)flags]; コピー 機能フラグを無効にする。 +[NewRelic disableFeatures:(NRMAFeatureFlags)flags]; コピー ここでは、その一例をご紹介します。 インタラクション・トレーシングと実験的なネットワーク計測が可能です。 NSURLSession インストルメンテーションとクラッシュ レポートは無効になっています。 [NewRelic enableFeatures:NRFeatureFlag_SwiftInteractionTracing | NRFeatureFlag_FedRampEnabled]; [NewRelic disableFeatures:NRFeatureFlag_NSURLSessionInstrumentation | NRFeatureFlag_CrashReporting]; [NewRelic startWithApplicationToken:...]; コピー
  迅速	機能フラグを有効にする。 NewRelic.enableFeatures(NRMAFeatureFlags.[NRMAFeatureFlag]) コピー 機能フラグを無効にする。 NewRelic.disableFeatures(NRMAFeatureFlags.[NRMAFeatureFlag]) コピー デフォルトの相互作用トレースを無効にする例: NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DefaultInteractions) コピー

  データエンドポイントの設定

  説明	例
  Crash analysisページに表示されるクラッシュ レポートを有効または無効にします。 収集データのアップロード エンドポイントの URI 権限コンポーネントを指定します。このエンドポイントは、処理された例外のアップロードにも使用されます。 データ収集のレポート時にエージェントが使用するデータ エンドポイントを置き換えるには、 andCollectorAddress: を NewRelic.start(withApplicationToken:) メソッド呼び出しに追加します。 デフォルト値は mobile-collector.newrelic.comです。	NewRelic.start(withApplicationToken:YOUR_APP_TOKEN andCollectorAddress:"harvest-upload.domain.com" andCrashCollectorAddress:"crash-upload.domain.com"); コピー
  衝突データアップロードURIの権限コンポーネントを指定します。 エージェントがクラッシュを報告するときに使用するデータ エンドポイントを置き換えるには、 andCrashCollectorAddress: を NewRelic.start(withApplicationToken:) メソッド呼び出しに追加します。 デフォルト値は mobile-crash.newrelic.comです。	NewRelic.start(withApplicationToken:YOUR_APP_TOKEN andCollectorAddress:"harvest-upload.domain.com" andCrashCollectorAddress:"crash-upload.domain.com"); コピー

  クラッシュ＆エラーレポート機能のフラグ

  以下のクラッシュおよびエラー報告設定のいずれかを変更する場合は、iOS エージェントが呼び出しを開始する前に必ず機能フラグを呼び出してください。

  説明	例
  Crash analysis [クラッシュ分析] ページに表示されるクラッシュ レポートを有効または無効にします。 収集データのアップロード エンドポイントの URI 権限コンポーネントを指定します。このエンドポイントは、処理された例外のアップロードにも使用されます。 データ収集のレポート時にエージェントが使用するデータ エンドポイントを置き換えるには、 .usingCollectorAddress() を NewRelic.withApplicationToken() メソッド呼び出しに追加します。 デフォルト値は trueです。	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_CrashReporting) コピー
  「処理された例外」ページに表示される、処理された例外イベントの記録をグローバルに有効または無効にします。 デフォルト値は trueです。	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_HandledExceptionEvents) コピー

  ディストリビューティッド（分散）トレーシング

  説明	例
  ネットワーク要求への分散トレース ヘッダーの追加を有効または無効にします。モバイルアプリでの 分散トレーシングの詳細については、「New Relic 分散トレーシングの仕組み」 を参照してください。 デフォルト値は trueです。	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DistributedTracing) コピー

  インタラクション機能のフラグ

  以下のクラッシュおよびエラー報告設定のいずれかを変更する場合は、New Relic iOS エージェントが呼び出しを開始する直前に必ず機能フラグを呼び出してください。

  説明	例
  インタラクション トレースを有効または無効にするのは、デフォルトのインストゥルメントで行われたクラスおよびメソッドに対してのみです。 カスタム インタラクションがレポートされます。 トレースはInteractionsページに表示されます。 デフォルト値は trueです。	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DefaultInteractions) コピー
  インタラクショントレースをグローバルに有効または無効にします。これは、 Interactionsページに表示されます。 エージェントの起動後、インタラクション トレースは無効になります。 エージェントの開始前に実行されたアクティビティまたはメソッドのインタラクションは、引き続きInteractionsページに表示される場合があります。 デフォルト値は trueです。	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_InteractionTracing) コピー
  注意 この機能を有効にする前に、 Enable Swift interaction traces を参照してください。適切な手順を踏まないと、この機能を有効にすると不安定になる可能性があります。 Swift コードのインタラクション トレースを有効または無効にします。 トレースはInteractionsページに表示されます。 NRFeatureFlag_InteractionTracingが無効になっている場合、この機能は常に無効になります。 デフォルト値は falseです。	NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_SwiftInteractionTracing) コピー
  自動 WKWebView インストルメンテーションを有効または無効にします。 デフォルト値は trueです。	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_WebViewInstrumentation) コピー
  注意 この機能は非推奨となっており、この機能フラグ呼び出しを有効にすると、アプリケーションの安定性が低下する可能性があります。New Relic の指示がない限り、使用を避けてください。 自動ジェスチャ計測を有効または無効にします。 デフォルト値は falseです。	NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_GestureInstrumentation) コピー

  ネットワーク機能フラグ

  以下の設定のいずれかを変更する場合は、New Relic iOS エージェントが呼び出しを開始する前に、必ず機能フラグを呼び出してください。

  説明	例
  注意 この機能は非推奨となっており、この機能フラグ呼び出しを有効にすると、アプリケーションの安定性が低下する可能性があります。New Relic の指示がない限り、使用を避けてください。 実験的なネットワーク計測を有効または無効にします。これにより、すべての NSURLConnection ネットワーク リクエストが NRMAURProtocol経由で強制されます。 デフォルト値は falseです。	NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_ExperimentalNetworkingInstrumentation) コピー
  NSURLSessionのネットワーク計測を有効または無効にします。これらの URL トレースは、 HTTP リクエスト ページに送信されます。 デフォルト値は trueです。	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_NSURLSessionInstrumentation) コピー
  ネットワーク計測を有効または無効にします。これにより、HTTP 応答データが MobileRequest イベントとして送信されます。 デフォルト値は trueです (エージェント バージョン 6.0.0 以降)。	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_NetworkRequestEvents) コピー
  エラーまたは失敗を引き起こす、計測されたネットワーク呼び出しの HTTP 要求エラー イベント生成を有効または無効にします。これらのイベントは、 MobileRequestError イベントとして報告されます。 デフォルト値は trueです。	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_RequestErrorEvents) コピー
  HTTP エラー トレースおよび MobileRequestError イベントの HTTP 応答本文のキャプチャを有効または無効にします。 デフォルト値は trueです。	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_HttpResponseBodyCapture) コピー
  非同期待機 URL セッションの計装を有効または無効にします。 デフォルト値は falseです (エージェント バージョン 7.4.5 以降)。	NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_SwiftAsyncURLSessionSupport) コピー

  アプリの起動時間設定

  説明	例
  レポート アプリの開始時間 (コールド時間とホット時間) をメトリクスとして有効または無効にします。 コールド タイムとは、アプリの起動から最初の抽選までの時間を指します。 ホットタイムとは、アプリがバックグラウンドでの実行から最初の描画まで再開するのにかかる時間を指します。 デフォルト値はtrueです (エージェント バージョン 7.4.0 以降)。	NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_AppStartMetrics) コピー

  FedRAMP エンドポイント設定

  説明	例
  FedRAMP エンドポイントを使用して有効または無効にします。 デフォルト値は falseです (エージェント バージョン 7.4.5 以降)。	NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_FedRampEnabled) コピー

  オフラインストレージ

  説明	例
  インターネット接続が利用できない場合は、オフライン データ ストレージを有効または無効にします。 オフライン ストレージの量を構成するには、 「最大オフライン ストレージ サイズを設定する」を参照してください。	オフライン ストレージはデフォルトでは無効になっています。 これを有効にするには、次の機能フラグを追加します。 NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_OfflineStorage) コピー

  背景レポート

  説明

  例

  アプリケーションがバックグラウンド状態になったときにバックグラウンド レポートを有効または無効にします。

  バックグラウンド レポートはデフォルトで無効になっています。 有効にするには、次の機能フラグを追加します。 NewRelic.enableFeatures([NRMAFeatureFlags.NRFeatureFlag_BackgroundReporting]) コピー バックグラウンド インストゥルメントを使用するための iOS アプリ プロジェクトの前提条件: アプリのバンドル ID を含む項目を含む配列を含むキーPermitted background task scheduler identifiersを追加します。 Xcode プロジェクト機能のBackground Fetch [バックグラウンド モード]セクションで、Background Processing [バックグラウンド フェッチ]とBackground Modes[バックグラウンド処理を]有効にします。 注意: iOS では、iOS がバックグラウンドで収集するのは 24 時間に 1 回のみであることを保証します。

  自動ログ収集

  説明	例
  リモート ログのstdoutとstderrの収集を有効または無効にします。	ログ収集はデフォルトで無効になっています。有効にするには、次の機能フラグを追加します。 NewRelic.disableFeatures([NRMAFeatureFlags.NRFeatureFlag_AutoCollectLogs]) コピー 詳細については、 iOS エージェントのログ記録を参照してください。

Capacitor エージェント SDK を使用すると、デフォルト設定を構成してエージェントの動作を変更できます。

デフォルト設定に変更を加えた場合は、必ず appTokenを呼び出した直後に機能フラグを追加してください。

設定例は次のとおりです。

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';
}

let agentConfig : AgentConfiguration = {
  analyticsEventEnabled: false,
  crashReportingEnabled: false,
  interactionTracingEnabled: false,
  networkRequestEnabled: false,
  networkErrorRequestEnabled: false,
  httpResponseBodyCaptureEnabled: false,
  loggingEnabled: false,
  logLevel: NREnums.LogLevel.INFO,
  webViewInstrumentation: false,
  collectorAddress: "",
  crashCollectorAddress: "",
  sendConsoleEvents: false,
  fedRampEnabled: false,
  offlineStorageEnabled: false
}

NewRelicCapacitorPlugin.start({appKey:appToken, agentConfiguration:agentConfig})

利用可能な構成 [#capacitor-configurations]

analyticsEventEnabled: true

crashReportingEnabled: true

interactionTracingEnabled: true

networkRequestEnabled: true

networkErrorRequestEnabled: true

httpResponseBodyCaptureEnabled: true

loggingEnabled: true

logLevel: NREnums.LogLevel.INFO

webViewInstrumentation: true

collectorAddress: "crash-upload-delegate.domain.com"

crashCollectorAddress: "crash-upload-delegate.domain.com"

sendConsoleEvents: true

fedRampEnabled: false

offlineStorageEnabled: false

backgroundReportingEnabled: true

Cordova エージェント SDK を使用すると、デフォルト設定を構成してエージェントの動作を変更できます。

デフォルト設定に変更を加えた場合は、必ず appTokenを呼び出した直後に機能フラグを追加してください。

設定例は次のとおりです。

$
# Disable Crash Reporting
$
cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git
$
  --variable IOS_APP_TOKEN="YOUR_IOS_APP_TOKEN"
$
  --variable ANDROID_APP_TOKEN="YOUR_ANDROID_APP_TOKEN"
$
  --variable CRASH_REPORTING_ENABLED="false"
$
  --variable OFFLINE_STORAGE_ENABLED="false"

利用可能な構成 [#cordova-configurations]

$
CRASH_REPORTING_ENABLED = "true"

$
INTERACTION_TRACING_ENABLED = "true"

networkRequestEnabled: true

networkErrorRequestEnabled: true

httpResponseBodyCaptureEnabled: true

$
LOGGING_ENABLED = "true"

$
LOG_LEVEL = "INFO"

$
WEB_VIEW_INSTRUMENTATION = "true"

$
COLLECTOR_ADDRESS = "crash-upload-delegate.domain.com"

$
CRASH_COLLECTOR_ADDRESS = "crash-upload-delegate.domain.com"

sendConsoleEvents: true

$
FEDRAMP_ENABLED = "false"

$
OFFLINE_STORAGE_ENABLED = "false"

$
BACKGROUND_REPORTING_ENABLED = "true"

.NET MAUI エージェント SDK を使用すると、デフォルト設定を構成してエージェントの動作を変更できます。

デフォルト設定に変更を加えた場合は、必ず appTokenを呼び出した直後に機能フラグを追加してください。

設定例は次のとおりです。

using NewRelic.MAUI.Plugin;
...

public static MauiApp CreateMauiApp()
{
  var builder = MauiApp.CreateBuilder();
  builder
    .UseMauiApp<App>()
    .ConfigureFonts(fonts =>
    {
      fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
      fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
    });

      builder.ConfigureLifecycleEvents(AppLifecycle => {
      #if ANDROID
          AppLifecycle.AddAndroid(android => android
              .OnCreate((activity, savedInstanceState) => StartNewRelic()));
      #endif
      #if IOS

            AppLifecycle.AddiOS(iOS => iOS.WillFinishLaunching((_,__) => {
              StartNewRelic();
              return false;
          }));
      #endif
      });
  return builder.Build();
}

private static void StartNewRelic()
{
  CrossNewRelic.Current.HandleUncaughtException();

  // Set optional agent configuration. Options are: 
  // crashReportingEnabled, loggingEnabled, logLevel, collectorAddress, 
  // crashCollectorAddress,analyticsEventEnabled, networkErrorRequestEnabled,
  // networkRequestEnabled, interactionTracingEnabled, webViewInstrumentation,
  // fedRampEnabled, offlineStorageEnabled, newEventSystemEnabled, backgroundReportingEnabled
  // AgentStartConfiguration agentConfig = new AgentStartConfiguration(crashReportingEnabled:false);

  if (DeviceInfo.Current.Platform == DevicePlatform.Android)
  {
    CrossNewRelic.Current.Start("APP_TOKEN_HERE");
    // Start with optional agent configuration
    // CrossNewRelic.Current.Start("APP_TOKEN_HERE", agentConfig);
  } 
  else if (DeviceInfo.Current.Platform == DevicePlatform.iOS)
  {
    CrossNewRelic.Current.Start("APP_TOKEN_HERE");
    // Start with optional agent configuration
    // CrossNewRelic.Current.Start("APP_TOKEN_HERE", agentConfig);
  }
}

利用可能な構成 [#maui-configurations]

analyticsEventEnabled: true

crashReportingEnabled: true

loggingEnabled: true

networkRequestEnabled: true

networkErrorRequestEnabled: true

interactionTracingEnabled: false

webViewInstrumentation: false

fedRampEnabled: false

logLevel: NREnums.LogLevel.INFO

collectorAddress: "crash-upload-delegate.domain.com"

crashCollectorAddress: "crash-upload-delegate.domain.com"

offlineStorageEnabled: false

backgroundReportingEnabled: true

Flutter エージェント SDK を使用すると、デフォルト設定を構成してエージェントの動作を変更できます。

デフォルト設定に変更を加えた場合は、必ず appTokenを呼び出した直後に機能フラグを追加してください。

設定例は次のとおりです。

if (Platform.isAndroid) {
  appToken = AppConfig.androidToken;
} else if (Platform.isIOS) {
  appToken = AppConfig.iOSToken;
}

Config config = Config(
    accessToken: appToken,
    analyticsEventEnabled: false,
    networkErrorRequestEnabled: false,
    networkRequestEnabled: false,
    crashReportingEnabled: false,
    interactionTracingEnabled: false,
    httpResponseBodyCaptureEnabled: false,
    loggingEnabled: false,
    webViewInstrumentation: false,
    printStatementAsEventsEnabled: false,
    httpInstrumentationEnabled: false,
    offlineStorageEnabled: true);

// NewrelicMobile.instance.start(config, () {
//   runApp(MyApp());
// });

runZonedGuarded(() async {
  WidgetsFlutterBinding.ensureInitialized();
  FlutterError.onError = NewrelicMobile.onError;
  await NewrelicMobile.instance.startAgent(config);
  runApp(MyApp());
}, (Object error, StackTrace stackTrace) {
  NewrelicMobile.instance.recordError(error, stackTrace);
});

利用可能な構成 [#flutter-configurations]

analyticsEventEnabled: true

crashReportingEnabled: true

interactionTracingEnabled: true

networkRequestEnabled: true

networkErrorRequestEnabled: true

httpResponseBodyCaptureEnabled: true

loggingEnabled: true

logLevel: NREnums.LogLevel.INFO

webViewInstrumentation: true

collectorAddress: "crash-upload-delegate.domain.com"

crashCollectorAddress: "crash-upload-delegate.domain.com"

sendConsoleEvents: true

offlineStorageEnabled: false

distributedTracingEnabled: false

backgroundReportingEnabled: true

React Native エージェント SDK を使用すると、デフォルト設定を構成してエージェントの動作を変更できます。

デフォルト設定に変更を加えた場合は、必ず appTokenを呼び出した直後に機能フラグを追加してください。

設定例は次のとおりです。

import NewRelic from 'newrelic-react-native-agent';
import * as appVersion from './package.json';
import {Platform} from 'react-native';

let appToken;

if (Platform.OS === 'ios') {
  appToken = 'IOS_APP_TOKEN';
} else {
  appToken = 'ANDROID_APP_TOKEN';
}


const agentConfiguration = {
  Config config = Config(
    analyticsEventEnabled: false,
    crashReportingEnabled: false,
    interactionTracingEnabled: false,
    networkRequestEnabled: false,
    networkErrorRequestEnabled: false,
    httpResponseBodyCaptureEnabled: false,
    loggingEnabled: false,
    logLevel: NREnums.LogLevel.INFO,
    webViewInstrumentation: false,
    collectorAddress: "",
    crashCollectorAddress: "",
    sendConsoleEvents: false,
    fedRampEnabled: false,
    offlineStorageEnabled:false
  )
};

NewRelic.startAgent(appToken,agentConfiguration);
NewRelic.setJSAppVersion(appVersion.version);
AppRegistry.registerComponent(appName, () => App);

利用可能な構成 [#react-native-configurations]

analyticsEventEnabled: true

crashReportingEnabled: true

nativeCrashReportingEnabled: true

interactionTracingEnabled: true

networkRequestEnabled: true

networkErrorRequestEnabled: true

httpResponseBodyCaptureEnabled: true

loggingEnabled: true

logLevel: NREnums.LogLevel.INFO

webViewInstrumentation: true

collectorAddress: "crash-upload-delegate.domain.com"

crashCollectorAddress: "crash-upload-delegate.domain.com"

sendConsoleEvents: true

fedRampEnabled: false

offlineStorageEnabled: false

backgroundReportingEnabled: true

New Relic は、Unity のモバイルアプリ監視のデフォルト設定を提供します。 これらの設定は、特定のニーズに合わせて Unity エディター内で簡単に調整できます。

これらの設定を構成するには:

1. Unity エディターをリリースし、Unity プロジェクトを開きます。

2. メニューバーから、 Tools > New Relic > Getting Started > New Relic Configurationを選択します。

3. 左側のInspector [インスペクター]ウィンドウには、デフォルト設定のリストが表示されます。 設定の横にあるボックスをチェックして有効にするか、ボックスのチェックを外して無効にします。

   

4. Add component [コンポーネントの追加]をクリックします。

New Relic は、Unreal Engine でのモバイル アプリ監視のデフォルト設定を提供します。 特定のニーズに合わせて、Unreal エディタ内でこれらの設定を簡単に調整できます。

これらの設定を構成するには:

1. Unreal Editor をリリースし、Unreal プロジェクトを開きます。

2. メニューバーから、**Plugins > New Relic > ** を選択します。

   

Xamarin エージェント SDK を使用すると、デフォルト設定を構成してエージェントの動作を変更できます。

デフォルト設定に変更を加えた場合は、必ず appTokenを呼び出した直後に機能フラグを追加してください。

設定例は次のとおりです。

public App ()
{
    InitializeComponent();

    MainPage = new MainPage();
    Application.Current.PageAppearing += OnPageAppearing;
    Application.Current.PageDisappearing += PageDisappearing;

    CrossNewRelicClient.Current.HandleUncaughtException();
    CrossNewRelicClient.Current.TrackShellNavigatedEvents();

    // Set optional agent configuration. Options are: 
    // crashReportingEnabled, loggingEnabled, logLevel, collectorAddress, 
    // crashCollectorAddress, analyticsEventEnabled, networkErrorRequestEnabled,
    // networkRequestEnabled, interactionTracingEnabled,webViewInstrumentation,
    // fedRampEnabled, offlineStorageEnabled
    AgentStartConfiguration agentConfig = new AgentStartConfiguration(crashReportingEnabled: false, offlineStorageEnabled: false);

    if (Device.RuntimePlatform == Device.Android)
    {
        //CrossNewRelicClient.Current.Start("APP_TOKEN_HERE");
        // Start with optional agent configuration
        CrossNewRelicClient.Current.Start("APP_TOKEN_HERE", agentConfig);
    }
    else if (Device.RuntimePlatform == Device.iOS)
    {
        //CrossNewRelicClient.Current.Start("APP_TOKEN_HERE");
        // Start with optional agent configuration
        CrossNewRelicClient.Current.Start("APP_TOKEN_HERE", agentConfig);
    }
}

利用可能な構成 [#xamarain-configurations]

analyticsEventEnabled: true

crashReportingEnabled: true

loggingEnabled: true

networkRequestEnabled: true

networkErrorRequestEnabled: true

logLevel: NREnums.LogLevel.INFO

collectorAddress: "crash-upload-delegate.domain.com"

crashCollectorAddress: "crash-upload-delegate.domain.com"

interactionTracingEnabled: false

webViewInstrumentation: false

fedRampEnabled: false

offlineStorageEnabled: false

backgroundReportingEnabled: true