• ログイン無料アカウント

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

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

recordCustomEvent (iOS SDK API)

構文

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タイプでなければなりません。

パラメーター

パラメータ

説明

$eventType

ストリング

必須。イベントの種類。カスタムイベントに名前を付けるために$eventTypeを使用しないでください。カスタム属性またはオプションのnameパラメーターを使用します。

$eventName

ストリング

オプション。このパラメーターを使用して、イベントに名前を付けます。 (このパラメーターを使用することは、 nameパラメーターを作成することと同じです。)

$eventAttributes

マップ<文字列, オブジェクト>

オプション。 $eventTypeのサブカテゴリをさらに指定する属性のリストを含むマップ。属性オブジェクトの要素は、NSStringまたはNSNumberタイプである必要があります。

役立つと思われるイベント記述子の属性を作成できます。カスタムイベントに名前を付けるには、 name属性を作成するか、 eventNameパラメーターを使用します。

重要

カスタムアトリビュートのキーを設定する際には、オーバーライドできない デフォルトのアトリビュートがあることに注意してください

戻り値

イベントが正常に記録された場合は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}];

Swift

方法をご紹介します。

NewRelic.recordCustomEvent(eventType: String!, attributes:[NSObject : AnyObject]!) -> Bool
NewRelic.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]);
Copyright © 2022 New Relic株式会社。