How getsentry/sentry works
Sentry is a developer debugging and observability platform: teams use SDKs and the product to detect, trace, and fix software issues. Its principal workflow spans event intake, issue investigation, and analysis of traces, logs, and replays; additional branches cover alerts, integrations, AI monitoring, and operational metrics. The README documents these capabilities, while sampled source confirms selected implementation links. Several product areas are represented by their documented subsystem paths because their source was not sampled; uncertain connections are omitted or marked unverified.
Main entry points: metrics.py Metrics API · sentry Sentry platform · event_manager.py Event processing · organization_events.py Event queries
Components 21
Intake and tenancy
- Sentry platform
src/sentry - Event processing
src/sentry/event_manager.py - Organizations
src/sentry/models/organization.py - Projects
src/sentry/models/project.py
Issue investigation
- Issue APIs
src/sentry/api/endpoints - Event queries
src/sentry/api/endpoints/organization_events.py - Snuba utilities
src/sentry/utils/snuba.py
Observability
- Context indexing
src/sentry/tasks/seer/context_engine_index.py - Context queries
src/sentry/seer/agent/context_engine_utils.py - AI monitoring
src/sentry/ai_monitoring - Replay storage
src/sentry/replays/lib/storage.py
Automation and integrations
- Alert conditions
src/sentry/workflow_engine/handlers/condition/event_frequency_query_handlers.py - Integrations
src/sentry/integrations/base.py - Install flow
src/sentry/integrations/pipeline.py - Identity flow
src/sentry/identity/pipeline.py
Platform services
- Metrics API
src/sentry/utils/metrics.py - SDK metrics backend
src/sentry/metrics/sentry_sdk.py - Logging metrics backend
src/sentry/metrics/logging.py - Feature flags
src/sentry/features/__init__.py
Other components
- Developers
- Official SDKs
Connections 18
- Developers → Official SDKs: instrument apps
- Official SDKs → Sentry platform: send telemetry
- Sentry platform → Event processing: process events
- Event processing → Projects: associate project
- Developers → Issue APIs: investigate issues
- Developers → Event queries: explore events
- Event queries → Snuba utilities: query data
- Developers → Alert conditions: configure alerts
- Developers → Integrations: connect services
- Install flow → Integrations: uses provider
src/sentry/integrations/pipeline.py - Developers → Identity flow: authenticate
- Context indexing → Context queries: uses queries
src/sentry/tasks/seer/context_engine_index.py - Developers → AI monitoring: inspect AI activity
- Developers → Replay storage: inspect replays
- Metrics API → SDK metrics backend: records metrics
src/sentry/utils/metrics.py - Metrics API → Logging metrics backend: records metrics
src/sentry/utils/metrics.py - Feature flags → Install flow: gates setup
src/sentry/integrations/pipeline.py - Organizations → Projects: owns projects
src/sentry/models/project.py