Skip to content

diagnostics

etl_craft.services.operations.diagnostics

Configuration, metadata and lineage documents shared by CLI and Python callers.

DoctorView dataclass

Every configuration check and whether the configuration can run.

LineageView dataclass

Collected lineage and the selected upstream and downstream paths.

check_configuration

check_configuration(config: ConnectorConfig) -> DoctorView

Report unreachable services rather than requiring an Engine DB connection first.

validate_metadata

validate_metadata(ctx: OperationContext, pipeline_code: str | None = None) -> validate.Report

Validate metadata and files under the caller's actor without running tasks.

trace_lineage

trace_lineage(ctx: OperationContext, *, table: str | None = None, column: str | None = None, upstream: bool = True, downstream: bool = True, depth: int | None = None, refresh: bool = False) -> LineageView

Collect and select lineage using the same validation for every caller.