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 eventoGestures
.Do not use
eventType
to name your custom events.Crie um atributo para nomear um evento ou use o parâmetro opcional
name
. Você pode criar vários eventos personalizados; são apenas os tipos de eventos que você deve limitar.Usar o parâmetro opcional
name
tem o mesmo efeito que adicionar uma chavename
no dicionárioattributes
.name
é uma palavra-chave usada para exibir seu evento na interface do New Relic. Para criar umname
ú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 |
---|---|---|
|
| Obrigatório. O tipo de evento. Do not use |
|
| Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o Nota: Nem todos os tipos de objetos são suportados. Consulte setAttribute para obter detalhes sobre os tipos suportados. ImportanteAo 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, comoGestures.
- 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 opcionalname
. - 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âmetroname
tem o mesmo efeito que adicionar uma chavename
no dicionário atributo. - Os elementos do objeto atributo devem ser do tipo NSString ou NSNumber.
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
---|---|---|
|
| Obrigatório. O tipo de evento. Não use |
|
| Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro |
|
| Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o Você pode criar um atributo para qualquer descritor de evento que achar útil. Para nomear seu evento personalizado, crie um atributo ImportanteAo 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 |
---|---|---|
|
| Obrigatório. O tipo de evento. Não use |
|
| Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro |
|
| Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o |
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 |
---|---|---|
|
| Obrigatório. O tipo de evento. Não use |
|
| Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro |
|
| Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o |
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 |
---|---|---|
|
| Obrigatório. O tipo de evento. Não use |
|
| Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro |
|
| 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 |
---|---|---|
|
| Obrigatório. O tipo de evento. Não use |
|
| Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro |
|
| Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o |
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 |
---|---|---|
|
| Obrigatório. O tipo de evento. Não use |
|
| Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro |
|
| Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o |
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 |
---|---|---|
|
| Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro |
|
| 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 |
---|---|---|
|
| Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro |
|
| 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 |
---|---|---|
|
| Obrigatório. O tipo de evento. Do not use |
|
| Opcional. Um mapa que inclui uma lista de atributos que designam subcategorias para o Nota: Nem todos os tipos de objetos são suportados. Consulte setAttribute para obter detalhes sobre os tipos suportados. ImportanteAo 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);
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 |
---|---|---|
|
| Obrigatório. O tipo de evento. Não use |
|
| Opcional. Use este parâmetro para nomear o evento. Usar esse parâmetro equivale a criar um parâmetro |
|
| 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 } } );