2 Intervalles personnalisés

Aperçu

Il est possible de créer des règles personnalisées concernant les moments où un élément est vérifié. Les deux méthodes pour cela sont les intervalles flexibles, qui permettent de redéfinir l’intervalle de mise à jour par défaut, et la planification, grâce à laquelle la vérification d’un élément peut être exécutée à une heure précise ou selon une séquence d’heures.

Intervalles flexibles

Les intervalles flexibles permettent de redéfinir l’intervalle de mise à jour par défaut pour des périodes spécifiques. Un intervalle flexible est défini par Interval et Period, où :

• Interval – l’intervalle de mise à jour pour la période spécifiée. Les suffixes de temps sont pris en charge, par exemple 30s, 1m, 2h, 1d.
• Period – la période pendant laquelle l’intervalle flexible est actif (voir les périodes de temps pour une description détaillée du format de Period)

Si plusieurs intervalles flexibles se chevauchent, la plus petite valeur de Interval est utilisée pour la période de chevauchement. Notez que si la plus petite valeur des intervalles flexibles qui se chevauchent est « 0 », aucune interrogation n’aura lieu. En dehors des intervalles flexibles, l’intervalle de mise à jour par défaut est utilisé.

Notez que si l’intervalle flexible est égal à la durée de la période, l’élément sera vérifié exactement une fois. Si l’intervalle flexible est supérieur à la période, l’élément peut être vérifié une fois ou ne pas être vérifié du tout (une telle configuration n’est donc pas recommandée). Si l’intervalle flexible est inférieur à la période, l’élément sera vérifié au moins une fois.

Si l’intervalle flexible est défini sur « 0 », l’élément n’est pas interrogé pendant la période de l’intervalle flexible et reprend l’interrogation selon l’Update interval par défaut une fois la période terminée. Exemples :

Intervalles de planification

Les intervalles de planification sont utilisés pour vérifier les éléments à des moments précis. Alors que les intervalles flexibles sont conçus pour redéfinir l’intervalle de mise à jour par défaut d’un élément, les intervalles de planification servent à spécifier un calendrier de vérification indépendant, exécuté en parallèle.

Un intervalle de planification est défini comme suit : md<filter>wd<filter>h<filter>m<filter>s<filter> où :

• md - jours du mois
• wd - jours de la semaine
• h - heures
• m - minutes
• s – secondes

<filter> est utilisé pour spécifier des valeurs pour son préfixe (jours, heures, minutes, secondes) et est défini comme suit : [<from>[-<to>]][/<step>][,<filter>] où :

• <from> et <to> définissent la plage des valeurs correspondantes (incluses). Si <to> est omis, alors le filtre correspond à une plage <from> - <from>. Si <from> est également omis, alors le filtre correspond à toutes les valeurs possibles.
• <step> définit le pas de progression des valeurs numériques dans la plage. Par défaut, <step> a la valeur 1, ce qui signifie que toutes les valeurs de la plage définie correspondent.

Bien que les définitions de filtre soient facultatives, au moins un filtre doit être utilisé. Un filtre doit soit avoir une plage, soit avoir la valeur <step> définie.

Un filtre vide correspond soit à « 0 » si aucun filtre de niveau inférieur n’est défini, soit à toutes les valeurs possibles dans le cas contraire. Par exemple, si le filtre des heures est omis, seule l’heure « 0 » correspondra, à condition que les filtres des minutes et des secondes soient également omis ; sinon, un filtre d’heures vide correspondra à toutes les valeurs d’heure.

Les valeurs valides de <from> et <to> pour leur préfixe de filtre respectif sont :

La valeur <from> doit être inférieure ou égale à la valeur <to>. La valeur <step> doit être supérieure ou égale à 1 et inférieure ou égale à <to> - <from>.

Les valeurs à un seul chiffre pour les jours du mois, les heures, les minutes et les secondes peuvent être préfixées par 0. Par exemple, md01-31 et h/02 sont des intervalles valides, mais md01-031 et wd01-07 ne le sont pas.

Dans le frontend Zabbix, plusieurs intervalles de planification sont saisis sur des lignes séparées. Dans l’API Zabbix, ils sont concaténés en une seule chaîne avec un point-virgule ; comme séparateur.

Si une heure correspond à plusieurs intervalles, elle n’est exécutée qu’une seule fois. Par exemple, wd1h9;h9 ne sera exécuté qu’une seule fois le lundi à 9h00.

Exemples :

Alignement des fuseaux horaires pour les proxies et l'agent

Notez que les proxies Zabbix et l'agent utilisent leurs fuseaux horaires locaux lors du traitement des intervalles de planification.

Pour cette raison, lorsque des intervalles de planification sont appliqués à des éléments supervisés par un proxy Zabbix ou à des éléments actifs de l'agent, il est recommandé de définir le fuseau horaire des proxies ou de l'agent concernés identique à celui du serveur Zabbix ; sinon, la queue peut signaler incorrectement des retards d'éléments.

Le fuseau horaire du proxy Zabbix ou de l'agent peut être défini à l'aide de la variable d'environnement TZ dans le fichier d'unité systemd :

[Service]
...
Environment="TZ=Europe/Amsterdam"