本手順は、Cocoapodsを使用するiOSアプリに適用されます。その他のタイプについては、 iOS のインストールと構成 を参照してください。
ご使用のiOSアプリケーションのインストール
インストレーションプロセスの一環として、New Relicはアプリケーショントークンを自動的に生成します。これはNew Relic でモニタリングする各モバイルアプリケーションを認証するための40文字の16進数の文字列です。
iOSアプリケーションをインストールして設定するには:
- one.newrelic.comにアクセスします。
- 該当する場合。Mobile Apps」リストから、 「Add a new app」 を選択します。
- Get Started ページから、モバイルモニタリングのプラットフォームとして iOS を選択します。
- モバイルアプリの名前を入力して、 Continue を選択します。
- インストールしたものに prefix ヘッダーが自動的に含まれていない場合は、 の手順に従って、プロジェクトに prefix ヘッダーを追加してください 。
引き続き、New Relicをモバイルモニタリング用に設定する手順をご紹介します。
Objective-Cによる設定
iOSアプリをCocoaPodsとObjective-Cで設定するこれらの手順は、New Relicの Get Started ページにも掲載されています。
プロジェクトのPodfile に、次の行を追加します。
pod 'NewRelicAgent'Xcodeでプロジェクトを閉じ、プロジェクトディレクトリにある Terminal から以下のコマンドを実行してアップデートします。
pod installプロジェクトのディレクトリにある Terminal から以下のコマンドを実行して、Xcode でプロジェクトを開きます。
open App.xcworkspaceAPP_NAME-Prefix.pch
プロジェクト ファイル (通常はSupporting Files
フォルダーにあります) で、#ifdef __OBJC__ #endif
ブロック内に New Relic ヘッダーを含めます。#import <NewRelic/NewRelic.h>AppDelegate.m
ファイルで、次の呼び出しをapplication:didFinishLaunchingWithOptions
の最初の行として追加し、APP_TOKEN
をアプリケーション トークンに置き換えます。[NewRelic startWithApplicationToken:@"APP_TOKEN"];重要
エージェントは
didFinishLaunchingWithOptions
の最初の行にあり、メイン スレッドで実行して、適切なインスツルメンテーションを確保する必要があります。後で、バックグラウンド スレッドで、または非同期で呼び出しを開始すると、予期しない動作や不安定な動作が発生する可能性があります。ビルド スクリプトをターゲットのBuild Phasesに追加します。新しいビルド スクリプトが最後のビルド スクリプトであることを確認します。次に、
APP_TOKEN
をアプリケーション トークンに置き換えて、以下を貼り付けます。SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`/bin/sh "${SCRIPT}" "APP_TOKEN"アプリをクリーンアップしてビルドし、シミュレーターなどで実行します。
Swiftを使った設定
iOSアプリをCocoaPodsとSwiftで設定するこれらの手順は、New Relicの Get Started ページにも掲載されています。
プロジェクトのPodfile に、次の行を追加します。
pod 'NewRelicAgent'Xcodeでプロジェクトを閉じ、プロジェクトディレクトリにある Terminal から以下のコマンドを実行してアップデートします。
pod installプロジェクトのディレクトリにある Terminal から以下のコマンドを実行して、Xcode でプロジェクトを開きます。
open App.xcworkspaceブリッジングヘッダーを作成します。
- File(ファイル)> New(新規)> File(ファイル)> Objective-C File(Objective-Cファイル)の順に選択します。
- ファイル
Placeholder.m
に名前を付け、次へを選択します。 - Create(作成)を選択し、ブリッジングヘッダの生成を促すXcodeプロンプトに同意します。
APP_NAME-Bridging-Header.h
に、New Relic ヘッダーを追加します。#import "NewRelic/NewRelic.h"AppDelegate.swift
ファイルで、次の呼び出しをapplication:didFinishLaunchingWithOptions
の最初の行として追加し、APP_TOKEN
をアプリケーション トークンに置き換えます。NewRelic.start(withApplicationToken:"APP_TOKEN")重要
適切なインストゥルメンテーションを確保するために、
didFinishLaunchingWithOptions()
の先頭行でエージェントを呼び出し、メインスレッドでエージェントを実行する必要があります。呼び出しを後回しにして、バックグラウンドスレッドで実行したり、非同期で実行したりすると、想定外の動作や不安定な動作を引き起こす場合があります。ビルド スクリプトをターゲットのBuild Phasesに追加します。新しいビルド スクリプトが最後のビルド スクリプトであることを確認します。次に、
APP_TOKEN
をアプリケーション トークンに置き換えて、以下を貼り付けます。SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`/bin/sh "${SCRIPT}" "APP_TOKEN"アプリをクリーンアップしてビルドし、シミュレーターなどで実行します。
Did this doc help with your installation?
ログレベルの変更(オプション)
モバイルアプリをモニタリングする際は、以下の6つのログレベルを使用できます。
none
error
warning
info
verbose
ALL
アプリのログ レベルを上げるには、 NewRelic.start(withApplicationToken)
を呼び出す前に次のメソッド呼び出しを追加します。
[NRLogger setLogLevels:NRLogLevelALL];
Swiftアプリの場合。
NRLogger.setLogLevels(NRLogLevelALL.rawValue)