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

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

In the event of any inconsistency between the English version and the translated version, the English versionwill take priority. Please visit this page for more information.

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 a 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 a 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.