Schedule a Report Examples - Administrator Guide - 6.9 - Cortex XSOAR - Cortex - Security Operations

Cortex XSOAR Administrator Guide

Product
Cortex XSOAR
Version
6.9
Creation date
2022-09-29
Last date published
2024-03-28
End_of_Life
EoL
Category
Administrator Guide
Abstract

Examples of scheduling a Cortex XSOAR report using Cron expressions. Cron scheduler format.

The following examples describe how to schedule a report using the Cron scheduler format. The Cron time string format consists of five fields that Cron converts into a time interval. For example, a Cron string of 0 10 15 * * runs a report on 15th of each month at 10:00 AM.

Schedule a report starting January 1 and then monthly

In this example, you want to schedule a report for January 1, 2020 at 8:00 AM, and thereafter on the 1st of each month.

In the Cron Expression field, type 00 8 1 1/1 *

Number

Description

00

00 in minutes

8

8 AM

1

The first of each month

1/1

Starting in January, and every month thereafter. If you want the report to start in a different month, change 1/1 to the relevant month, such as 2/1 for February, 3/1 for March and so on.

*

Any day of the week

The reports run at 8:00 AM on January 1, 2020, February 1, 2020, March 1, 2020 and so on.

Note

Cron calculates the next relevant date. If you want the report to run next month, provided that date has passed in the current month, you do not need to specify the month. For example, assume the date is December 12. To run the report on January 11 at 8:00 AM, type 00 8 11 * *. The report starts running on January 11 (and on the 11th of each month, thereafter). If the current date is December 10, the next run date would be December 11.

Schedule a report for once a year

In this example, you want to schedule a report for January 1, 2020 at 8:00 AM, and every year on January 1 (the current date is Thursday, December 12, 2019).

In the Cron Expression field, type 00 8 1 1 *

Number

Description

00

00 minutes

8

8 AM

1

1st day of each month

1

Starting every January. For different months change the number

*

Any day of the week

The report runs at 8:00 AM on January 1, 2020, January 1, 2021, January 1, 2022, and so on.

Schedule a report every week on a Monday

In this example, you need to schedule a report to run at midnight every week on a Monday (the current date is Thursday, December 12, 2019).

Type the following expression in Cron: 00 0 * * 1

Number

Description

00

00 in minutes

0

Midnight

*

Any day

*

Any month

1

Monday

The report runs on the first available Monday, which is December 16 at midnight, and then on December 23, December 30, January 6, and so on.

Schedule a report every weekday from February for 6 months

In this example, you need to schedule a report at 5:30 PM every weekday (Mon–Fri) starting in February for 6 months (assume the current date is Thursday, December 12, 2019).

In the Cron Expression field, type 30 17 * 2/6 1-5

Number

Description

30

30 minutes

17

5 PM

*

Any day

2/6

Starting in February for the next 6 months

1-5

Monday to Friday

The report runs at 5:30 PM on February 3, 4, 5, 6, 7, and so on.

Schedule a daily report

In this example, you need to schedule a report every day at 6:00 AM (the current date is Wednesday, December 12).

In the Cron Expression field, type 0 6 * * *

Number

Description

00

00 in minutes

6

6 AM

*

Any day

*

Any month

*

Any day of the week. If you want to run from Monday to Friday, type 1-5. For Sunday to Thursday, type 0-4.

The report runs at 6 AM on December 13, 14, 15, 16, and so on.