# Explorar

## 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](https://lymen.app/docs/datos/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

1. Entrá a **Explorar** (grupo Observar). La pestaña "Consultas" es la principal; al lado está "Trazas" (ver [Trazas](https://lymen.app/docs/datos/trazas/)).
2. 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.
3. Elegí el período (hasta 31 días), salvo que la consulta traiga su propio período.
4. Tocá **Ejecutar** o presioná Ctrl+Enter. Con el modo guiado, el resultado se actualiza al cambiar una opción.
5. Elegí cómo verlo: **Línea**, **Barras**, **Tabla** o **Número**.
6. Debajo del resultado ves un resumen, por ejemplo "1 serie · 15 puntos · 14 ms".
7. 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

1. Con la consulta ejecutada, tocá **Agregar a un dashboard**. Solo Sistemas y Administración.
2. 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. |

3. Tocá **Agregar**. Recién ahí se guarda, y aparece "Ir al dashboard".

Más sobre dashboards en [Dashboards](https://lymen.app/docs/datos/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 10m
```
Cuenta los errores de las últimas 2 horas, por servicio, en tramos de 10 minutos.

```
from eventos where evento = "pago.aprobado" sum(monto) by canal
```
Suma lo cobrado por canal.

Hay más ejemplos en [LQL](https://lymen.app/docs/datos/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`, `today` o `yesterday`). Sacalo para volver a usar el de la pantalla.
- **Se cortó por tiempo**: pasaron 15 segundos. Achicá el período o agregá filtros.