v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB

Analytics

Analytics - Retrievers

Get Stage Breakdown

Get stage-level performance breakdown.

Analyzes individual stage performance to identify bottlenecks:

Stage execution times
Document flow (in/out)
Stage-level latency distribution

Use Cases:

Identify slow stages in retrieval pipeline
Optimize stage ordering
Debug pipeline bottlenecks
Understand document reduction rates

Example:

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

get/v1/analytics/retrievers/{retriever_id}/stages

Path parameters

retriever_idstring required

Query parameters

hoursinteger

Hours of history

Response

Successful Response

retriever_idstring required

Retriever identifier

total_latency_msnumber required

Total pipeline latency

Example response

{
  "retriever_id": "ret_abc123",
  "stages": [
    {
      "avg_documents_in": 0,
      "avg_documents_out": 100,
      "avg_latency_ms": 45.3,
      "execution_count": 1234,
      "p95_latency_ms": 89.2,
      "stage_name": "knn_search",
      "stage_type": "vector_search"
    },
    {
      "avg_documents_in": 100,
      "avg_documents_out": 10,
      "avg_latency_ms": 102.5,
      "execution_count": 1234,
      "p95_latency_ms": 198.7,
      "stage_name": "rerank",
      "stage_type": "reranking"
    }
  ],
  "total_latency_ms": 147.8
}