ご使用のiOS/tvOSアプリケーションとともにNew Relic機能をインストールして設定するには、以下の手順に従ってください。ご使用のiOS/tvOSアプリケーションがCocoapodsを使用する場合は、Cocoapodsインストレーション手順に従ってください。
ご使用のiOSアプリケーションのインストール
インストレーションプロセスの一環として、New Relicはアプリケーショントークンを自動的に生成します。これはNew Relic でモニタリングする各モバイルアプリケーションを認証するための40文字の16進数の文字列です。
iOS/tvOSアプリケーションをインストールして設定するには:
one.newrelic.comに移動します。
該当する場合:Mobile appsインデックスから、
Add a new appを選択します。
Get startedページから、モバイル監視用のプラットフォームとしてiOSを選択します。
モバイルアプリケーションに名前を付けて、Continueを選択します。
New Relic の設定手順を続けます。
New Relicフレームワークをアプリケーションに追加する
New RelicフレームワークをXcodeプロジェクトに追加するには:
Finderを使用して、
NewRelic.xcframework
フォルダをXcodeプロジェクトにドラッグし、フレームワーク、ライブラリ、組み込みコンテンツの下にあるProject navigatorウィンドウにあるプロジェクトにドロップします。埋め込みドロップダウンメニューの下で、埋め込んで署名が選択されていることを確認します。
適切な方法を使用してエージェントを実装します。
重要
適切なインストゥルメンテーションを確保するために、
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")
を追加します。
- エージェントを起動するには、
ビルドスクリプトをターゲットのビルドフェーズに追加します。新しいビルドスクリプトが最後のビルドフェーズであることを確認してから、以下をペーストして、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" ]; thenecho "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"exit 0fi```アプリをクリーンにして構築してから、シミュレータまたは他のデバイスで実行します。
このドキュメントはインストールで役立ちましたか。
オプション: デモクラッシュの実行
アプリがクラッシュする問題が発生している場合、New Relic エージェントでは API でデモクラッシュを実行できます。
推奨事項:以下のいずれかの命令行を、必要に応じて、ボタンクリックイベントハンドラに追加します。
言語 | コード |
---|---|
Objective-C | クラッシュ:
ログメッセージ付きクラッシュ:
|
Swift | クラッシュ:
ログメッセージ付きクラッシュ:
|
オプション:ロギングレベルの変更
デフォルトでは、New Relicエージェントはinfo
レベルでログを記録します。ログレベルをverbose
以上に上げることは、リリースビルドではなくデバッグにのみ推奨されます。詳細レベル以上の優先度では、New Relic ServersとのすべてのAPIインタラクションのログが記録されます。モバイルアプリをモニタリングする際は、以下の6つのログレベルを使用できます。
none
error
warning
info
verbose
ALL
アプリでロギングレベルを上げるには、以下のメソッドを追加します。
言語 | コード |
---|---|
Objective-C |
|
Swift |
|