Consulta APM intervalo de tiempo de datos métricos con NRQL

APM reporta datos métricos en forma de intervalo de tiempo de datos métricos, y puede usar NRQL para consultar y alertar sobre este tipo de datos. Para explorar tus datos de intervalo de tiempo, consulta Explora tu métrica.

¿Por qué consultar intervalo de tiempo de datos métricos?

New Relic informa métrica de varias maneras. Una variedad de datos métricos la llamamos metric timeslice data; este es el tipo de datos que se utilizan para generar muchos de los gráficos en APM, monitoreo de aplicaciones móvilesy browser (para obtener más detalles, consulte intervalo de tiempo de datos métricos).

APMmétricas se convierten automáticamente de datos de intervalo de tiempo de métrica a datos métricos dimensionales más detallados, lo que los abre para consultas a través de NRQL y a través de nuestra API NerdGraph. Esta capacidad le permite crear visualizaciones personalizadas potentes y detalladas de estas importantes métricas APM. Y esto incluye poder consultar tu métrica personalizada.

¿Dónde consultar?

Recomendamos consultar los datos de intervalo de tiempo de métrica de APM utilizando nuestro generador de consultas. Esta experiencia ofrece funcionalidad NRQL completa y también brinda sugerencias útiles de autocompletar y comentarios sobre errores de consulta.

Tú también puedes:

• Realice una consulta NRQL utilizando nuestra API NerdGraph (GraphQL)
• Alerta sobre consulta NRQL usando NRQL condición de alerta

Cómo construir una consulta

En APM, algunos gráficos tienen la opción de ver la consulta NRQL que generó ese gráfico. Este es un buen punto de partida para entender cómo realizar una consulta métrica. La consulta NRQL que aparece a continuación se modifica ligeramente con respecto al gráfico de tasa de errores de la página de resumen APM.

FROM Metric
  SELECT count(apm.service.error.count) / count(apm.service.transaction.duration)
  WHERE (entity.guid = 'AN_ENTITY_GUID')
  AND (transactionType = 'Web')
  SINCE 1 day ago TIMESERIES

A continuación se muestra un desglose de cómo funcionan las partes de esta consulta:

Para obtener información general sobre la sintaxis de NRQL, incluidos FROM, FACET y TIMESERIES, consulte Introducción a NRQL.

Para obtener más consultas, consulte ejemplos de consultas.

Cómo se convierten los datos de intervalo de tiempo de métrica

La conversión de la APMmétrica de segmento de tiempo original en métrica dimensional que está disponible para consulta es un proceso continuo y no está completo. Si no ve la métrica que está buscando en esta sección, consulte Consulta genérica.

Así es como la métrica de segmento de tiempo APM original se convierte en métrica dimensional:

Algunas de las APM métricas disponibles como métrica dimensional:

Aprende cómo ver todas las métricas disponibles para ti. Para obtener la unidad de métrica para un nombre de métrica determinado, puede utilizar una consulta como:

FROM Metric
  SELECT unit
  WHERE appName = 'YOUR_APP_NAME'
  AND metricName = 'METRIC_NAME'

Para comprender más sobre la estructura general de los datos de intervalo de tiempo de métrica, incluidos algunos ejemplos comunes, consulte intervalo de tiempo de datos métricos.

Atributo

Estos atributos están disponibles además del atributo métrico específico que figura en la tabla métrica APManterior.

Descripción general métrica

La descripción general métrica le permite obtener un desglose de dónde se dedica el tiempo durante la ejecución. Estas métricas son únicas en algunos aspectos:

• Son una combinación de muchos intervalos de tiempo.
• Están diseñados para funcionar únicamente con la función de agregador average .
• El código ejecutado simultáneamente mostrará el tiempo de ejecución combinado.

Por ejemplo, si su servicio llama a una base de datos MySQL en 3 subprocesos simultáneos con un tiempo de respuesta promedio de 0,1 segundos para cada subproceso, el segmento MySQL aparecerá como 0,3.

Se proporcionan varias métricas generales para diferentes propósitos:

Consulta genérica con la métrica newrelic.timeslice.value

Para métricas que no han sido convertidas a métrica dimensional, o para su propia métrica personalizada, tenemos una métrica dimensional llamada newrelic.timeslice.value.

¿Cuándo usar newrelic.timeslice.value?

Dado un nombre de intervalo de tiempo de métrica, puedes consultar para ver si tiene un equivalente métrico dimensional convertido con esta sintaxis:

FROM Metric
SELECT uniques(metricName)
WHERE metricTimesliceName = 'Datastore/statement/MySQL/test/select'

Si el único nombre de métrica devuelto es newrelic.timeslice.value, deberá consultar sus datos utilizando este enfoque general.

Obtener disponible métrica

Para obtener una lista de métricas disponibles para una aplicación, puede utilizar una consulta como:

SELECT uniques(metricTimesliceName) 
FROM Metric WHERE appName='YOUR_APP_NAME' 
AND newrelic.timeslice.value IS NOT NULL

Faceta en un segmento de nombre de métrica con comodines

Algunos nombres de intervalo de tiempo de métrica incluyen valores de atributos como segmentos del nombre de la métrica. Por ejemplo, nuestro APMagente reporta métrica al rastrear la duración de las llamadas externas usando este formato:

External/{externalHost}/all

Aquí, {externalHost} representa el nombre de host para la llamada de red saliente.

A continuación se muestra un ejemplo de una consulta newrelic.timeslice.value genérica de una métrica personalizada que tiene facetas en un segmento de métrica con comodines:

FROM Metric SELECT count(newrelic.timeslice.value) 
  WHERE appName = 'MY APP' 
  WITH METRIC_FORMAT 'Custom/Labels/{action}' 
  TIMESERIES FACET action

En esta consulta, {action} crea un atributo temporal, action, que luego utiliza FACET action. Puede usar cualquier nombre que desee, porque es solo un atributo que existe mientras dura la consulta. Debe elegir un nombre que no entre en conflicto con el nombre de un atributo existente.

Funciones de agregador recomendadas

Las funciones recomendadas del agregador NRQL incluyen:

• apdex
• average
• sum
• count
• rate
• uniques

Ejemplos de consulta

Algunos ejemplos de consulta de datos de intervalo de tiempo de métrica:

FROM Metric
  SELECT rate(count(apm.service.transaction.duration), 1 minute) as 'Web throughput' 
  WHERE appName IN ('MY_APPLICATION', 'MY_OTHER_APPLICATION')
  AND (transactionType = 'Web')
  FACET appName
  TIMESERIES

FROM Metric 
  SELECT rate(count(apm.service.transaction.duration), 1 minute) as 'HttpDispatcher requests_per_minute' 
  WHERE appName = 'MY_APPLICATION' 
  AND (transactionType = 'Web')
  TIMESERIES SINCE 3 days ago

FROM Metric 
  SELECT count(apm.service.transaction.duration) as 'HttpDispatcher requests_per_minute' 
  WHERE appName = 'MY_APPLICATION' 
  AND (transactionType = 'Web')
  TIMESERIES SINCE 3 hours ago 
  FACET host 
  LIMIT 20

FROM Metric
  SELECT average(apm.service.transaction.duration) as 'HttpDispatcher average duration' 
  WHERE appName = 'MY_APPLICATION' 
  AND (transactionType = 'Web') 
  TIMESERIES SINCE 3 days ago

FROM Metric 
  SELECT average(newrelic.timeslice.value, exclusiveTime: true) as 'duration, seconds' 
  WHERE appName = 'MY_APPLICATION' 
  AND scope = 'Controller/users/show'
  LIMIT 20 
  FACET metricTimesliceName
  TIMESERIES SINCE 3 days ago