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

原文: 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. データ収集の制限によるデータ損失を防ぐために、エージェントの収集間隔タイマー、またはイベントプールを調整します。
   • setMaxEventBufferTime
   • sexMaxEventPoolSize
9. クラッシュが正しくレポートされるかテストします。
10. ステップ1の手順およびこのガイドに従ってiOSエージェントをインストールしても問題が解決しない場合は、サポートに連絡して以下の内容を伝えてください。
    • AppDelegateファイル
    • エージェントのログレベルがALLに調整されたBuild and Runtime Logs