Skip to main content

Alert object

An Alert object represents the current state of an alert at a given moment. It is returned by the alert listing and single-alert endpoints.

Notes

  • id remains stable across the full lifetime of an alert
  • metrics is included when the endpoint returns expanded metric data or always includes it by design
  • learningStatus is the aggregate learning state for the alert view

Attributes

FieldTypeDescription
idstringUnique alert identifier
lastSeenAtdatetimeLatest event timestamp for this alert state
firstSeenAtdatetimeTimestamp when the alert first appeared
activebooleanWhether the alert is active at the selected moment
impactstringOverall impact level, for example medium or high
activeNodesintegerNumber of nodes currently participating in the alert
activeMetricsintegerNumber of metrics currently participating in the alert
scorenumberAggregate alert score
learningStatusnumberAggregate learning-status value for the alert
metricsarrayList of alert metric entries

Metric entry attributes

FieldTypeDescription
nodeIdintegerNode identifier
nodeNamestringNode display name
statTypeIdstringMetric type identifier
statTypeNamestringMetric display name
systemIdintegerSystem identifier
systemNamestringSystem display name
score.adjustednumberAdjusted per-metric score
score.contributionnumberRaw per-metric score contribution
learningStatusnumberLearning-status value for the metric
severitystringPer-metric severity
typestringMetric anomaly type, for example deviation or missing_data
closestBaselineDeviationnumberDistance from the closest baseline corridor when available

Example

{
"id": "alert-123",
"lastSeenAt": "2025-11-13T12:34:56Z",
"firstSeenAt": "2025-11-13T10:00:00Z",
"active": true,
"impact": "high",
"activeNodes": 3,
"activeMetrics": 5,
"score": 2.1,
"learningStatus": 0,
"metrics": [
{
"nodeId": 10,
"nodeName": "Order Service",
"statTypeId": "3ef542f1-2c80-4c83-ae06-8741857ed78a",
"statTypeName": "CPU Usage",
"systemId": 101,
"systemName": "Prod Cluster",
"score": {
"adjusted": 1.7,
"contribution": 0.9
},
"learningStatus": 0,
"severity": "red",
"type": "deviation",
"closestBaselineDeviation": 2.4
}
]
}