Cómo crear dashboards con NRQL en New Relic

Crear un dashboard en New Relic con NRQL te permite guardar consultas reutilizables y monitorear tu aplicación sin repetir queries cada vez. Es útil para desarrolladores y equipos de DevOps que necesitan tomar decisiones basadas en datos de transacciones, pageviews y geolocalización de usuarios.

¿Qué es NRQL y en qué se diferencia de SQL?

NRQL significa New Relic Query Language y es un lenguaje propio desarrollado por New Relic para consultar datos de monitoreo. Aunque se parece a SQL en sintaxis, no es lo mismo: está diseñado específicamente para extraer métricas de aplicaciones, transacciones y eventos dentro de la plataforma [0:14].

¿NRQL es lo mismo que SQL? No. NRQL es un lenguaje creado por New Relic para consultar datos de telemetría. Comparte estructura con SQL pero está optimizado para métricas y eventos.

La ventaja práctica está en que puedes guardar esas consultas como widgets dentro de un dashboard, lo que ahorra tiempo y mejora la efectividad del análisis.

¿Cómo se crea el primer dashboard en New Relic?

Desde el portal de New Relic, en el menú lateral izquierdo, encuentras la opción Dashboard. Si nunca has creado uno, aparecen dos botones: cargar un dashboard existente o crear el primero [1:09].

Al crear uno nuevo, New Relic te pide dos datos:

• El nombre del dashboard, por ejemplo Dashboard 01.
• El tipo de permisos: edición, solo lectura o privado.

Por defecto queda activado el permiso de edición. Al darle clic a crear, aparece el esqueleto vacío con varios recuadros listos para agregar gráficos.

¿Por qué el dashboard aparece vacío al inicio?

El esqueleto vacío es intencional. Cada recuadro es un espacio para que tú decidas qué métrica visualizar. Solo en el primer dashboard verás esos recuadros guía; después tendrás que agregar widgets desde el menú superior derecho con el botón Add widget.

¿Cómo agregar un widget con un query NRQL?

Al darle a Add new chart, aparecen dos opciones: agregar un gráfico o agregar texto, imágenes o links. Para trabajar con datos eliges gráfico y se abre el editor de NRQL [2:30].

El flujo básico es así:

1. Pegas el query NRQL en el editor.
2. Le das clic a Run para ejecutarlo.
3. Revisas el resultado y eliges el tipo de visualización.
4. Le pones nombre desde Basic information.
5. Guardas con Save.

En el primer ejemplo, un query simple cuenta todas las transacciones registradas y devuelve un total de 227 transacciones [3:18]. New Relic recomienda automáticamente el tipo de gráfico más adecuado según los datos, en este caso Billboard, pero puedes cambiarlo a Bullet o explorar el JSON crudo.

¿Qué es un widget en New Relic? Es cada bloque visual dentro de un dashboard que muestra el resultado de un query NRQL en formato gráfico, tabla o texto.

¿Cómo elegir el tipo de gráfico correcto?

New Relic habilita o inhabilita ciertos tipos de visualización según la naturaleza del query. Para un conteo simple funciona bien Billboard; para distribuciones por categoría, los formatos Pie o Bar son más útiles.

En el segundo widget se usa un query que cuenta todos los pageviews de la aplicación [5:09]. New Relic sugiere mostrarlo como tabla, pero al cambiarlo a Pie, el gráfico aparece junto con una leyenda que detalla:

• La descripción de la aplicación.
• La cantidad de vistas.
• El porcentaje que representa cada segmento.

Este widget se guarda con el nombre Pie 01.

¿Cómo agrupar resultados por ciudad y país con FACET?

El tercer query sube la complejidad. Selecciona las sesiones únicas de pageviews agrupadas por ciudad y código de país, filtradas desde el día anterior [6:45]. La cláusula clave aquí es FACET, que cumple la misma función que el GROUP BY de SQL.

Entender esa equivalencia acelera la curva de aprendizaje: si ya conoces SQL, basta con mapear GROUP BY a FACET y puedes construir agrupaciones geográficas, temporales o por atributo sin fricción.

¿Qué hace FACET en NRQL? Agrupa los resultados de un query por uno o varios atributos, igual que GROUP BY en SQL. Por ejemplo, FACET city, countryCode separa los datos por ciudad y país.

Al ejecutar este query y elegir el formato Pie, obtienes un gráfico con tabla lateral que muestra países, cantidades y porcentajes. Si compartes la URL de tu aplicación con personas en otros países, el gráfico se actualiza automáticamente conforme entran nuevos visitantes.

¿Por qué guardar queries en un dashboard ahorra tiempo?

La razón es directa: cada widget guardado conserva su query NRQL y se actualiza con datos en tiempo real. No tienes que volver a escribir ni ejecutar la consulta manualmente cada vez que quieras revisar transacciones, pageviews o distribución geográfica.

El dashboard final del ejercicio combina tres widgets:

• Transaction 01 en formato Billboard con el conteo total.
• Pie 01 con la distribución de pageviews por aplicación.
• Chart 02 con sesiones únicas agrupadas por ciudad y país.

Esa combinación te da una vista panorámica de volumen, distribución y geografía sin esfuerzo recurrente. Cuéntame en los comentarios cómo quedó tu primer dashboard y qué queries decidiste incluir.