Crear métricas a partir de otros tipos de datos

Utilice el servicio API métrica de New Relic para definir reglas para crear métricas a partir de otros tipos de datos, como eventos, registros o intervalos. Recommendation: Antes de comenzar, revise nuestros requisitos y sugerencias para crear reglas.

Crear una regla métrica

Para crear una regla para crear métricas a partir de eventos, log o spans:

Construya la regla métrica usando NRQL.
Cree una solicitud de API NerdGraph (formato GraphQL) que contenga su regla NRQL.
Cree la métrica realizando la solicitud de API.

Una vez creada una métrica, puede consultarla y trazarla utilizando NRQL.

Paso 1. Crear regla de consulta NRQL

La parte más importante de la creación de una regla de métricas es construir la consulta NRQL que define la métrica para sus datos de evento, registro o intervalos. Puedes crear hasta 10 métricas con una sola consulta NRQL siguiendo este procedimiento:

Usando la interfaz NRQL de New Relic, cree una consulta para la métrica que desea crear. Por ejemplo:
```
FROM ProcessSample SELECT average(ioTotalReadBytes)
WHERE nr.entityType = 'HOST'
```
Importante
Las reglas de evento a métrica no soportan la cláusula WITH ... AS en NRQL consulta.
Edite la consulta para utilizar uno de los tres tipos métricos disponibles:
- summary: Úselo si la función de la consulta es min, max, sum, count o average.
- uniqueCount: Úselo si la función de la consulta es uniqueCount.
- distribution: Úselo si la función de la consulta es percentile o histogram.
  Esta consulta de ejemplo usa average, así que use summary:
  FROM ProcessSample SELECT summary(ioTotalReadBytes) WHERE nr.entityType = 'HOST'
  Esta consulta de ejemplo utiliza count en un campo no numérico:
  FROM ProcessSample SELECT count(hostname) WHERE hostname LIKE '%prod%'
  Para summary en un campo no numérico, utilice summary(1):
  FROM ProcessSample SELECT summary(1) WHERE hostname LIKE '%prod%'
  Sugerencia
  Para obtener información más detallada sobre el uso de estos tipos métricos en reglas, consulte Creación de reglas métricas: requisitos y consejos.
Decida los atributos que desea adjuntar a la métrica, siguiendo los límites de cardinalidad de combinaciones únicas de nombre de métrica/valor de atributo.
Recommendation: Ejecute una consulta independiente para garantizar que la cardinalidad máxima no supere los 50 000 durante una ventana de 30 segundos. Por ejemplo, la siguiente consulta encontrará la cardinalidad máxima encontrada en un período de 30 segundos durante las últimas 3 horas para el evento ProcessSample al incluir los atributos awsRegion, awsAvailabilityZone y commandName :
```
FROM (FROM ProcessSample
 SELECT rate(uniqueCount(awsRegion, awsAvailabilityZone, commandName), 30 seconds) AS 'cardinalityRate'
 WHERE nr.entityType = 'HOST' TIMESERIES 30 seconds) SELECT max(cardinalityRate) AS 'maxCardinalityRate' SINCE 3 hours AGO
```
Para poder agregar y filtrar tus métricas, agrega el atributo que deseas adjuntar a la métrica usando la cláusula FACET . Por ejemplo:
```
FROM ProcessSample
SELECT summary(ioTotalReadBytes) WHERE nr.entityType = 'HOST' 
FACET awsRegion, awsAvailabilityZone, commandName
```

Establezca el nombre de la métrica utilizando la función AS . Por ejemplo:

FROM ProcessSample SELECT summary(ioTotalReadBytes) AS 'io.totalread.bytes'
WHERE nr.entityType = 'HOST' FACET awsRegion, awsAvailabilityZone, commandName

Una vez que su regla NRQL esté completa, úsela para crear la solicitud de API.

Paso 2. Crear solicitud de API

Después de crear la regla NRQL para convertir datos de evento, registro o intervalos a métrica, continúe con la creación de la solicitud API. Puede utilizar nuestra herramienta API NerdGraph para explorar la estructura de datos y construir y realizar su solicitud.

Para verificar que la regla se creó correctamente, puede ejecutar una consulta para devolver esa regla usando su ID. Para obtener consejos sobre cómo consultar la métrica que has creado, consulta consulta y traza tu métrica.

El siguiente ejemplo de solicitud de API NerdGraph utiliza la misma regla NRQL del paso 1. El IO Total Read Bytes Rule crea una métrica denominada io.totalread.bytes. (El nombre de la regla puede tener espacios, lo que difiere de las reglas de nomenclatura métrica).

mutation {
  eventsToMetricsCreateRule(rules: {
    name: "io.totalread.bytes for computeSample entities",
    description:"Created by Zach on March 27, 2019. Used by team Network.",
    nrql:"FROM ProcessSample SELECT summary(ioTotalReadBytes) AS 'io.totalread.bytes' WHERE nr.entityType = 'ComputeSample' FACET awsRegion, awsAvailabilityZone, commandName",
    accountId: 123456
  })
  {
    successes {
      id
      name
      nrql
      enabled
    }
    failures {
      submitted {
        name
        nrql
        accountId        
      }
      errors {
        reason
        description
      }
    }
  }
}

En esta solicitud:

Solicitar elementos	Descripción
`mutation`	Uno de los tipos de operaciones API básicas.
`eventsToMetricsCreateRule`	El método que se llama para crear una regla.
`rules`	Toma cuatro parámetros: `name`: El nombre de la regla. `description`: Opcional. La descripción de la regla. Le recomendamos incluir información sobre quién creó los datos métricos y quién los utilizará. `accountId`: El ID de la cuenta New Relic donde vive el evento, registro o intervalos y se creará la métrica. `nrql`: la consulta NRQL que crea la regla. Para obtener más información sobre esto, consulte Crear consulta NRQL.
`successes` y `submitted` bloques	Aquí usted define los datos devueltos por una respuesta exitosa o fallida. Los parámetros disponibles para estos bloques incluyen: `id` (`ruleId` para `submitted`) `name` `description` `nrql` `enabled` (estado habilitado/deshabilitado) `accountId`
`ruleId` y `accountId`	Si se produce un error, los `ruleId` y `accountId` enviados se devolverán junto con el motivo del error y la descripción del error.

A continuación se muestra un ejemplo de una respuesta devuelta:

{
  "data": {
    "eventsToMetricsCreateRule": {
      "failures": [],
      "successes": [
        {
          "enabled": true,
          "id": "46",
          "name": "io.totalread.bytes for computeSample entities",
          "nrql": "FROM ProcessSample SELECT summary(ioTotalReadBytes) AS 'io.totalread.bytes' WHERE nr.entityType = 'ComputeSample' FACET awsRegion, awsAvailabilityZone, commandName"
        }
      ]
    }
  }
}

Paso 3. Crea una regla métrica con solicitud API

Cuando su solicitud API esté lista, puede usar la API NerdGraph para realizar la solicitud, lo que creará la métrica.

Consulta y traza tu métrica

Después de crear una regla métrica para convertir datos para su evento, registro o intervalos, puede ver los nuevos datos métricos en la UI de New Relic. Para ver sus datos:

Vaya a la interfaz de consulta NRQL de New Relic.
Ejecute la siguiente consulta para ver el nombre de todas sus métricas:
```
SELECT uniques(metricName) FROM Metric
```
Elija la métrica de interés y luego ejecute la siguiente consulta para ver el atributo disponible:
```
SELECT * FROM Metric where metricName = 'yourMetric'
```
Si no ve los datos esperados, siga los procedimientos de resolución de problemas .

Las funciones del agregador NRQL disponibles dependen del tipo de métrica que haya creado. Aquí hay unos ejemplos.

Si creó un tipo de métrica de resumen, puede usar las funciones de agregador count, sum, max, min y average , como se muestra en la siguiente consulta:

SELECT count(appStartResponseTime), sum(appStartResponseTime), max(appStartResponseTime), min(appStartResponseTime),  average(appStartResponseTime) FROM Metric

Si creó un tipo de métrica uniqueCount , solo puede usar la función uniqueCount , como se muestra en la siguiente consulta:

SELECT uniqueCount(playbackErrorStreamUniqueCount) * 100 / uniqueCount(streamUniqueCount) AS '% of Streams Impacted' FROM Metric

Si creó un tipo de métrica distribution , use las funciones percentile o histogram , como se muestra en la siguiente consulta:

SELECT percentile(service.responseTime, 95) FROM Metric

SELECT histogram(service.responseTime, 10, 20) FROM Metric

Resolución de problemas

Si su llamada NerdGraph no se construye correctamente, puede recibir un mensaje como este:

Cannot parse the unexpected character "\u201C”

Verifique que las comillas en la llamada NerdGraph no sean comillas tipográficas (comillas rizadas). Nuestra API NerdGraph solo acepta cotizaciones directas.

Te ofrecemos esta traducción automática para facilitar la lectura.

Crear métricas a partir de otros tipos de datos

Crear una regla métrica

Paso 1. Crear regla de consulta NRQL

Importante

Sugerencia

Paso 2. Crear solicitud de API

Ejemplo de solicitud de API de NerdGraph

Ejemplo de respuesta de la API NerdGraph

Paso 3. Crea una regla métrica con solicitud API

Consulta y traza tu métrica

Ejemplo de métrica de resumen

Ejemplo de métrica de conteo

Ejemplo de métrica de distribución

Resolución de problemas

Te ofrecemos esta traducción automática para facilitar la lectura.

Crear métricas a partir de otros tipos de datos

Crear una regla métrica .css-21sua1{background:none;border:none;width:0;padding:0;}

Paso 1. Crear regla de consulta NRQL

Importante

Sugerencia

Paso 2. Crear solicitud de API

Ejemplo de respuesta de la API NerdGraph

Paso 3. Crea una regla métrica con solicitud API

Consulta y traza tu métrica

Ejemplo de métrica de resumen

Ejemplo de métrica de conteo

Ejemplo de métrica de distribución

Resolución de problemas

Crear una regla métrica