manual:config:items:item:custom_intervals

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
manual:config:items:item:custom_intervals [2017/01/03 10:43]
martins-v fixing examples and description
manual:config:items:item:custom_intervals [2020/09/17 13:20] (current)
dimir added "Custom intervals correlation" section
Line 1: Line 1:
-==== - #2 Custom intervals ====+==== 2 Custom intervals ====
  
 === Overview === === Overview ===
Line 24: Line 24:
  
 === Scheduling intervals === === Scheduling intervals ===
 +
 Scheduling intervals are used to check items at specific times. While flexible intervals are designed to redefine the default item update interval, the scheduling intervals are used to specify an independent checking schedule, which is executed in parallel. ​ Scheduling intervals are used to check items at specific times. While flexible intervals are designed to redefine the default item update interval, the scheduling intervals are used to specify an independent checking schedule, which is executed in parallel. ​
  
Line 38: Line 39:
  
 While the filter definitions are optional, at least one filter must be used. A filter must either have a range or the //<​step>//​ value defined. While the filter definitions are optional, at least one filter must be used. A filter must either have a range or the //<​step>//​ value defined.
 +
 +An empty filter matches either '​0'​ if no lower-level filter is defined or all possible values otherwise. For example, if the hour filter is omitted then only '​0'​ hour will match, provided minute and seconds filters are omitted too, otherwise an empty hour filter will match all hour values.
  
 Valid ''<​from>''​ and ''<​to>''​ values for their respective filter prefix are:  Valid ''<​from>''​ and ''<​to>''​ values for their respective filter prefix are: 
Line 57: Line 60:
 Examples: Examples:
  
-^Interval^Description+^Interval^Will be executed
-|m0-59|execute ​every minute| +|m0-59|every minute| 
-|h9-17/2|execute ​every 2 hours starting with 9:00 (9:00, 11:00 ...)| +|h9-17/​2|every 2 hours starting with 9:00 (9:00, 11:00 ...)| 
-|m0,30 or m/30|execute ​hourly at hh:00 and hh:30|+|m0,30 or m/30|hourly at hh:00 and hh:30|
 |m0,​5,​10,​15,​20,​25,​30,​35,​40,​45,​50,​55 or m/5|every five minutes| |m0,​5,​10,​15,​20,​25,​30,​35,​40,​45,​50,​55 or m/5|every five minutes|
 |wd1-5h9|every Monday till Friday at 9:00| |wd1-5h9|every Monday till Friday at 9:00|
Line 67: Line 70:
 |md1h9m30|every 1st day of each month at 9:30| |md1h9m30|every 1st day of each month at 9:30|
 |md1wd1h9m30|every 1st day of each month at 9:30 if it is Monday| |md1wd1h9m30|every 1st day of each month at 9:30 if it is Monday|
-|h9m/30|execute ​at 9:00, 9:30| +|h9m/30|every day at 9:00, 9:30| 
-|h9m0-59/​30|execute ​at 9:00, 9:30| +|h9m0-59/​30|every day at 9:00, 9:30| 
-|h9,10m/30|execute ​at 9:00, 9:30, 10:00, 10:30| +|h9,10m/30|every day at 9:00, 9:30, 10:00, 10:30| 
-|h9-10m30|execute ​at 9:30, 10:30| +|h9-10m30|every day at 9:30, 10:30| 
-|h9m10-40/​30|execute ​at 9:10, 9:40| +|h9m10-40/​30|every day at 9:10, 9:40| 
-|h9,​10m10-40/​30|execute ​at 9:10, 9:40, 10:10, 10:40| +|h9,​10m10-40/​30|every day at 9:10, 9:40, 10:10, 10:40| 
-|h9-10m10-40/​30|execute ​at 9:10, 9:40, 10:10, 10:40| +|h9-10m10-40/​30|every day at 9:10, 9:40, 10:10, 10:40| 
-|h9m10-40|execute ​at 9:10, 9:11, 9:12, ... 9:40| +|h9m10-40|every day at 9:10, 9:11, 9:12, ... 9:40| 
-|h9m10-40/​1|execute ​at 9:10, 9:11, 9:12, ... 9:40| +|h9m10-40/​1|every day at 9:10, 9:11, 9:12, ... 9:40| 
-|h9-12,15|execute ​at 9:00, 10:00, 11:00, 12:00, 15:00| +|h9-12,15|every day at 9:00, 10:00, 11:00, 12:00, 15:00| 
-|h9-12,​15m0|execute ​at 9:00, 10:00, 11:00, 12:00, 15:00| +|h9-12,​15m0|every day at 9:00, 10:00, 11:00, 12:00, 15:00| 
-|h9-12,​15m0s30|execute ​at 9:00:30, 10:00:30, 11:00:30, 12:00:30, 15:00:30| +|h9-12,​15m0s30|every day at 9:00:30, 10:00:30, 11:00:30, 12:00:30, 15:00:30| 
-|h9-12s30|execute ​at 9:00:30, 9:01:30, 9:02:30 ... 12:58:30, 12:59:30| +|h9-12s30|every day at 9:00:30, 9:01:30, 9:02:30 ... 12:58:30, 12:59:30| 
-|h9m/​30;​h10|execute ​at 9:00, 9:30, 10:00|+|h9m/​30;​h10 ​(//​API-specific syntax//)|every day at 9:00, 9:30, 10:00| 
 +|h9m/30\\ h10 (//add this as another row in frontend//​)|every day at 9:00, 9:30, 10:00| 
 + 
 +=== Custom intervals correlation === 
 + 
 +Keep in mind that when configuring custom intervals the value of //Update interval// is taken into account. The following table shows correlation between custom intervals and //Update interval//.
  
 +^Update interval^Flexible^Scheduling^Result ​                       ^
 +|0              |        |          |//​Error// ​                    |
 +|0              |non-zero| ​         |Flexible ​                     |
 +|0              |        |non-zero ​ |Scheduling ​                   |
 +|non-zero ​      ​| ​       |          |Update interval ​              |
 +|non-zero ​      ​|non-zero| ​         |Flexible ​                     |
 +|non-zero ​      ​| ​       |non-zero ​ |Update interval and Scheduling|