Gravar evento personalizado

Sintaxe

Java

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

Kotlin [#kotlin]

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

Descrição [#description]

Registra um evento New Relic personalizado.

Cria e registra um evento personalizado, para uso em NRQL. O evento inclui uma lista de atributos, especificados como um mapa. Ao contrário de usar setAttribute, adicionar atributos a um evento personalizado os adiciona apenas a esse evento; eles não são atributos de sessão.

Considerações importantes e práticas recomendadas incluem:

Você deve limitar o número total de tipos de eventos a aproximadamente cinco. eventType deve ser usado para categorias de alto nível. Por exemplo, você pode criar um tipo de evento Gestures.
Não use eventType para nomear seu evento personalizado. Crie um atributo para nomear um evento ou use o parâmetro opcional name. Embora você possa criar vários eventos personalizados, é crucial limitar o número de eventTypes.
Usar o parâmetro opcional name tem o mesmo efeito que adicionar uma chave name no dicionário attributes . name é uma palavra-chave usada para exibir seu evento na interface do New Relic. Para criar um name útil, você pode combinar vários atributos (veja exemplos).

Importante

A partir da versão 5.12.0 do agente Android New Relic, o método recordEvent foi descontinuado e substituído por recordCustomEvent. O método recordEvent continuará funcionando por um período de tempo indeterminado, mas se seu aplicativo contiver métodos recordEvent , a New Relic recomenda que você os substitua.

A atualização desses métodos afetará qualquer consulta NRQL e painel que use os tipos de evento obsoletos. Certifique-se de ajustar sua consulta e painel de NRQL conforme necessário.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`$eventType`	`string`	Obrigatório. O tipo de evento. Não use `$eventType` para nomear seu evento personalizado. Em vez disso, use um atributo personalizado ou o opcional `name`.
`$eventName`	`dictionary`	Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o `$eventType`. Você pode criar um atributo para qualquer descritor de evento que achar útil. Para nomear seu evento personalizado, crie um atributo `name` ou utilize o parâmetro `eventName` . Nota: Nem todos os tipos de objetos são suportados. Consulte setAttribute para obter detalhes sobre os tipos suportados. Importante Ao definir a chave do seu atributo personalizado, esteja ciente de que existem atributos padrão que não podem ser substituídos.

Parâmetro

Tipo

Descrição

$eventType

string

Obrigatório. O tipo de evento. Não use $eventType para nomear seu evento personalizado. Em vez disso, use um atributo personalizado ou o opcional name.

$eventName

dictionary

Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o $eventType. Você pode criar um atributo para qualquer descritor de evento que achar útil. Para nomear seu evento personalizado, crie um atributo name ou utilize o parâmetro eventName .

Nota: Nem todos os tipos de objetos são suportados. Consulte setAttribute para obter detalhes sobre os tipos suportados.

Importante

Ao definir a chave do seu atributo personalizado, esteja ciente de que existem atributos padrão que não podem ser substituídos.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplos [#examples]

Aqui está um exemplo de um 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)

Aqui está um exemplo de evento personalizado com vários 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)

Veja um exemplo de evento personalizado usando o 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 da versão 5.12.0 do agente iOS da New Relic, o método recordEvent foi descontinuado e substituído por recordCustomEvent. O método recordEvent continuará funcionando por um período de tempo indeterminado, mas se seu aplicativo contiver métodos recordEvent , a New Relic recomenda que você os substitua.

A atualização desses métodos afetará qualquer consulta e painel que use os tipos de evento obsoletos. Certifique-se de ajustar sua consulta e painel de NRQL conforme necessário.

Sintaxe

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

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

Descrição [#description]

Cria e registra um evento personalizado que você pode consultar usando NRQL. O evento inclui uma lista de atributos, especificados como um mapa. Ao contrário de usar setAttribute, adicionar atributos a um evento personalizado os adiciona apenas a esse evento; eles não são atributos de sessão.

Considerações importantes e práticas recomendadas incluem:

Limite o número total de valores eventType a aproximadamente cinco. Destina-se a ser usado para categorias de alto nível, como Gestures.
Não use eventType para nomear seu evento personalizado. Em vez disso, crie um atributo para nomear o evento personalizado, ou utilize o parâmetro opcional name .
Utilize a palavra-chave name para exibir seu evento na interface de monitoramento de Mobile. Para criar um nome útil, você pode combinar vários atributos. Usar o parâmetro name tem o mesmo efeito que adicionar uma chave name no dicionário atributo.
Os elementos do objeto atributo devem ser do tipo NSString ou NSNumber.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`$eventType`	`string`	Obrigatório. O tipo de evento. Não use `$eventType` para nomear seu evento personalizado; use um atributo personalizado ou o parâmetro opcional `name` .
`$eventName`	`string`	Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro `name` .
`$eventAttributes`	`dictionary`	Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o `$eventType`. Os elementos do objeto atributo devem ser do tipo NSString ou NSNumber. Você pode criar um atributo para qualquer descritor de evento que achar útil. Para nomear seu evento personalizado, crie um atributo `name` ou utilize o parâmetro `eventName` . Importante Ao definir a chave do seu atributo personalizado, esteja ciente de que existem atributos padrão que não podem ser substituídos.

Parâmetro

Tipo

Descrição

$eventType

string

Obrigatório. O tipo de evento. Não use $eventType para nomear seu evento personalizado; use um atributo personalizado ou o parâmetro opcional name .

$eventName

string

Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro name .

$eventAttributes

dictionary

Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o $eventType. Os elementos do objeto atributo devem ser do tipo NSString ou NSNumber.

Você pode criar um atributo para qualquer descritor de evento que achar útil. Para nomear seu evento personalizado, crie um atributo name ou utilize o parâmetro eventName .

Importante

Ao definir a chave do seu atributo personalizado, esteja ciente de que existem atributos padrão que não podem ser substituídos.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

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

Sintaxe

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

Descrição [#description]

Cria e registra um evento personalizado, para uso em NRQL.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`eventType`	`string`	Obrigatório. O tipo de evento. Não use `$eventType` para nomear seu evento personalizado; use um atributo personalizado ou o parâmetro opcional `name` .
`eventName`	`string`	Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro `name` .
`attributes`	`object`	Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o `eventType`.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplo [#example]

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

Sintaxe

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

Descrição [#description]

Cria e registra um evento personalizado, para uso em NRQL.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`eventType`	`string`	Obrigatório. O tipo de evento. Não use `$eventType` para nomear seu evento personalizado; use um atributo personalizado ou o parâmetro opcional `name` .
`eventName?`	`string`	Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro `name` .
`attributes?`	`dictionary`	Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o `eventType`.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplo [#example]

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

Sintaxe

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

Descrição [#description]

Cria e registra um evento personalizado, para uso em NRQL.

Além de qualquer atributo personalizado que você escolher, o evento também terá sessão associada atributo. Ao contrário do uso de setAttribute, adicionar atributos a um evento de trilhas os adiciona apenas a esse evento; eles não são atributos de sessão.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`eventType`	`string`	Obrigatório. O tipo de evento. Não use `$eventType` para nomear seu evento personalizado; use um atributo personalizado ou o parâmetro opcional `name` .
`eventName`	`string`	Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro `name` .
`attributes`	`Dictionary<string, object>`	Opcional. Um dicionário de pares de valores principais que podem ser usados para fornecer informações adicionais sobre o evento customizado.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplo [#example]

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

Sintaxe

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

Descrição [#description]

Cria e registra um evento personalizado, para uso em NRQL.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`eventType`	`string`	Obrigatório. O tipo de evento. Não use `$eventType` para nomear seu evento personalizado; use um atributo personalizado ou o parâmetro opcional `name` .
`eventName`	`string`	Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro `name` .
`eventAttributes`	`dictionary`	Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o `eventType`.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplo [#example]

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

Sintaxe

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

Descrição [#description]

Cria e registra um evento personalizado, para uso em NRQL.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`eventType`	`string`	Obrigatório. O tipo de evento. Não use `$eventType` para nomear seu evento personalizado; use um atributo personalizado ou o parâmetro opcional `name` .
`eventName`	`string`	Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro `name` .
`attributes`	`dictionary`	Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o `eventType`.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplo [#example]

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

Sintaxe

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

Descrição [#description]

Cria e registra um evento personalizado, para uso em NRQL.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`name`	`string`	Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro `name` .
`attributes`	`Dictionary<string, object>`	Opcional. Um dicionário de pares de valores principais que podem ser usados para fornecer informações adicionais sobre o evento customizado.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplo [#example]

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

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

Sintaxe

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

Descrição [#description]

Cria e registra um evento personalizado, para uso em NRQL.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`name`	`string`	Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro `name` .
`attributes`	`Dictionary<string, object>`	Opcional. Um dicionário de pares de valores principais que podem ser usados para fornecer informações adicionais sobre o evento customizado.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplo [#example]

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

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

Sintaxe

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

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

Descrição [#description]

Cria e registra um evento personalizado, para uso em NRQL.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`$eventType`	`string`	Obrigatório. O tipo de evento. Não use `$eventType` para nomear seu evento personalizado. Em vez disso, use um atributo personalizado ou o opcional `name`.
`$eventName`	`eventAttributes`	Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o `$eventType`. Você pode criar um atributo para qualquer descritor de evento que achar útil. Para nomear seu evento personalizado, crie um atributo `name` ou utilize o parâmetro `eventName` . Nota: Nem todos os tipos de objetos são suportados. Consulte setAttribute para obter detalhes sobre os tipos suportados. Importante Ao definir a chave do seu atributo personalizado, esteja ciente de que existem atributos padrão que não podem ser substituídos.

Parâmetro

Tipo

Descrição

$eventType

string

Obrigatório. O tipo de evento. Não use $eventType para nomear seu evento personalizado. Em vez disso, use um atributo personalizado ou o opcional name.

$eventName

eventAttributes

Nota: Nem todos os tipos de objetos são suportados. Consulte setAttribute para obter detalhes sobre os tipos suportados.

Importante

Ao definir a chave do seu atributo personalizado, esteja ciente de que existem atributos padrão que não podem ser substituídos.

Exemplo [#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

Sintaxe

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

Descrição [#description]

Cria e registra um evento personalizado, para uso em NRQL.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`eventType`	`string`	Obrigatório. O tipo de evento. Não use `$eventType` para nomear seu evento personalizado; use um atributo personalizado ou o parâmetro opcional `name` .
`eventName`	`string`	Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro `name` .
`attributes`	`Dictionary<string, object>`	Opcional. Um dicionário de pares de valores principais que podem ser usados para fornecer informações adicionais sobre o evento customizado.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplo [#example]

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

Esta tradução de máquina é fornecida para sua comodidade.

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

Java

Kotlin [#kotlin]

Descrição [#description]

Importante

Parâmetro [#parameters]

Importante

Valores de retorno [#return-values]

Exemplos [#examples]

Java [#java]

Kotlin [#kotlin]

Java [#java]

Kotlin [#kotlin]

Java [#java]

Kotlin [#kotlin]

Importante

Sintaxe

Objetivo-c

Swift [#swift]

Descrição [#description]

Parâmetro [#parameters]

Importante

Valores de retorno [#return-values]

Exemplos [#examples]

Objective-C [#obj-c]

Swift [#swift]

Sintaxe

Descrição [#description]

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplo [#example]

Sintaxe

Descrição [#description]

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplo [#example]

Sintaxe

Descrição [#description]

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplo [#example]

Sintaxe

Descrição [#description]

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplo [#example]

Sintaxe

Descrição [#description]

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplo [#example]

Sintaxe

Descrição [#description]

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplo [#example]

Sintaxe

Descrição [#description]

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplo [#example]

Sintaxe

Descrição [#description]

Parâmetro [#parameters]

Importante

Exemplo [#example]

Sintaxe

Descrição [#description]

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplo [#example]

Sintaxe