Explorar
Preguntale libremente a tus datos (métricas, logs, eventos de negocio, trazas y experiencia de usuarios) y, si sirve, dejalo guardado en un dashboard.
En esta página
Para qué sirve#
Explorar es el lugar para mirar cualquier dato sin armar un dashboard antes. Escribís (o armás con ayuda) una consulta, la ejecutás y ves el resultado como línea, barras, tabla o número. Si te sirve, lo agregás a un dashboard con un clic.
En pantalla se llama "consulta". El lenguaje con que se escribe se llama LQL.
Cuándo usarlo#
- Querés saber "cuántos errores hubo ayer por servicio" y no existe un tile para eso.
- Estás investigando un problema y necesitás cruzar datos.
- Querés probar una consulta antes de ponerla en un tablero.
Qué datos podés consultar#
| Fuente | Qué contiene |
|---|---|
| Métricas | Números medidos a lo largo del tiempo: pedidos, errores, duración, CPU, memoria, disco. |
| Logs | Líneas de texto que escriben tus sistemas (mensajes, errores, avisos). |
| Eventos de negocio | Hechos que le importan a tu organización: turnos reservados, pagos aprobados, etc. |
| Trazas | El recorrido completo de un pedido entre servicios. |
| Experiencia de usuarios | Lo que miden tus sitios y apps desde el dispositivo de la persona (vitales, vistas, errores). |
Cómo se usa, paso a paso#
- Entrá a Explorar (grupo Observar). La pestaña "Consultas" es la principal; al lado está "Trazas" (ver Trazas).
- Elegí cómo armar la consulta:
- Armar con ayuda: un asistente de cinco pasos (ver abajo). Lo puede usar cualquier rol técnico.
- Escribirla: en el editor. Solo Sistemas y Administración pueden escribir a mano.
- Elegí el período (hasta 31 días), salvo que la consulta traiga su propio período.
- Tocá Ejecutar o presioná Ctrl+Enter. Con el modo guiado, el resultado se actualiza al cambiar una opción.
- Elegí cómo verlo: Línea, Barras, Tabla o Número.
- Debajo del resultado ves un resumen, por ejemplo "1 serie · 15 puntos · 14 ms".
- Si te sirve, tocá Agregar a un dashboard (ver más abajo).
La última consulta queda guardada en tu navegador, para retomarla al volver. No se comparte con otras personas ni dispositivos.
Asistente "Armar con ayuda"#
| Paso | Qué decidís |
|---|---|
| 1. Qué datos | Métricas, Logs, Eventos de negocio, Trazas o Experiencia de usuarios. |
| 2. Qué medir | Una métrica del catálogo, o contar, sumar un campo, medir un valor, o ver los registros uno por uno. |
| 3. Filtros | Campo, operador y valor (con valores sugeridos). |
| 4. Período y agrupamiento | Usar el período de la pantalla, las últimas N minutos, horas o días, o entre dos fechas; y por qué campo separar. |
| 5. Cómo se ve | Visualización, orden y cantidad máxima de filas. |
Al final tocás "Usar esta consulta" y se pega en el editor. Si ya había una consulta, Lymen pregunta "¿Reemplazar la consulta actual?"; si cancelás, volvés al asistente sin perder nada.
Ayuda dentro del editor#
Al lado del editor hay un panel con:
- Dónde se calcula: para cada cláusula te dice si se resuelve en la base de datos (rápido) o en Lymen sobre el resultado, con un tope de 10.000 filas.
- Ejemplos: consultas listas para probar con un clic.
- Cláusulas y funciones: la referencia con buscador. Cada entrada trae un ejemplo.
El editor te avisa los errores con la línea y la columna, y te sugiere el nombre correcto ("¿Quisiste decir «servicio»?"). Si pegás una consulta en un formato anterior, aparece el botón Convertir.
Agregar un resultado a un dashboard#
- Con la consulta ejecutada, tocá Agregar a un dashboard. Solo Sistemas y Administración.
- Completá:
| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Título del tile | Nombre del tile. | Propuesto a partir de la consulta | Hasta 80 caracteres | Solo informativo. |
| Cómo se ve | Visualización del tile. | La que tenías elegida | Línea, Barras, Tabla, Número | Cambia solo el tile, no la consulta. |
| Ancho del tile | Cuánto ocupa. | Mediano | Chico (3 columnas), Mediano (6), Grande (12) | Solo diseño. |
| Dashboard | Dónde queda. | Ninguno | Uno existente (con buscador) o uno nuevo con nombre propio | Se modifica el dashboard elegido: todos los que lo ven van a ver el tile nuevo. |
- Tocá Agregar. Recién ahí se guarda, y aparece "Ir al dashboard".
Más sobre dashboards en Dashboards.
Campos y opciones#
| Elemento | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Período | Ventana de tiempo de la consulta. | El período global | Hasta 31 días | Más período, más datos y más tiempo de espera. Una consulta con período propio ignora este selector. |
| Consulta | El texto que se ejecuta. | Vacío | Hasta 4.000 caracteres | Solo lectura de datos: no modifica nada. |
| Ejecutar | Corre la consulta. | Cada persona puede tener hasta 3 consultas corriendo a la vez y cada una se corta a los 15 segundos. | ||
| Cómo se ve | Forma de mostrar el resultado. | Según la consulta | Línea, Barras, Tabla, Número | Solo visual. |
Explorar nunca modifica tus datos: solo los lee. Todas las consultas quedan registradas en una auditoría.
Ejemplos#
from logs where servicio = "web-turnos" and nivel = "ERROR" last 2h count by servicio every 10mCuenta los errores de las últimas 2 horas, por servicio, en tramos de 10 minutos.
from eventos where evento = "pago.aprobado" sum(monto) by canalSuma lo cobrado por canal.
Hay más ejemplos en LQL.
Problemas comunes#
- "Escribir consultas a mano es para IT y admin": tu rol no puede escribir. Usá "Armar con ayuda".
- "Se calculó sobre las primeras 10.000 filas": parte de la consulta se resuelve en Lymen y el resultado se cortó. Sumá filtros o achicá el período.
- El resultado dice "No hubo datos en este período": probá con un período más largo o revisá los nombres de campo.
- El período del selector está deshabilitado: la consulta trae su propio período (
last,since,todayoyesterday). Sacalo para volver a usar el de la pantalla. - Se cortó por tiempo: pasaron 15 segundos. Achicá el período o agregá filtros.