8 Prädiktive Funktionen

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

• Auslöser-Ausdrücken
• Berechneten Datenpunkten
• Ausdrucks-Makros

Die Funktionen sind ohne zusätzliche Informationen aufgeführt. 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 die Historie des Host-Datenpunkts beziehen
• (sec|#num)<:time shift> ist ein gemeinsamer zweiter Parameter für die Funktionen, die sich auf die Historie des Host-Datenpunkts beziehen, wobei:
  • sec - maximaler Auswertungszeitraum in Sekunden (Zeit-Suffixe können verwendet werden), oder
  • #num - maximaler Auswertungsbereich in den zuletzt erfassten Werten (wenn eine Raute vorangestellt ist)
  • time shift (optional) ermöglicht es, den Auswertungszeitpunkt in die Vergangenheit zu verschieben. Siehe weitere Details zur Angabe von time shift.

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, Minimum, Delta oder der Durchschnitt des Datenpunkts.
Unterstützte Wertetypen: Float, Integer.

Parameter:

• Siehe allgemeine Parameter;
  
• time - der Prognosehorizont in Sekunden (Zeitsuffixe können verwendet werden); negative Werte werden unterstützt;
  
• fit (optional; muss in doppelte Anführungszeichen gesetzt werden) - die Funktion, die zum Anpassen 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 gleichbedeutend mit linear ist;
• mode (optional; muss in doppelte Anführungszeichen gesetzt 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.

Kommentare:

• 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 bzw. -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 im Fehlerfall -1 zurückgegeben;
• Siehe auch zusätzliche Informationen zu prädiktiven Auslöserfunktionen.

Beispiele:

forecast(/host/key,#10,1h) #prognostiziert den Datenpunktwert in einer Stunde auf Basis der letzten 10 Werte
forecast(/host/key,1h,30m) #prognostiziert den Datenpunktwert in 30 Minuten auf Basis der Daten der letzten Stunde
forecast(/host/key,1h:now-1d,12h) #prognostiziert den Datenpunktwert in 12 Stunden auf Basis einer Stunde von vor einem Tag
forecast(/host/key,1h,10m,"exponential") #prognostiziert den Datenpunktwert in 10 Minuten auf Basis der Daten der letzten Stunde und einer Exponentialfunktion
forecast(/host/key,1h,2h,"polynomial3","max") #prognostiziert den maximalen Wert, den der Datenpunkt in den nächsten zwei Stunden erreichen kann, auf Basis der Daten der letzten Stunde und eines kubischen Polynoms (dritten Grades)
forecast(/host/key,#2,-20m) #schätzt den Datenpunktwert vor 20 Minuten auf Basis der letzten zwei Werte (dies kann genauer sein als die Verwendung von last(), insbesondere wenn der Datenpunkt selten aktualisiert wird, z. B. einmal pro Stunde)

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

Die in Sekunden benötigte Zeit, bis ein Datenpunkt den angegebenen Schwellenwert erreicht.
Unterstützte Wertetypen: Float, Integer.

Parameter:

• Siehe allgemeine Parameter;
  
• threshold - der zu erreichende Wert (Einheitensuffixe können verwendet werden);
• fit (optional; muss in doppelte Anführungszeichen gesetzt 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 im Fehlerfall -1 zurückgegeben;
• Siehe auch zusätzliche Informationen zu prädiktiven Auslöserfunktionen.

Beispiele:

timeleft(/host/key,#10,0) #die Zeit, bis der Datenpunktwert auf null sinkt, basierend auf den letzten 10 Werten
timeleft(/host/key,1h,100) #die Zeit, bis der Datenpunktwert 100 erreicht, basierend auf den Daten der letzten Stunde
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 der Annahme, dass sich der Datenpunkt wie ein quadratisches Polynom (zweiten Grades) verhält

Siehe alle unterstützten Funktionen.