For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • About NVIDIA NeMo Relay
    • Overview
    • Architecture
    • Ecosystem
    • Concepts
    • Release Notes
  • Getting Started
    • Agent Runtime Primer
    • Prerequisites
    • Installation
    • Configuration / Setup
    • Quick Start
  • NVIDIA NeMo Relay CLI
    • About
    • Basic Usage
    • Claude Code
    • Codex
    • Cursor
    • Hermes Agent
  • Supported Integrations
    • About
    • OpenClaw Plugin Guide
    • LangChain Integration Guide
    • LangGraph Integration Guide
    • Deep Agents Integration Guide
  • Instrument Applications
    • About
    • Adding Scopes and Marks
    • Instrument a Tool Call
    • Instrument an LLM Call
    • Add Middleware
    • Code Examples
  • Observability Plugin
    • About
    • Configuration
    • Agent Trajectory Interchange Format (ATIF)
    • Agent Trajectory Observability Format (ATOF)
    • OpenTelemetry
    • OpenInference
  • Adaptive Plugin
    • About
    • Configuration
    • Adaptive Cache Governor (ACG)
    • Adaptive Hints
  • NeMo Guardrails Plugin
    • About
    • Configuration
  • Integrate into Frameworks
    • About
    • Adding Scopes
    • Wrap Tool Calls
    • Wrap LLM Calls
    • Handle Non-Serializable Data
    • Using Codecs
    • Provider Codecs
    • Provider Response Codecs
    • Code Examples
  • Build Plugins
    • About
    • Define a Plugin
    • Validate Plugin Configuration
    • Plugin Configuration Files
    • Register Plugin Behavior
    • Design Plugin Configuration
    • NeMo Guardrails Example Plugin
    • Code Examples
  • Contribute
    • About
    • Development Setup
    • Workflow and Reviews
    • Testing and Documentation
  • Reference
    • APIs
      • Python Library Reference
      • Node.js Library Reference
      • Rust Library Reference
        • nemo-relay
        • nemo-relay-adaptive
          • acg
            • anthropic_plugin
            • canonicalize
            • capability
            • ir_builder
            • openai_plugin
            • passthrough
            • plugin
            • plugin_registry
            • policy
            • profile
            • prompt_ir
            • retention
            • stability
            • telemetry
              • CacheHitRate
              • CacheMissDiagnosis
              • CacheRequestFacts
              • CacheTelemetryEvent
              • CacheMissEvidence
              • CacheMissReason
              • CacheTelemetryProvider
            • types
            • variable_extractor
            • error
            • MIN_ACG_OBSERVATIONS
          • acg_component
          • acg_learner
          • acg_profile
          • adaptive_hints_intercept
          • cache_diagnostics
          • config
          • context_helpers
          • drain
          • error
          • intercepts
          • learner
          • plugin_component
          • redis
          • storage
          • subscriber
          • tool_parallelism_learner
          • trie
          • types
          • AdaptiveRuntime
        • nemo-relay-ffi
    • Performance
  • Resources
    • Support and FAQs
    • Glossary
    • Troubleshooting Guide
    • Community
    • Legal
NVIDIANVIDIA
Developer-friendly docs for your API
Privacy Policy | Your Privacy Choices | Terms of Service | Accessibility | Corporate Policies | Product Security | Contact

Copyright © 2026, NVIDIA Corporation.

LogoLogo
On this page
  • Variants
  • PrefixMismatch
  • Fields
  • first_mismatch_span_id: String
  • sequence_index: u32
  • expected_hash_prefix: String
  • actual_hash_prefix: String
  • BelowMinimumThreshold
  • Fields
  • observed_prefix_tokens: u32
  • required_min_tokens: u32
  • estimation_source: String
  • RetentionExpired
  • Fields
  • observed_gap_secs: f64
  • retention_window_secs: f64
  • provider_semantics: String
  • Unknown
  • Fields
  • missing_facts: Vec<String>
  • Trait Implementations
  • impl Clone for CacheMissEvidence
  • clone
  • clone_from
  • impl Debug for CacheMissEvidence
  • fmt
  • impl<'de> Deserialize<'de> for CacheMissEvidence
  • deserialize
  • impl PartialEq for CacheMissEvidence
  • eq
  • ne
  • impl Serialize for CacheMissEvidence
  • serialize
  • impl StructuralPartialEq for CacheMissEvidence
ReferenceAPIsRust Library Referencenemo-relay-adaptiveacgtelemetry

Enum Cache Miss Evidence

||View as Markdown|
Previous

Struct Cache Telemetry Event

Next

Enum Cache Miss Reason

Generated from cargo doc --no-deps -p nemo-relay -p nemo-relay-adaptive -p nemo-relay-ffi.

pub enum CacheMissEvidence {
    PrefixMismatch {
        first_mismatch_span_id: String,
        sequence_index: u32,
        expected_hash_prefix: String,
        actual_hash_prefix: String,
    },
    BelowMinimumThreshold {
        observed_prefix_tokens: u32,
        required_min_tokens: u32,
        estimation_source: String,
    },
    RetentionExpired {
        observed_gap_secs: f64,
        retention_window_secs: f64,
        provider_semantics: String,
    },
    Unknown {
        missing_facts: Vec<String>,
    },
}

Typed evidence for a cache miss diagnosis.

Variants

PrefixMismatch

PrefixMismatch

Stable prefix diverged from the retained exemplar.

Fields

first_mismatch_span_id: String

Span ID of the first mismatching stable block.

sequence_index: u32

Zero-based sequence index of the mismatching block.

expected_hash_prefix: String

Expected short SHA-256 hash prefix.

actual_hash_prefix: String

Actual short SHA-256 hash prefix.

BelowMinimumThreshold

BelowMinimumThreshold

Stable prefix is too short for provider cache reuse.

Fields

observed_prefix_tokens: u32

Observed stable prefix tokens.

required_min_tokens: u32

Required minimum tokens for cache reuse.

estimation_source: String

Source of the token estimate.

RetentionExpired

RetentionExpired

Stable prefix likely aged out of the provider retention window.

Fields

observed_gap_secs: f64

Observed gap between requests with the same stable prefix.

retention_window_secs: f64

Provider retention window in seconds.

provider_semantics: String

Human-readable provider semantics summary.

Unknown

Unknown

Diagnosis could not be justified from the available facts.

Fields

missing_facts: Vec<String>

List of facts that were unavailable at classification time.

Trait Implementations

impl Clone for CacheMissEvidence

impl Clone for CacheMissEvidence

clone

fn clone(&self) -> CacheMissEvidence

clone_from

fn clone_from(&mut self, source: &Self)

impl Debug for CacheMissEvidence

impl Debug for CacheMissEvidence

fmt

fn fmt(&self, f: &mut Formatter<'_>) -> Result

impl<'de> Deserialize<'de> for CacheMissEvidence

impl<'de> Deserialize<'de> for CacheMissEvidence

deserialize

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
    __D: Deserializer<'de>,

impl PartialEq for CacheMissEvidence

impl PartialEq for CacheMissEvidence

eq

fn eq(&self, other: &CacheMissEvidence) -> bool

ne

fn ne(&self, other: &Rhs) -> bool

impl Serialize for CacheMissEvidence

impl Serialize for CacheMissEvidence

serialize

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where
    __S: Serializer,

impl StructuralPartialEq for CacheMissEvidence

impl StructuralPartialEq for CacheMissEvidence