Use timer field commands manually in the CLI - Administrator Guide - Cortex XSIAM - Cortex

Use timer field commands manually in the CLI - Administrator Guide - Cortex XSIAM - Cortex - Security Operations

Cortex XSIAM Documentation

Product

Cortex XSIAM

Creation date

2024-03-06

Last date published

2024-10-10

Category

Administrator Guide

Abstract

Set and change timers for specific alerts, such as decreasing the required response time for a high-priority incident.

You can manage the timers for a specific alert by running commands manually in the CLI. By running CLI command you can to manage timers on a more granular level within specific alerts when the need arises. For example, for a high severity alert you might need to decrease the response time.

Use the setAlert command to set a specific alert due date, or to set a specific timer field in an alert. If you add the sla parameter to the command, it sets the time for the alert's due date. If you also add the slaField you set the timer for the incident field.

Example 21.

To change the Time to Assignment field target to 30 minutes in the current alert, run the following command:

!setAlert sla=30 slaField=timetoassignment

To change the timer to February 1, 2024, at 11.12 am, run the following command:

!setAlert sla=2024-02-01T11:12

Note

When defining the values for the slaField use the machine name for the field, which is lowercase and without spaces. You can check the machine name by editing the alert field.

Run the following commands in the CLI:

Command	Description
`startTimer`	Starts the timer. This command can also be used to restart a paused timer. Example 22. !startTimer timerField=timetoassignnment Note Timer fields are not started automatically when an alert is created unless run in a playbook.
`pauseTimer`	Pauses the timer. Use this command when a timer field has already started. Example 23. !pauseTimer timerField=timetoassignment
`stopTimer`	Stops the timer. Example 24. !stopTimer timerField=timetoassignment Note After a timer field is stopped, before you can start the timer again you must reset the timer using the resetTimer command. Timers are automatically stopped when an alert is closed.
`resetTimer`	Clears all fields for the timer. This command must be used before restarting a timer that was stopped. Example 25. !resetTimer timerField=timetoassignment

Note

When running commands in the CLI, you can specify the alertID to change the timer for a different alert.