Activity Timeline

The Activity Timeline is the persistent audit trail of the Polycrate API: data model, typical event kinds, automatic generation and where activities are shown in the dashboards.

Activity Timeline

The Activity Timeline is the persistent audit trail of the Polycrate API. Every relevant event is stored as an Activity and read in the detail dashboard as a Timeline tab — API-based, with "Load More" pagination (Alpine.js).

Model

Field Meaning
object_id / object_type / object_name Linked subject
kind Event type (e.g. downtime_started, maintenance_scheduled)
message Human-readable text
metadata Machine-readable context
organization / workspace inherited from the subject

Activities are visible to authenticated users within their scope; creating/deleting is system-side / admin-only.

Typical kinds

Area Examples
Downtime downtime_started, downtime_ended, downtime_object_added
Maintenance maintenance_scheduled, maintenance_started, maintenance_ended
Incident incident_created, incident_status_changed, incident_downtime_linked
Notifications notification_sent, notification_send_failed
Notes note_created, note_reply, note_resolved
Workspace workspace-sync, ssh-session

Automatic generation

  • Lifecycle hooks on Downtime / Maintenance / Incident
  • Central hook: every sent notification creates an Activity on the source object
  • No more compiled JSON cache — the tab reads the Activity API directly

Where it is visible

  • Downtime, Maintenance, Incident and Workspace dashboards (Timeline tab)
  • Object-class icons instead of generic up/down circles
  • Optionally linked Alerts tabs on Downtime/Maintenance

Related topics