# cell-architecture

> Claude/Codex skill by [@getsentry](https://omgskills.com/library/getsentry/index.md) · 45k stars · Updated 2026-08-31

Reference and active migration guide for Sentry's cell architecture. Explains what cells and localities are and why they're different, how requests reach cells via Synapse API routing, ingestion routing, and the control silo gateway, and how to safely query cross-cell data without silently missing results. The migration section covers how to do migration work: draining the URL\_NAME\_TO\_ACTION registry in test\_urls.py to zero (with a recipe for each action type), rolling deploy safety and the two-phase pattern required by independent sentry/getsentry deploys, and the region -\> cell rename including what not to rename (DB columns, AWS refs, uptime regions, billing address). Also documents known issues with proposed fixes: integration TeamLinkageView routing, Jira cross-cell fan-out, and relocation endpoint routing.

Tags: apm, crash-reporting, crash-reports, csp-report, devops, django, error-logging, error-monitoring, fair-source, hacktoberfest, monitor, monitoring, python, sentry, tag-production

## Install

```sh
git clone https://github.com/getsentry/sentry /tmp/sentry && ln -s /tmp/sentry/.agents/skills/cell-architecture ~/.claude/skills/cell-architecture
```

## From README

Cells Cell vs Locality These are two different layers of the architecture. Cell — a self-contained Sentry deployment that owns a subset of organizations. Each cell runs its own full stack — Getsentry, Snuba, Seer, Relay, Kafka, Symbolicator, and others — on an isolated network with no direct cell-to-cell communication. OrganizationMapping.cellname records which cell an org lives in. See Paths Into a Cell for how cells communicate with the outside world. Locality — a named collection of cells, representing either a data residency zone (for multi-tenant customers, e.g. "us", "de") or a dedicated deployment for a single customer (e.g. s4s2). Multi-tenant customers choose a locality when creating an organization; single-tenant localities are provisioned privately and not customer-selectable. Each locality maps to a subdomain (us.sentry.io, de.sentry.io or s4s2.sentry.io). Note: "region" is the old name for "cell". The codebase is actively being migrated. See Active Migration for details.

## Links

- HTML page: https://omgskills.com/skills/getsentry/sentry/cell-architecture/
- GitHub: https://github.com/getsentry/sentry
- Author: [@getsentry](https://omgskills.com/library/getsentry/index.md)

## More from this repo

- [design-system](https://omgskills.com/skills/getsentry/sentry/design-system/index.md) — Guide for using Sentry's layout and text primitives.
   - [@getsentry](https://omgskills.com/library/getsentry/index.md) · 45k stars
- [cmdk-actions](https://omgskills.com/skills/getsentry/sentry/cmdk-actions/index.md) — Guide for adding new actions to Sentry's Command+K palette.
   - [@getsentry](https://omgskills.com/library/getsentry/index.md) · 45k stars
- [django-models](https://omgskills.com/skills/getsentry/sentry/django-models/index.md) — Used to design Django ORM models for Sentry following architectural conventions for silos, replication, relocation, and...
   - [@getsentry](https://omgskills.com/library/getsentry/index.md) · 45k stars