Monitoring Charts

Page Outline

• Path Parameters
• Query Parameters
• Behavior
• Response

---

Returns timeseries chart data for model monitoring, including prediction distribution, feature drift scores, and data quality indicators over a specified time window.

Base Path: /api/v1/models

Method: GET

Path: /{model_id}/monitoring/charts

Auth: Requires a valid Bearer token (Authorization: Bearer <JWT>)

Path Parameters

Parameter	Type	Description
model_id	string	Unique identifier of the model

Query Parameters

Parameter	Type	Default	Description
from	string (ISO 8601)	7 days ago	Start of the monitoring window
to	string (ISO 8601)	now	End of the monitoring window
granularity	string	1d	Data point interval: 1h, 6h, 1d, 7d
chart	string	—	Filter to a specific chart type: prediction_distribution, feature_drift, data_quality, throughput
version_id	string	—	Filter data to a specific promoted version period. Defaults to all version segments

Behavior

• Returns multiple chart series grouped by chart type unless chart filter is specified.
• feature_drift scores are computed using Population Stability Index (PSI) against the training dataset distribution.
• data_quality tracks missing value rates and out-of-range feature values per inference batch.
• Returns HTTP 404 if the model is not found or monitoring data is not available (monitoring not yet started).

Response

Returns a MonitoringCharts object.

{
  "model_id": "mdl-7f3a19bc",
  "from": "2026-03-06T00:00:00Z",
  "to": "2026-03-13T00:00:00Z",
  "granularity": "1d",
  "series": {
    "prediction_distribution": [
      { "timestamp": "2026-03-07T00:00:00Z", "class_0": 0.61, "class_1": 0.39 },
      { "timestamp": "2026-03-08T00:00:00Z", "class_0": 0.59, "class_1": 0.41 }
    ],
    "feature_drift": [
      { "timestamp": "2026-03-07T00:00:00Z", "tenure_psi": 0.04, "monthly_spend_psi": 0.02 },
      { "timestamp": "2026-03-08T00:00:00Z", "tenure_psi": 0.07, "monthly_spend_psi": 0.03 }
    ]
  }
}