• English日本語한국어
  • ログイン今すぐ開始

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

    1. エージェントを起動するには、AppDelegate.mの先頭に#import <NewRelic/NewRelic.h>を追加してNew Relicヘッダーをインポートします。
    2. 自動的に生成される一意のアプリケーショントークンを使用して、AppDelegate.m-application:didFinishLaunchingWithOptions:の先頭に+[NewRelic startWithApplicationToken:@"APP_TOKEN"]を追加します。

    Swift

    1. AppDelegate.swiftの先頭にimport NewRelicを追加してNew Relicエージェントをインポートします。(アプリケーションがSwiftUIで作成されている場合は、次の手順に従ってAppDelegateをプロジェクトに追加します。)
    2. 自動的に生成される一意のアプリケーショントークンを使用して、AppDelegate.swiftapplication(_: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 でデモクラッシュを実行できます。

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

言語

コード

Objective-C

クラッシュ:

[NewRelic crashNow];

ログメッセージ付きクラッシュ:

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

Swift

クラッシュ:

NewRelic.crashNow()

ログメッセージ付きクラッシュ:

NewRelic.crashNow(_ message:)

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

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

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

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

言語

コード

Objective-C

AppDelegate.mstartWithApplicationTokenを呼び出す直前に、以下を追加します。

[NRLogger setLogLevels:NRLogLevelALL];

Swift

AppDelegate.swiftstart(withApplicationToken:)を呼び出す直前に、以下を追加します。

NRLogger.setLogLevels(NRLogLevelALL.rawValue)
Copyright © 2023 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.