Syntaxe
Java
NewRelic.recordCustomEvent(string $eventType, [string $eventName,] map<string, object> $eventAttributes)Kotlin [#kotlin]
NewRelic.recordCustomEvent( eventType: String?, eventName: String?, eventAttributes: MutableMap<String?, Any?>?)Description [#description]
Enregistre un événement New Relic personnalisé.
Crée et enregistre un événement personnalisé, à utiliser dans NRQL. L'événement comprend une liste d'attributs, spécifiés sous forme de carte. Contrairement à l'utilisation de setAttribute, l'ajout d'un attribut à un événement personnalisé les ajoute uniquement à cet événement ; ce ne sont pas des attributs de session.
Les considérations importantes et les bonnes pratiques comprennent :
- Vous devez limiter le nombre total de types d’événements à environ cinq.
eventTypeest destiné à être utilisé pour les catégories de haut niveau. Par exemple, vous pouvez créer un type d’événementGestures. - N'utilisez pas
eventTypepour nommer votre événement personnalisé. Créez un attribut pour nommer un événement ou utilisez le paramètre facultatifname. Bien que vous puissiez créer de nombreux événements personnalisés, il est essentiel de limiter le nombre deeventType. - L'utilisation du paramètre facultatif
namea le même effet que l'ajout d'une clénamedans le dictionnaireattributes.nameest un mot-clé utilisé pour afficher votre événement dans l'interface utilisateur de New Relic. Pour créer unnameutile, vous pouvez combiner plusieurs attributs (voir exemples).
Important
À partir de la version 5.12.0 de l'agent Android New Relic, la méthode recordEvent est obsolète et remplacée par recordCustomEvent. La méthode recordEvent continuera à fonctionner pendant une période indéterminée, mais si votre application contient des méthodes recordEvent , New Relic vous recommande de les remplacer.
La mise à jour de ces méthodes affectera toutes les requêtes et tableaux de bord NRQL qui utilisent les types d’événements obsolètes. Assurez-vous d'ajuster votre requête NRQL et votre tableau de bord selon vos besoins.
Paramètres [#parameters]
paramètres | Type | Description |
|---|---|---|
|
| Requis. Le type d'événement. N'utilisez pas |
|
| Facultatif. Une carte qui comprend une liste d'attributs qui désignent en outre des sous-catégories du Remarque : tous les types d’objets ne sont pas pris en charge. Voir setAttribute pour plus de détails sur les types pris en charge. ImportantLors de la définition de la clé de votre attribut personnalisé, sachez qu'il existe des attributs par défaut qui ne peuvent pas être remplacés. |
Valeurs de retour [#return-values]
Renvoie true si l'événement est enregistré avec succès, ou false dans le cas contraire.
Exemples [#examples]
Voici un exemple d’événement personnalisé de base :
Java [#java]
Map attributes = new HashMap();attributes.put("attributeName1", "value1");attributes.put("attributeName1", 2);boolean eventRecorded = NewRelic.recordCustomEvent("eventType", attributes);Kotlin [#kotlin]
val attributes = mutableMapOf<String,Any>("attributeName1" to "value1", "attributeName1" to 2)val eventRecorded = NewRelic.recordCustomEvent("eventType", attributes)Voici un exemple d'événement personnalisé avec plusieurs attributs :
Java [#java]
Map attributes = new HashMap();attributes.put("make", "Ford");attributes.put("model", "ModelT");attributes.put("color", "Black");attributes.put("VIN", "123XYZ");attributes.put("maxSpeed", 12);
NewRelic.recordCustomEvent("Car", attributes);Kotlin [#kotlin]
val attributes = mutableMapOf<String,Any>()attributes["make"] = "Ford"attributes["model"] = "ModelT"attributes["color"] = "Black"attributes["VIN"] = "123XYZ"attributes["maxSpeed"] = 12NewRelic.recordCustomEvent("Car", attributes)Voici un exemple d'événement personnalisé utilisant le paramètre name :
Java [#java]
Map attributes = new HashMap();attributes.put("make", "Ford");attributes.put("model", "ModelT");
NewRelic.recordCustomEvent("Car", "Ford Model T", attributes);Kotlin [#kotlin]
val attributes = mutableMapOf<String,Any>() attributes["make"] = "Ford" attributes["model"] = "ModelT" NewRelic.recordCustomEvent("Car", "Ford Model T", attributes);Important
À partir de la version 5.12.0 de l'agent iOS New Relic, la méthode recordEvent est obsolète et remplacée par recordCustomEvent. La méthode recordEvent continuera à fonctionner pendant une période indéterminée, mais si votre application contient des méthodes recordEvent , New Relic vous recommande de les remplacer.
La mise à jour de ces méthodes affectera toutes les requêtes et tous les tableaux de bord qui utilisent les types d’événements obsolètes. Assurez-vous d'ajuster votre requête NRQL et votre tableau de bord selon vos besoins.
Syntaxe
Objectif-C
+ (BOOL) recordCustomEvent:(NSString*)eventType attributes:(NSDictionary*)attributes;+ (BOOL) recordCustomEvent:(NSString*)eventType name:(NSString*)name attributes:(NSDictionary*)attributes;Swift [#swift]
NewRelic.recordCustomEvent(eventType: String!, attributes:[NSObject : AnyObject]!) -> BoolNewRelic.recordCustomEvent(eventType: String!, name: String!, attributes:[NSObject : AnyObject]!) -> BoolDescription [#description]
Crée et enregistre un événement personnalisé que vous pouvez requêter à l'aide de NRQL. L'événement comprend une liste d'attributs, spécifiés sous forme de carte. Contrairement à l'utilisation de setAttribute, l'ajout d'un attribut à un événement personnalisé les ajoute uniquement à cet événement ; ce ne sont pas des attributs de session.
Les considérations importantes et les bonnes pratiques comprennent :
- Limitez le nombre total de valeurs
eventTypeà environ cinq. Il est destiné à être utilisé pour les catégories de haut niveau, telles queGestures. - N'utilisez pas
eventTypepour nommer votre événement personnalisé. Créez plutôt un attribut pour nommer l'événement personnalisé ou utilisez le paramètre facultatifname. - Utilisez le mot-clé
namepour afficher votre événement dans l'interfacemonitoring des applications mobiles. Pour créer un nom utile, vous pouvez combiner plusieurs attributs. L'utilisation du paramètrenamea le même effet que l'ajout d'une clénamedans le dictionnaire d'attributs. - Les éléments de l'objet attribut doivent être de type NSString ou NSNumber.
Paramètres [#parameters]
paramètres | Type | Description |
|---|---|---|
|
| Requis. Le type d'événement. N'utilisez pas |
|
| Facultatif. Utilisez ce paramètre pour nommer l'événement. L'utilisation de ce paramètre équivaut à créer un paramètre |
|
| Facultatif. Une carte qui comprend une liste d'attributs qui désignent en outre des sous-catégories du Vous pouvez créer des attributs pour tous les descripteurs d'événements que vous jugez utiles. Pour nommer votre événement personnalisé, créez un attribut ImportantLors de la définition de la clé de votre attribut personnalisé, sachez qu'il existe des attributs par défaut qui ne peuvent pas être remplacés. |
Valeurs de retour [#return-values]
Renvoie true si l'événement est enregistré avec succès, ou false dans le cas contraire.
Exemples [#examples]
Objective-C [#obj-c]
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 [#swift]
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]);Syntaxe
recordCustomEvent(options: { eventType: string; eventName: string; attributes: object; }) => voidDescription [#description]
Crée et enregistre un événement personnalisé, à utiliser dans NRQL.
Paramètres [#parameters]
paramètres | Type | Description |
|---|---|---|
|
| Requis. Le type d'événement. N'utilisez pas |
|
| Facultatif. Utilisez ce paramètre pour nommer l'événement. L'utilisation de ce paramètre équivaut à créer un paramètre |
|
| Facultatif. Une carte qui comprend une liste d'attributs qui désignent en outre des sous-catégories du |
Valeurs de retour [#return-values]
Renvoie true si l'événement est enregistré avec succès, ou false dans le cas contraire.
Exemple [#example]
NewRelicCapacitorPlugin.recordCustomEvent({ eventType: "mobileClothes", eventName: "pants", attributes:{"pantsColor": "blue","pantssize": 32,"belt": true} });Syntaxe
recordCustomEvent(eventType: string, eventName?: string, attributes?: {[key: string]: boolean | number | string}): void;Description [#description]
Crée et enregistre un événement personnalisé, à utiliser dans NRQL.
Paramètres [#parameters]
paramètres | Type | Description |
|---|---|---|
|
| Requis. Le type d'événement. N'utilisez pas |
|
| Facultatif. Utilisez ce paramètre pour nommer l'événement. L'utilisation de ce paramètre équivaut à créer un paramètre |
|
| Facultatif. Une carte qui comprend une liste d'attributs qui désignent en outre des sous-catégories du |
Valeurs de retour [#return-values]
Renvoie true si l'événement est enregistré avec succès, ou false dans le cas contraire.
Exemple [#example]
NewRelic.recordCustomEvent("mobileClothes", "pants", {"pantsColor": "blue", "pantssize": 32, "belt": true});Syntaxe
RecordCustomEvent(string eventType, string eventName, Dictionary<string, object> attributes): bool;Description [#description]
Crée et enregistre un événement personnalisé, à utiliser dans NRQL.
En plus de tout attribut personnalisé que vous choisissez, l'événement aura également un attribut de session associé. Contrairement à l'utilisation de setAttribute, l'ajout d'un attribut à un événement fil d'Ariane les ajoute uniquement à cet événement ; ce ne sont pas des attributs de session.
Paramètres [#parameters]
paramètres | Type | Description |
|---|---|---|
|
| Requis. Le type d'événement. N'utilisez pas |
|
| Facultatif. Utilisez ce paramètre pour nommer l'événement. L'utilisation de ce paramètre équivaut à créer un paramètre |
|
| Facultatif. Un dictionnaire de paires de valeurs clés qui peuvent être utilisées pour fournir des informations supplémentaires sur l'événement personnalisé. |
Valeurs de retour [#return-values]
Renvoie true si l'événement est enregistré avec succès, ou false dans le cas contraire.
Exemple [#example]
CrossNewRelic.Current.RecordCustomEvent("MAUICustomEvent", "MAUICustomEventCategory", new Dictionary<string, object>() { {"BreadNumValue", 12.3 }, {"BreadStrValue", "MAUIBread" }, {"BreadBoolValue", true } });Syntaxe
recordCustomEvent(String eventType,{String eventName = "", Map<String, dynamic>? eventAttributes}): void;Description [#description]
Crée et enregistre un événement personnalisé, à utiliser dans NRQL.
Paramètres [#parameters]
paramètres | Type | Description |
|---|---|---|
|
| Requis. Le type d'événement. N'utilisez pas |
|
| Facultatif. Utilisez ce paramètre pour nommer l'événement. L'utilisation de ce paramètre équivaut à créer un paramètre |
|
| Facultatif. Une carte qui comprend une liste d'attributs qui désignent en outre des sous-catégories du |
Valeurs de retour [#return-values]
Renvoie true si l'événement est enregistré avec succès, ou false dans le cas contraire.
Exemple [#example]
NewrelicMobile.instance.recordCustomEvent("Major",eventName: "User Purchase",eventAttributes: {"item1":"Clothes","price":34.00});Syntaxe
recordCustomEvent(eventType: string, eventName?: string, attributes?: {[key: string]: any}): void;Description [#description]
Crée et enregistre un événement personnalisé, à utiliser dans NRQL.
Paramètres [#parameters]
paramètres | Type | Description |
|---|---|---|
|
| Requis. Le type d'événement. N'utilisez pas |
|
| Facultatif. Utilisez ce paramètre pour nommer l'événement. L'utilisation de ce paramètre équivaut à créer un paramètre |
|
| Facultatif. Une carte qui comprend une liste d'attributs qui désignent en outre des sous-catégories du |
Valeurs de retour [#return-values]
Renvoie true si l'événement est enregistré avec succès, ou false dans le cas contraire.
Exemple [#example]
NewRelic.recordCustomEvent("mobileClothes", "pants", {"pantsColor": "blue","pantssize": 32,"belt": true});Syntaxe
RecordCustomEvent(string name, Dictionary<string, object> attributes): bool;Description [#description]
Crée et enregistre un événement personnalisé, à utiliser dans NRQL.
Paramètres [#parameters]
paramètres | Type | Description |
|---|---|---|
|
| Utilisez ce paramètre pour nommer l'événement. L'utilisation de ce paramètre équivaut à créer un paramètre |
|
| Facultatif. Un dictionnaire de paires de valeurs clés qui peuvent être utilisées pour fournir des informations supplémentaires sur l'événement personnalisé. |
Valeurs de retour [#return-values]
Renvoie true si l'événement est enregistré avec succès, ou false dans le cas contraire.
Exemple [#example]
Dictionary<string, object> dic = new Dictionary<string, object>();dic.Add("Unity Custom Attribute", "Data2");
NewRelicAgent.RecordCustomEvent("Unity Custom Event Example", dic);Syntaxe
RecordCustomEvent(string name, Dictionary<string, object> attributes): bool;Description [#description]
Crée et enregistre un événement personnalisé, à utiliser dans NRQL.
Paramètres [#parameters]
paramètres | Type | Description |
|---|---|---|
|
| Utilisez ce paramètre pour nommer l'événement. L'utilisation de ce paramètre équivaut à créer un paramètre |
|
| Facultatif. Un dictionnaire de paires de valeurs clés qui peuvent être utilisées pour fournir des informations supplémentaires sur l'événement personnalisé. |
Valeurs de retour [#return-values]
Renvoie true si l'événement est enregistré avec succès, ou false dans le cas contraire.
Exemple [#example]
Dictionary<string, object> dic = new Dictionary<string, object>();dic.Add("Unity Custom Attribute", "Data2");
NewRelicAgent.RecordCustomEvent("Unity Custom Event Example", dic);Syntaxe
recordCustomEvent(FString eventType, TMap <FString, FString> eventAttributes):void
recordCustomEventWithEventType(FString eventType,FString eventName, TMap <FString, FString> eventAttributes):voidDescription [#description]
Crée et enregistre un événement personnalisé, à utiliser dans NRQL.
Paramètres [#parameters]
paramètres | Type | Description |
|---|---|---|
|
| Requis. Le type d'événement. N'utilisez pas |
|
| Facultatif. Une carte qui comprend une liste d'attributs qui désignent en outre des sous-catégories du Remarque : tous les types d’objets ne sont pas pris en charge. Voir setAttribute pour plus de détails sur les types pris en charge. ImportantLors de la définition de la clé de votre attribut personnalisé, sachez qu'il existe des attributs par défaut qui ne peuvent pas être remplacés. |
Exemple [#example]
#include "NewRelicBPLibrary.h"
TMap<FString, FString> customEventMap;customEventMap.Add("place", TEXT("Robots"));customEventMap.Add("user", TEXT("user1"));
UNewRelicBPLibrary::recordCustomEvent("Unreal Custom Event Example", customEventMap);
TMap<FString, FString> customEventMap;customEventMap.Add("place", TEXT("Robots"));customEventMap.Add("user", TEXT("user1"));
UNewRelicBPLibrary::recordCustomEvent("Unreal Custom Event Type","Unreal Custom Event Example", customEventMap);
Syntaxe
RecordCustomEvent(string eventType, string eventName, Dictionary<string, object> attributes): bool;Description [#description]
Crée et enregistre un événement personnalisé, à utiliser dans NRQL.
Paramètres [#parameters]
paramètres | Type | Description |
|---|---|---|
|
| Requis. Le type d'événement. N'utilisez pas |
|
| Facultatif. Utilisez ce paramètre pour nommer l'événement. L'utilisation de ce paramètre équivaut à créer un paramètre |
|
| Facultatif. Un dictionnaire de paires de valeurs clés qui peuvent être utilisées pour fournir des informations supplémentaires sur l'événement personnalisé. |
Valeurs de retour [#return-values]
Renvoie true si l'événement est enregistré avec succès, ou false dans le cas contraire.
Exemple [#example]
CrossNewRelicClient.Current.RecordCustomEvent("XamarinCustomEvent", "XamarinCustomEventCategory", new Dictionary<string, object>() { {"BreadNumValue", 12.3 }, {"BreadStrValue", "XamBread" }, {"BreadBoolValue", true } });