Glosario
Cada palabra que Sypnia usa con un significado fijo, definida en una o dos frases, con el nombre que tiene en la API y en inglés.
Esta página es para quien encuentra una palabra en esta documentación y quiere su significado exacto. El vocabulario es el mismo para el motor de código abierto Motor y para Sypnia Cloud Nube; una definición lo dice cuando algo existe solo en uno de los dos.
Sypnia usa un nombre por cosa, en todas partes: en esta documentación, en la app, en la API y en lo que escribe el agente. Conviene conocer tres decisiones antes de leer la lista:
- Un grupo de fallas con una sola causa es un problema. Sypnia nunca dice «issue».
- El agente es el análisis propio de Sypnia. La herramienta que escribe código por ti, como Cursor o Claude Code, es tu agente de código.
- El motor es la parte de código abierto, y Sypnia Cloud es el servicio pago que lo corre por ti.
Donde una palabra de esta lista aparece subrayada en una página, al señalarla se ve su definición y al seguirla llegas aquí.
Los términos
- Cuenta
- El equipo o la empresa a la que pertenece una persona en tu app. Tu app la envía con
identify(). No es una cuenta de Sypnia. - El agente
- El análisis de Sypnia. Lee un problema y escribe, en palabras simples, qué pasó, a quién le pasó, desde cuándo, la causa probable y qué hacer. No es tu agente de código.
- Token de API
- Una llave secreta que empieza por
sps_. Lee datos por la API y el servidor MCP, dentro de sus alcances,read,replayyadmin. - Sypnia Cloud
- El servicio pago, con un plan gratis. Es el mismo motor, operado por nosotros, más las cuentas, la facturación, la app completa y la GitHub App.
- Consola
- La única página incluida en el motor. Muestra la lista de problemas y el visor de grabaciones de sesión.
- Clic muerto
- Un clic en algo que parece que debería hacer algo, después del cual no pasa nada.
- Motor de Sypnia
- La parte de código abierto de Sypnia, un programa que recibe, guarda y analiza tus datos. Puedes correrlo tú mismo, gratis.
- Entorno
- Dónde corre una versión de tu app, por ejemplo
productionodevelopment. Cada evento lleva su entorno, así distingues a tus clientes reales de tus propias pruebas. - Evento
- Una cosa que tu app le reportó a Sypnia, como un error, una petición lenta, un clic o una medición de rendimiento.
- Arreglo
- Lo que Sypnia le entrega a tu agente de código para un problema. Llega de tres formas, un prompt listo, el servidor MCP y un pull request (Sypnia Cloud).
- Llave de ingesta
- Una llave pública, solo de escritura, que empieza por
spk_. Tu app la usa para enviar eventos. Es seguro publicarla en un navegador. - Marca
- Lo que Sypnia le agrega por su cuenta a un problema abierto. Hay tres, «nuevo» en sus primeras 24 horas, «creciendo» cuando llega al doble de personas de su última alerta y al menos a 5, y «volvió» cuando estaba resuelto y pasó otra vez.
- Caída
- El tiempo en que tu app no respondió a una revisión de disponibilidad. Se abre tras dos fallas seguidas y se cierra con la primera respuesta correcta.
- Captura de página
- Una copia de la estructura de una página, tomada por el SDK del navegador con el mismo enmascarado que una grabación. Los mapas de clics se dibujan sobre ella.
- Persona
- Alguien que usa tu app. Una persona tiene un id y, solo si tu app los envía con
identify(), un nombre y un correo. Una sesión sin persona es anónima. - Problema
- Un grupo de fallas con una misma causa, contado en una frase. Sypnia dice «problema», nunca «issue».
- Proyecto
- Una app que Sypnia vigila. Cada evento, sesión y problema pertenece a un solo proyecto, y nada se comparte entre proyectos.
- Clic de rabia
- Una ráfaga de tres o más clics en el mismo punto dentro de un segundo. Te dice que una persona se quedó atascada, aunque no hubo ningún error.
- Versión (release)
- Una versión de tu app que publicaste. Sypnia la usa para decir desde cuándo pasa un problema y qué cambió.
- Grabación
- El registro de una sesión, reproducido como lo vio la persona. Lo que se escribe y los campos enmascarados nunca se graban.
- Token raíz
- El primer token de un motor en alojamiento propio. Lo defines en el entorno al instalar, y lo usas para crear proyectos y otros tokens.
- Sesión
- Una visita de una persona, desde la primera página hasta la última, con todos los eventos que pasaron en medio.
- Span
- Un paso de una traza, como una petición, una función o una llamada a la base de datos, con su inicio, su duración y si falló.
- Traza
- El camino de una petición por tu app, del navegador a la API y a las llamadas a la base de datos, con lo que tardó cada paso.
Las mismas palabras en inglés
La documentación en español usa una traducción fija para cada término, y deja algunas palabras en inglés porque así las usan los desarrolladores. El código, los comandos y los nombres de la API nunca se traducen.
| Español | Inglés |
|---|---|
| problema | problem |
| sesión | session |
| grabación | replay |
| traza | trace |
| evento | event |
| versión (release) | release |
| entorno | environment |
| proyecto | project |
| el agente | the agent |
| motor | engine |
| la Consola | the Console |
| alojamiento propio | self-hosting |
| llave de ingesta | ingest key |
| token de API | API token |
| clic de rabia, clic muerto | rage click, dead click |
| disponibilidad | uptime |
| alerta, resumen diario | alert, daily summary |
| enmascarado, muestreo | masking, sampling |
| Se quedan en inglés | span, pull request, prompt, webhook, source maps, skill, MCP, SDK, CLI, Sypnia Cloud |
Los nombres en el código
En la API, los eventos y la configuración, las mismas cosas tienen nombres cortos y fijos. La lista completa de los campos de los eventos está en el esquema de eventos.
| Cosa | En la API y la CLI | Se ve así |
|---|---|---|
| Proyecto | project, un id o un slug | prj_5k2m9x4q7w1z, shop |
| Problema | problem, un id o un slug | prb_8f3k2m9x4q7w, pay-button-does-nothing |
| Sesión | session, 32 caracteres hexadecimales que elige el SDK | 8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0 |
| Traza | trace_id, un id de traza W3C | 7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c |
| Versión (release) | version, el texto que tu app envía como release | 4f2a91c |
| Llave de ingesta | La llave misma, y su registro | spk_…, key_… |
| Token de API | El token mismo, y su registro | sps_…, tok_… |
| Alerta, comprobación de disponibilidad, webhook | Sus ids | alt_…, chk_…, whk_… |