Comience con NRQL: el lenguaje de los datos

New Relic Query Language (NRQL) es un lenguaje similar a SQL para consultar los datos de New Relic. El mismo lenguaje de consulta que impulsa los gráficos y el dashboard integrados de New Relic está a su disposición, para que pueda crear las vistas y alertas que el equipo necesita.

Aquí tiene un video para ayudarle a familiarizarse con el uso de NRQL al mostrarle cómo encontrar una consulta desde un dashboard y modificarla en el generador de consultas. Para obtener información más detallada sobre cómo realizar consultas, incluida una lista de cláusulas, funciones y consultas de ejemplo, consulte nuestra referencia de NRQL.

Qué puede hacer con NRQL

Use NRQL para:

Cree gráficos que muestren el rendimiento de la transacción, la tasa de errores o la latencia a lo largo del tiempo.
Responder una pregunta específica con fines de resolución de problemas o análisis de negocios.
Investigue un problema de rendimiento consultando los eventos y atributos específicos involucrados
Configure alertas basadas en NRQL que se activen cuando una métrica cruce un umbral
Realice consultas de API para los datos de New Relic, por ejemplo, usando nuestra API de NerdGraph.

NRQL funciona tanto para consultas básicas (obtención de filas sin procesar de datos de eventos) como para resultados calculados, como embudos basados en cómo los usuarios interactúan con su sitio o aplicación.

Sugerencia

New Relic utiliza NRQL internamente para potenciar los gráficos y dashboards en la plataforma de New Relic. Ese mismo lenguaje de consulta está disponible para usted.

Tipos de datos consultables

NRQL le permite consultar casi todos los tipos de nuestros telemetry data, incluidos:

Datos de eventos de todos los productos New Relic. Ejemplos incluyen:
- Evento APM, como Transaction
- Monitoreo de eventos del navegador, como PageView
- Monitoreo de eventos móviles, como Mobile
- Evento de infraestructura, como ProcessSample
- monitoreo sintético evento, como SyntheticCheck
- Evento personalizado, como los reportados por la API de eventos
El tipo de datosMetric (métrica reportada por la API métrica y fuentes de datos que utilizan esa API)
El tipo de datosSpan (datos de rastreo distribuido)
El tipo de datosLog (datos de nuestras capacidades de administración de logs)

Sugerencia

Algunos datos, como las relaciones entre entidades monitoras, no están disponibles a través de NRQL, pero sí mediante nuestra API NerdGraph.

Dónde usar NRQL

NRQL está disponible en toda la plataforma:

Acceda al generador de consultas a través del cajón Query your data en la parte inferior de cualquier página de New Relic para ejecutar consultas y crear gráficos personalizados.

Puede ejecutar una consulta NRQL en el generador de consultas dentro de la plataforma. Esta consulta NRQL muestra un recuento de los spans de rastreo distribuido desglosados por sus nombres de entidad.

Las alertas basadas en NRQL son el tipo de alerta principal en New Relic. Para crear una, vaya a one.newrelic.com > All capabilities > Alerts > Alert conditions (Policies) > (select a policy) > Add a condition, haga clic en NRQL y luego Next, define thresholds.

También puede usar NRQL con la API de NerdGraph. Esto le permite ejecutar consultas entre cuentas y consultas asincrónicas que no están disponibles en la UI.

Estructura de la consulta NRQL

NRQL sigue una sintaxis estructurada basada en cláusulas. Esta es una consulta de NRQL que cuenta todas las transacciones en la última hora:

SELECT count(*) FROM Transaction SINCE 1 hour ago

Aquí hay un desglose de todas las cláusulas disponibles:

SELECT function(attribute) [AS 'label'][, ...] 
  FROM data type
  [WHERE attribute [comparison] [AND|OR ...]][AS 'label'][, ...]
  [FACET attribute | function(attribute)]
  [LIMIT number]
  [SINCE time]
  [UNTIL time]
  [WITH TIMEZONE timezone]
  [COMPARE WITH time]
  [TIMESERIES time]

Estas son las reglas que sigue NRQL:

NRQL rule	Detalles
Valores requeridos	Las cláusulas `SELECT` y `FROM` son obligatorias. Todas las demás cláusulas son opcionales. Puede comenzar su consulta con `SELECT` o `FROM`.
Tamaño de la cadena de consulta	La cadena de consulta debe tener menos de 4 KB.
Sensibilidad entre mayúsculas y minúsculas	Los nombres de los tipos de datos y los nombres de los atributos distinguen entre mayúsculas y minúsculas. Las cláusulas y funciones de NRQL no distinguen entre mayúsculas y minúsculas.
Sintaxis para cadenas	NRQL utiliza comillas simples para designar cadenas. El siguiente ejemplo muestra la sintaxis: `... WHERE traceId = '030a573f0df02c57'`
Nombres de atributos y eventos personalizados no estándar	Los eventos que reportamos por defecto tienen nombres que contienen caracteres alfanuméricos, dos puntos (`:`) y guiones bajos (`_`). Los nombres de atributos pueden tener esos caracteres y puntos (`.`). Los nombres informados por defecto comienzan con una letra. Debe incluir los nombres personalizados que no sigan estas pautas entre comillas invertidas en las consultas NRQL. El siguiente ejemplo muestra un nombre personalizado entre comillas invertidas: ... FACET `Logged-in user`
Coerción de tipo de datos	No admitimos el tipo de datos "coerción". Para obtener más información, consulte Conversión de tipos de datos.

Para obtener más información, consulte la referencia de NRQL para ayudarle a crear las consultas.

Próximos pasos

Cómo funciona NRQL (ejecución de consultas, actualización de datos y límites)
Gráficos y dashboard con NRQL (visualice los resultados de la consulta)
Tutorial guiado de NRQL (guía práctica para nuevos usuarios)
Referencia de NRQL (sintaxis completa, cláusulas y funciones)

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

Comience con NRQL: el lenguaje de los datos

Qué puede hacer con NRQL .css-21sua1{background:none;border:none;width:0;padding:0;}

Sugerencia

Tipos de datos consultables

Sugerencia

Dónde usar NRQL

Estructura de la consulta NRQL

Próximos pasos

Qué puede hacer con NRQL