Skip to content
Release: Australia · Updated: 2026-05-25 · Official documentation · View source

Configure timeline event configurations

Create or modify timeline event configurations to control which events appear on the security incident timeline.

Before you begin

Role required: sn_si.admin

Procedure

  1. Navigate to Workspaces > Security Incident Response Workspace > Administration.

  2. Select Timeline Event Configuration.

  3. Select New to create a configuration, or open an existing one to modify it.

  4. Fill in the event configuration fields.

    FieldDescription
    NameName of the event as it appears on the timeline.
    DescriptionA brief description of what this event type represents.
    ActiveWhen deselected, events of this type do not appear on the timeline.
    Event TypeSelect Point (single marker at a timestamp) or Range (bar spanning a start and end time).
    Fetch TypeSelect Table (query a table directly) or Script (use a custom script). The form fields change based on this selection.
    IconIcon used to represent this event on the timeline.
    ColorColor used to visually distinguish this event type from others.
    FieldDescription
    Source TableTable from which to retrieve event data.
    SIR Reference FieldField on the source table that links records to a security incident.
    Event Label FieldField to display as the event label on the timeline.
    Additional FilterFilter conditions to restrict which records appear as events.
    Timestamp FieldDate and time field for the position of a point event. Visible when Event Type is Point.
    Start Date and Time FieldDate and time field marking the beginning of a range event. Visible when Event Type is Range.
    End Date and Time FieldDate and time field marking the end of a range event. Visible when Event Type is Range.
    FieldDescription
    ScriptServer-side script that fetches event data. The script field includes commented template code showing the expected format for both point and range events.
  5. Select Save.

  6. Scroll down to the Popover Fields related list.

  7. Select New to add a popover field.

  8. Fill in the popover field details and select Submit.

    FieldDescription
    Admin Event ConfigurationThe parent event configuration this popover field belongs to.
    Source TableAutomatically populated from the event configuration. Read-only.
    Field NameThe field whose value is displayed in the popover.
    LabelDisplay label for this field in the popover.
    Is LinkWhen selected, the field value appears as a clickable link to the related event record.
    OrderSort order in the popover. Lower values appear first.

    Note: For state transition events, the popover automatically displays the state, the previous state (from/to), and the duration. Color coding for each state is fixed and consistent across all timelines.

Parent Topic:Timeline in Security Incident Response Workspace