2 Benutzerdefinierte Intervalle

Übersicht

Es ist möglich, benutzerdefinierte Regeln für die Zeiten zu erstellen, zu denen ein Datenpunkt geprüft wird. Dafür gibt es zwei Methoden: Flexible Intervalle, mit denen das Standard-Aktualisierungsintervall neu definiert werden kann, und Zeitplanung, bei der eine Datenpunkt-Prüfung zu einer bestimmten Zeit oder zu einer Folge von Zeiten ausgeführt werden kann.

Flexible Intervalle

Flexible Intervalle ermöglichen es, das Standard-Aktualisierungsintervall für bestimmte Zeiträume neu zu definieren. Ein flexibles Intervall wird mit Intervall und Zeitraum definiert, wobei gilt:

  • Intervall – das Aktualisierungsintervall für den angegebenen Zeitraum. Zeitsuffixe werden unterstützt, z. B. 30s, 1m, 2h, 1d.
  • Zeitraum – der Zeitraum, in dem das flexible Intervall aktiv ist (siehe Zeiträume für eine detaillierte Beschreibung des Formats von Zeitraum)

Wenn sich mehrere flexible Intervalle überschneiden, wird für den überschneidenden Zeitraum der kleinste Intervall-Wert verwendet. Beachten Sie, dass bei einem kleinsten Wert von '0' in sich überschneidenden flexiblen Intervallen keine Abfrage erfolgt. Außerhalb der flexiblen Intervalle wird das Standard-Aktualisierungsintervall verwendet.

Beachten Sie, dass der Datenpunkt genau einmal geprüft wird, wenn das flexible Intervall der Länge des Zeitraums entspricht. Wenn das flexible Intervall größer als der Zeitraum ist, wird der Datenpunkt möglicherweise einmal geprüft oder überhaupt nicht geprüft (daher wird eine solche Konfiguration nicht empfohlen). Wenn das flexible Intervall kleiner als der Zeitraum ist, wird der Datenpunkt mindestens einmal geprüft.

Wenn das flexible Intervall auf '0' gesetzt ist, wird der Datenpunkt während des Zeitraums des flexiblen Intervalls nicht abgefragt und die Abfrage wird nach Ablauf des Zeitraums gemäß dem Standard-Aktualisierungsintervall fortgesetzt. Beispiele:

Intervall Zeitraum Beschreibung
10 1-5,09:00-18:00 Datenpunkt wird während der Arbeitszeit alle 10 Sekunden geprüft.
0 1-7,00:00-7:00 Datenpunkt wird nachts nicht geprüft.
0 7-7,00:00-24:00 Datenpunkt wird sonntags nicht geprüft.
60 1-7,12:00-12:01 Datenpunkt wird jeden Tag um 12:00 geprüft. Beachten Sie, dass dies als Behelfslösung für geplante Prüfungen verwendet wurde; für solche Prüfungen wird die Verwendung von Planungsintervallen empfohlen.

Zeitplanintervalle

Zeitplanintervalle werden verwendet, um Datenpunkte zu bestimmten Zeiten zu prüfen. Während flexible Intervalle dazu dienen, das Standard-Aktualisierungsintervall eines Datenpunkts neu zu definieren, werden Zeitplanintervalle verwendet, um einen unabhängigen Prüfzeitplan festzulegen, der parallel ausgeführt wird.

Ein Zeitplanintervall wird wie folgt definiert: md<filter>wd<filter>h<filter>m<filter>s<filter>, wobei:

  • md - Monatstage
  • wd - Wochentage
  • h - Stunden
  • m - Minuten
  • s – Sekunden

<filter> wird verwendet, um Werte für sein Präfix (Tage, Stunden, Minuten, Sekunden) anzugeben, und ist wie folgt definiert: [<from>[-<to>]][/<step>][,<filter>], wobei:

  • <from> und <to> definieren den Bereich der übereinstimmenden Werte (einschließlich). Wenn <to> weggelassen wird, dann entspricht der Filter einem Bereich <from> - <from>. Wenn auch <from> weggelassen wird, dann entspricht der Filter allen möglichen Werten.
  • <step> definiert die Sprünge des Zahlenwerts innerhalb des Bereichs. Standardmäßig hat <step> den Wert 1, was bedeutet, dass alle Werte des definierten Bereichs übereinstimmen.

Während die Filterdefinitionen optional sind, muss mindestens ein Filter verwendet werden. Ein Filter muss entweder einen Bereich oder den Wert <step> definiert haben.

Ein leerer Filter entspricht entweder '0', wenn kein Filter niedrigerer Ebene definiert ist, oder andernfalls allen möglichen Werten. Wenn zum Beispiel der Stundenfilter weggelassen wird, dann entspricht nur die Stunde '0', vorausgesetzt, Minuten- und Sekundenfilter werden ebenfalls weggelassen; andernfalls entspricht ein leerer Stundenfilter allen Stundenwerten.

Gültige <from>- und <to>-Werte für ihr jeweiliges Filterpräfix sind:

Prefix Beschreibung <from> <to>
md Monatstage 1-31 1-31
wd Wochentage 1-7 1-7
h Stunden 0-23 0-23
m Minuten 0-59 0-59
s Sekunden 0-59 0-59

Der Wert <from> muss kleiner oder gleich dem Wert <to> sein. Der Wert <step> muss größer oder gleich 1 und kleiner oder gleich <to> - <from> sein.

Einstellige Werte für Monatstage, Stunden, Minuten und Sekunden können mit einer führenden 0 versehen werden. Zum Beispiel sind md01-31 und h/02 gültige Intervalle, aber md01-031 und wd01-07 nicht.

Im Zabbix Frontend werden mehrere Zeitplanintervalle in separaten Zeilen eingegeben. In der Zabbix API werden sie zu einer einzelnen Zeichenkette zusammengefügt, wobei ein Semikolon ; als Trennzeichen verwendet wird.

Wenn eine Zeit durch mehrere Intervalle abgedeckt wird, wird sie nur einmal ausgeführt. Zum Beispiel wird wd1h9;h9 am Montag um 9:00 Uhr nur einmal ausgeführt.

Beispiele:

Intervall Wird ausgeführt
m0-59 jede Minute
h9-17/2 alle 2 Stunden beginnend mit 9:00 (9:00, 11:00 ...)
m0,30 or m/30 stündlich um hh:00 und hh:30
m0,5,10,15,20,25,30,35,40,45,50,55 or m/5 alle fünf Minuten
wd1-5h9 jeden Montag bis Freitag um 9:00
wd1-5h9-18 jeden Montag bis Freitag um 9:00,10:00,...,18:00
h9,10,11 or h9-11 jeden Tag um 9:00, 10:00 und 11:00
md1h9m30 jeden 1. Tag jedes Monats um 9:30
md1wd1h9m30 jeden 1. Tag jedes Monats um 9:30, wenn es ein Montag ist
h9m/30 jeden Tag um 9:00, 9:30
h9m0-59/30 jeden Tag um 9:00, 9:30
h9,10m/30 jeden Tag um 9:00, 9:30, 10:00, 10:30
h9-10m30 jeden Tag um 9:30, 10:30
h9m10-40/30 jeden Tag um 9:10, 9:40
h9,10m10-40/30 jeden Tag um 9:10, 9:40, 10:10, 10:40
h9-10m10-40/30 jeden Tag um 9:10, 9:40, 10:10, 10:40
h9m10-40 jeden Tag um 9:10, 9:11, 9:12, ... 9:40
h9m10-40/1 jeden Tag um 9:10, 9:11, 9:12, ... 9:40
h9-12,15 jeden Tag um 9:00, 10:00, 11:00, 12:00, 15:00
h9-12,15m0 jeden Tag um 9:00, 10:00, 11:00, 12:00, 15:00
h9-12,15m0s30 jeden Tag um 9:00:30, 10:00:30, 11:00:30, 12:00:30, 15:00:30
h9-12s30 jeden Tag um 9:00:30, 9:01:30, 9:02:30 ... 12:58:30, 12:59:30
h9m/30;h10 (API-specific syntax) jeden Tag um 9:00, 9:30, 10:00
h9m/30
h10 (add this as another row in frontend)		 jeden Tag um 9:00, 9:30, 10:00
Zeitzonen für Proxys und Agent angleichen

Beachten Sie, dass Zabbix-Proxys und Agent bei der Verarbeitung von Planungsintervallen ihre lokalen Zeitzonen verwenden.

Aus diesem Grund wird empfohlen, bei Planungsintervallen, die auf Datenpunkte angewendet werden, die von einem Zabbix Proxy überwacht werden, oder auf aktive Agent-Datenpunkte, die Zeitzone der jeweiligen Proxys oder des Agent auf dieselbe wie die des Zabbix Server festzulegen. Andernfalls kann die queue Verzögerungen von Datenpunkten falsch melden.

Die Zeitzone für Zabbix Proxy oder Agent kann über die Umgebungsvariable TZ in der systemd-Unit-Datei festgelegt werden:

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