構文
NewRelic.recordHandledException(Exception $exceptionToHandle)NewRelic.recordHandledException(Exception $exceptionToHandle, Map of String, Object $exceptionAttributes)
処理された例外を記録します。オプションで、コンテキストを示す追加の属性を持つマップを取ります。
要件
エージェント バージョン 5.15.0 以上.
説明
recordHandledException()
を try{...} catch(){...}
ブロック内で使用することで、アプリケーションがどのくらいの頻度で、どのような状況で例外を投げているのかを把握することができます。
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); } } }); ...}