Sintaxe
Java
NewRelic.setUserId(string $userId)
Kotlin [#kotlin]
NewRelic.recordMetric( name: String, category: String, count: Int, totalValue: Double, exclusiveValue: Double, countUnit: MetricUnit, valueUnit: MetricUnit)NewRelic.recordMetric(name: String?, category: String?, value: Double = 1.0)
Descrição [#description]
Com este método, você pode registrar métricas arbitrárias personalizadas para fornecer mais detalhes sobre a atividade do aplicativo que não é rastreada automaticamente pelo New Relic. A chamada aceita vários conjuntos de parâmetros para níveis opcionais de detalhe.
Para aproveitar ao máximo sua métrica, siga estas diretrizes para criar nomes de métricas claros e concisos:
- Use caracteres de maiúsculas e minúsculas e espaços em branco apropriados para exibição na interface do usuário. os nomes das métricas são renderizados como estão.
- Coloque o nome da métrica em maiúscula.
- Evite usar os caracteres
/
]
[
|
*
ao nomear métrica. - Evite caracteres multibyte.
O category
também é obrigatório; é exibido na interface e é útil para organizar métricas personalizadas caso você tenha muitas delas. Pode ser uma categoria personalizada ou uma categoria predefinida usando o MetricCategory
enum.
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
---|---|---|
|
| Obrigatório. O nome desejado para a métrica personalizada. |
|
| Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida. |
|
| Obrigatório. O valor da métrica. |
|
| Obrigatório. O número de vezes que a métrica foi registrada. |
|
| Obrigatório. O valor total da métrica. |
|
| Obrigatório. O valor exclusivo da gravação; por exemplo, se o valor total contiver medições contabilizadas em outro lugar. |
|
| Obrigatório. Unidade de medida para a contagem métrica, incluindo |
|
| Obrigatório. Unidade de medida do valor da métrica, incluindo |
Exemplos [#examples]
Aqui está um exemplo de criação de métrica personalizada simples:
Java [#java]
NewRelic.recordMetric("Custom Metric Name","MyCategory", 1.0);NewRelic.recordMetric("Login Auth Metric", "Network", 1.0);
Kotlin [#kotlin]
NewRelic.recordMetric("Custom Metric Name","MyCategory", 1.0)NewRelic.recordMetric("Login Auth Metric", "Network", 1.0)
Aqui está um exemplo de criação de uma métrica personalizada para início do agente:
Java [#java]
NewRelic.recordMetric("Agent start", "Lifecycle");
Kotlin [#kotlin]
NewRelic.recordMetric("Agent start", "Lifecycle")
Aqui está um exemplo da mesma métrica acima, mas com valor de tempo decorrido adicionado:
Java [#java]
NewRelic.recordMetric("Agent start", "Lifecycle", 10.11f);
Kotlin [#kotlin]
NewRelic.recordMetric("Agent start", "Lifecycle", 10.11)
Aqui está um exemplo da mesma métrica acima, mas com cinco contagens de tempo decorrido, tempo exclusivo e um parâmetro de valor unitário:
Java [#java]
NewRelic.recordMetric("Agent start", "Lifecycle", 5, 10.11, 1.23, MetricUnit.OPERATIONS, MetricUnit.SECONDS);
Kotlin [#kotlin]
NewRelic.recordMetric("Agent start", "Lifecycle", 5, 10.11, 1.23, MetricUnit.OPERATIONS, MetricUnit.SECONDS)
Sintaxe
Objetivo-c
[NewRelic recordMetricWithName:(NSString *)name category:(NSString *)category value:(NSNumber *)value];
Swift [#swift]
NewRelic.recordMetric(withName: String!, category: String!, value: NSNumber!)
Descrição [#description]
Com este método, você pode registrar métricas arbitrárias personalizadas para fornecer mais detalhes sobre a atividade do aplicativo que não é rastreada automaticamente pelo New Relic. A chamada aceita vários conjuntos de parâmetros para níveis opcionais de detalhe.
Este método registrará uma métrica no formato Custom/[Category]/[Name]
, com uma contagem de 1 e um valor total igual ao valor passado. Várias chamadas agregarão a contagem e o valor de acordo com as regras de agregação métrica padrão para .
Para aproveitar ao máximo sua métrica, siga estas diretrizes para criar nomes de métricas claros e concisos:
- Use caracteres de maiúsculas e minúsculas e espaços em branco apropriados para exibição na interface do usuário. os nomes das métricas são renderizados como estão.
- Coloque o nome da métrica em maiúscula.
- Evite usar os caracteres
/
]
[
|
*
ao nomear métrica. - Evite caracteres multibyte.
O category
também é obrigatório; é exibido na interface e é útil para organizar métricas personalizadas caso você tenha muitas delas. Pode ser uma categoria personalizada ou uma categoria predefinida usando a enumeração MetricCategory
.
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
---|---|---|
|
| Obrigatório. O nome desejado para a métrica personalizada. |
|
| Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida. |
|
| Obrigatório. O valor da métrica. |
Exemplos [#examples]
Objective-C [#obj-c]
Aqui está um exemplo de criação de uma métrica em milissegundos:
[NewRelic recordMetricWithName:(NSString *)@"My Important Metric" category:(NSString *)@"Important Metrics" value:(NSNumber *)145.67];
Swift [#swift]
Aqui está um exemplo de criação de uma métrica em milissegundos:
NewRelic.recordMetric(withName: "My Important Metric", category: "Important Metrics", value: 145.67)
Sintaxe
recordMetric(options: { name: string; category: string; value?: number; countUnit?: string; valueUnit?: string; }) => void
Descrição [#description]
Registra métrica personalizada (dados numéricos arbitrários), onde countUnit
é a unidade de medida da contagem da métrica e valueUnit
é a unidade de medida do valor da métrica. Se você usar countUnit
ou valueUnit
, deverá definir todos os três: value
, countUnit
e valueUnit
.
As medidas suportadas para countUnit
e valueUnit
são:
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
---|---|---|
|
| Obrigatório. O nome desejado para a métrica personalizada. |
|
| Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida. |
|
| Obrigatório. O valor da métrica. |
|
| Obrigatório. A unidade de medida da contagem. |
|
| Obrigatório. A unidade de medida da contagem. |
Exemplo [#example]
NewRelicCapacitorPlugin.recordMetric({ name: "CapacitorMetricName", category: "CapacitorMetricCategory",});NewRelicCapacitorPlugin.recordMetric({ name: "CapacitorMetricName2", category: "CapacitorMetricCategory2", value: 25,});NewRelicCapacitorPlugin.recordMetric({ name: "CapacitorMetricName3", category: "CapacitorMetricCategory3", value: 30, countUnit: NREnums.MetricUnit.SECONDS, valueUnit: NREnums.MetricUnit.OPERATIONS,});
Sintaxe
recordMetric(name: string, category: string, value?: number, countUnit?: string, valueUnit?: string): void;
Descrição [#description]
Registra métrica personalizada (dados numéricos arbitrários), onde countUnit
é a unidade de medida da contagem da métrica e valueUnit
é a unidade de medida do valor da métrica. Se você usar countUnit
ou valueUnit
, deverá definir todos os três: value
, countUnit
e valueUnit
.
As medidas suportadas para countUnit
e valueUnit
são:
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
---|---|---|
|
| Obrigatório. O nome desejado para a métrica personalizada. |
|
| Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida. |
|
| Obrigatório. O valor da métrica. |
|
| Obrigatório. A unidade de medida da contagem. |
|
| Obrigatório. A unidade de medida da contagem. |
Exemplo [#example]
NewRelic.recordMetric('CordovaCustomMetricName', 'CordovaCustomMetricCategory');NewRelic.recordMetric('CordovaCustomMetricName', 'CordovaCustomMetricCategory', 12);NewRelic.recordMetric('CordovaCustomMetricName', 'CordovaCustomMetricCategory', 13, 'PERCENT', 'SECONDS');
Sintaxe
RecordMetric(string name, string category) : void;RecordMetric(string name, string category, double value) : void;
Descrição [#description]
Registra métrica personalizada (dados numéricos arbitrários), onde countUnit
é a unidade de medida da contagem da métrica e valueUnit
é a unidade de medida do valor da métrica. Se você usar countUnit
ou valueUnit
, deverá definir todos os três: value
, countUnit
e valueUnit
.
As medidas suportadas para countUnit
e valueUnit
são:
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
---|---|---|
|
| Obrigatório. O nome desejado para a métrica personalizada. |
|
| Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida. |
|
| Obrigatório. O valor da métrica. |
|
| Obrigatório. A unidade de medida da contagem. |
|
| Obrigatório. A unidade de medida da contagem. |
Exemplo [#example]
CrossNewRelic.Current.RecordMetric("Agent start", "Lifecycle");CrossNewRelic.Current.RecordMetric("Login Auth Metric", "Network", 78.9);
Sintaxe
recordMetric(name: string, category: string, value?: number, countUnit?: string, valueUnit?: string): void;
Descrição [#description]
Registra métrica personalizada (dados numéricos arbitrários), onde countUnit
é a unidade de medida da contagem da métrica e valueUnit
é a unidade de medida do valor da métrica. Se você usar countUnit
ou valueUnit
, deverá definir todos os três: value
, countUnit
e valueUnit
.
As medidas suportadas para countUnit
e valueUnit
são:
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
---|---|---|
|
| Obrigatório. O nome desejado para a métrica personalizada. |
|
| Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida. |
|
| Obrigatório. O valor da métrica. |
|
| Obrigatório. A unidade de medida da contagem. |
|
| Obrigatório. A unidade de medida da contagem. |
Exemplo [#example]
NewrelicMobile.instance.recordMetric("testMetric", "Test Champ",value: 12.0);NewrelicMobile.instance.recordMetric("testMetric1", "TestChamp12",value: 10,valueUnit: MetricUnit.BYTES,countUnit: MetricUnit.PERCENT);
Sintaxe
recordMetric(name: string, category: string, value?: number, countUnit?: string, valueUnit?: string): void;
Descrição [#description]
Registra métrica personalizada (dados numéricos arbitrários), onde countUnit
é a unidade de medida da contagem da métrica e valueUnit
é a unidade de medida do valor da métrica. Se você usar countUnit
ou valueUnit
, deverá definir todos os três: value
, countUnit
e valueUnit
.
As medidas suportadas para countUnit
e valueUnit
são:
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
---|---|---|
|
| Obrigatório. O nome desejado para a métrica personalizada. |
|
| Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida. |
|
| Obrigatório. O valor da métrica. |
|
| Obrigatório. A unidade de medida da contagem. |
|
| Obrigatório. A unidade de medida da contagem. |
Exemplo [#example]
NewRelic.recordMetric('RNCustomMetricName', 'RNCustomMetricCategory');NewRelic.recordMetric('RNCustomMetricName', 'RNCustomMetricCategory', 12);NewRelic.recordMetric('RNCustomMetricName', 'RNCustomMetricCategory', 13, NewRelic.MetricUnit.PERCENT, NewRelic.MetricUnit.SECONDS);
Sintaxe
RecordMetricWithName(string name, string category) : void;RecordMetricWithName(string name, string category, double value) : void;RecordMetricWithName(string name, string category, double value, MetricUnit countUnit, MetricUnit valueUnit) : void;
Descrição [#description]
Registra métrica personalizada (dados numéricos arbitrários), onde countUnit
é a unidade de medida da contagem da métrica e valueUnit
é a unidade de medida do valor da métrica. Se você usar countUnit
ou valueUnit
, deverá definir todos os três: value
, countUnit
e valueUnit
.
As medidas suportadas para countUnit
e valueUnit
são:
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
---|---|---|
|
| Obrigatório. O nome desejado para a métrica personalizada. |
|
| Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida. |
|
| Obrigatório. O valor da métrica. |
|
| Obrigatório. A unidade de medida da contagem. |
|
| Obrigatório. A unidade de medida da contagem. |
Exemplo [#example]
NewRelicAgent.RecordMetricWithName('UnityCustomMetricName', 'UnityCustomMetricCategory');NewRelicAgent.RecordMetricWithName('UnityCustomMetricName', 'UnityCustomMetricCategory', 12);NewRelicAgent.RecordMetricWithName('UnityCustomMetricName', 'UnityCustomMetricCategory', 13, NewRelicAgent.MetricUnit.PERCENT, NewRelicAgent.MetricUnit.SECONDS);
Sintaxe
RecordMetric(string name, string category) : void;RecordMetric(string name, string category, double value) : void;RecordMetric(string name, string category, double value, MetricUnit countUnit, MetricUnit valueUnit) : void;
Descrição [#description]
Registra métrica personalizada (dados numéricos arbitrários), onde countUnit
é a unidade de medida da contagem da métrica e valueUnit
é a unidade de medida do valor da métrica. Se você usar countUnit
ou valueUnit
, deverá definir todos os três: value
, countUnit
e valueUnit
.
As medidas suportadas para countUnit
e valueUnit
são:
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
Parâmetro [#parameters]
Parâmetro | Tipo | Descrição |
---|---|---|
|
| Obrigatório. O nome desejado para a métrica personalizada. |
|
| Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida. |
|
| Obrigatório. O valor da métrica. |
|
| Obrigatório. A unidade de medida da contagem. |
|
| Obrigatório. A unidade de medida da contagem. |
Exemplo [#example]
CrossNewRelicClient.Current.RecordMetric("Agent start", "Lifecycle");CrossNewRelicClient.Current.RecordMetric("Login Auth Metric", "Network", 78.9);CrossNewRelicClient.Current.RecordMetric("Request Metric", "Network", 20, MetricUnit.SECONDS, MetricUnit.OPERATIONS);