stormlog.gap_analysis

Shared hidden-memory gap analysis utilities.

Functions

analyze_hidden_memory_gaps(events, ...[, ...])

Classify allocator-vs-device hidden memory gaps over time.

Classes

GapFinding(classification, severity, ...[, ...])

A classified finding from hidden-memory gap analysis.
class stormlog.gap_analysis.GapFinding(classification, severity, confidence, evidence, description, remediation, evidence_timestamp_ns=None, phase_attribution=None)[source]

Bases: object

A classified finding from hidden-memory gap analysis.

Parameters:

  • classification (str)

  • severity (str)

  • confidence (float)

  • evidence (dict[str, Any])

  • description (str)

  • remediation (List[str])

  • evidence_timestamp_ns (int | None)

  • phase_attribution (PhaseAttribution | None)

classification: str
severity: str
confidence: float
evidence: dict[str, Any]
description: str
remediation: List[str]
evidence_timestamp_ns: int | None = None
phase_attribution: PhaseAttribution | None = None
stormlog.gap_analysis.analyze_hidden_memory_gaps(events, thresholds, format_memory, remediation_by_classification, phase_resolver=None)[source]

Classify allocator-vs-device hidden memory gaps over time.

Parameters:

  • events (Sequence[TelemetryEventV2])

  • thresholds (Mapping[str, float])

  • format_memory (Callable[[int], str])

  • remediation_by_classification (Mapping[str, List[str]])

  • phase_resolver (PhaseReplayIndex | None)

Return type:

List[GapFinding]