• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

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

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Registro métrico personalizado

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

$name

string

Obrigatório. O nome desejado para a métrica personalizada.

$category

string

Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida.

value

double

Obrigatório. O valor da métrica.

count

int

Obrigatório. O número de vezes que a métrica foi registrada.

totalValue

double

Obrigatório. O valor total da métrica.

exclusiveValue

double

Obrigatório. O valor exclusivo da gravação; por exemplo, se o valor total contiver medições contabilizadas em outro lugar.

countUnit

MetricUnit

Obrigatório. Unidade de medida para a contagem métrica, incluindo PERCENT, BYTES, SECONDS, BYTES_PER_SECOND ou OPERATIONS.

valueUnit

MetricUnit

Obrigatório. Unidade de medida do valor da métrica, incluindo PERCENT, BYTES, SECONDS, BYTES_PER_SECOND ou OPERATIONS.

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

name

NSString

Obrigatório. O nome desejado para a métrica personalizada.

category

NSString

Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida.

value

NSNumber

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

name

string

Obrigatório. O nome desejado para a métrica personalizada.

category

string

Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida.

value

number

Obrigatório. O valor da métrica.

countUnit

string

Obrigatório. A unidade de medida da contagem.

valueUnit

string

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

name

string

Obrigatório. O nome desejado para a métrica personalizada.

category

string

Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida.

value

number

Obrigatório. O valor da métrica.

countUnit

string

Obrigatório. A unidade de medida da contagem.

valueUnit

string

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

name

string

Obrigatório. O nome desejado para a métrica personalizada.

category

string

Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida.

value

number

Obrigatório. O valor da métrica.

countUnit

string

Obrigatório. A unidade de medida da contagem.

valueUnit

string

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

name

string

Obrigatório. O nome desejado para a métrica personalizada.

category

string

Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida.

value

number

Obrigatório. O valor da métrica.

countUnit

string

Obrigatório. A unidade de medida da contagem.

valueUnit

string

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

name

string

Obrigatório. O nome desejado para a métrica personalizada.

category

string

Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida.

value

number

Obrigatório. O valor da métrica.

countUnit

string

Obrigatório. A unidade de medida da contagem.

valueUnit

string

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

name

string

Obrigatório. O nome desejado para a métrica personalizada.

category

string

Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida.

value

number

Obrigatório. O valor da métrica.

countUnit

string

Obrigatório. A unidade de medida da contagem.

valueUnit

string

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

name

string

Obrigatório. O nome desejado para a métrica personalizada.

category

string

Obrigatório. O nome da categoria de métrica, personalizado ou usando uma categoria de métrica predefinida.

value

number

Obrigatório. O valor da métrica.

countUnit

string

Obrigatório. A unidade de medida da contagem.

valueUnit

string

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);
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.