Skip to content
Kitbay

backend-conventions

NOASSERTIONUpdated on Nov 11, 202645,751GitHub stars

A maintainer skill in Sentry's repository setting conventions for its backend Python code. Registered options are read without a second default, since the registered one always applies.

What the skill teaches

A maintainer skill in Sentry's repository setting conventions for its backend Python code. Registered options are read without a second default, since the registered one always applies. Logging uses logger.exception inside exception handlers and passes arguments instead of pre-formatted strings, matching two lint rules. Before inventing a span or tag attribute name, the agent checks the shared list of OpenTelemetry and Sentry attribute names and only then uses a namespaced custom key. Metric tags stay few and low-cardinality, never IDs, emails, URLs or free text; keys ending in _id and a few others are stripped or rejected by middleware, and the allowlist must not be widened to get around this.

Capabilities

  • Apply Sentry's logging lint rules
  • Choose standard span and tag attribute names
  • Keep metric tags low-cardinality
  • Read registered options correctly