# Documentación de Sypnia > Sypnia vigila tu app en producción y te dice en palabras simples qué se rompió, a quién le pasó y desde cuándo. Luego le entrega el arreglo a tu agente de código: como un prompt listo, por un servidor MCP o como un pull request. Sypnia viene de dos formas, y cada página dice de cuál habla: - **Motor de Sypnia** (código abierto, en tu propia infraestructura): Ingesta, almacenamiento, agregación, agrupación de problemas, sesiones, datos de grabación y revisiones de disponibilidad. Lo lees con: La API HTTP, el servidor MCP, la CLI y la Consola: una página incluida con la lista de problemas y el visor de grabaciones de sesión. - **Sypnia Cloud** (servicio pago, con un plan gratis): El mismo motor, operado por nosotros. Lo lees con: La app completa: reproductor de grabaciones, rendimiento, disponibilidad, resumen diario, búsqueda y equipos. Cada página también es Markdown plano: agrega `.md` a su dirección (`https://docs.sypnia.com/es/start/open-source-and-cloud.md`). Todas las páginas en un archivo: https://docs.sypnia.com/es/llms-full.txt ## 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. - [Empieza aquí: resumen](https://docs.sypnia.com/es/start.md): 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. [Motor, Nube] - [Qué es Sypnia](https://docs.sypnia.com/es/start/what-sypnia-is.md): Qué vigila Sypnia, para quién es, en qué se diferencia de un tablero y qué no hace. [Motor, Nube] - [Cómo funciona](https://docs.sypnia.com/es/start/how-it-works.md): El camino desde un clic en tu aplicación hasta una frase en tu correo, las partes que intervienen y qué tan reciente es cada tipo de información. [Motor, Nube] - [Código abierto y Sypnia Cloud](https://docs.sypnia.com/es/start/open-source-and-cloud.md): Lee esto para saber si una función existe en el motor de código abierto, en Sypnia Cloud o en los dos, antes de decirle a alguien cómo usarla. [Motor, Nube] - [Inicio rápido: Sypnia Cloud](https://docs.sypnia.com/es/start/quickstart-cloud.md): De cero a tu primera sesión y tu primer problema en Sypnia Cloud, en cinco pasos y unos diez minutos. [Nube] - [Inicio rápido: alojamiento propio](https://docs.sypnia.com/es/start/quickstart-self-host.md): Corre el motor de código abierto de Sypnia en tu propia máquina con Docker, crea un proyecto y mira tu primera sesión y tu primer problema. [Motor] - [Instalar con tu agente de código](https://docs.sypnia.com/es/start/install-with-your-agent.md): Deja que Claude Code, Cursor o cualquier agente de código agregue Sypnia a tu proyecto, qué va a cambiar, el prompt exacto para agentes sin skills y qué revisar después. [Motor, Nube] - [Tu primer problema](https://docs.sypnia.com/es/start/your-first-problem.md): Rompe algo a propósito y síguelo por Sypnia, desde la falla hasta la sesión, la grabación, la frase y el arreglo. [Motor, Nube] ## Conceptos Las 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. - [Conceptos: resumen](https://docs.sypnia.com/es/concepts.md): Las 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. [Motor, Nube] - [Proyectos, entornos, llaves y tokens](https://docs.sypnia.com/es/concepts/projects-keys-and-tokens.md): A dónde pertenecen tus datos en Sypnia, y qué pueden y qué no pueden hacer exactamente una llave de ingesta, un token de API y el token raíz. [Motor, Nube] - [Eventos](https://docs.sypnia.com/es/concepts/events.md): Qué le reporta tu app a Sypnia, qué lleva cada evento, cómo viajan los eventos y cuáles cuentan para un plan. [Motor, Nube] - [Sesiones y grabación](https://docs.sypnia.com/es/concepts/sessions-and-replay.md): Qué empieza y qué termina una sesión, de quién es una sesión, qué sesiones se graban y qué muestra exactamente una grabación. [Motor, Nube] - [Problemas](https://docs.sypnia.com/es/concepts/problems.md): Qué es un problema, qué hace que dos fallas sean el mismo problema, y cuándo exactamente un problema es nuevo, crece, está resuelto, está ignorado o volvió. [Motor, Nube] - [Trazas](https://docs.sypnia.com/es/concepts/traces.md): Cómo sigue Sypnia una petición desde un clic en el navegador hasta tu API y las llamadas a la base de datos que hay detrás, y qué guarda una traza. [Motor, Nube] - [Rendimiento](https://docs.sypnia.com/es/concepts/performance.md): Cómo mide Sypnia la velocidad de las páginas y de la API para personas reales, cómo se calculan y se muestran los percentiles, y cómo nombra el elemento que hay detrás de una página lenta. [Motor, Nube] - [Clics de rabia y clics muertos](https://docs.sypnia.com/es/concepts/rage-and-dead-clicks.md): Las reglas exactas que hacen de un clic un clic de rabia o un clic muerto, lo que no cuenta, y cómo los muestran los mapas de clics sobre la página. [Motor, Nube] - [Disponibilidad](https://docs.sypnia.com/es/concepts/uptime.md): Qué hace una comprobación de disponibilidad, cuándo tu app cuenta como caída y cuándo como recuperada, cuándo te avisan, y en qué se diferencian el motor y Sypnia Cloud. [Motor, Nube] - [Versiones y source maps](https://docs.sypnia.com/es/concepts/releases-and-source-maps.md): Cómo sabe Sypnia de qué versión de tu app salió una falla, cómo dice «desde el cambio de ayer», y cómo los source maps convierten el código compilado de vuelta en el tuyo. [Motor, Nube] - [Alertas y el resumen diario](https://docs.sypnia.com/es/concepts/alerts-and-daily-summary.md): Qué crea una alerta, qué contiene, cómo te llega en el motor y en Sypnia Cloud, y qué dice el resumen diario y cuándo. [Motor, Nube] ## SDK Có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. - [SDK: resumen](https://docs.sypnia.com/es/sdks.md): Có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. [Motor, Nube] - [Navegador](https://docs.sypnia.com/es/sdks/browser.md): Instala @sypnia/browser con un gestor de paquetes o con una etiqueta script, cada opción de init con su tipo y su valor por defecto, qué se captura sin escribir código y las pocas funciones que llamas tú. [Motor, Nube] - [Node](https://docs.sypnia.com/es/sdks/node.md): Traza cada petición que atiende tu servidor Node y cada llamada que hace, únelas a la sesión del navegador que las causó y reporta los errores del servidor, con un solo import. [Motor, Nube] - [Next.js](https://docs.sypnia.com/es/sdks/nextjs.md): Una sola configuración de @sypnia/next cubre el navegador y el servidor de una app Next.js, en el App Router y en el Pages Router, y sube los source maps cuando compilas. [Motor, Nube] - [OpenTelemetry](https://docs.sypnia.com/es/sdks/opentelemetry.md): Apunta a Sypnia un exportador de trazas OTLP/HTTP que ya tienes, con ejemplos para Python, Go, PHP, Rust, Java y el Collector, en qué se convierte cada span y qué se ignora exactamente al lanzar. [Motor, Nube] - [Privacidad y enmascarado](https://docs.sypnia.com/es/sdks/privacy-and-masking.md): Los valores por defecto de privacidad de los SDK, cada opción y atributo que enmascara más, cómo dejar fuera áreas enteras de tu app y cómo ver por ti mismo lo que se envía. [Motor, Nube] - [Identificar personas](https://docs.sypnia.com/es/sdks/identifying-people.md): Cómo identify() une sesiones y problemas a una persona y a una cuenta, qué se guarda, cómo funcionan las sesiones anónimas y cómo identificar peticiones en el servidor. [Motor, Nube] - [Muestreo y cuotas](https://docs.sypnia.com/es/sdks/sampling-and-quotas.md): Qué sesiones se graban y cómo cambiarlo, qué envían y qué retienen los SDK, la señal de «baja el ritmo», y qué pasa exactamente cuando un proyecto llega a un límite. [Motor, Nube] - [Solución de problemas](https://docs.sypnia.com/es/sdks/troubleshooting.md): Qué revisar cuando no llega nada, cuando un bloqueador de anuncios, CORS o una política de seguridad de contenido bloquean las peticiones, cuando los source maps no aplican y cuando las sesiones parecen duplicadas. [Motor, Nube] ## El agente Cómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace. - [El agente: resumen](https://docs.sypnia.com/es/agent.md): Índice de la sección sobre el análisis propio de Sypnia (el agente): cómo funciona, el prompt listo, los pull requests en Sypnia Cloud, proveedores de modelos y qué datos se envían, y los límites. [Motor, Nube] - [Cómo funciona el análisis](https://docs.sypnia.com/es/agent/how-the-analysis-works.md): El proceso del análisis de Sypnia: disparadores (nuevo, crece, vuelve, a pedido), entradas (falla, pila con líneas de código, pasos previos, traza, cambios de la versión, impacto), los cinco pasos, los campos de salida y las reglas de confianza, los modos de falla (not_enough_evidence, failed, limit_reached, off) y las sugerencias semanales. [Motor, Nube] - [El prompt](https://docs.sypnia.com/es/agent/the-prompt.md): La estructura exacta y fija del prompt listo de Sypnia (What happens / Where / Why / Do / Check, luego Evidence y Rules), un ejemplo completo, las variantes sin análisis, dónde conseguirlo (app, Consola, API, MCP, CLI) y su límite de tamaño. [Motor, Nube] - [Pull requests](https://docs.sypnia.com/es/agent/pull-requests.md): Pull requests de Sypnia Cloud: cuándo se puede abrir uno (confianza high o medium, repositorio conectado), rama sypnia/, contenido del PR (cambio, prueba, descripción), permisos de la GitHub App (Contents RW, Pull requests RW, Metadata R), qué nunca hace (sin merge, sin push a la rama principal), modos de falla y arreglos por mes según el plan. [Nube] - [Modelos y qué se envía](https://docs.sypnia.com/es/agent/models-and-what-is-sent.md): Proveedores de modelos para el análisis de Sypnia: la nube usa modelos por medio de OpenRouter (sin prometer un modelo específico); el motor está apagado hasta configurar SYPNIA_AI_PROVIDER (openrouter, openai, anthropic, google, openai-compatible), SYPNIA_AI_API_KEY, SYPNIA_AI_MODEL, SYPNIA_AI_BASE_URL; se comprueba con sypnia doctor; los datos exactos que se envían y los que nunca; ejemplos para llamar tú a un modelo con los SDK de OpenAI, Anthropic y OpenRouter a partir del contexto del problema. [Motor, Nube] - [Límites](https://docs.sypnia.com/es/agent/limits.md): Límites del análisis de Sypnia: análisis por proyecto por día (ajuste SYPNIA_AI_MAX_ANALYSES_PER_DAY en el motor, por plan en la nube), 3 por problema por día, pull requests por mes según el plan (5/50/300), tamaños de entrada y salida, tiempo de espera y reintentos, topes de las sugerencias semanales. [Motor, Nube] ## MCP y skills Conecta 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. - [MCP y skills: resumen](https://docs.sypnia.com/es/mcp.md): Empieza aquí para conectar un agente de código a Sypnia: el servidor MCP (remoto, alojado por ti, local por stdio), sus diez herramientas, las dos skills (sypnia-setup, sypnia-fix), ejemplos y seguridad. [Motor, Nube] - [Conectar](https://docs.sypnia.com/es/mcp/connect.md): Comandos y fragmentos exactos para conectar el servidor MCP de Sypnia: Claude Code (claude mcp add), Cursor (.cursor/mcp.json), otros clientes; remoto por Streamable HTTP en https://mcp.sypnia.com/mcp, alojado por ti en /mcp, local por stdio con npx @sypnia/mcp. [Motor, Nube] - [Autenticación](https://docs.sypnia.com/es/mcp/authentication.md): Cómo se autentica el servidor MCP de Sypnia: un token de API (sps_) con el permiso read, enviado como encabezado Authorization Bearer al servidor remoto o como SYPNIA_API_TOKEN al local; un token es un proyecto; sin OAuth al lanzar. [Motor, Nube] - [Referencia de herramientas](https://docs.sypnia.com/es/mcp/tools-reference.md): Las diez herramientas del servidor MCP de Sypnia (health, problems, problem, problem_prompt, sessions, session, search, performance, uptime, resolve_problem) con sus esquemas de entrada y resultados de ejemplo, más sus recursos y prompts. [Motor, Nube] - [Skills](https://docs.sypnia.com/es/mcp/skills.md): Las skills de Sypnia para agentes (código abierto, MIT): sypnia-setup instala y configura Sypnia en un proyecto; sypnia-fix arregla un problema por el servidor MCP. Comandos para instalar, actualizar y quitar en Claude Code y Cursor, el equivalente en reglas para otros agentes, y el texto completo de cada SKILL.md. [Motor, Nube] - [Ejemplos](https://docs.sypnia.com/es/mcp/examples.md): Sesiones MCP completas con las llamadas y resultados exactos: (1) qué falla -> problems -> problem -> arreglo -> resolve_problem, (2) rendimiento de una página lenta, (3) buscar a una persona -> sessions -> línea de tiempo de la sesión. [Motor, Nube] - [Seguridad](https://docs.sypnia.com/es/mcp/security.md): Modelo de seguridad del servidor MCP de Sypnia: solo lectura salvo resolve_problem, cómo desactivarla (read_only=true, --read-only, SYPNIA_MCP_READ_ONLY), qué nunca contienen los resultados, manejo de inyección de instrucciones, permiso del token, registros, a dónde van los datos. [Motor, Nube] ## Referencia de la API La 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 API: resumen](https://docs.sypnia.com/es/api.md): Índice de la referencia de la API HTTP de Sypnia. URL base https://api.sypnia.com/v1 (alojamiento propio: /v1). Empieza por Resumen y autenticación; las convenciones están en Errores, límites, paginación. El contrato es spec/openapi.yaml. [Motor, Nube] - [Resumen y autenticación](https://docs.sypnia.com/es/api/overview-and-authentication.md): Lee esto antes de llamar a la API HTTP de Sypnia: URLs base de la nube y del alojamiento propio, llave de ingesta, token de API y token raíz, permisos, el parámetro project, y los endpoints whoami, summary y search. [Motor, Nube] - [Ingesta](https://docs.sypnia.com/es/api/ingest.md): Referencia de los endpoints de ingesta de la API HTTP de Sypnia: sobre del lote de eventos, trozos de grabación, capturas de página, configuración para el SDK y el script del SDK; límites, reintentos y errores. [Motor, Nube] - [OTLP](https://docs.sypnia.com/es/api/otlp.md): Referencia del endpoint OTLP/HTTP de trazas de Sypnia: variables del exportador, cómo se convierten los spans en datos de Sypnia, límites y errores. [Motor, Nube] - [Problemas](https://docs.sypnia.com/es/api/problems.md): Referencia de los endpoints de problemas de la API de Sypnia: listar, traer, contexto completo, prompt, línea de tiempo, sesiones afectadas, resolver, reabrir, ignorar, analizar otra vez y pull request (Cloud). [Motor, Nube] - [Sesiones y grabaciones](https://docs.sypnia.com/es/api/sessions-and-replays.md): Referencia de los endpoints de sesiones de la API de Sypnia: listar y traer sesiones, línea de tiempo de eventos, grabación por ventanas con enlaces firmados, personas, cuentas, eventos propios y borrado de datos. [Motor, Nube] - [Trazas](https://docs.sypnia.com/es/api/traces.md): Referencia de los endpoints de trazas de la API de Sypnia: listar trazas con filtros y traer una con todos sus spans (browser, server, db, http, internal). [Motor, Nube] - [Rendimiento](https://docs.sypnia.com/es/api/performance.md): Referencia de los endpoints de rendimiento de la API de Sypnia: resumen, páginas, llamadas a la API, elementos detrás de LCP/INP/CLS, mapa de clics, captura de página, fallas de formularios y sugerencias semanales. [Motor, Nube] - [Disponibilidad](https://docs.sypnia.com/es/api/uptime.md): Referencia de los endpoints de disponibilidad de la API de Sypnia: crear, listar, actualizar y borrar comprobaciones, y leer sus resultados y caídas. [Motor, Nube] - [Versiones y source maps](https://docs.sypnia.com/es/api/releases-and-source-maps.md): Referencia de los endpoints de versiones (releases) y source maps de la API de Sypnia: crear o actualizar una versión con sus cambios, listar, y subir source maps en dos pasos con enlaces firmados. [Motor, Nube] - [Proyectos, llaves y tokens](https://docs.sypnia.com/es/api/projects-keys-and-tokens.md): Referencia de los endpoints de proyectos, llaves de ingesta, tokens de API y uso de la API de Sypnia, con lo que existe solo en el motor y lo que se maneja en la app de Sypnia Cloud. [Motor, Nube] - [Alertas y webhooks](https://docs.sypnia.com/es/api/webhooks.md): Referencia de alertas, reglas de alerta y webhooks de la API de Sypnia: tipos de alerta y umbrales, registro de webhooks, el cuerpo de una entrega, cómo verificar el encabezado Sypnia-Signature, reintentos. [Motor, Nube] - [Errores, límites, paginación](https://docs.sypnia.com/es/api/errors-limits-pagination.md): Las convenciones que comparten todos los endpoints de la API de Sypnia: forma JSON del error y sus códigos, cuándo reintentar, encabezados de límite de peticiones, paginación por cursor, since/until, environment, Idempotency-Key, versiones, retención. [Motor, Nube] ## Referencia de la CLI El comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando. - [Referencia de la CLI: resumen](https://docs.sypnia.com/es/cli.md): Resumen de la CLI sypnia: un binario que es a la vez el motor (serve, aggregate, migrate, doctor) y su cliente (project, key, token, sourcemaps upload, problems, problem); formas de instalarlo, variables de entorno, códigos de salida. [Motor, Nube] - [Comandos](https://docs.sypnia.com/es/cli/commands.md): Referencia de la CLI sypnia: serve, aggregate, migrate, doctor, project, key, token, sourcemaps upload, problems, problem, version; opciones, variables de entorno, salida de ejemplo y códigos de salida. [Motor, Nube] ## Alojamiento propio Qué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud. - [Alojamiento propio: resumen](https://docs.sypnia.com/es/self-hosting.md): Resumen del alojamiento propio del motor de código abierto de Sypnia: las tres cosas que corres (el binario sypnia, Postgres 15+, un bucket compatible con S3), las dos formas de despliegue (plantilla de AWS, Docker Compose), requisitos, resumen de costos, qué debe estar corriendo para las comprobaciones de disponibilidad, y qué tiene solo Sypnia Cloud. [Motor] - [Desplegar en AWS](https://docs.sypnia.com/es/self-hosting/deploy-aws.md): Cómo desplegar el motor de Sypnia con alojamiento propio en AWS con la plantilla única de CloudFormation sypnia-aws.yaml: qué crea (tres funciones Lambda, una cola, una programación, un bucket S3, una dirección de CloudFront, Postgres en RDS opcional), sus parámetros, los comandos paso a paso con el resultado esperado, dominio propio, actualizaciones, cambio de configuración y eliminación. [Motor] - [Desplegar con Docker](https://docs.sypnia.com/es/self-hosting/deploy-docker.md): Cómo desplegar el motor de Sypnia con alojamiento propio en un servidor con Docker Compose: el compose.yaml completo (motor, Postgres 16, MinIO, Caddy para HTTPS), el archivo .env, la comprobación de salud, sypnia doctor, el primer proyecto, la llave de ingesta y el token de API con la CLI, variantes con Amazon S3, Cloudflare R2, Supabase o Neon, la regla CORS del bucket, comandos del día a día, eliminación y solución de fallas. [Motor] - [Referencia de configuración](https://docs.sypnia.com/es/self-hosting/configuration.md): Cada variable de entorno SYPNIA_ del motor alojado por ti, con tipo, valor por defecto y significado: URL base, token raíz, base de datos, almacenamiento compatible con S3, retención, cuotas, límites de peticiones, valores iniciales de grabación, disponibilidad, webhook de alertas, proveedor de IA. [Motor] - [Estructura del almacenamiento](https://docs.sypnia.com/es/self-hosting/storage-layout.md): La vista del operador sobre dónde guarda datos el motor de Sypnia con alojamiento propio: los seis prefijos del bucket bajo el id de cada proyecto con sus ajustes de retención, las tablas de Postgres que crecen, tamaños estimados por millón de eventos y para un proyecto pequeño y uno mediano, comandos para medir el uso real, y qué reglas de ciclo de vida, versionado y clases de almacenamiento son seguras en el bucket. [Motor] - [La Consola](https://docs.sypnia.com/es/self-hosting/console.md): La Consola es la única página web integrada del motor de Sypnia con alojamiento propio, en /console: una lista de problemas con el análisis y el prompt de cada uno, las alertas sin reconocer, y una lista de sesiones con línea de tiempo y visor de grabaciones. Se entra con un token de API (read, más replay para las grabaciones), nunca con el token raíz. Cómo protegerla (tokens por persona, reglas en el proxy, SYPNIA_CONSOLE_ENABLED=false) y qué tiene solo la app de Sypnia Cloud. [Motor] - [Actualizaciones, respaldos y retención](https://docs.sypnia.com/es/self-hosting/upgrades-backups-retention.md): Operar en el tiempo un motor de Sypnia con alojamiento propio: el orden de una actualización (registro de cambios, respaldar Postgres, sypnia migrate, reemplazar el motor, sypnia doctor), qué prometen las reglas de compatibilidad, cómo volver atrás, qué hay que respaldar (Postgres) y qué se puede reconstruir desde el bucket con sypnia aggregate --from, los pasos para restaurar, y los cinco ajustes de retención con lo que hace cambiarlos. [Motor] - [Escalado y costo](https://docs.sypnia.com/es/self-hosting/scaling-and-cost.md): Costo y capacidad de un motor de Sypnia con alojamiento propio: qué mueve el costo y el ajuste que controla cada cosa, totales mensuales estimados para un proyecto pequeño (4 millones de eventos al mes, cerca de USD 22 en AWS) y uno mediano (40 millones, cerca de USD 60 a 85), tamaño del servidor para Docker, las señales de que un despliegue está en su límite, la aritmética de conexiones a la base de datos, cómo dividir un proceso en roles, y cuándo usar la forma de funciones en AWS. Todas las cifras son estimaciones o mediciones del sistema del que sale el motor, y lo dicen. [Motor] - [Lista de seguridad](https://docs.sypnia.com/es/self-hosting/security-checklist.md): Lista para asegurar un motor de Sypnia con alojamiento propio antes de producción: el token raíz, HTTPS y el número de proxies, un bucket privado con una llave acotada y su regla CORS, una base de datos propia con TLS, tokens de API con los menos alcances posibles y vencimiento, orígenes permitidos y cuotas para las llaves de ingesta, la Consola y el servidor MCP, las llamadas salientes (comprobaciones de disponibilidad, webhooks, el proveedor de IA), respaldos, logs y actualizaciones. Cada punto nombra el ajuste o el comando exacto y cómo verificarlo. [Motor] ## Cómo está construido el motor Todo 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. - [Cómo está construido el motor: resumen](https://docs.sypnia.com/es/architecture.md): Todo 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. [Motor] - [Flujo de datos](https://docs.sypnia.com/es/architecture/data-flow.md): Cada salto que da un evento dentro del motor, con su presupuesto de tiempo, qué espera a qué, cómo frena el motor, qué pasa cuando una pieza se cae y cómo se cumplen las promesas de 2 y 10 minutos. [Motor] - [Qué pasa cuando algo falla](https://docs.sypnia.com/es/architecture/reliability.md): Lee esto para conocer la garantía de entrega del motor (al menos una vez entre pasos, pasos idempotentes), la tabla de fallas por salto, la cola de entrada y su cola de mensajes fallidos en AWS (retención, tiempo de invisibilidad, máximo de entregas, redrive, alarmas), el búfer en memoria de la forma de un solo proceso, la cuarentena de segmentos envenenados, el trabajo como filas en Postgres (tareas, liberación de alertas, entregas de webhook), GET /healthz, GET /v1/engine/status y sypnia doctor. [Motor] - [Almacenamiento](https://docs.sypnia.com/es/architecture/storage.md): La disposición del bucket como árbol, el esquema de Postgres con sus tablas principales, cómo se particionan y expiran los datos, cuánto pesa un millón de eventos y qué nunca se guarda. [Motor] - [Ingesta](https://docs.sypnia.com/es/architecture/ingest.md): Cómo recibe el motor eventos, fragmentos de grabación, capturas de página, source maps y trazas OTLP, qué revisa, cómo convierte lotes en objetos, cómo maneja duplicados y por qué no consulta la base de datos para hacerlo. [Motor] - [Agregación](https://docs.sypnia.com/es/architecture/aggregation.md): Cómo la consolidación convierte una hora de eventos crudos en números sin un motor SQL, con sus agrupaciones, histogramas, armado de sesiones, el registro que hace que los contadores sumen exactamente una vez, sus límites de memoria y el archivo Parquet diario. [Motor] - [Agrupación de problemas](https://docs.sypnia.com/es/architecture/problem-grouping.md): Cómo las fallas se vuelven problemas, con el algoritmo exacto de la huella calculado a mano, la traducción de pilas con source maps, la regla que hace de una solicitud un solo problema entre navegador y servidor, los estados de un problema y qué dispara una alerta. [Motor] - [El proceso del agente](https://docs.sypnia.com/es/architecture/agent-pipeline.md): Cómo analiza el motor un problema, desde el disparador y el contexto que arma hasta la llamada al proveedor, la respuesta revisada, la alerta que libera y el prompt, con lo que se guarda en caché, lo que se limita y lo que solo agrega Sypnia Cloud. [Motor] - [Formas de despliegue](https://docs.sypnia.com/es/architecture/deployment-shapes.md): Cómo el mismo binario de Sypnia corre como tres funciones de AWS o como un proceso largo, qué crea la plantilla de AWS, cuánto cuesta cada forma con la aritmética a la vista, y las piezas que puedes cambiar, vistas desde el código. [Motor] - [El código](https://docs.sypnia.com/es/architecture/codebase.md): El repositorio del motor, crate por crate, con los traits y tipos principales, las reglas que sigue cada línea de código, las pruebas que repiten horas grabadas, cómo correrlo en tu máquina y cómo fluye una contribución. [Motor] ## Sypnia Cloud Có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. - [Sypnia Cloud: resumen](https://docs.sypnia.com/es/cloud.md): Có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. [Nube] - [Organizaciones y equipos](https://docs.sypnia.com/es/cloud/organizations-and-teams.md): Cómo funcionan las cuentas, las organizaciones y los roles en Sypnia Cloud, qué puede hacer cada rol, y cómo se invita y se quita a una persona. [Nube] - [Planes y límites](https://docs.sypnia.com/es/cloud/plans-and-limits.md): Qué incluye cada plan de Sypnia Cloud, cómo se cuenta exactamente cada límite, y qué pasa cuando se llega a uno. [Nube] - [Facturación](https://docs.sypnia.com/es/cloud/billing.md): Cómo funciona el pago de Sypnia Cloud, incluido qué pasa al cambiar o cancelar un plan, qué pasa cuando un pago falla, y qué no se te cobra nunca. [Nube] - [Ubicación y retención de los datos](https://docs.sypnia.com/es/cloud/data-location-and-retention.md): Dónde guarda tus datos Sypnia Cloud, qué otras empresas los tocan, cuánto tiempo se guarda cada tipo de dato en cada plan, y cuándo se elimina. [Nube] - [La GitHub App](https://docs.sypnia.com/es/cloud/github-app.md): Qué puede hacer la GitHub App de Sypnia en tus repositorios, qué no hace nunca, qué pasa con tu código, y cómo instalarla y quitarla. [Nube] - [Soporte](https://docs.sypnia.com/es/cloud/support.md): Cómo conseguir ayuda con Sypnia en cada plan, qué enviar para que podamos ayudarte rápido, y qué no prometemos. [Motor, Nube] ## Privacidad y seguridad Qué 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. - [Privacidad y seguridad: resumen](https://docs.sypnia.com/es/privacy.md): Qué 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. [Motor, Nube] - [Qué se recoge](https://docs.sypnia.com/es/privacy/what-is-collected.md): Cada tipo de dato que Sypnia recibe de tu app y de sus usuarios, cuáles son datos personales, qué se guarda en el navegador, y qué no recoge Sypnia nunca. [Motor, Nube] - [Enmascarado](https://docs.sypnia.com/es/privacy/masking.md): Qué oculta Sypnia en las grabaciones y en los eventos sin que se lo pidas, qué puedes ocultar tú, qué le hace exactamente el enmascarado a la página, y cómo comprobarlo. [Motor, Nube] - [Eliminar datos](https://docs.sypnia.com/es/privacy/deleting-data.md): Cómo se eliminan datos de Sypnia, en el motor de código abierto y en Sypnia Cloud: DELETE /v1/people/{person_id}, DELETE /v1/sessions/{session}, DELETE /v1/releases/{version}/sourcemaps y DELETE /v1/projects/{project_ref} con sus credenciales, qué quita cada uno, los tiempos (de las listas al instante, los objetos guardados en menos de 24 horas), qué se queda (totales, registros de problemas, respaldos, lo que ya salió de Sypnia), y la eliminación de una organización o de una cuenta en Sypnia Cloud. [Motor, Nube] - [Prácticas de seguridad](https://docs.sypnia.com/es/privacy/security-practices.md): Las prácticas de seguridad de Sypnia, sin afirmaciones de cumplimiento: protecciones integradas en los SDK y en el motor (llaves de ingesta de solo escritura, tokens de API guardados como hash y con alcances, aislamiento por proyecto, enmascarado en el navegador, límites de ingesta, bucket privado con enlaces firmados, webhooks firmados, reglas para las llamadas salientes, qué envía el agente), cómo se opera Sypnia Cloud (cifrado, reglas de acceso del personal, respaldos, subencargados, aviso de incidentes), qué no existe todavía, y cómo reportar una vulnerabilidad a support@sypnia.com. [Motor, Nube] ## Licencias Qué 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. - [Licencias: resumen](https://docs.sypnia.com/es/licensing.md): Índice de la sección de licencias de Sypnia: el motor y la Consola bajo AGPL-3.0, los SDK, @sypnia/mcp y las skills de agente bajo MIT, la documentación bajo CC BY 4.0, la app de Sypnia Cloud propietaria, el nombre y el logo como marcas, y las contribuciones aceptadas con una firma DCO. Es una propuesta que el dueño va a confirmar; no es asesoría legal. [Motor, Nube] - [Las licencias en palabras simples](https://docs.sypnia.com/es/licensing/licences-in-plain-words.md): Explicación en lenguaje simple de las licencias propuestas de Sypnia, por situación: alojar el motor sin modificar (AGPL-3.0, sin más obligación que conservar los avisos), modificarlo (ofrecer tu código fuente a quienes usan tu versión por una red), incluir los SDK con licencia MIT en una app de código cerrado (permitido), construir sobre la API (tu código sigue siendo tuyo), redistribuir o hacer un fork, ofrecerlo como servicio alojado (permitido bajo la AGPL, no con el nombre Sypnia), reutilizar la documentación (CC BY 4.0). No es asesoría legal. [Motor, Nube] - [Marcas](https://docs.sypnia.com/es/licensing/trademarks.md): Las reglas de marca de Sypnia en palabras simples (una propuesta): el nombre Sypnia, Sypnia Cloud y el logo no los otorgan las licencias AGPL, MIT ni CC BY. Permitido sin preguntar: la referencia veraz (usa, funciona con, para Sypnia, basado en Sypnia), escribir y enseñar, redistribuir sin cambios. Necesita permiso: nombres de producto, empresa, dominio o paquete que contengan Sypnia, servicios alojados llamados Sypnia, el logo como marca propia. Las versiones modificadas y los forks necesitan otro nombre. [Motor, Nube] - [Contribuir](https://docs.sypnia.com/es/licensing/contributing.md): Cómo contribuir a las partes de código abierto de Sypnia (motor, Consola, SDK, @sypnia/mcp, skills, documentación): dónde hacer preguntas y reportar errores, qué contiene un buen reporte, el flujo de un cambio empezando por la documentación, y los términos: las contribuciones quedan bajo la licencia del propio repositorio (AGPL-3.0, MIT o CC BY 4.0), los autores conservan sus derechos, no hay CLA, y cada commit debe llevar la firma del Developer Certificate of Origin (git commit -s). [Motor] ## Guías Recetas 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. - [Guías: resumen](https://docs.sypnia.com/es/guides.md): Recetas 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. [Motor, Nube] - [Apps hechas con Lovable, Bolt, v0 o Replit](https://docs.sypnia.com/es/guides/lovable-bolt-v0-replit.md): Agrega Sypnia a una app hecha con un constructor de apps con IA, con el prompt para darle al constructor, el código que debería producir y cómo revisar que lo hizo bien. [Motor, Nube] - [Next.js en Vercel](https://docs.sypnia.com/es/guides/nextjs-on-vercel.md): Configura @sypnia/next para una app desplegada en Vercel, con las variables de entorno, qué reportan los despliegues de vista previa, los source maps al compilar y la ruta para bloqueadores de anuncios. [Motor, Nube] - [Apps con Supabase](https://docs.sypnia.com/es/guides/supabase.md): Vigila una app construida sobre Supabase, desde las llamadas del navegador a tu base de datos hasta las Edge Functions, con las llamadas a la base de datos como spans y las personas identificadas desde Supabase Auth. [Motor, Nube] - [Source maps en CI](https://docs.sypnia.com/es/guides/source-maps-in-ci.md): Sube los source maps y registra la versión desde tu compilación, con un ejemplo completo de GitHub Actions, para que las pilas muestren tus propios archivos y los problemas digan qué cambio los empezó. [Motor, Nube] - [Correos de alerta desde un motor con alojamiento propio](https://docs.sypnia.com/es/guides/alert-emails-self-hosted.md): Convierte en correo el webhook de alertas de tu propio motor, con una función pequeña sobre Amazon SES o un servidor pequeño sobre cualquier cuenta SMTP. [Motor] - [Venir desde Sentry](https://docs.sypnia.com/es/guides/coming-from-sentry.md): Cómo se corresponden los conceptos y las llamadas de Sentry con los de Sypnia, qué quitar de tu código, y una lista honesta de lo que todavía no tiene equivalente. [Motor, Nube] ## Referencia Las páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes. - [Referencia: resumen](https://docs.sypnia.com/es/reference.md): Índice de las páginas de referencia de Sypnia: el esquema de eventos (cada evento campo por campo), el glosario (un nombre por cosa), Planeado (todo lo que no existe al lanzar), el registro de cambios y las preguntas frecuentes. La API, la CLI, las herramientas de MCP y la configuración del motor tienen sus propias secciones de referencia. [Motor, Nube] - [Esquema de eventos](https://docs.sypnia.com/es/reference/event-schema.md): Cada evento que envían los SDK, campo por campo, con tipos, límites y un ejemplo de cada uno, y las reglas que el motor les aplica. [Motor, Nube] - [Glosario](https://docs.sypnia.com/es/reference/glossary.md): 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. [Motor, Nube] - [Planeado](https://docs.sypnia.com/es/reference/planned.md): Todo lo que Sypnia NO tiene al lanzar, para que un agente nunca lo presente como existente. Planeado (sin fechas): SDK nativos de iOS y Android, SDK para Python, PHP, Go y Rust, logs, métricas personalizadas y tableros, SSO, identidad firmada para enviar, más drivers de bases de datos en Node, un adaptador para AWS Lambda, Bun/Deno/Workers, el runtime Edge de Next.js, source maps de los bundles de servidor, muestreo de peticiones exitosas. No existe y no se promete: track() en el servidor, avisos de vencimiento de certificados, páginas de estado, OAuth para MCP, elección de región, y otros. No por diseño: WhatsApp y Slack, correo y pull requests en el motor, hacer merge de código, grabar lo que se escribe. [Motor, Nube] - [Registro de cambios](https://docs.sypnia.com/es/reference/changelog.md): La página del registro de cambios de Sypnia y sus reglas. Todavía no se ha publicado nada, así que no hay entradas. Cuando haya versiones: una entrada por versión, la más nueva primero, por componente (motor, SDK, @sypnia/mcp, skills, Sypnia Cloud), con encabezados fijos (Qué hacer al actualizar, Agregado, Cambiado, Arreglado, Seguridad, Obsoleto, Eliminado). Las versiones siguen el versionado semántico; dentro de la versión 1 la API, el esquema de eventos, la configuración y la base de datos solo agregan. [Motor, Nube] - [Preguntas frecuentes](https://docs.sypnia.com/es/reference/faq.md): Preguntas frecuentes sobre Sypnia con respuestas cortas y exactas y sus enlaces: qué es, el motor de código abierto frente a Sypnia Cloud, el precio, las plataformas que cubre, la rapidez (un problema en menos de 2 minutos, los números en menos de 10), qué se graba y qué nunca, dónde están los datos, sin certificados de cumplimiento, el agente y los modelos de IA, los pull requests, los agentes de código y MCP, requisitos y costo del alojamiento propio, las alertas (correo en Cloud, webhook en el motor, sin Slack ni WhatsApp), las licencias, y lo que no está disponible al lanzar. [Motor, Nube]