構文
recordCustomEvent:(NSString*)eventType attributes:(NSDictionary*)attributes;NewRelic.recordCustomEvent(string $eventType, [string $eventName,] map<string, object> $eventAttributes)カスタム・モバイル・モニタリング・イベントを記録します。
要件
New Relic iOSエージェントバージョン5.12.0以降、 recordEventメソッドは非推奨になり、 recordCustomEventに置き換えられました。 recordEventメソッドは不特定の期間機能し続けますが、アプリにrecordEventメソッドが含まれている場合、NewRelicはそれらを置き換えることをお勧めします。
これらのメソッドを更新すると、すべてのクエリに影響し、 非推奨のイベント タイプを使用します。必要に応じて、NRQL クエリとダッシュボードを調整してください。
説明
NRQLを使用してクエリできるカスタムイベントを作成して記録します。イベントには、マップとして指定された属性のリストが含まれています。 setAttributeを使用するのとは異なり、カスタムイベントに属性を追加すると、そのイベントにのみ属性が追加されます。それらはセッション属性ではありません。
重要な検討事項やベストプラクティスは以下の通りです。
eventType値の総数を約5つに制限します。これは、次のような高レベルのカテゴリに使用することを目的としています。Gestures.- カスタムイベントに名前を付けるために
eventTypeを使用しないでください。代わりに、カスタムイベントに名前を付ける属性を作成するか、オプションのnameパラメーターを使用してください。 nameキーワードを使用して、モバイル監視UIにイベントを表示します。便利な名前を作成するために、いくつかの属性を組み合わせることができます。nameパラメータを使用すると、属性ディクショナリにnameキーを追加するのと同じ効果があります。- 属性オブジェクトの要素は、NSStringまたはNSNumberタイプでなければなりません。
パラメーター
パラメータ | 説明 |
|---|---|
ストリング | 必須。イベントの種類。カスタムイベントに名前を付けるために |
ストリング | オプション。このパラメーターを使用して、イベントに名前を付けます。 （このパラメーターを使用することは、 |
マップ<文字列, オブジェクト> | オプション。 役立つと思われるイベント記述子の属性を作成できます。カスタムイベントに名前を付けるには、 重要カスタムアトリビュートのキーを設定する際には、オーバーライドできない デフォルトのアトリビュートがあることに注意してください 。 |
戻り値
イベントが正常に記録された場合はtrueを返し、そうでない場合はfalseを返します。
例
Objective-C
方法をご紹介します。
+ (BOOL) recordCustomEvent:(NSString*)eventType attributes:(NSDictionary*)attributes;+ (BOOL) recordCustomEvent:(NSString*)eventType name:(NSString*)name attributes:(NSDictionary*)attributes;例：
BOOL eventRecorded = [NewRelic recordCustomEvent:@"eventType"attributes:@{@"attributeName1": @"value1", @"attributeName2": @2}];BOOL eventRecorded = [NewRelic recordCustomEvent:@"Vehicle" name:@"1908 Ford ModelT" attributes:@{@"make":@"Ford", @"model":@"ModelT", @"year": @1908, @"color": @"black", @"mileage": @250000}];迅速
方法をご紹介します。
NewRelic.recordCustomEvent(eventType: String!, attributes:[NSObject : AnyObject]!) -> BoolNewRelic.recordCustomEvent(eventType: String!, name: String!, attributes:[NSObject : AnyObject]!) -> Bool例：
let eventRecorded = NewRelic.recordCustomEvent("eventType", attributes: ["attributeName1" : "value1", "attributeName2": 2])let eventRecorded = NewRelic.recordCustomEvent("Vehicle", name:"1908 Ford ModelT", attributes:["make":"Ford", "model":"ModelT", "year": 1908, "color": "black", "mileage": 250000]);