8 Funzioni predittive

Tutte le funzioni elencate qui sono supportate in:

• Espressioni di trigger
• Item calcolati
• Macro di espressione

Le funzioni sono elencate senza informazioni aggiuntive. Fare clic sulla funzione per visualizzare i dettagli completi.

Parametri comuni

• /host/key è un primo parametro comune obbligatorio per le funzioni che fanno riferimento alla cronologia dell'item dell'host
• (sec|#num)<:time shift> è un secondo parametro comune per le funzioni che fanno riferimento alla cronologia dell'item dell'host, dove:
  • sec - periodo massimo di valutazione in secondi (è possibile usare i suffissi temporali), oppure
  • #num - intervallo di valutazione massimo nei valori raccolti più recenti (se preceduto da un cancelletto)
  • time shift (facoltativo) consente di spostare all'indietro nel tempo il punto di valutazione. Vedere maggiori dettagli sulla specifica del time shift.

Dettagli della funzione

Alcune note generali sui parametri della funzione:

• I parametri della funzione sono separati da una virgola
• I parametri opzionali della funzione (o parti di parametro) sono indicati da < >
• I parametri specifici della funzione sono descritti con ciascuna funzione
• I parametri /host/key e (sec|#num)<:time shift> non devono mai essere racchiusi tra virgolette

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

Il valore futuro, massimo, minimo, delta o medio dell'item.
Tipi di valore supportati: Float, Integer.

Parametri:

• Vedere i parametri comuni;
  
• time - l'orizzonte di previsione in secondi (ad es. 1, 60) (è possibile utilizzare i suffissi temporali (ad es. 30s, 1m)); sono supportati valori negativi;
  
• fit (facoltativo; deve essere racchiuso tra virgolette doppie) - la funzione utilizzata per adattare i dati storici. Adattamenti supportati:
  linear - funzione lineare (predefinita)
  polynomialN - polinomio di grado N (1 <= N <= 6)
  exponential - funzione esponenziale
  logarithmic - funzione logaritmica
  power - funzione potenza
  Nota: polynomial1 equivale a linear;
• mode (facoltativo; deve essere racchiuso tra virgolette doppie) - l'output richiesto. Modalità supportate:
  value - valore (predefinita)
  max - massimo
  min - minimo
  delta - max-min
  avg - media
  Nota: value stima il valore dell'item al momento now + time; max, min, delta e avg analizzano la stima del valore dell'item nell'intervallo tra now e now + time.

Commenti:

• Se il valore da restituire è maggiore di 1.7976931348623158E+308 o minore di -1.7976931348623158E+308, il valore restituito viene limitato rispettivamente a 1.7976931348623158E+308 o -1.7976931348623158E+308;
• Diventa non supportato solo se utilizzato in modo errato nell'espressione (tipo di item errato, parametri non validi); in caso contrario restituisce -1 in caso di errori;
• Vedere anche le informazioni aggiuntive sulle funzioni trigger predittive.

Esempi:

forecast(/host/key,#10,1h) #prevede il valore dell'item tra un'ora in base agli ultimi 10 valori
forecast(/host/key,1h,30m) #prevede il valore dell'item tra 30 minuti in base ai dati dell'ultima ora
forecast(/host/key,1h:now-1d,12h) #prevede il valore dell'item tra 12 ore in base a un'ora di dati risalenti a un giorno prima
forecast(/host/key,1h,10m,"exponential") #prevede il valore dell'item tra 10 minuti in base ai dati dell'ultima ora e alla funzione esponenziale
forecast(/host/key,1h,2h,"polynomial3","max") #prevede il valore massimo che l'item può raggiungere nelle due ore successive in base ai dati dell'ultima ora e al polinomio cubico (di terzo grado)
forecast(/host/key,#2,-20m) #stima il valore dell'item di 20 minuti fa in base agli ultimi due valori (può essere più preciso rispetto all'utilizzo di last(), soprattutto se l'item viene aggiornato raramente, ad esempio una volta all'ora)

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

Il tempo in secondi necessario affinché un item raggiunga la soglia specificata.
Tipi di valore supportati: Float, Integer.

Parametri:

• Vedi parametri comuni;
  
• threshold - il valore da raggiungere (è possibile usare i suffissi di unità);
• fit (opzionale; deve essere tra virgolette doppie) - vedi forecast().

Commenti:

• Se il valore da restituire è maggiore di 1.7976931348623158E+308, il valore restituito viene limitato a 1.7976931348623158E+308;
• Restituisce 1.7976931348623158E+308 se la soglia non può essere raggiunta;
• Diventa unsupported solo se usata in modo errato nell'espressione (tipo di item errato, parametri non validi), altrimenti restituisce -1 in caso di errori;
• Vedi anche le informazioni aggiuntive sulle funzioni predittive dei trigger.

Esempi:

timeleft(/host/key,#10,0) #il tempo fino a quando il valore dell'item raggiunge zero in base agli ultimi 10 valori
timeleft(/host/key,1h,100) #il tempo fino a quando il valore dell'item raggiunge 100 in base ai dati dell'ultima ora
timeleft(/host/key,1h:now-1d,100) #il tempo fino a quando il valore dell'item raggiunge 100 in base a un'ora di dati di un giorno fa
timeleft(/host/key,1h,200,"polynomial2") #il tempo fino a quando il valore dell'item raggiunge 200 in base ai dati dell'ultima ora e all'ipotesi che l'item si comporti come un polinomio quadratico (di secondo grado)

Vedi tutte le funzioni supportate.