ecluse:ecluse-core
Safe HaskellNone
LanguageGHC2021

Ecluse.Core.Server.Pipeline.Diagnostics

Description

Operator diagnostics for metadata failures, dropped entries, and integrity divergence. Access-refusal logs contain no upstream body, headers, or credential.

The bad-upstream warnings carry pipelineInternalModule as their module filter key and every other line carries pipelineModule.

Synopsis

Metadata-read failures

logMetadataFailure :: KatipContext m => PackageName -> Text -> MetadataError -> m () Source #

Log once per real fetch, inside the single-flight leader's request context.

logDirectoryFailure :: KatipContext m => Text -> MetadataError -> m () Source #

logMetadataFailure for a registry-wide directory read. Its lines name no package.

Dropped entries and divergence

logInvalidEntries :: KatipContext m => PackageName -> Text -> [InvalidEntry] -> m () Source #

The malformed packument entries the projection dropped rather than failing the whole document.

logPackumentDrops :: KatipContext m => PackageName -> Text -> PackageInfo -> m () Source #

The entries one packument read dropped, naming a document that kept no version as such.

logVersionlessRefusal :: KatipContext m => PackageName -> Text -> Text -> Int -> m () Source #

A request refused because this upstream's packument kept no version. Its read logged the dropped entries.

logDirectoryInvalidEntries :: KatipContext m => Text -> [InvalidEntry] -> m () Source #

The malformed rows a registry-wide directory dropped. The line names no package.

warnDivergences :: KatipContext m => MetricsPort -> PackageName -> MergePlan -> m () Source #

Warn and increment the divergence metric when shared digests disagree across origins.