Docs

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.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Los términos
  2. Las mismas palabras en inglés
  3. Los nombres en el código

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, replay y admin.
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 production o development. 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ñolInglés
problemaproblem
sesiónsession
grabaciónreplay
trazatrace
eventoevent
versión (release)release
entornoenvironment
proyectoproject
el agentethe agent
motorengine
la Consolathe Console
alojamiento propioself-hosting
llave de ingestaingest key
token de APIAPI token
clic de rabia, clic muertorage click, dead click
disponibilidaduptime
alerta, resumen diarioalert, daily summary
enmascarado, muestreomasking, sampling
Se quedan en inglésspan, 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.

CosaEn la API y la CLISe ve así
Proyectoproject, un id o un slugprj_5k2m9x4q7w1z, shop
Problemaproblem, un id o un slugprb_8f3k2m9x4q7w, pay-button-does-nothing
Sesiónsession, 32 caracteres hexadecimales que elige el SDK8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0
Trazatrace_id, un id de traza W3C7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c
Versión (release)version, el texto que tu app envía como release4f2a91c
Llave de ingestaLa llave misma, y su registrospk_…, key_…
Token de APIEl token mismo, y su registrosps_…, tok_…
Alerta, comprobación de disponibilidad, webhookSus idsalt_…, chk_…, whk_…

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar