• ログイン無料アカウント

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

CocoaPodsのインストール

本手順は、Cocoapodsを使用するiOSアプリに適用されます。その他のタイプについては、 iOS のインストールと構成 を参照してください。

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

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

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

  1. one.newrelic.comに移動します。
  2. 該当する場合。Mobile Apps」リストから、 「Add a new app」 を選択します。
  3. Get Started ページから、モバイルモニタリングのプラットフォームとして iOS を選択します。
  4. モバイルアプリの名前を入力して、 Continue を選択します。
  5. インストールしたものに prefix ヘッダーが自動的に含まれていない場合は、 の手順に従って、プロジェクトに prefix ヘッダーを追加してください

引き続き、New Relicをモバイルモニタリング用に設定する手順をご紹介します。

Objective-Cによる設定

iOSアプリをCocoaPodsとObjective-Cで設定するこれらの手順は、New Relicの Get Started ページにも掲載されています。

  1. プロジェクトのPodfile に、次の行を追加します。

    pod 'NewRelicAgent'
  2. Xcodeでプロジェクトを閉じ、プロジェクトディレクトリにある Terminal から以下のコマンドを実行してアップデートします。

    pod install
  3. プロジェクトのディレクトリにある Terminal から以下のコマンドを実行して、Xcode でプロジェクトを開きます。

    open App.xcworkspace
  4. APP_NAME-Prefix.pch プロジェクトファイル (通常、 Supporting Files フォルダにあります) の中で、 #ifdef __OBJC__ #endif ブロックの中に New Relic のヘッダーを入れてください。

    #import <NewRelic/NewRelic.h>
  5. AppDelegate.m ファイルの中で、 application:didFinishLaunchingWithOptions の1行目にこの呼び出しを追加し、 APP_TOKENアプリケーション・トークン に置き換えます。

    [NewRelic startWithApplicationToken:@"APP_TOKEN"];

    重要

    エージェントは、適切なインスツルメンテーションを確保するために、 didFinishLaunchingWithOptions の最初の行にあり、メインスレッドで実行されている必要があります。呼び出しを後で開始したり、バックグラウンド・スレッドで開始したり、非同期に開始したりすると、予期しない動作や不安定な動作を引き起こす可能性があります。

  6. ビルドスクリプトをターゲットの Build Phases に追加します。この新しいビルドスクリプトが最後のビルドスクリプトであることを確認します。そして、 APP_TOKEN をあなたの アプリケーション・トークン に置き換えて、以下を貼り付けます。

    SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
    /bin/sh "${SCRIPT}" "APP_TOKEN"
  7. アプリをクリーンアップしてビルドし、シミュレーターなどで実行します。

Swiftを使った設定

iOSアプリをCocoaPodsとSwiftで設定するこれらの手順は、New Relicの Get Started ページにも掲載されています。

  1. プロジェクトのPodfile に、次の行を追加します。

    pod 'NewRelicAgent'
  2. Xcodeでプロジェクトを閉じ、プロジェクトディレクトリにある Terminal から以下のコマンドを実行してアップデートします。

    pod install
  3. プロジェクトのディレクトリにある Terminal から以下のコマンドを実行して、Xcode でプロジェクトを開きます。

    open App.xcworkspace
  4. ブリッジングヘッダーを作成します。

    1. File(ファイル)> New(新規)> File(ファイル)> Objective-C File(Objective-Cファイル)の順に選択します。
    2. ファイルにPlaceholder.mという名前を付け、Nextを選択します。
    3. Create(作成)を選択し、ブリッジングヘッダの生成を促すXcodeプロンプトに同意します。
  5. APP_NAME-Bridging-Header.h の中に、New Relic のヘッダーを追加します。

    #import "NewRelic/NewRelic.h"
  6. AppDelegate.swift ファイルの中で、 application:didFinishLaunchingWithOptions の1行目にこの呼び出しを追加し、 APP_TOKENアプリケーション・トークン に置き換えます。

    NewRelic.start(withApplicationToken:"APP_TOKEN")

    重要

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

  7. ビルドスクリプトをターゲットの Build Phases に追加します。この新しいビルドスクリプトが最後のビルドスクリプトであることを確認します。そして、 APP_TOKEN をあなたの アプリケーション・トークン に置き換えて、以下を貼り付けます。

    SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
    /bin/sh "${SCRIPT}" "APP_TOKEN"
  8. アプリをクリーンアップしてビルドし、シミュレーターなどで実行します。

ログレベルの変更(オプション)

モバイルアプリをモニタリングする際は、以下の6つのログレベルを使用できます。

  • なし
  • エラー
  • 警告
  • 情報
  • 詳細
  • ALL

アプリでのロギングレベルを上げるために、 NewRelic.start(withApplicationToken) を呼び出す前に、このメソッドコールを追加します。

[NRLogger setLogLevels:NRLogLevelALL];

Swiftアプリの場合。

NRLogger.setLogLevels(NRLogLevelALL.rawValue)
Copyright © 2022 New Relic株式会社。