| Safe Haskell | None |
|---|---|
| Language | GHC2021 |
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
- logMetadataFailure :: KatipContext m => PackageName -> Text -> MetadataError -> m ()
- logDirectoryFailure :: KatipContext m => Text -> MetadataError -> m ()
- logInvalidEntries :: KatipContext m => PackageName -> Text -> [InvalidEntry] -> m ()
- logPackumentDrops :: KatipContext m => PackageName -> Text -> PackageInfo -> m ()
- logVersionlessRefusal :: KatipContext m => PackageName -> Text -> Text -> Int -> m ()
- logDirectoryInvalidEntries :: KatipContext m => Text -> [InvalidEntry] -> m ()
- warnDivergences :: KatipContext m => MetricsPort -> PackageName -> MergePlan -> m ()
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.