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

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) コピー

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

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

  説明	例
  Crash analysis [クラッシュ分析] ページに表示されるクラッシュ レポートを有効または無効にします。 デフォルト値は trueです。	NRFeatureFlag_CrashReporting(false) コピー
  「処理された例外」ページに表示される、処理された例外イベントの記録をグローバルに有効または無効にします。 デフォルト値は trueです。	NRFeatureFlag_HandledExceptionEvents(false) コピー

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

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

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

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

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

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

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

  ネットワーク機能フラグ

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

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

  アプリの起動時間設定

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

  FedRAMP エンドポイント設定

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

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
}

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

利用可能な構成 [#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

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

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

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

# Disable Crash Reporting
cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git 
--variable IOS_APP_TOKEN="{ios-app-token}" 
--variable ANDROID_APP_TOKEN="{android-app-token}" 
--variable CRASH_REPORTING_ENABLED="false"

利用可能な構成 [#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"

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

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

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

using NewRelic.MAUI.Plugin;
            ...
    public App()
        {
            InitializeComponent();

            MainPage = new AppShell();

            CrossNewRelic.Current.HandleUncaughtException();
            CrossNewRelic.Current.TrackShellNavigatedEvents();

            // Set optional agent configuration
            // Options are: crashReportingEnabled, loggingEnabled, logLevel, collectorAddress, crashCollectorAddress
            AgentStartConfiguration agentConfig = new AgentStartConfiguration(true, true, LogLevel.INFO, "mobile-collector.newrelic.com", "mobile-crash.newrelic.com");

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



    }

利用可能な構成 [#configurations]

analyticsEventEnabled: true

crashReportingEnabled: true

loggingEnabled: true

networkRequestEnabled: true

networkErrorRequestEnabled: true

httpResponseBodyCaptureEnabled: true

logLevel: NREnums.LogLevel.INFO

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

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

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

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

利用可能な構成 [#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

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


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

利用可能な構成 [#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

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
      AgentStartConfiguration agentConfig = new AgentStartConfiguration(true, true, LogLevel.INFO, "mobile-collector.newrelic.com", "mobile-crash.newrelic.com");
      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);
                }
            }
        }

利用可能な構成 [#configurations]

analyticsEventEnabled: true

crashReportingEnabled: true

loggingEnabled: true

networkRequestEnabled: true

networkErrorRequestEnabled: true

httpResponseBodyCaptureEnabled: true

logLevel: NREnums.LogLevel.INFO

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

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