Grabar evento personalizado

Sintaxis

Java

NewRelic.recordCustomEvent(string $eventType, [string $eventName,] map<string, object> $eventAttributes)

Kotlin [#kotlin]

NewRelic.recordCustomEvent(
    eventType: String?,
    eventName: String?,
    eventAttributes: MutableMap<String?, Any?>?
)

Descripción [#description]

Graba un evento New Relic personalizado.

Crea y registra un evento personalizado, para usar en NRQL. El evento incluye una lista de atributos, especificados como un mapa. A diferencia de usar setAttribute, agregar atributos a un evento personalizado los agrega solo a ese evento; No son atributos de sesión.

Las consideraciones importantes y las mejores prácticas incluyen:

Debe limitar el número total de tipos de eventos a aproximadamente cinco. eventType está pensado para usarse en categorías de alto nivel. Por ejemplo, podría crear un tipo de evento Gestures.
No emplees eventType para nombrar tu evento personalizado. Cree un atributo para nombrar un evento o emplee el parámetro opcional name. Si bien puedes crear numerosos eventos personalizados, es crucial limitar la cantidad de eventTypes.
Usar el parámetro name opcional tiene el mismo efecto que agregar una clave name en el diccionario attributes . name es una palabra clave utilizada para mostrar su evento en la UI de New Relic. Para crear un name útil, puedes combinar varios atributos (ver ejemplos).

Importante

A partir de la versión 5.12.0 del agente de Android New Relic, el método recordEvent está obsoleto y reemplazado por recordCustomEvent. El método recordEvent seguirá funcionando durante un período de tiempo no especificado, pero si su aplicación contiene métodos recordEvent , New Relic le recomienda reemplazarlos.

La actualización de estos métodos afectará cualquier consulta NRQL y panel que utilice los tipos de eventos obsoletos. Asegúrese de ajustar su consulta y panel de NRQL según sea necesario.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`$eventType`	`string`	Requerido. El tipo de evento. No emplees `$eventType` para nombrar tu evento personalizado. En su lugar, emplee un atributo personalizado o el `name` opcional.
`$eventName`	`dictionary`	Opcional. Un mapa que incluye una lista de atributos que designan además subcategorías para `$eventType`. Puede crear atributos para cualquier descriptor de eventos que crea que será útil. Para nombrar tu evento personalizado, crea un atributo `name` o usa el parámetro `eventName` . Nota: No se admiten todos los tipos de objetos. Consulte setAttribute para obtener detalles sobre los tipos admitidos. Importante Al configurar la clave para su atributo personalizado, tenga en cuenta que hay atributos predeterminados que no se pueden anular.

Parámetro

Tipo

Descripción

$eventType

string

Requerido. El tipo de evento. No emplees $eventType para nombrar tu evento personalizado. En su lugar, emplee un atributo personalizado o el name opcional.

$eventName

dictionary

Opcional. Un mapa que incluye una lista de atributos que designan además subcategorías para $eventType. Puede crear atributos para cualquier descriptor de eventos que crea que será útil. Para nombrar tu evento personalizado, crea un atributo name o usa el parámetro eventName .

Nota: No se admiten todos los tipos de objetos. Consulte setAttribute para obtener detalles sobre los tipos admitidos.

Importante

Al configurar la clave para su atributo personalizado, tenga en cuenta que hay atributos predeterminados que no se pueden anular.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplos [#examples]

A continuación se muestra un ejemplo de un evento personalizado básico:

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)

A continuación se muestra un ejemplo de un evento personalizado con varios atributos:

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"] = 12
NewRelic.recordCustomEvent("Car", attributes)

A continuación se muestra un ejemplo de un evento personalizado que utiliza el parámetro 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);

Importante

A partir de la versión 5.12.0 del agente iOS de New Relic, el método recordEvent está obsoleto y reemplazado por recordCustomEvent. El método recordEvent seguirá funcionando durante un período de tiempo no especificado, pero si su aplicación contiene métodos recordEvent , New Relic le recomienda reemplazarlos.

La actualización de estos métodos afectará cualquier consulta y panel que utilice los tipos de eventos obsoletos. Asegúrese de ajustar su consulta y panel de NRQL según sea necesario.

Sintaxis

C objetivo

+ (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]!) -> Bool

NewRelic.recordCustomEvent(eventType: String!, name: String!, attributes:[NSObject : AnyObject]!) -> Bool

Descripción [#description]

Crea y registra un evento personalizado que puedes consultar usando NRQL. El evento incluye una lista de atributos, especificados como un mapa. A diferencia de usar setAttribute, agregar atributos a un evento personalizado los agrega solo a ese evento; No son atributos de sesión.

Las consideraciones importantes y las mejores prácticas incluyen:

Limite el número total de valores eventType a aproximadamente cinco. Está destinado a ser utilizado para categorías de alto nivel, como Gestures.
No utilices eventType para nombrar tu evento personalizado. En su lugar, cree un atributo para nombrar el evento personalizado o use el parámetro opcional name .
Utilice la palabra clave name para mostrar su evento en la UI de monitoreo de móviles. Para crear un nombre útil, puedes combinar varios atributos. Usar el parámetro name tiene el mismo efecto que agregar una clave name en el diccionario de atributos.
Los elementos del objeto de atributo deben ser del tipo NSString o NSNumber.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`$eventType`	`string`	Requerido. El tipo de evento. No utilices `$eventType` para nombrar tu evento personalizado; utilice un atributo personalizado o el parámetro opcional `name` .
`$eventName`	`string`	Opcional. Utilice este parámetro para nombrar el evento. Usar este parámetro equivale a crear un parámetro `name` .
`$eventAttributes`	`dictionary`	Opcional. Un mapa que incluye una lista de atributos que designan además subcategorías para `$eventType`. Los elementos del objeto atributo deben ser del tipo NSString o NSNumber. Puede crear atributos para cualquier descriptor de eventos que crea que será útil. Para nombrar tu evento personalizado, crea un atributo `name` o usa el parámetro `eventName` . Importante Al configurar la clave para su atributo personalizado, tenga en cuenta que hay atributos predeterminados que no se pueden anular.

Parámetro

Tipo

Descripción

$eventType

string

Requerido. El tipo de evento. No utilices $eventType para nombrar tu evento personalizado; utilice un atributo personalizado o el parámetro opcional name .

$eventName

string

Opcional. Utilice este parámetro para nombrar el evento. Usar este parámetro equivale a crear un parámetro name .

$eventAttributes

dictionary

Opcional. Un mapa que incluye una lista de atributos que designan además subcategorías para $eventType. Los elementos del objeto atributo deben ser del tipo NSString o NSNumber.

Puede crear atributos para cualquier descriptor de eventos que crea que será útil. Para nombrar tu evento personalizado, crea un atributo name o usa el parámetro eventName .

Importante

Al configurar la clave para su atributo personalizado, tenga en cuenta que hay atributos predeterminados que no se pueden anular.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplos [#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]);

Sintaxis

recordCustomEvent(options: { eventType: string; eventName: string; attributes: object; }) => void

Descripción [#description]

Crea y registra un evento personalizado, para usar en NRQL.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`eventType`	`string`	Requerido. El tipo de evento. No utilices `$eventType` para nombrar tu evento personalizado; utilice un atributo personalizado o el parámetro opcional `name` .
`eventName`	`string`	Opcional. Utilice este parámetro para nombrar el evento. Usar este parámetro equivale a crear un parámetro `name` .
`attributes`	`object`	Opcional. Un mapa que incluye una lista de atributos que designan además subcategorías para `eventType`.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplo [#example]

NewRelicCapacitorPlugin.recordCustomEvent({ eventType: "mobileClothes", eventName: "pants", attributes:{"pantsColor": "blue","pantssize": 32,"belt": true} });

Sintaxis

recordCustomEvent(eventType: string, eventName?: string, attributes?: {[key: string]: boolean | number | string}): void;

Descripción [#description]

Crea y registra un evento personalizado, para usar en NRQL.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`eventType`	`string`	Requerido. El tipo de evento. No utilices `$eventType` para nombrar tu evento personalizado; utilice un atributo personalizado o el parámetro opcional `name` .
`eventName?`	`string`	Opcional. Utilice este parámetro para nombrar el evento. Usar este parámetro equivale a crear un parámetro `name` .
`attributes?`	`dictionary`	Opcional. Un mapa que incluye una lista de atributos que designan además subcategorías para `eventType`.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplo [#example]

NewRelic.recordCustomEvent("mobileClothes", "pants", {"pantsColor": "blue", "pantssize": 32, "belt": true});

Sintaxis

RecordCustomEvent(string eventType, string eventName, Dictionary<string, object> attributes): bool;

Descripción [#description]

Crea y registra un evento personalizado, para usar en NRQL.

Además de cualquier atributo personalizado que elijas, el evento también tendrá asociado un atributo de sesión. A diferencia del uso de setAttribute, agregar atributos a un evento de ruta de navegación los agrega solo a ese evento; No son atributos de sesión.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`eventType`	`string`	Requerido. El tipo de evento. No utilices `$eventType` para nombrar tu evento personalizado; utilice un atributo personalizado o el parámetro opcional `name` .
`eventName`	`string`	Opcional. Utilice este parámetro para nombrar el evento. Usar este parámetro equivale a crear un parámetro `name` .
`attributes`	`Dictionary<string, object>`	Opcional. Un diccionario de pares de valores principales que se puede utilizar para proporcionar información adicional sobre el evento personalizado.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplo [#example]

CrossNewRelic.Current.RecordCustomEvent("MAUICustomEvent", "MAUICustomEventCategory", new Dictionary<string, object>()
    {
        {"BreadNumValue", 12.3 },
        {"BreadStrValue", "MAUIBread" },
        {"BreadBoolValue", true }
    }
);

Sintaxis

recordCustomEvent(String eventType,{String eventName = "", Map<String, dynamic>? eventAttributes}): void;

Descripción [#description]

Crea y registra un evento personalizado, para usar en NRQL.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`eventType`	`string`	Requerido. El tipo de evento. No utilices `$eventType` para nombrar tu evento personalizado; utilice un atributo personalizado o el parámetro opcional `name` .
`eventName`	`string`	Opcional. Utilice este parámetro para nombrar el evento. Usar este parámetro equivale a crear un parámetro `name` .
`eventAttributes`	`dictionary`	Opcional. Un mapa que incluye una lista de atributos que designan además subcategorías para `eventType`.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplo [#example]

NewrelicMobile.instance.recordCustomEvent("Major",eventName: "User Purchase",eventAttributes: {"item1":"Clothes","price":34.00});

Sintaxis

recordCustomEvent(eventType: string, eventName?: string, attributes?: {[key: string]: any}): void;

Descripción [#description]

Crea y registra un evento personalizado, para usar en NRQL.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`eventType`	`string`	Requerido. El tipo de evento. No utilices `$eventType` para nombrar tu evento personalizado; utilice un atributo personalizado o el parámetro opcional `name` .
`eventName`	`string`	Opcional. Utilice este parámetro para nombrar el evento. Usar este parámetro equivale a crear un parámetro `name` .
`attributes`	`dictionary`	Opcional. Un mapa que incluye una lista de atributos que designan además subcategorías para `eventType`.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplo [#example]

NewRelic.recordCustomEvent("mobileClothes", "pants", {"pantsColor": "blue","pantssize": 32,"belt": true});

Sintaxis

RecordCustomEvent(string name, Dictionary<string, object> attributes): bool;

Descripción [#description]

Crea y registra un evento personalizado, para usar en NRQL.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`name`	`string`	Utilice este parámetro para nombrar el evento. Usar este parámetro equivale a crear un parámetro `name` .
`attributes`	`Dictionary<string, object>`	Opcional. Un diccionario de pares de valores principales que se puede utilizar para proporcionar información adicional sobre el evento personalizado.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplo [#example]

Dictionary<string, object> dic = new Dictionary<string, object>();
dic.Add("Unity Custom Attribute", "Data2");

NewRelicAgent.RecordCustomEvent("Unity Custom Event Example", dic);

Sintaxis

RecordCustomEvent(string name, Dictionary<string, object> attributes): bool;

Descripción [#description]

Crea y registra un evento personalizado, para usar en NRQL.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`name`	`string`	Utilice este parámetro para nombrar el evento. Usar este parámetro equivale a crear un parámetro `name` .
`attributes`	`Dictionary<string, object>`	Opcional. Un diccionario de pares de valores principales que se puede utilizar para proporcionar información adicional sobre el evento personalizado.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplo [#example]

Dictionary<string, object> dic = new Dictionary<string, object>();
dic.Add("Unity Custom Attribute", "Data2");

NewRelicAgent.RecordCustomEvent("Unity Custom Event Example", dic);

Sintaxis

recordCustomEvent(FString eventType, TMap <FString, FString> eventAttributes):void

recordCustomEventWithEventType(FString eventType,FString eventName, TMap <FString, FString> eventAttributes):void

Descripción [#description]

Crea y registra un evento personalizado, para usar en NRQL.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`$eventType`	`string`	Requerido. El tipo de evento. No emplees `$eventType` para nombrar tu evento personalizado. En su lugar, emplee un atributo personalizado o el `name` opcional.
`$eventName`	`eventAttributes`	Opcional. Un mapa que incluye una lista de atributos que designan además subcategorías para `$eventType`. Puede crear atributos para cualquier descriptor de eventos que crea que será útil. Para nombrar tu evento personalizado, crea un atributo `name` o usa el parámetro `eventName` . Nota: No se admiten todos los tipos de objetos. Consulte setAttribute para obtener detalles sobre los tipos admitidos. Importante Al configurar la clave para su atributo personalizado, tenga en cuenta que hay atributos predeterminados que no se pueden anular.

Parámetro

Tipo

Descripción

$eventType

string

Requerido. El tipo de evento. No emplees $eventType para nombrar tu evento personalizado. En su lugar, emplee un atributo personalizado o el name opcional.

$eventName

eventAttributes

Nota: No se admiten todos los tipos de objetos. Consulte setAttribute para obtener detalles sobre los tipos admitidos.

Importante

Al configurar la clave para su atributo personalizado, tenga en cuenta que hay atributos predeterminados que no se pueden anular.

Ejemplo [#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);

Screenshot of the Unreal Engine Plugin Record Custom Event

Sintaxis

RecordCustomEvent(string eventType, string eventName, Dictionary<string, object> attributes): bool;

Descripción [#description]

Crea y registra un evento personalizado, para usar en NRQL.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`eventType`	`string`	Requerido. El tipo de evento. No utilices `$eventType` para nombrar tu evento personalizado; utilice un atributo personalizado o el parámetro opcional `name` .
`eventName`	`string`	Opcional. Utilice este parámetro para nombrar el evento. Usar este parámetro equivale a crear un parámetro `name` .
`attributes`	`Dictionary<string, object>`	Opcional. Un diccionario de pares de valores principales que se puede utilizar para proporcionar información adicional sobre el evento personalizado.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplo [#example]

CrossNewRelicClient.Current.RecordCustomEvent("XamarinCustomEvent", "XamarinCustomEventCategory", new Dictionary<string, object>()
    {
        {"BreadNumValue", 12.3 },
        {"BreadStrValue", "XamBread" },
        {"BreadBoolValue", true }
    }
);

Te ofrecemos esta traducción automática para facilitar la lectura.

Sintaxis .css-21sua1{background:none;border:none;width:0;padding:0;}

Java

Kotlin [#kotlin]

Descripción [#description]

Importante

Parámetros [#parameters]

Importante

Valores de retorno [#return-values]

Ejemplos [#examples]

Java [#java]

Kotlin [#kotlin]

Java [#java]

Kotlin [#kotlin]

Java [#java]

Kotlin [#kotlin]

Importante

Sintaxis

C objetivo

Swift [#swift]

Descripción [#description]

Parámetros [#parameters]

Importante

Valores de retorno [#return-values]

Ejemplos [#examples]

Objective-C [#obj-c]

Swift [#swift]

Sintaxis

Descripción [#description]

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplo [#example]

Sintaxis

Descripción [#description]

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplo [#example]

Sintaxis

Descripción [#description]

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplo [#example]

Sintaxis

Descripción [#description]

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplo [#example]

Sintaxis

Descripción [#description]

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplo [#example]

Sintaxis

Descripción [#description]

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplo [#example]

Sintaxis

Descripción [#description]

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplo [#example]

Sintaxis

Descripción [#description]

Parámetros [#parameters]

Importante

Ejemplo [#example]

Sintaxis

Descripción [#description]

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplo [#example]

Sintaxis