cadrumo.core.telemetry.errors module

Canonical telemetry error types.

Declared alongside the schema/consent/emit modules per the project’s error-taxonomy convention: every CadrumoError subclass binds to a registered ErrorCode row (core/errors/registry/_core.py).

See also

TelemetrySchemaError

Telemetry schema failure defined by this module.

TELEMETRY_METRIC_REGISTRY

Closed metric allowlist whose integrity violations raise this error.

build_telemetry_payload()

Payload builder that enforces the registry before emission.

exception TelemetrySchemaError(message=None, *, context=None, translated_message=None)[source]

Bases: CoreError

Raised when a telemetry payload references an unregistered metric key.

This is a development/authoring-time integrity failure, not an operator- facing refusal: the metric-key registry (TELEMETRY_METRIC_REGISTRY) is the closed allowlist a telemetry producer must enroll in before it can emit a counter or timing. A key that is not registered for its command means a producer was added without registering its schema entry first — the exact gap aeat-calculation-aggregation’s closed-registry discipline exists to catch elsewhere in the codebase.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code