observability

List metric failure rates for the insights window

Changed on

Return the percentage of evaluated calls that failed each metric during the selected Insights date range. Optionally scope to agent_ids (comma-separated agent ids) and/or agent_version_ids (comma-separated agent version ids) — the latter is how you compare a metric's failure rate before and after an agent version change. Rates are counted from the verdicts recorded at evaluation time, so editing a metric's failure criteria changes future calls only.

get/observability/v1/metric-failure-mode-insights/failure-rates/

Request

  • Base URL
    https://api.cekura.ai
  • URL
    https://api.cekura.ai/observability/v1/metric-failure-mode-insights/failure-rates/
  • Auth
    • API key in header X-CEKURA-API-KEY
    • or HTTP bearer
    • or HTTP bearer
    • or HTTP bearer

Query parameters

agent_idsstring

Comma-separated agent ids; only calls handled by these agents are counted.

agent_version_idsstring

Comma-separated agent version ids; only calls that ran on those agent versions are counted.

Response

idinteger
projectinteger
metricinteger nullable
predefined_metricinteger nullable
metric_namestring
is_triageboolean

Derived live from the metric's current Insights opt-in + failure criteria (not persisted) — the FE renders a metric's insight card only when this is true.

window_startstring date-time
window_endstring date-time
num_calls_analyzedinteger
total_failures_in_windowinteger
status'pending' | 'running' | 'succeeded' | 'failed' | 'skipped_no_failures'
  • pending - Pending
  • running - Running
  • succeeded - Succeeded
  • failed - Failed
  • skipped_no_failures - Skipped No Failures
headlinestring
overall_status_emojistring
failure_modesunknown
error_messagestring
duration_secondsnumber double nullable
created_atstring date-time
updated_atstring date-time

Changes