New Relic の iOS エージェントは、エージェントのデフォルトの動作を変更するための構成設定を提供します。使用する場合は、呼び出しの直前にこれらのフラグを実装してください。
- Objective-C:
+[NewRelic startWithApplicationToken:]を使用しています。
- Swift:
NewRelic.start(withApplicationToken:)
機能フラグの有効化・無効化
機能フラグを設定するには、 NewRelic.hで定義されている以下のメソッドを使用します。
iOS言語 | 手順 |
---|
Objective-C | Objective-Cでは、これらの機能はビットマスクされているので、 | を使って、複数の機能を同時に有効または無効にすることができます。 機能フラグを有効にする。 +[NewRelic enableFeatures:(NRMAFeatureFlags)flags];
機能フラグを無効にする。 +[NewRelic disableFeatures:(NRMAFeatureFlags)flags];
ここでは、その一例をご紹介します。 - インタラクション・トレーシングと実験的なネットワーク計測が可能です。
NSURLSession インスツルメンテーションとクラッシュレポートは無効です。
[NewRelic enableFeatures:NRFeatureFlag_SwiftInteractionTracing | NRFeatureFlag_ExperimentalNetworkingInstrumentation]; [NewRelic disableFeatures:NRFeatureFlag_NSURLSessionInstrumentation | NRFeatureFlag_CrashReporting]; [NewRelic startWithApplicationToken:...];
|
Swift | 機能フラグを有効にする。 NewRelic.enableFeatures(NRMAFeatureFlags.[NRMAFeatureFlag])
機能フラグを無効にする。 NewRelic.disableFeatures(NRMAFeatureFlags.[NRMAFeatureFlag])
インタラクション・トレーシングを無効にする例 NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DefaultInteractions)
|
クラッシュ&エラーレポート機能のフラグ
使用する場合は、New Relic iOS エージェントの開始コールの前に、必ず機能フラグをコールしてください。
処理された例外イベントの記録をグローバルに有効(デフォルト)または無効にします。これらのイベントは、 「処理された例外」ページ に表示されます。
ディストリビューティッド(分散)トレーシング
ネットワークリクエストに分散型トレーシングヘッダを追加することを有効または無効にします。
モバイルアプリでの分散トレースの詳細については、NewRelic分散トレースのしくみを参照してください。
インタラクション機能のフラグ
使用する場合は、New Relic iOS エージェントの開始コールの前に、必ず機能フラグをコールしてください。
デフォルトでインスツルメンテーションされているクラスとメソッドに対してのみインタラクション・トレースを有効(デフォルト)または無効にします。カスタム・インタラクションはレポートされます。トレースは、 インタラクション ページ に表示されます。
インタラクション ページ に表示されるインタラクション・トレースをグローバルに有効(デフォルト)または無効にします。
インタラクションのトレースは、エージェントの起動後に無効になります。エージェントを開始する前に実行されたアクティビティやメソッドのインタラクションは、 Interactions ページに表示されることがあります。
ネットワーク機能フラグ
使用する場合は、New Relic iOS エージェントの開始コールの前に、必ず機能フラグをコールしてください。
注意
この機能のフラグコールを有効にすると、アプリケーションの安定性が低下する可能性があります。New Relic の指示がない限り、使用は避けてください。
実験的なネットワーク計測を有効または無効(デフォルト)にします。これにより、すべての NSURLConnection
ネットワーク要求が NRMAURProtocol
を通して行われます。
NSURLSession
のネットワーキングインスツルメンテーションを有効(デフォルト)または無効にします。これらのURLトレースは、 HTTP Requests ページに送信されます。
ネットワークインスツルメンテーションを有効または無効(デフォルト)にします。これは、HTTPレスポンスデータを MobileRequest イベントとして送信します。
iOS Agentバージョン5.14.0以上で利用可能
タイプ | ブール値 |
---|
デフォルト | true - 6.0.0よりデフォルトで有効になりました。
|
---|
エラーや障害が発生したインスツルメンテッド・ネットワーク・コールのHTTPリクエスト・エラー・イベント生成を有効(デフォルト)または無効にします。これらのイベントは、 MobileRequestError イベントとして報告されます。
iOS Agentバージョン5.11.0以上で利用可能
HTTPエラートレース、MobileRequestErrorイベントのHTTPレスポンスボディのキャプチャを有効または無効にします。