構文
NewRelic.recordHandledException(Exception $exceptionToHandle)NewRelic.recordHandledException(Exception $exceptionToHandle, Map of String, Object $exceptionAttributes)
NewRelic.recordHandledException(Throwable $throwableToHandle)NewRelic.recordHandledException(Throwable $throwableToHandle, Map of String, Object $exceptionAttributes)
処理された例外またはその他のスロー可能な型を記録する。オプションで、コンテキストを示す追加属性を持つマップを取ることができます。
要件
エージェント バージョン 5.15.0 以上.
説明
try{...} catch(){...}
ブロック内でrecordHandledException()
を使用すると、アプリケーションが例外をスローする頻度と状況を把握できます。
New Relic SDK API for Android をインポートします。
import com.newrelic.agent.android.NewRelic;アプリのコードで例外を記録し、オプションでコンテキスト属性のマップを渡します。
NewRelic.recordHandledException(Exception $exceptionToHandle, Map of String, Object $exceptionAttributes);
関連するカスタム属性に加えて、イベントには関連する セッション属性 があります。イベントデータは、モバイルモニタリングUIの Crash event trail 、またはNRQL経由で見ることができます。
New Relic Android SDK API の使用に関する一般的な情報については、 使用ガイド をご参照ください。
パラメーター
パラメータ | 説明 |
---|---|
例外 | 必要です。投げられた例外オブジェクト。 |
文字列、オブジェクトのマップ | 任意です。コンテキストを与える属性のマップ。 |
戻り値
処理された例外が正常に記録された場合はtrue
を返し、そうでない場合はfalse
を返します。
例
ボタン押下時の例外処理を記録
オンクリック リスナー内からClassCastException
を記録する例:
public class MainActivity extends Activity { ... coolButton.setOnClickListener(new View.OnClickListener() { Map myMap = new HashMap<>(); @Override public void onClick(View view) { try { myMap.put("Key", "Value"); Integer stringVar = (Integer) myMap.get("Key"); //throws ClassCastException } catch (Exception e) { NewRelic.recordHandledException(e, myMap); } } }); ...}