v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB

Analytics

Analytics - Retrievers

Get Cache Performance

Get cache performance metrics.

Analyzes cache effectiveness including:

Hit/miss rates
Latency comparison (cache vs full search)
Hourly cache performance trends

Use Cases:

Evaluate cache effectiveness
Optimize cache TTL settings
Monitor cache performance
Identify cache warming opportunities

Example:

curl -X GET "https://api.mixpeek.com/v1/analytics/retrievers/ret_abc123/cache-performance?hours=168" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Namespace: your-namespace"

get/v1/analytics/retrievers/{retriever_id}/cache-performance

Path parameters

retriever_idstring required

Query parameters

hoursinteger

Hours of history

Response

Successful Response

retriever_idstring required

Retriever identifier

cache_hit_ratenumber required

Overall cache hit rate

total_cache_hitsinteger required

Total cache hits

total_cache_missesinteger required

Total cache misses

avg_cache_hit_latency_msnumber required

Average latency on cache hit

avg_cache_miss_latency_msnumber required

Average latency on cache miss

hourly_breakdownobject[] required

Hourly cache performance

Example response

{
  "avg_cache_hit_latency_ms": 5.2,
  "avg_cache_miss_latency_ms": 145.8,
  "cache_hit_rate": 0.78,
  "hourly_breakdown": [
    {
      "hit_rate": 0.78,
      "hits": 145,
      "hour": "2025-10-28T10:00:00Z",
      "misses": 42
    }
  ],
  "retriever_id": "ret_abc123",
  "time_range": {
    "end": "2025-10-29T00:00:00Z",
    "start": "2025-10-28T00:00:00Z"
  },
  "total_cache_hits": 3456,
  "total_cache_misses": 978
}