iOS向けAgentのインストールと設定に関するトラブルシューティングフレームワーク

所要時間:約 3分

原文: iOS Troubleshooting Framework Install and Config

トラブルシューティングフレームワークの翻訳済みリスト

  1. iOS Agent Installation Guide: 「iOS Installation for CocoaPods」または「Manual Installation for iOS」に従ってください(最新のAgentバージョンを推奨します:iOS Release Notes)。
  2. エージェントは、AppDelegate.swiftファイル内のapplication:didFinishLaunchingWithOptions()の1行目で起動されます。
    • 適切な計装を行うためには、didFinishLaunchingWithOptions()の1行目でエージェントを呼び出し、メインスレッドでエージェントを実行する必要があります。後から呼び出しを開始したり、バックグラウンドスレッドで実行したり、非同期に実行したりすると、予期せぬ動作や不安定な動作を引き起こす可能性があります。
    • iOS は 1 つのクラッシュハンドラしかサポートしていないため、エージェントをメソッドの最初に配置し、他のハンドラを無効にしておかないと、クラッシュが New Relicに送信されない可能性があるからです。
  3. ビルドスクリプトをターゲットのビルドフェーズに追加します。新しいビルドスクリプトが一番最後のビルドフェーズであることを確認し、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"
    
    
  4. インストール、ランタイム、ビルド時のエラーを避けるために、互換性と要件を確認してください。
  5. 必要に応じてエージェント機能フラグを有効/無効にするコードをエージェント開始前に配置します: iOS Agent Configuration and Feature Flags
  6. 必要に応じてカスタムデータを追加します。
  7. コンソールでエージェントのメッセージを確認し、データが正しくレポートされているか確認します: iOS Logging LevelをALLレベルにすることを推奨します。
    • エージェントのメッセージを取得するには、デバイスのログを出力するためにXcodeで環境変数を設定する必要があります。Product>>Scheme>>Edit Scheme: 環境変数 OS_ACTIVITY_MODE
  8. データ収集の制限によるデータ損失を防ぐために、エージェントの収集間隔タイマー、またはイベントプールを調整します。
  9. クラッシュが正しくレポートされるかテストします。
  10. ステップ1の手順およびこのガイドに従ってiOSエージェントをインストールしても問題が解決しない場合は、サポートに連絡して以下の内容を伝えてください。