La Consola
Qué muestra la única página integrada del motor, cómo abrirla con un token de API, cómo protegerla o apagarla, y qué no hace frente a la app de Sypnia Cloud.
Motor Esta página es para quien usa o protege un motor con alojamiento propio. La Consola existe solo en el motor de código abierto. Sypnia Cloud tiene en su lugar la app completa, en app.sypnia.com, y no tiene Consola.
La Consola no tiene datos propios. Lee por la misma API que todo lo demás, con el token que le das, así que muestra exactamente lo que ese token puede leer y nada más.
Abrirla
Al final tendrás: los problemas de un proyecto en tu pantalla.
Crea un token para ti
A la Consola se entra con un token de API.
readmuestra los problemas, las sesiones y sus líneas de tiempo; agregareplaypara ver grabaciones.Terminal sypnia token create --project shop --name "Console, Ana" --scopes read,replay --expires 90dDeberías verUna línea que empieza porsps_. Se muestra una sola vez.
Qué pasa con el token:
- Se queda en esa pestaña del navegador y se olvida cuando la cierras. La Consola no pone cookies ni guarda nada en el servidor.
- Se envía solo a tu motor, como el encabezado
Authorizationde las llamadas a la API. - Un token pertenece a un proyecto, así que la Consola muestra un proyecto a la vez. Para otro proyecto, pega el token de ese proyecto.
- El token raíz se rechaza. Puede eliminar proyectos, y su lugar no es un navegador.
Qué muestra
Problemas
La lista muestra los problemas del proyecto, con la actividad más reciente primero: la frase en palabras simples, o el título técnico cuando el agente está apagado; las marcas «nuevo», «creciendo» y «volvió»; a cuántas personas afectó; desde cuándo; y la versión. Puedes filtrar por estado y entorno, y buscar en el texto.
Al abrir un problema ves:
- El análisis, cuando hay un proveedor de IA conectado: a quién afectó, desde cuándo, la causa probable con su evidencia, qué hacer, y qué tan seguro está el agente.
- La falla misma: el stack, en tus propios archivos y líneas cuando la versión tiene source maps; qué hizo la persona antes; y la traza, como una lista de pasos con sus tiempos.
- Las sesiones que afectó, cada una con un enlace a su grabación.
- Copiar prompt: el prompt listo para tu agente de código, el mismo texto que imprime
sypnia problem --prompt. - Resolver y Reabrir. Ignorar y Analizar de nuevo aparecen solo cuando el token tiene el alcance
admin.
Alertas
Las alertas que nadie ha reconocido quedan en una franja sobre la lista, la más nueva primero, cada una con un botón Reconocer. Una alerta sobre un problema abre ese problema. Las alertas de disponibilidad, de una página más lenta, de una ruta de API que falla o de uso muestran su título y sus números, y nada más: la Consola no tiene pantalla para eso. Los datos están en la API.
Sesiones y el visor de grabaciones
La segunda pestaña lista las sesiones recientes: quién, cuándo, cuántas páginas, y si algo salió mal. Puedes dejar solo las sesiones con problemas o con grabación, y encontrar una por id de persona o id de sesión.
Al abrir una sesión ves su línea de tiempo, en orden: páginas, clics, clics de rabia, clics muertos, errores, peticiones fallidas. Si la sesión tiene grabación y tu token tiene el alcance replay, el visor la reproduce junto a la línea de tiempo: reproducir, pausar, cambiar la velocidad, y saltar a cualquier evento de la línea de tiempo.
- Una grabación se puede ver cuando su sesión lleva 2 minutos inactiva o ya terminó.
- Lo que una persona escribió son asteriscos, y las áreas enmascaradas están en blanco. La Consola no puede mostrar lo que el navegador nunca envió. Ver Enmascarado.
- El visor trae la grabación directo de tu bucket, con enlaces firmados que funcionan 15 minutos (
SYPNIA_STORAGE_PRESIGN_TTL_SECONDS). El bucket sigue siendo privado. - La Consola no carga el SDK, así que nunca se graba a sí misma.
Qué no hace
La Consola es una sola página a propósito. Esto es lo que tiene la app de Sypnia Cloud y la Consola no:
| La Consola Motor | La app de Sypnia Cloud Nube | |
|---|---|---|
| Problemas con su análisis y su prompt | Sí | Sí |
| Grabación de sesiones | Un visor: reproducir, pausar, velocidad, saltar a un evento | El reproductor completo, con el momento en que se rompió marcado en la línea de tiempo |
| Rendimiento: páginas lentas, llamadas de API lentas o que fallan, el elemento detrás de una métrica | No. API y MCP | Pantallas |
| Mapas de clics, clics de rabia y muertos por página | No. API | Pantallas |
| Trazas | La traza de un problema, como lista | Una cascada para cualquier petición |
| Disponibilidad | No. API | Pantallas |
| Búsqueda en todo | Búsqueda de texto en problemas; sesiones por id | Un solo buscador |
| Actividad de personas y cuentas | No. API | Pantallas |
| El resumen diario y las sugerencias semanales | No. GET /v1/summary y GET /v1/suggestions | En la app y por correo |
| Configuración del proyecto, llaves, tokens, reglas de alerta, webhooks | No. La CLI y la API | Pantallas |
| Entrar | Un token de API, un proyecto a la vez | Cuentas, organizaciones y roles |
| Un enlace que le puedes mandar a un colega | Le abre a quien tenga su propio token de ese proyecto | Le abre a los miembros de la organización |
| Pull requests | No | Un botón en el problema |
Nada de la columna izquierda se te esconde: todo está en la API, la CLI y el servidor MCP. La Consola solo elige no dibujarlo.
Protegerla
Sin un token la Consola no muestra nada: la página es un cascarón vacío, y los datos están detrás de la API. Proteger la Consola es entonces, sobre todo, proteger los tokens. Haz esto en orden.
Dale a cada persona su propio token
Un token por persona, con los menos alcances posibles y una fecha de vencimiento.
replaydeja a quien lo tiene ver lo que tus usuarios vieron en sus pantallas: dalo solo a quien deba.Terminal sypnia token create --project shop --name "Console, Ana" --scopes read,replay --expires 90d sypnia token list --project shopDeberías verLa lista muestra quién tiene qué, y cuándo se usó cada token por última vez. Revoca uno consypnia token revoke; deja de funcionar en menos de un minuto.Decide quién puede siquiera cargar la página
Por defecto la Consola está en una dirección pública. Para cerrarla a todo el que no sea de tu equipo, agrega una regla en el proxy que está delante del motor, solo para la ruta
/console. Los SDK y los clientes de la API tienen que seguir llegando a/v1.Con el Caddy de Desplegar con Docker, genera el hash de una contraseña y agrega cuatro líneas:
Terminal docker compose exec caddy caddy hash-passwordCaddyfile {$SYPNIA_DOMAIN} { @console path /console /console/* basic_auth @console { team <el hash> } reverse_proxy sypnia:8080 }Deberías verDespués dedocker compose restart caddy, el navegador pide el nombreteamy la contraseña antes de mostrar la Consola, y luego la Consola pide el token como antes.En AWS, la dirección es una distribución de CloudFront: asóciale una regla de AWS WAF que permita
/console*solo desde las direcciones de tu oficina o tu VPN. AWS cobra un WAF por mes.O apágala
Si tu equipo lee con un agente de código y la CLI, puede que no necesites la página.
Terminal SYPNIA_CONSOLE_ENABLED=falseDeberías verDespués de reiniciar,<tu URL base>/consoleresponde404. La API, el servidor MCP y la CLI no cambian. Los enlaces de las alertas siguen apuntando a la Consola, y dejan de funcionar.
Además, configura SYPNIA_API_CORS_ORIGINS solo si una app web tuya tiene que llamar a la API de lectura desde un navegador. La Consola no necesita nada ahí: está en la misma dirección del motor.
Cuando algo no aparece
| Lo que ves | Por qué | Qué hacer |
|---|---|---|
404 en /console | La Consola está apagada, o este proceso corre sin el rol api. | SYPNIA_CONSOLE_ENABLED, y el rol de sypnia serve. |
| «Este token no puede entrar» | El token fue revocado, venció, está mal escrito, o es el token raíz o una llave de ingesta. | Crea un token de API. |
| Una lista de problemas vacía, y esperabas uno | El entorno. Una prueba desde localhost normalmente cae en development. | Cambia el entorno arriba. |
| Un problema que solo tiene título técnico | No hay proveedor de IA conectado, o se alcanzó el límite de análisis del día. | Modelos y qué se envía. |
| Una sesión sin enlace «Ver grabación» | No se grabó: por defecto se graba el 10 % de las sesiones, más toda sesión con un error, un clic de rabia o un clic muerto. | Sesiones y grabación. |
| «Necesitas el alcance replay» | El token solo tiene read. | Crea un token con read,replay. |
| «Todavía no está lista» en una grabación | La sesión sigue en curso. | Espera a que lleve 2 minutos inactiva. |
| «Venció» en una sesión o una grabación | Es más vieja que tu retención. | Retención. |
| El visor se queda vacío y la consola del navegador muestra un error de CORS o de red | El navegador no puede leer del bucket. | Revisa SYPNIA_STORAGE_PUBLIC_ENDPOINT, y la regla del bucket si es un bucket alojado. Prueba sin extensiones del navegador que bloqueen peticiones. |
Relacionado
- Qué le permite cada alcance a un token.
- La Consola es una de sus líneas.
- La comparación completa.