iOSの手動インストレーション

ご使用のiOS/tvOSアプリケーションとともにNew Relic機能をインストールして設定するには、以下の手順に従ってください。ご使用のiOS/tvOSアプリケーションがCocoapodsを使用する場合は、Cocoapodsインストレーション手順に従ってください。

ご使用のiOSアプリケーションのインストール

インストレーションプロセスの一環として、New Relicはアプリケーショントークンを自動的に生成します。これはNew Relic でモニタリングする各モバイルアプリケーションを認証するための40文字の16進数の文字列です。

iOS/tvOSアプリケーションをインストールして設定するには：

1. one.newrelic.comに移動します。

2. 該当する場合：Mobile appsインデックスから、

   Add a new appを選択します。

3. Get startedページから、モバイル監視用のプラットフォームとしてiOSを選択します。

4. モバイルアプリケーションに名前を付けて、Continueを選択します。

New Relic の設定手順を続けます。

New Relicフレームワークをアプリケーションに追加する

1. iOSエージェントをダウンロードして解凍します。

2. New RelicフレームワークをXcodeプロジェクトに追加するには：

3. Finderを使用して、NewRelic.xcframeworkフォルダをXcodeプロジェクトにドラッグし、フレームワーク、ライブラリ、組み込みコンテンツの下にあるProject navigatorウィンドウにあるプロジェクトにドロップします。

4. 埋め込みドロップダウンメニューの下で、埋め込んで署名が選択されていることを確認します。

5. 適切な方法を使用してエージェントを実装します。

   重要

   適切なインストゥルメンテーションを確保するために、didFinishLaunchingWithOptions()の先頭行でエージェントを呼び出し、メインスレッドでエージェントを実行する必要があります。呼び出しを後回しにして、バックグラウンドスレッドで実行したり、非同期で実行したりすると、想定外の動作や不安定な動作を引き起こす場合があります。

   言語	手順
   Objective-C	エージェントを起動するには、AppDelegate.mの先頭に#import <NewRelic/NewRelic.h>を追加してNew Relicヘッダーをインポートします。 自動的に生成される一意のアプリケーショントークンを使用して、AppDelegate.mの-application:didFinishLaunchingWithOptions:の先頭に+[NewRelic startWithApplicationToken:@"APP_TOKEN"]を追加します。
   Swift	AppDelegate.swiftの先頭にimport NewRelicを追加してNew Relicエージェントをインポートします。（アプリケーションがSwiftUIで作成されている場合は、次の手順に従ってAppDelegateをプロジェクトに追加します。） 自動的に生成される一意のアプリケーショントークンを使用して、AppDelegate.swiftのapplication(_:didFinishLaunchingWithOptions:)の先頭にNewRelic.start(withApplicationToken: "APP_TOKEN")を追加します。

6. ビルドスクリプトをターゲットのビルドフェーズに追加します。新しいビルドスクリプトが最後のビルドフェーズであることを確認してから、以下をペーストして、APP_TOKENをアプリケーショントークンに置き換えます。

   iOSエージェント7.4.0以降：

   SCRIPT=`/usr/bin/find "${SRCROOT}" -name run-symbol-tool | head -n 1`
   /bin/sh "${SCRIPT}" "APP_TOKEN"

   コピー

   iOSエージェント7.3.8以下：

   SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
   /bin/sh "${SCRIPT}" "APP_TOKEN"

   コピー

   オプション：

   デバッグ中にシンボルのアップロードをスキップするには、既存の行の上にあるビルドスクリプトに次の行を追加します。

   if [ ${CONFIGURATION} = "Debug" ]; then
       echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"
       exit 0
   fi
   ```

   コピー

7. アプリをクリーンにして構築してから、シミュレータまたは他のデバイスで実行します。

オプション: デモクラッシュの実行

アプリがクラッシュする問題が発生している場合、New Relic エージェントでは API でデモクラッシュを実行できます。

推奨事項：以下のいずれかの命令行を、必要に応じて、ボタンクリックイベントハンドラに追加します。

[NewRelic crashNow];

[NewRelic crashNow:@"<reason>"];

NewRelic.crashNow()

NewRelic.crashNow(_ message:)

オプション：ロギングレベルの変更

デフォルトでは、New Relicエージェントはinfoレベルでログを記録します。ログレベルをverbose以上に上げることは、リリースビルドではなくデバッグにのみ推奨されます。詳細レベル以上の優先度では、New Relic ServersとのすべてのAPIインタラクションのログが記録されます。モバイルアプリをモニタリングする際は、以下の6つのログレベルを使用できます。

• none
• error
• warning
• info
• verbose
• ALL

アプリでロギングレベルを上げるには、以下のメソッドを追加します。

[NRLogger setLogLevels:NRLogLevelALL];

NRLogger.setLogLevels(NRLogLevelALL.rawValue)