---
id: sentry-kafka-schemas
version: "3.0.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# sentry-kafka-schemas — Kafka topics and schemas for Sentry

License: unclear · Maintenance: active · Downloads: 135.7K/mo

## What it is and what it does

sentry-kafka-schemas is a schema registry and codec library for Sentry's Kafka infrastructure. It defines the topics, JSON schemas, and message formats that Sentry services use to stream events and metrics through Kafka, along with validation and type-generation tooling. The package contains YAML topic definitions, jsonschema files for both JSON and msgpack message types, and example payloads stripped of customer data.

When installed, it provides a Python API to retrieve codecs for specific topics (e.g., `get_codec("ingest-metrics")`), validate incoming messages against their schemas, and access auto-generated TypedDict classes that correspond to each schema version. This allows Sentry services and integrations to encode, decode, and validate Kafka messages with type safety and schema compliance.

Use it for:

- Validate incoming Kafka messages in a Sentry service consumer against the canonical schema before processing.
- Generate type-safe Python objects from Kafka payloads using auto-generated schema_types classes.
- Encode outgoing events or metrics to Kafka with schema validation to prevent malformed messages.
- Reference topic definitions and examples during development of new Sentry services that produce or consume Kafka topics.
- Synchronize schema definitions across Sentry, Snuba, and Relay services during schema evolution.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Kafka topic definitions and JSON schema validators for Sentry's event streaming infrastructure, with auto-generated Python type hints for schema-compliant message handling.

Yes, if you are developing or operating a Sentry instance or integration that produces or consumes Kafka messages. The package is actively maintained, has low install friction, and provides essential schema definitions and validation for Sentry's event pipeline. Verify the license status before use in proprietary contexts, and confirm Python version compatibility for your environment.

## Install

pip install sentry-kafka-schemas
uv add sentry-kafka-schemas
poetry add sentry-kafka-schemas

## Installing sentry-kafka-schemas

Before you install: Active maintenance with a release on 2026-08-14. Low install friction: pure Python wheel with six runtime dependencies (python-rapidjson, PyYAML, typing-extensions, fastjsonschema, msgpack, sentry-protos). No minimum Python version specified in the fact sheet.

License in practice: License treatment is unclear—no SPDX identifier or raw license text is provided. Verify the actual license before using in proprietary or GPL-sensitive contexts.

Quickstart:

pip install sentry-kafka-schemas

from sentry_kafka_schemas import get_codec, ValidationError
from sentry_kafka_schemas.schema_types.ingest_metrics_v1 import IngestMetric

SCHEMA = get_codec("ingest-metrics")
try:
    decoded = SCHEMA.decode(b'{"type": "c", ...}')
except ValidationError:
    pass

Verify before relying:

- Minimum Python version required (requires_python is unspecified in the fact sheet)
- Whether license is open-source or proprietary (license_treatment is 'unclear')
- Stability guarantees for schema versioning and backward compatibility across releases

## Package facts

- License: not declared (unclear)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 135.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

kafka schema registry, sentry event schemas, message validation kafka, json schema codec, kafka topic definitions, typed kafka messages, sentry kafka integration, kafka, schema-registry, sentry

[View on SkillFed](https://skillfed.io/packages/sentry-kafka-schemas) · [View on PyPI](https://pypi.org/project/sentry-kafka-schemas/)