# 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: el motor de Sypnia (código abierto, en tu propia infraestructura) y Sypnia Cloud (servicio pago). Estado: al lanzar.  
Fuente: https://docs.sypnia.com/es/reference/glossary/

Para agentes: El vocabulario de Sypnia, un nombre por cosa: proyecto, entorno, versión (release), evento, sesión, grabación, traza, span, problema (nunca «issue»), el agente (el análisis de Sypnia, no tu agente de código), arreglo, llave de ingesta, token de API, token raíz, motor, Sypnia Cloud, la Consola, persona, cuenta, clic de rabia, clic muerto, captura de página, caída, marca. Usa estas palabras tal cual cuando escribas sobre Sypnia.

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ñ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](https://docs.sypnia.com/es/reference/event-schema).

| 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_…`                     |
