Prädiktive Funktionen

Alle hier aufgeführten Funktionen werden unterstützt in:

• Auslöserausdrücken
• Formeln für berechnete Datenpunkte
• Ausdrucksmakros

Die Funktionen werden ohne zusätzliche Informationen aufgelistet. Klicken Sie auf die Funktion, um die vollständigen Details anzuzeigen.

Allgemeine Parameter

• /host/key ist ein gemeinsamer obligatorischer erster Parameter für die Funktionen, die sich auf den Verlauf des Host-Datenpunkts beziehen
• (sec|#num)<:time shift> ist ein gemeinsamer zweiter Parameter für die Funktionen, die sich auf den Verlauf des Host-Datenpunkts beziehen, wobei:
  • sec - maximale Auswertungsperiode in Sekunden (Zeit-Suffixe können verwendet werden), oder
  • #num - maximaler Auswertungsbereich in den zuletzt erfassten Werten (wenn ein Hash-Zeichen davor steht)
  • time shift (optional) ermöglicht es, den Auswertungspunkt in der Zeit zurückzuverschieben. Weitere Details zur Angabe von time shift finden Sie hier.

Funktionsdetails

Einige allgemeine Hinweise zu Funktionsparametern:

• Funktionsparameter werden durch ein Komma getrennt
• Optionale Funktionsparameter (oder Parameterteile) werden durch < > angegeben
• Funktionsspezifische Parameter werden bei jeder Funktion beschrieben
• Die Parameter /host/key und (sec|#num)<:time shift> dürfen niemals in Anführungszeichen gesetzt werden

forecast(/host/key,(sec|#num)<:time shift>,time,<fit>,<mode>)

Der zukünftige Wert, das Maximum, das Minimum, die Differenz oder der Durchschnitt des Datenpunkts.
Unterstützte Werttypen: Float, Integer.

Parameter:

• Siehe allgemeine Parameter;
  
• time - der Prognosezeitraum in Sekunden (z. B. 1, 60) (Zeitsuffixe können verwendet werden (z. B. 30s, 1m)); negative Werte werden unterstützt;
  
• fit (optional; muss in doppelte Anführungszeichen eingeschlossen werden) - die Funktion, die zur Anpassung historischer Daten verwendet wird. Unterstützte Anpassungen:
  linear - lineare Funktion (Standard)
  polynomialN - Polynom vom Grad N (1 <= N <= 6)
  exponential - Exponentialfunktion
  logarithmic - logarithmische Funktion
  power - Potenzfunktion
  Beachten Sie, dass polynomial1 linear entspricht;
• mode (optional; muss in doppelte Anführungszeichen eingeschlossen werden) - die gewünschte Ausgabe. Unterstützte Modi:
  value - Wert (Standard)
  max - Maximum
  min - Minimum
  delta - max-min
  avg - Durchschnitt
  Beachten Sie, dass value den Datenpunktwert zum Zeitpunkt now + time schätzt; max, min, delta und avg untersuchen die Schätzung des Datenpunktwerts im Intervall zwischen now und now + time.

Hinweise:

• Wenn der zurückzugebende Wert größer als 1.7976931348623158E+308 oder kleiner als -1.7976931348623158E+308 ist, wird der Rückgabewert entsprechend auf 1.7976931348623158E+308 oder -1.7976931348623158E+308 begrenzt;
• Wird nur dann nicht unterstützt, wenn die Funktion im Ausdruck falsch verwendet wird (falscher Datenpunkttyp, ungültige Parameter); andernfalls wird bei Fehlern -1 zurückgegeben;
• Weitere Informationen finden Sie unter prädiktiven Auslöserfunktionen.

Beispiele:

forecast(/host/key,#10,1h) #Prognose des Datenpunktwerts in einer Stunde basierend auf den letzten 10 Werten
forecast(/host/key,1h,30m) #Prognose des Datenpunktwerts in 30 Minuten basierend auf den Daten der letzten Stunde
forecast(/host/key,1h:now-1d,12h) #Prognose des Datenpunktwerts in 12 Stunden basierend auf einer Stunde Daten von vor einem Tag
forecast(/host/key,1h,10m,"exponential") #Prognose des Datenpunktwerts in 10 Minuten basierend auf den Daten der letzten Stunde und einer Exponentialfunktion
forecast(/host/key,1h,2h,"polynomial3","max") #Prognose des maximalen Werts, den der Datenpunkt in den nächsten zwei Stunden erreichen kann, basierend auf den Daten der letzten Stunde und einem kubischen Polynom (dritten Grades)
forecast(/host/key,#2,-20m) #Schätzung des Datenpunktwerts vor 20 Minuten basierend auf den letzten beiden Werten (dies kann genauer sein als die Verwendung von last(), insbesondere wenn der Datenpunkt selten aktualisiert wird, beispielsweise einmal pro Stunde)

timeleft(/host/key,(sec|#num)<:time shift>,threshold,<fit>)

Die Zeit in Sekunden, die ein Datenpunkt benötigt, um den angegebenen Schwellenwert zu erreichen.
Unterstützte Werttypen: Float, Integer.

Parameter:

• Siehe allgemeine Parameter;
  
• threshold - der zu erreichende Wert (Einheiten-Suffixe können verwendet werden);
• fit (optional; muss in doppelte Anführungszeichen eingeschlossen werden) - siehe forecast().

Kommentare:

• Wenn der zurückzugebende Wert größer als 1.7976931348623158E+308 ist, wird der Rückgabewert auf 1.7976931348623158E+308 begrenzt;
• Gibt 1.7976931348623158E+308 zurück, wenn der Schwellenwert nicht erreicht werden kann;
• Wird nur dann nicht unterstützt, wenn die Funktion im Ausdruck falsch verwendet wird (falscher Datenpunkttyp, ungültige Parameter); andernfalls wird bei Fehlern -1 zurückgegeben;
• Siehe auch zusätzliche Informationen zu prädiktiven Auslöserfunktionen.

Beispiele:

timeleft(/host/key,#10,0) #die Zeit, bis der Datenpunktwert basierend auf den letzten 10 Werten null erreicht
timeleft(/host/key,1h,100) #die Zeit, bis der Datenpunktwert basierend auf den Daten der letzten Stunde 100 erreicht
timeleft(/host/key,1h:now-1d,100) #die Zeit, bis der Datenpunktwert 100 erreicht, basierend auf einer Stunde Daten von vor einem Tag
timeleft(/host/key,1h,200,"polynomial2") #die Zeit, bis der Datenpunktwert 200 erreicht, basierend auf den Daten der letzten Stunde und unter der Annahme, dass sich der Datenpunkt wie ein quadratisches Polynom (Polynom zweiten Grades) verhält

Siehe alle unterstützten Funktionen.