Curso de Ingeniería en Observabilidad con New Relic

Queries en New Relic sin escribir código

Curso de Ingeniería en Observabilidad con New Relic

Queries en New Relic sin escribir código

Resumen

¿Te suena complicado escribir consultas en NRQL desde cero? Existe una forma gráfica de construir queries en New Relic sin escribir código, ideal para quienes están empezando con este lenguaje de monitoreo de aplicaciones. Aquí descubrirás cómo apoyarte en la documentación oficial y en el Data Explorer para crear consultas visuales paso a paso.

¿Dónde encontrar la documentación oficial de NRQL?

La documentación de New Relic es tu primer recurso cuando necesitas profundizar en data events y atributos para monitorear aplicaciones con mayor precisión.

Para llegar ahí, entra a New Relic Docs y usa el menú lateral izquierdo. Haz clic en buscar, escribe NRQL y el portal desplegará todos los recursos disponibles sobre el lenguaje.

¿Qué encuentras en la documentación de NRQL? Información sobre tipos de eventos, atributos disponibles y ejemplos de consultas. Es la fuente para resolver dudas técnicas sin depender de tutoriales externos.

Dedica unos minutos a explorarla. Te dará contexto sobre qué datos puedes consultar y cómo afinar tus queries para obtener métricas más útiles [01:00].

¿Cómo construir un query gráfico en el Data Explorer de New Relic?

El Data Explorer es la herramienta visual que te permite armar consultas sin escribir una sola línea de código. Está dentro del mismo escenario que ya conoces, pero con una interfaz guiada.

¿Cómo acceder al Data Explorer?

En el portal de New Relic, ve al menú lateral izquierdo y haz clic en Query your data. Verás el query builder habitual, pero esta vez selecciona la pestaña Data Explorer [01:35].

Ahí encontrarás los mismos elementos que en el modo escrito, organizados por categorías para que los selecciones con clics.

¿Qué elementos necesitas para armar el query?

La construcción gráfica se apoya en tres bloques principales:

  • Event types: el tipo de evento que vas a consultar, por ejemplo page view. Al seleccionarlo, se llenan automáticamente los campos Select y From.
  • Plot: la función que aplicas sobre los datos. Viene con count por defecto, pero puedes cambiarlo a sum, average y otras opciones según lo que necesites medir.
  • Dimensión: el atributo por el que agrupas los resultados, como app name para ver los datos por aplicación.

Por ejemplo, si eliges page view como event type, average sobre duración como plot, y app name como dimensión, obtienes el promedio de duración de las páginas vistas agrupado por aplicación [02:30].

¿Cómo se relacionan los términos gráficos con la sintaxis NRQL?

Los nombres cambian entre la vista gráfica y el código escrito, pero los conceptos son los mismos. Esta equivalencia te ayuda a leer cualquier query con confianza.

¿Qué diferencia hay entre plot y dimensión en NRQL? El plot es la función que calcula un valor (como count o average sobre un atributo). La dimensión es el campo por el que agrupas los resultados, equivalente al facet en código.

Mira esta correspondencia con un query simple:

  • FROM transaction corresponde al event type en el modo gráfico.
  • SELECT count(*) representa el plot, donde count es la función y el asterisco el atributo.
  • FACET app name equivale a la dimensión, que agrupa los resultados por nombre de aplicación [03:15].

Con esta traducción mental, puedes pasar de la interfaz visual al editor de NRQL sin perderte.

¿Dónde ves el query autogenerado y qué significa?

Después de seleccionar event type, plot y dimensión, dirígete al espacio que dice NRQL dentro del Data Explorer. Ahí aparecerá el query construido automáticamente con base en tus elecciones gráficas [04:00].

Leyendo el ejemplo: la consulta selecciona el promedio de duración de los page view, los agrupa por nombre de aplicación y consulta los últimos 30 minutos por defecto.

Esto último es importante: si generaste transacciones hace una o dos horas, no aparecerán en el resultado salvo que ajustes el rango de tiempo. El Data Explorer parte siempre de una ventana corta para mostrarte datos recientes.

¿Puedo cambiar el rango de tiempo del query gráfico? Sí, una vez generado el query puedes editar el rango directamente en NRQL o desde los controles de tiempo del portal para ampliar más allá de los 30 minutos iniciales.

Y así, sin agregar una línea de código, ya tienes una consulta funcional que puedes guardar, modificar o usar como base para queries más avanzados. Te animo a construir tus propios queries gráficos y compartir tus aprendizajes en los comentarios.