recordHandledException (iOS SDK API)

構文

recordHandledException:(NSException* __nonnull)exception withAttributes:(NSDictionary* __nullable)attributes;

処理された例外を記録します。オプションで、コンテキストを示す追加の属性を持つマップを取ります。

要件

エージェントバージョン 5.15.0 以上.

説明

recordHandledException APIはクラッシュ分析に役立ちます。キャプチャされたイベントは、アプリケーションが例外をスローする頻度とその条件を理解するのに役立ちます。関連するカスタム属性に加えて、イベントには関連するセッション属性もあります。

このAPIは、 NSExceptionのインスタンスとオプションのNSDictionary属性ディクショナリを取得してから、 recordHandledExceptionイベントを作成します。クラッシュイベントトレイルUIでイベントデータを表示し、NRQLでクエリを実行できます。

このAPIの使用方法については、カスタムアトリビュートとイベントの送信に関するドキュメントを参照してください。

Objective-C

パラメーター

パラメータ	説明
`$exception` NSException	必要です。投げられた例外オブジェクト。
`$attributes` NSDictionary	任意です。コンテキストを与える属性の辞書。

パラメータ

説明

$exception

NSException

必要です。投げられた例外オブジェクト。

$attributes

NSDictionary

任意です。コンテキストを与える属性の辞書。

例

Objective-C

方法です。

+ (void) recordHandledException:(NSException* __nonnull)exception withAttributes:(NSDictionary* __nullable)attributes;

+ (void) recordHandledException:(NSException* __nonnull)exception;

例：

シンプルなObjective-Cの例。

@try {
       @throw [NSException exceptionWithName:@"versionException"
                                      reason:@"App version no longer supported"
                                    userInfo:nil];
     } @catch (NSException* e) {
       [NewRelic recordHandledException:e];
     }

辞書を使ったObjective-Cの例。

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];

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

構文

要件

説明

パラメーター

例

Objective-C