構文
Java
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)コトリン [#android-syntax-kotlin]
NewRelic.recordHandledException( exception: Exception?, exceptionAttributes: Map<String?, Any?>?)NewRelic.recordHandledException(throwable: Throwable?)NewRelic. recordHandledException( throwable: Throwable?, attributes: Map<String?, Any?>?)説明 [#android-description]
処理された例外またはその他のスロー可能な型を記録する。オプションで、コンテキストを示す追加属性を持つマップを取ることができます。
try{...} catch(){...}ブロック内でrecordHandledException()を使用すると、アプリケーションが例外をスローする頻度と状況を把握できます。
関連するカスタム属性に加えて、イベントには関連する セッション属性 があります。イベントデータは、モバイルモニタリングUIの Crash event trail 、またはNRQL経由で見ることができます。
パラメーター [#android-parameters]
パラメータ | タイプ | 説明 |
|---|---|---|
|
| 必要。記録される例外。 |
|
| オプション。例外に関連付けられる属性のマップ。 |
戻り値 [#android-return-values]
正常に記録された場合はtrueを返し、そうでない場合はfalseを返します。
例 [#android-examples]
以下は、クリック時リスナー内から ClassCastException を記録する例です。
Java [#android-examples-java]
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); } } }); ...}コトリン [#android-examples-kotlin]
class MainActivity : AppCompatActivity() { ... binding.fab.setOnClickListener { view -> val myMap = mutableMapOf<String,Any>() try { myMap["Key"] = "Value" Snackbar.make(view, "Replace with your own action", Snackbar.LENGTH_LONG) .setAnchorView(R.id.fab) .setAction("Action", null).show() } catch(exception:Exception) { NewRelic.recordHandledException(exception,myMap) } } ...}構文
目的-c
recordHandledException:(NSException* __nonnull)exception withAttributes:(NSDictionary* __nullable)attributes;説明 [#ios-description]
処理された例外を記録します (Objective-c のみ)。オプションで、コンテキストを示す追加属性を含むマップを取得します。
recordHandledException APIはクラッシュ分析に役立ちます。キャプチャされたイベントは、アプリケーションが例外をスローする頻度とその条件を理解するのに役立ちます。関連するカスタム属性に加えて、イベントには関連するセッション属性もあります。
このAPIは、 NSExceptionのインスタンスとオプションのNSDictionary属性ディクショナリを取得してから、 recordHandledExceptionイベントを作成します。クラッシュイベントトレイルUIでイベントデータを表示し、NRQLでクエリを実行できます。
重要
この関数は Swift コードでは使用しないでください。 Swift コードで処理されたエラーを追跡するには、 recordErrorを使用してください。
パラメーター [#ios-parameters]
パラメータ | タイプ | 説明 |
|---|---|---|
|
| 必要。記録される例外。 |
|
| 任意です。コンテキストを与える属性の辞書。 |
戻り値 [#ios-return-values]
イベントが正常に記録された場合はtrueを返し、そうでない場合はfalseを返します。
例 [#ios-examples]
以下に、処理される単純な例外の例を示します。
try { @throw [NSException exceptionWithName:@"versionException" reason:@"App version no longer supported" userInfo:nil];} @catch(NSException* e) { [NewRelic recordHandledException:e];}別の例、または辞書を使用して処理された例外を次に示します。
NSException* exception = [NSException exceptionWithName:@"MyException" reason:@"I have my reason" userInfo:nil];
NSDictionary* dictionary = @{@"int" : @1, @"Test Group" : @"A | B"};
[NewRelic recordHandledException:exception withAttributes:dictionary];構文
RecordException(System.Exception exception) : void;説明 [#maui-description]
致命的ではない例外を手動で記録します。
パラメーター [#maui-parameters]
パラメータ | タイプ | 説明 |
|---|---|---|
|
| 必要。記録される例外。 |
戻り値 [#maui-return-values]
イベントが正常に記録された場合はtrueを返し、そうでない場合はfalseを返します。
例 [#maui-example]
try { some_code_that_throws_error(); } catch (Exception ex) { CrossNewRelic.Current.RecordException(ex); }構文
RecordException(System.Exception exception) : void;説明 [#unity-description]
処理された例外を記録します。オプションで、コンテキストを示す追加の属性を持つマップを取ります。
パラメーター [#unity-parameters]
パラメータ | タイプ | 説明 |
|---|---|---|
|
| 必要。記録される例外。 |
戻り値 [#unity-return-values]
イベントが正常に記録された場合はtrueを返し、そうでない場合はfalseを返します。
例 [#unity-example]
try { some_code_that_throws_error();} catch(Exception ex) { NewRelicAgent.RecordException(e);}構文
RecordException(System.Exception exception) : void;説明 [#xamarin-description]
処理された例外を手動で記録します。
パラメーター [#xamarin-parameters]
パラメータ | タイプ | 説明 |
|---|---|---|
|
| 必要。記録される例外。 |
戻り値 [#xamarin-return-values]
イベントが正常に記録された場合はtrueを返し、そうでない場合はfalseを返します。
例 [#xamarin-example]
try { some_code_that_throws_error();} catch(Exception ex) { CrossNewRelicClient.Current.RecordException(ex);}