Overview

    Flexible intervals

    Flexible intervals allow to redefine the default update interval for specific time periods. A flexible interval is defined with Interval and Period where:

    • Interval – the update interval for the specified time period

    • Period – the time period when the flexible interval is active (see the for detailed description of the Period format)

    Up to seven flexible intervals can be defined. If multiple flexible intervals overlap, the smallest Interval value is used for the overlapping period. Note that if the smallest value of overlapping flexible intervals is ‘0’, no polling will take place. Outside the flexible intervals the default update interval is used.

    Note that if the flexible interval equals the length of the period, the item will be checked exactly once. If the flexible interval is greater than the period, the item might be checked once or it might not be checked at all (thus such configuration is not advisable). If the flexible interval is less than the period, the item will be checked at least once.

    If the flexible interval is set to ‘0’, the item is not polled during the flexible interval period and resumes polling according to the default Update interval once the period is over. Examples:

    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.

    • md - month days

    • h - hours

    • m - minutes

    • s – seconds

    <filter> is used to specify values for its prefix (days, hours, minutes, seconds) and is defined as: [<from>[-<to>]][/<step>][,<filter>] where:

    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:

    The <from> value must be less or equal to <to> value. The value must be greater or equal to 1 and less or equal to <to> - <from>.

    Single digit month days, hours, minutes and seconds values can be prefixed with 0. For example md01-31 and h/02 are valid intervals, but md01-031 and wd01-07 are not.

    In Zabbix frontend, multiple ​scheduling intervals ​are entered in separate rows. In Zabbix API, they are concatenated into a single string ​with a semicolon ​as a separator.

    If a time is matched by several intervals it is executed only once. For example, wd1h9;h9 will be executed only once on Monday at 9am.

    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.