New Relic機能をご使用のiOSアプリケーションとともにインストールして設定するには、以下の手順に従ってください。ご使用のiOSアプリケーションがCocoapodsを使用する場合は、Cocoapodsインストレーション手順に従ってください。
ご使用のiOSアプリケーションのインストール
インストレーションプロセスの一環として、New Relicはアプリケーショントークンを自動的に生成します。これはNew Relic でモニタリングする各モバイルアプリケーションを認証するための40文字の16進数の文字列です。
iOSアプリケーションをインストールして設定するには:
one.newrelic.comに移動します。
該当する場合:Mobile appsインデックスから、
Add a new appを選択します。
Get startedページから、モバイルモニタリング用のプラットフォームとして XCFrameworkを選択します。
モバイルアプリケーションに名前を付けて、Continueを選択します。
New Relic の設定手順を続けます。
New Relicフレームワークをアプリケーションに追加する
New Relic用のiOS SDKをダウンロードし、解凍します。
New RelicフレームワークをXcodeプロジェクトに追加するには:Finderを使用して、
NewRelicAgent.framework
フォルダーをXcodeプロジェクトにドラッグし、フレームワーク、ライブラリ、組み込みコンテンツの下にあるProject navigatorウィンドウにあるプロジェクトにドロップします。埋め込みドロップダウンメニューの下で、埋め込んで署名が選択されていることを確認します。適切な方法を使用してエージェントを実装します。
重要
適切なインストゥルメンテーションを確保するために、
didFinishLaunchingWithOptions()
の先頭行でエージェントを呼び出し、メインスレッドでエージェントを実行する必要があります。呼び出しを後回しにして、バックグラウンドスレッドで実行したり、非同期で実行したりすると、想定外の動作や不安定な動作を引き起こす場合があります。言語
手順
Objective-C
- エージェントを起動するには:New Relicヘッダーを
prefix.pch
の先頭にインポートします。 - 自動的に生成される一意のアプリケーショントークンを使用して、
AppDelegate.m
の-application:didFinishLaunchingWithOptions:
の先頭に+[NewRelic startWithApplicationToken:@"<appToken>"]
を追加します。
Swift
ブリッジングヘッダファイルを作成します。
- File(ファイル)> New(新規)> File(ファイル)> Objective-C File(Objective-Cファイル)の順に選択します。
- ファイル
Placeholder.m
に名前を付け、次へを選択します。 - Create(作成)を選択し、ブリッジングヘッダの生成を促すXcodeプロンプトに同意します。
Placeholder.m
を削除します。
MyApp-Bridging-Header.h
の先頭に#import "NewRelic/NewRelic.h"
を追加してNew Relicエージェントをインポートします。自動的に生成される一意のアプリケーショントークンを使用して、
AppDelegate.swift
のapplication(_:didFinishLaunchingWithOptions:)
の先頭にNewRelic.start(withApplicationToken: ">appToken>")
を追加します。
- エージェントを起動するには:New Relicヘッダーを
ビルドスクリプトをターゲットのビルドフェーズに追加します。新しいビルドスクリプトが最後のビルドフェーズであることを確認してから、以下をペーストして、PUT_NEW_RELIC_APP_TOKEN_HEREをアプリケーショントークンに置き換えます:
SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1` /bin/sh "${SCRIPT}" "PUT_NEW_RELIC_APP_TOKEN_HERE"
アプリをクリーンにして構築してから、シミュレータまたは他のデバイスで実行します。
Did this doc help with your installation?
オプション: デモクラッシュの実行
アプリがクラッシュする問題が発生している場合、New Relic エージェントでは API でデモクラッシュを実行できます。
推奨事項:以下のいずれか1つの命令行を、必要に応じて、ボタンクリックイベントハンドラに追加します。
言語 | コード |
---|---|
Objective-C | クラッシュ:
ログメッセージ付きクラッシュ:
|
Swift | クラッシュ:
ログメッセージ付きクラッシュ:
|
オプション:ロギングレベルの変更
モバイルアプリをモニタリングする際は、以下の6つのログレベルを使用できます。
none
error
warning
info
verbose
ALL
アプリでロギングレベルを上げるには、以下のメソッドを追加します。
言語 | コード |
---|---|
Objective-C |
|
Swift |
|