Alarm Schema
Felder
Alarm Schema
ADR 0326 — stateful monitoring alarm (one doc per open dedupKey period), classified by the alarm rule stack.
status
Lifecycle: OPEN → ACKNOWLEDGED (in Bearbeitung) → RESOLVED (source sent CLEAR) | CLOSED (manual or auto_close action).
OPENACKNOWLEDGEDRESOLVEDCLOSEDisOpen
Computed: true while status is OPEN or ACKNOWLEDGED. Exists solely for the unique partial index (one open alarm per dedupKey) — always derive from status, never set independently.
severity
Display severity from the FIRST matching rule; fallback: severityHint mapping (critical→error) when no rule matched.
infowarningerrorcanonicalSeverity
Provider-mapped 4-level severity of the first RAISE (RmmSeverity). Kept alongside the 3-level display severity because ticket-priority policies are 4-level — the seeded default rule maps priorities from THIS field (fixed-policy parity).
infowarningerrorcriticalnulldedupKey
Provider-scoped identity (ADR 0244) — passed through, never recomputed.
provider
RMM provider id (octoja|riverbird|…).
connectionId
integration_config the events came from.
errorType
Check name/category ("Fehlerart") — snapshot from the first RAISE.
checkType
Normalized check type (RMM_CHECK_TYPES catalog value), null when unknown.
message
Human-readable check output — updated on UPDATE events.
deviceName
deviceCategory
Normalized device category (RMM_DEVICE_CATEGORIES value).
siteName
customerName
partyId
rmmDeviceId
assetId
CMDB asset of the device — snapshot of rmm_device.assetId at alarm creation; null = no match ("ohne Asset" marker in the UI).
ticketId
Ticket created/attached by a create_ticket action.
matchedRuleIds
All rules that matched (evaluation transparency in the UI).
suppressedByException
A rule matched but its exception suppressed all actions.
pinned
OR over the matching rules — a pinned alarm cannot be hidden.
acknowledgedBy
acknowledgedAt
firstOccurredAt
lastEventAt
resolvedAt
eventCount
scheduledActionJobIds
Pending BullMQ action jobIds — best-effort cancel bookkeeping on CLEAR/ack.
executedActionKeys
Idempotency keys of actions that already fired. The authoritative dedup — BullMQ jobId dedup ends at removeOnComplete.
Keine Felder passen zum Filter.
Standard-Endpoints
Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:
GET /api/v1/alarms— Liste, paginiert + filterbarGET /api/v1/alarms/<id>— Einzelne EntityPOST /api/v1/alarms— AnlegenPATCH /api/v1/alarms/<id>— Teil-UpdateDELETE /api/v1/alarms/<id>— Soft-DeleteGET /api/v1/alarms/<id>/timeline— Audit + Aktivitäten