# Glossary

> Every word Sypnia uses with a fixed meaning, defined in one or two sentences, with the name it has in the API and in Spanish.

Applies to: the Sypnia engine (open source, self-hosted) and Sypnia Cloud (paid service). Status: at launch.  
Source: https://docs.sypnia.com/reference/glossary/

For agents: Sypnia's vocabulary, one name per thing: project, environment, release, event, session, replay, trace, span, problem (never «issue»), the agent (Sypnia's analysis, not your coding agent), fix, ingest key, API token, root token, engine, Sypnia Cloud, the Console, person, account, rage click, dead click, page snapshot, outage, mark. Use these words exactly when you write about Sypnia.

This page is for anyone who meets a word in these docs and wants its exact meaning. The vocabulary is the same for the open-source engine **\[Engine]** and for Sypnia Cloud **\[Cloud]**; a definition says so when a thing exists in only one of them.

Sypnia uses **one name per thing**, everywhere: in these docs, in the app, in the API and in what the agent writes. Three choices are worth knowing before you read the list:

- A group of failures with one cause is a **problem**. Sypnia never says «issue».
- **The agent** is Sypnia's own analysis. The tool that writes code for you, such as Cursor or Claude Code, is your **coding agent**.
- **The engine** is the open-source part, and **Sypnia Cloud** is the paid service that runs it for you.

Wherever a word of this list appears underlined in a page, pointing at it shows its definition and following it brings you here.

## The terms

**Account**: The team or company a person belongs to in your app. Your app sends it with `identify()`. It is not a Sypnia account.

**The agent**: Sypnia's analysis. It reads a problem and writes, in plain words, what happened, who it hit, since when, the likely cause and what to do. It is not your coding agent.

**API token**: A secret key that starts with `sps_`. It reads data through the API and the MCP server, within its scopes, `read`, `replay` and `admin`.

**Sypnia Cloud**: The paid service, with a free tier. It is the same engine, run by us, plus accounts, billing, the full app and the GitHub App.

**Console**: The one page built into the engine. It shows the problems list and the session replay viewer.

**Dead click**: A click on something that looks like it should do something, after which nothing happens.

**Sypnia engine**: The open-source part of Sypnia, one program that receives, stores and analyses your data. You can run it yourself for free.

**Environment**: Where a build of your app runs, such as `production` or `development`. Each event carries its environment, so you can tell real customers from your own testing.

**Event**: One thing your app reported to Sypnia, such as an error, a slow request, a click or a performance measurement.

**Fix**: What Sypnia hands to your coding agent for a problem. It comes three ways, a ready prompt, the MCP server and a pull request (Sypnia Cloud).

**Ingest key**: A public, write-only key that starts with `spk_`. Your app uses it to send events. It is safe to ship in a browser.

**Mark**: What Sypnia adds to an open problem on its own. There are three, «new» in its first 24 hours, «growing» when it reaches twice the people of its last alert and at least 5, and «came back» when it was resolved and happened again.

**Outage**: The time your app did not answer an uptime check. It opens after two failures in a row and closes at the first success.

**Page snapshot**: A copy of a page's structure, taken by the browser SDK with the same masking as a replay. Click maps are drawn over it.

**Person**: Someone using your app. A person has an id and, only if your app sends them with `identify()`, a name and an e-mail. A session with no person is anonymous.

**Problem**: A group of failures with one cause, told in one sentence. Sypnia says «problem», never «issue».

**Project**: One app that Sypnia watches. Every event, session and problem belongs to exactly one project, and nothing is shared between projects.

**Rage click**: A burst of three or more clicks on the same spot within one second. It tells you a person was stuck, even when no error was thrown.

**Release**: One version of your app that you shipped. Sypnia uses it to say since when a problem happens and what changed.

**Replay**: The recording of a session, played back as the person saw it. Typed input and masked fields are never recorded.

**Root token**: The first token of a self-hosted engine. You set it in the environment when you install, and use it to create projects and other tokens.

**Session**: One visit by one person, from the first page to the last, with every event that happened in between.

**Span**: One step of a trace, such as a request, a function or a database call, with its start, its duration and whether it failed.

**Trace**: The path of one request across your app, from the browser to the API to the database calls, with how long each step took.

## The same words in Spanish

The Spanish docs use one fixed translation for each term, and keep some words in English because developers use them that way.

| English                | Spanish                                                                              |
| ---------------------- | ------------------------------------------------------------------------------------ |
| problem                | problema                                                                             |
| session                | sesión                                                                               |
| replay                 | grabación                                                                            |
| trace                  | traza                                                                                |
| event                  | evento                                                                               |
| release                | versión (release)                                                                    |
| environment            | entorno                                                                              |
| project                | proyecto                                                                             |
| the agent              | el agente                                                                            |
| engine                 | motor                                                                                |
| the Console            | la Consola                                                                           |
| self-hosting           | alojamiento propio                                                                   |
| ingest key             | llave de ingesta                                                                     |
| API token              | token de API                                                                         |
| rage click, dead click | clic de rabia, clic muerto                                                           |
| uptime                 | disponibilidad                                                                       |
| alert, daily summary   | alerta, resumen diario                                                               |
| masking, sampling      | enmascarado, muestreo                                                                |
| Kept in English        | span, pull request, prompt, webhook, source maps, skill, MCP, SDK, CLI, Sypnia Cloud |

## Names in code

In the API, the events and the settings, the same things have short fixed names. The full list of event fields is in the [event schema](https://docs.sypnia.com/reference/event-schema).

| Thing                        | In the API and the CLI                            | Looks like                                    |
| ---------------------------- | ------------------------------------------------- | --------------------------------------------- |
| Project                      | `project`, an id or a slug                        | `prj_5k2m9x4q7w1z`, `shop`                    |
| Problem                      | `problem`, an id or a slug                        | `prb_8f3k2m9x4q7w`, `pay-button-does-nothing` |
| Session                      | `session`, 32 hex characters chosen by the SDK    | `8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0`            |
| Trace                        | `trace_id`, a W3C trace id                        | `7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c`            |
| Release                      | `version`, the string your app sends as `release` | `4f2a91c`                                     |
| Ingest key                   | The key itself, and its record                    | `spk_…`, `key_…`                              |
| API token                    | The token itself, and its record                  | `sps_…`, `tok_…`                              |
| Alert, uptime check, webhook | Their ids                                         | `alt_…`, `chk_…`, `whk_…`                     |
