Sintaxis
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)Descripción [#description]
Con este método, puede registrar métricas personalizadas arbitrarias para brindar más detalles sobre la actividad de la aplicación que New Relic no rastrea automáticamente. La convocatoria acepta varios conjuntos de parámetros para niveles de detalle opcionales.
Para aprovechar al máximo su métrica, siga estas pautas para crear nombres métricos claros y concisos:
- Utilice caracteres de mayúsculas y minúsculas y espacios en blanco apropiados para su visualización en la interfaz de usuario. Los nombres métricos se representan tal cual.
- Escriba en mayúscula el nombre de la métrica.
- Evite emplear los caracteres
/][|*al nombrar métrica. - Evite los caracteres de varios bytes.
El category también es obligatorio; se muestra en la UI y es útil para organizar métricas personalizadas si tienes muchas. Puede ser una categoría personalizada o puede ser una categoría predefinida usando la enumeraciónMetricCategory .
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El nombre deseado para la métrica personalizada. |
|
| Requerido. El nombre de la categoría de métrica, ya sea personalizado o usando una categoría de métrica predefinida. |
|
| Requerido. El valor de la métrica. |
|
| Requerido. El número de veces que se registró la métrica. |
|
| Requerido. El valor total de la métrica. |
|
| Requerido. El valor exclusivo de la grabación; por ejemplo, si el valor total contiene mediciones contabilizadas en otra parte. |
|
| Requerido. Unidad de medida para el recuento métrico, incluidos |
|
| Requerido. Unidad de medida del valor de la métrica, incluidos |
Ejemplos [#examples]
A continuación se muestra un ejemplo de creación de métricas personalizadas sencillas:
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)A continuación se muestra un ejemplo de cómo crear una métrica personalizada para el inicio del agente:
Java [#java]
NewRelic.recordMetric("Agent start", "Lifecycle");Kotlin [#kotlin]
NewRelic.recordMetric("Agent start", "Lifecycle")A continuación se muestra un ejemplo de la misma métrica anterior, pero con el valor del tiempo transcurrido agregado:
Java [#java]
NewRelic.recordMetric("Agent start", "Lifecycle", 10.11f);Kotlin [#kotlin]
NewRelic.recordMetric("Agent start", "Lifecycle", 10.11)A continuación se muestra un ejemplo de la misma métrica anterior, pero con cinco recuentos de tiempo transcurrido, tiempo exclusivo y un parámetro de valor unitario:
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)Sintaxis
C objetivo
[NewRelic recordMetricWithName:(NSString *)name category:(NSString *)category value:(NSNumber *)value];Swift [#swift]
NewRelic.recordMetric(withName: String!, category: String!, value: NSNumber!)Descripción [#description]
Con este método, puede registrar métricas personalizadas arbitrarias para brindar más detalles sobre la actividad de la aplicación que New Relic no rastrea automáticamente. La convocatoria acepta varios conjuntos de parámetros para niveles de detalle opcionales.
Este método registrará una métrica del formato Custom/[Category]/[Name], con un recuento de 1 y un valor total igual al valor pasado. Varias llamadas agregarán el recuento y el valor de acuerdo con las reglas de agregación métrica estándar para .
Para aprovechar al máximo su métrica, siga estas pautas para crear nombres métricos claros y concisos:
- Utilice caracteres de mayúsculas y minúsculas y espacios en blanco apropiados para su visualización en la interfaz de usuario. Los nombres métricos se representan tal cual.
- Escriba en mayúscula el nombre de la métrica.
- Evite emplear los caracteres
/][|*al nombrar métrica. - Evite los caracteres de varios bytes.
El category también es obligatorio; se muestra en la UI y es útil para organizar métricas personalizadas si tienes muchas. Puede ser una categoría personalizada o puede ser una categoría predefinida usando la enumeración MetricCategory .
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El nombre deseado para la métrica personalizada. |
|
| Requerido. El nombre de la categoría de métrica, ya sea personalizado o usando una categoría de métrica predefinida. |
|
| Requerido. El valor de la métrica. |
Ejemplos [#examples]
Objective-C [#obj-c]
A continuación se muestra un ejemplo de cómo crear una métrica en milisegundos:
[NewRelic recordMetricWithName:(NSString *)@"My Important Metric" category:(NSString *)@"Important Metrics" value:(NSNumber *)145.67];Swift [#swift]
A continuación se muestra un ejemplo de cómo crear una métrica en milisegundos:
NewRelic.recordMetric(withName: "My Important Metric", category: "Important Metrics", value: 145.67)Sintaxis
recordMetric(options: { name: string; category: string; value?: number; countUnit?: string; valueUnit?: string; }) => voidDescripción [#description]
Registros métricos personalizados (datos numéricos arbitrarios), donde countUnit es la unidad de medida del conteo métrico y valueUnit es la unidad de medida del valor métrico. Si usa countUnit o valueUnit, debe configurar los tres: value, countUnit y valueUnit.
Las medidas admitidas para countUnit y valueUnit son:
PERCENTBYTESSECONDSBYTES_PER_SECONDOPERATIONS
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El nombre deseado para la métrica personalizada. |
|
| Requerido. El nombre de la categoría de métrica, ya sea personalizado o usando una categoría de métrica predefinida. |
|
| Requerido. El valor de la métrica. |
|
| Requerido. La unidad de medida para el recuento. |
|
| Requerido. La unidad de medida para el recuento. |
Ejemplo [#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,});Sintaxis
recordMetric(name: string, category: string, value?: number, countUnit?: string, valueUnit?: string): void;Descripción [#description]
Registros métricos personalizados (datos numéricos arbitrarios), donde countUnit es la unidad de medida del conteo métrico y valueUnit es la unidad de medida del valor métrico. Si usa countUnit o valueUnit, debe configurar los tres: value, countUnit y valueUnit.
Las medidas admitidas para countUnit y valueUnit son:
PERCENTBYTESSECONDSBYTES_PER_SECONDOPERATIONS
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El nombre deseado para la métrica personalizada. |
|
| Requerido. El nombre de la categoría de métrica, ya sea personalizado o usando una categoría de métrica predefinida. |
|
| Requerido. El valor de la métrica. |
|
| Requerido. La unidad de medida para el recuento. |
|
| Requerido. La unidad de medida para el recuento. |
Ejemplo [#example]
NewRelic.recordMetric('CordovaCustomMetricName', 'CordovaCustomMetricCategory');NewRelic.recordMetric('CordovaCustomMetricName', 'CordovaCustomMetricCategory', 12);NewRelic.recordMetric('CordovaCustomMetricName', 'CordovaCustomMetricCategory', 13, 'PERCENT', 'SECONDS');Sintaxis
RecordMetric(string name, string category) : void;RecordMetric(string name, string category, double value) : void;Descripción [#description]
Registros métricos personalizados (datos numéricos arbitrarios), donde countUnit es la unidad de medida del conteo métrico y valueUnit es la unidad de medida del valor métrico. Si usa countUnit o valueUnit, debe configurar los tres: value, countUnit y valueUnit.
Las medidas admitidas para countUnit y valueUnit son:
PERCENTBYTESSECONDSBYTES_PER_SECONDOPERATIONS
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El nombre deseado para la métrica personalizada. |
|
| Requerido. El nombre de la categoría de métrica, ya sea personalizado o usando una categoría de métrica predefinida. |
|
| Requerido. El valor de la métrica. |
|
| Requerido. La unidad de medida para el recuento. |
|
| Requerido. La unidad de medida para el recuento. |
Ejemplo [#example]
CrossNewRelic.Current.RecordMetric("Agent start", "Lifecycle");CrossNewRelic.Current.RecordMetric("Login Auth Metric", "Network", 78.9);Sintaxis
recordMetric(name: string, category: string, value?: number, countUnit?: string, valueUnit?: string): void;Descripción [#description]
Registros métricos personalizados (datos numéricos arbitrarios), donde countUnit es la unidad de medida del conteo métrico y valueUnit es la unidad de medida del valor métrico. Si usa countUnit o valueUnit, debe configurar los tres: value, countUnit y valueUnit.
Las medidas admitidas para countUnit y valueUnit son:
PERCENTBYTESSECONDSBYTES_PER_SECONDOPERATIONS
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El nombre deseado para la métrica personalizada. |
|
| Requerido. El nombre de la categoría de métrica, ya sea personalizado o utilizando una categoría de métrica predefinida. |
|
| Requerido. El valor de la métrica. |
|
| Requerido. La unidad de medida para el recuento. |
|
| Requerido. La unidad de medida para el recuento. |
Ejemplo [#example]
NewrelicMobile.instance.recordMetric("testMetric", "Test Champ",value: 12.0);NewrelicMobile.instance.recordMetric("testMetric1", "TestChamp12",value: 10,valueUnit: MetricUnit.BYTES,countUnit: MetricUnit.PERCENT);Sintaxis
recordMetric(name: string, category: string, value?: number, countUnit?: string, valueUnit?: string): void;Descripción [#description]
Registros métricos personalizados (datos numéricos arbitrarios), donde countUnit es la unidad de medida del conteo métrico y valueUnit es la unidad de medida del valor métrico. Si usa countUnit o valueUnit, debe configurar los tres: value, countUnit y valueUnit.
Las medidas admitidas para countUnit y valueUnit son:
PERCENTBYTESSECONDSBYTES_PER_SECONDOPERATIONS
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El nombre deseado para la métrica personalizada. |
|
| Requerido. El nombre de la categoría de métrica, ya sea personalizado o usando una categoría de métrica predefinida. |
|
| Requerido. El valor de la métrica. |
|
| Requerido. La unidad de medida para el recuento. |
|
| Requerido. La unidad de medida para el recuento. |
Ejemplo [#example]
NewRelic.recordMetric('RNCustomMetricName', 'RNCustomMetricCategory');NewRelic.recordMetric('RNCustomMetricName', 'RNCustomMetricCategory', 12);NewRelic.recordMetric('RNCustomMetricName', 'RNCustomMetricCategory', 13, NewRelic.MetricUnit.PERCENT, NewRelic.MetricUnit.SECONDS);Sintaxis
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;Descripción [#description]
Registros métricos personalizados (datos numéricos arbitrarios), donde countUnit es la unidad de medida del conteo métrico y valueUnit es la unidad de medida del valor métrico. Si usa countUnit o valueUnit, debe configurar los tres: value, countUnit y valueUnit.
Las medidas admitidas para countUnit y valueUnit son:
PERCENTBYTESSECONDSBYTES_PER_SECONDOPERATIONS
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El nombre deseado para la métrica personalizada. |
|
| Requerido. El nombre de la categoría de métrica, ya sea personalizado o usando una categoría de métrica predefinida. |
|
| Requerido. El valor de la métrica. |
|
| Requerido. La unidad de medida para el recuento. |
|
| Requerido. La unidad de medida para el recuento. |
Ejemplo [#example]
NewRelicAgent.RecordMetricWithName('UnityCustomMetricName', 'UnityCustomMetricCategory');NewRelicAgent.RecordMetricWithName('UnityCustomMetricName', 'UnityCustomMetricCategory', 12);NewRelicAgent.RecordMetricWithName('UnityCustomMetricName', 'UnityCustomMetricCategory', 13, NewRelicAgent.MetricUnit.PERCENT, NewRelicAgent.MetricUnit.SECONDS);Sintaxis
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;Descripción [#description]
Registros métricos personalizados (datos numéricos arbitrarios), donde countUnit es la unidad de medida del conteo métrico y valueUnit es la unidad de medida del valor métrico. Si usa countUnit o valueUnit, debe configurar los tres: value, countUnit y valueUnit.
Las medidas admitidas para countUnit y valueUnit son:
PERCENTBYTESSECONDSBYTES_PER_SECONDOPERATIONS
Parámetros [#parameters]
Parámetro | Tipo | Descripción |
|---|---|---|
|
| Requerido. El nombre deseado para la métrica personalizada. |
|
| Requerido. El nombre de la categoría de métrica, ya sea personalizado o usando una categoría de métrica predefinida. |
|
| Requerido. El valor de la métrica. |
|
| Requerido. La unidad de medida para el recuento. |
|
| Requerido. La unidad de medida para el recuento. |
Ejemplo [#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);