Get Stage Breakdown

curl --request GET \
  --url https://api.mixpeek.com/v1/analytics/retrievers/{retriever_id}/stages \
  --header 'Authorization: Bearer <token>'

{
  "retriever_id": "<string>",
  "stages": [
    {
      "stage_name": "<string>",
      "stage_type": "<string>",
      "execution_count": 123,
      "avg_latency_ms": 123,
      "p95_latency_ms": 123,
      "avg_documents_in": 123,
      "avg_documents_out": 123
    }
  ],
  "total_latency_ms": 123
}

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

analytics

retrievers

{retriever_id}

stages

Get Stage Breakdown

curl --request GET \
  --url https://api.mixpeek.com/v1/analytics/retrievers/{retriever_id}/stages \
  --header 'Authorization: Bearer <token>'

{
  "retriever_id": "<string>",
  "stages": [
    {
      "stage_name": "<string>",
      "stage_type": "<string>",
      "execution_count": 123,
      "avg_latency_ms": 123,
      "p95_latency_ms": 123,
      "avg_documents_in": 123,
      "avg_documents_out": 123
    }
  ],
  "total_latency_ms": 123
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

retriever_id

string

required

Query Parameters

hours

integer

default:24

Hours of history

Required range: 1 <= x <= 720

Response

Successful Response

Stage breakdown response.

retriever_id

string

required

Retriever identifier

stages

StagePerformanceMetrics · object[]

required

Stage metrics

Show child attributes

total_latency_ms

number

required

Total pipeline latency

Get Slow Queries Get Cache Performance