構文
recordError:(NSError* _Nonnull)error attributes:(NSDictionary* _Nullable)attributes;NewRelic.recordError(error: $Error, map $eventAttributes);
Swift のエラーと NSErrors を MobileHandledException イベントとして記録します。オプションで、コンテキストを示す追加の属性を持つマップを取ります。
要件
エージェント バージョン 6.0.0 以上.
説明
クラッシュ分析にはrecordError
API呼び出しを使用できます。キャプチャされたイベントを確認して、アプリがエラーをスローする頻度と条件を理解するのに役立ててください。追加したカスタム属性に加えて、イベントにはセッション属性も関連付けられます。
このAPIは、 NSError
のインスタンスとオプションのNSDictionary
属性ディクショナリを取得してから、 recordHandledException
イベントを作成します。処理された例外ページやクラッシュイベントトレイルなどの場所で、モバイルモニタリングUIのイベントデータを表示できます。このデータをNRQLでクエリし、NewRelicダッシュボードでグラフ化することもできます。
このAPIの使用方法については、カスタムアトリビュートとイベントの送信に関するドキュメントを参照してください。
パラメーター
パラメータ | 説明 |
---|---|
NSError, Error | 必要です。投げられたエラーオブジェクト。 |
NSDictionary, [AnyHashable, Any]? | 任意です。コンテキストを与える属性の辞書。 |
例
Objective-C
方法です。
+ (void) recordError:(NSError* _Nonnull)error attributes:(NSDictionary* _Nullable)attributes;
+ (void) recordError:(NSError* _Nonnull)error;
例:
シンプルなObjective-Cの例。
[NSJSONSerialization JSONObjectWithData:data options:opt error:error];if (error) { [NewRelic recordError:error];}
辞書を使ったObjective-Cの例。
[NSJSONSerialization JSONObjectWithData:data options:opt error:error];if (error) { [NewRelic recordError:error withAttributes:@{@"int": @1, @"Test Group" : @"A | B"}];}
Swift
方法:
func recordError(error: Error)
func recordError(error: Error, attributes: [ AnyHashable : Any]?)
例:
シンプルなSwiftの例。
do { try method()} catch { NewRelic.recordError(error)}
辞書付きのSwiftの例。
do { try method()} catch { NewRelic.recordError(error, attributes: [ "int" : 1, "Test Group" : "A | B" ])}