Get Engine Performance

Get engine performance metrics over time.

Query profiling data logged by the engine’s profiling infrastructure. All queries are automatically filtered to your namespace.

Time Range:

• Specify hours for recent history (e.g., hours=24 for last 24 hours)
• OR specify start_date and end_date for custom range
• Defaults to last 24 hours if neither provided

Grouping:

• minute: High-resolution (for short time ranges)
• hour: Standard resolution (default)
• day: For longer time ranges
• week, month: For historical trends

Response:

• Time-series metrics (avg, p50, p95, p99 latencies)
• Summary statistics across the entire time range
• All latencies in milliseconds

Example:

GET /v1/analytics/performance/engine?hours=24&group_by=hour

GET /v1/analytics/performance/engine

Get Engine Performance

cURL

curl --request GET \
  --url https://api.mixpeek.com/v1/analytics/performance/engine \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Namespace: <api-key>'

200

{
  "time_range": {
    "start": "2023-11-07T05:31:56Z",
    "end": "2023-11-07T05:31:56Z"
  },
  "metrics": [
    {
      "time_bucket": "2023-11-07T05:31:56Z",
      "execution_count": 123,
      "avg_latency_ms": 123,
      "p50_latency_ms": 123,
      "p95_latency_ms": 123,
      "p99_latency_ms": 123,
      "max_latency_ms": 123
    }
  ],
  "summary": {
    "total_executions": 0,
    "avg_latency_ms": 0,
    "p50_latency_ms": 0,
    "p95_latency_ms": 0,
    "p99_latency_ms": 0,
    "max_latency_ms": 0,
    "total_time_seconds": 0
  },
  "service_health": {
    "availability": 123,
    "degraded_rate": 123,
    "partial_rate": 123,
    "timeout_rate": 123,
    "throttle_rate": 123,
    "dependency_health": {},
    "window_end_ts": 123,
    "freshness_seconds": 120,
    "reconciliation": "Rates come from the unsampled per-execution `_signals` ledger (one doc per execution) folded into the latest complete rollup window. They reconcile to request logs within one rollup window (default 60 minutes); executions in the in-progress window may not be folded yet."
  }
}

Authorizations

Authorization · string · header · required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing, malformed, unknown, revoked, inactive or expired key returns 401; a key without the permission, scope or plan an operation needs returns 403.

X-Namespace · string · header · required

Namespace id (ns_...), not the namespace name. This scopes the request rather than authenticating it, and it is required on every operation marked x-mixpeek-namespace-scoped.

Query Parameters

hours · integer | null

Hours of history (alternative to date range)

Required range: 1 <= x <= 720

start_date · string<date-time> | null

Start date for time range

end_date · string<date-time> | null

End date for time range

group_by · string · default: hour

Time grouping (minute, hour, day, week)

Pattern: ^(minute|hour|day|week|month)$

Response

200

application/json

Successful Response

Response for engine performance query.

time_range · TimeRange · object · required

Time range of the query

Show child attributes

metrics · PerformanceMetric · object[] · required

Time-series performance metrics

Show child attributes

summary · PerformanceSummary · object | null

Overall summary statistics

Show child attributes

service_health · ServiceHealth · object | null

Per-namespace service-health dimensions: availability, degraded/partial rates, timeout/throttle rates and dependency health. Unwired dimensions are None with a stated reason, never a fabricated zero.

Show child attributes