• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

この機械翻訳は、参考として提供されています。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。

問題を作成する

Swift パッケージ マネージャーの手動インストール

iOS 監視を設定するには、 ガイド付きインストールを 使用することをお勧めします。ただし、エージェントを手動でインストールする必要がある場合は、以下の手順に従って、Swift Package Manager を使用して New Relic iOS エージェントをインストールします。

ご使用の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をモバイルモニタリング用に設定する手順をご紹介します。

Swift Package Managerを使った設定

  1. File > Swift Packages > Add Package Dependency...を選択します。

  2. PackageファイルのGithub URLを追加します。

    https://github.com/newrelic/newrelic-ios-agent-spm

    ヒント

    パッケージの抽出時にartifact of binary target 'NewRelic' failed extraction: The operation couldn’t be completed. (TSCBasic.StringError error 1.)エラーが発生した場合は、Xcode を閉じて、派生データ フォルダーを削除し、Xcode を再度開いて、もう一度試してください。

  3. NewRelic パッケージ製品を選択し、ターゲットを選択して、 Finishを選択します。

  4. AppDelegate.swiftファイルで、この呼び出しをapplicationDidFinishLaunchWithOptionsの最初の行として追加し、 APP_TOKEN アプリケーション トークンに置き換えます (アプリが SwiftUI で作成されている場合は、次の 手順 に従って AppDelegate をプロジェクトに追加してください)。

    NewRelic.start(withApplicationToken:"APP_TOKEN")

    重要

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

  5. iOS エージェントのバージョンに基づいて、以下のビルド スクリプトをターゲットのBuild Phasesに追加します。 スクリプトが最後のビルド スクリプトであることを確認し、 APP_TOKENアプリケーション トークンに置き換えます。

    • iOS エージェント 7.4.0 以降の場合:
    bash
    $
    ARTIFACT_DIR="${BUILD_DIR%Build/*}"
    $
    SCRIPT=`/usr/bin/find "${SRCROOT}" "${ARTIFACT_DIR}" -type f -name run-symbol-tool | head -n 1`
    $
    /bin/sh "${SCRIPT}" "APP_TOKEN"
    • iOS エージェント 7.3.8 の場合以下:
    bash
    $
    SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
    $
    /bin/sh "${SCRIPT}" "APP_TOKEN"
  6. (オプション) デバッグ中にシンボルのアップロードをスキップするには、上記のビルド スクリプトに次の行を追加します。

    bash
    $
    if [ ${CONFIGURATION} = "Debug" ]; then
    $
    echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"
    $
    exit 0
    $
    fi
  7. 「スクリプトを実行: 依存関係分析に基づいて」というチェックボックスがある場合は、チェックが外れていることを確認してください。

  8. アプリをクリーンアップしてビルドし、シミュレーターなどで実行します。

このドキュメントはインストールの役に立ちましたか?

トラブルシューティング

Swift パッケージを追加するときに、次のエラーが表示される場合があります。

  • アーティファクトがチェックサムと一致しません
  • フレームワークを remoteSourceControl からダウンロードできません

これらのタイプのエラーが表示された場合は、次のことを試してください。

  1. Xcode プロジェクトから New Relic Swift パッケージの統合を解除します。

  2. ターミナルから次のコマンドを実行して、spm キャッシュを削除します。

    bash
    $
    rm -rf ~/Library/Caches/org.swift.swiftpm
    $
    rm -rf ~/Library/org.swift.swiftpm
  3. Xcode を使用して派生データを削除します。

  4. New Relic Swift パッケージを Xcode プロジェクトに再統合します。

(オプション) ログレベルを変更する

デフォルトでは、iOS エージェントはinfoレベルでログを記録します。ログ レベルを変更して、収集するデータを増減できます。サポートされているログ レベルは 6 つあります。

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

重要

ログ レベルをverbose以上に増やすのは、リリース ビルドではなく、デバッグの場合のみです。

アプリのロギング レベルを変更するには、 NewRelic.start(withApplicationToken)を呼び出す前に次のメソッド呼び出しを追加します。

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

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