Concelier Connector Reason Codes

Last updated: 2026-01-16

This reference is for operators triaging connector health in a Stella Ops Concelier instance. It lists the deterministic reason codes emitted by stella db connectors status, stella db connectors list, and stella db connectors test, along with the category each code maps to and the recommended remediation.

CodeCategoryMeaningRemediation
CON_RATE_001degradedUpstream rate limit or throttling detected.Reduce fetch cadence, honor Retry-After, or request higher quotas.
CON_UPSTREAM_002failedUpstream service unreachable or returning persistent errors.Check upstream availability, retry with backoff, or switch to mirror.
CON_TIMEOUT_001failedConnector test exceeded timeout window.Increase --timeout or troubleshoot network latency.
CON_UNKNOWN_001unknownNo status data reported for enabled connector.Verify scheduler and connector logs.
CON_DISABLED_001disabledConnector is disabled in configuration.Enable in concelier configuration if required.