Fonctions prédictives

Toutes les fonctions répertoriées ici sont prises en charge dans :

• Expressions de déclencheur
• Formules d'élément calculé
• Macros d'expression

Les fonctions sont répertoriées sans information supplémentaire. Cliquez sur la fonction pour afficher les détails complets.

Paramètres communs

• /host/key est un premier paramètre commun obligatoire pour les fonctions faisant référence à l'historique de l'élément de l'hôte
• (sec|#num)<:time shift> est un deuxième paramètre commun pour les fonctions faisant référence à l'historique de l'élément de l'hôte, où :
  • sec - période d'évaluation maximale en secondes (des suffixes de temps peuvent être utilisés), ou
  • #num - plage d'évaluation maximale dans les dernières valeurs collectées (si précédé d'un dièse)
  • time shift (facultatif) permet de déplacer le point d'évaluation dans le passé. Voir plus de détails sur la spécification du time shift.

Détails des fonctions

Quelques remarques générales sur les paramètres des fonctions :

• Les paramètres des fonctions sont séparés par une virgule
• Les paramètres de fonction facultatifs (ou parties de paramètres) sont indiqués par < >
• Les paramètres spécifiques à chaque fonction sont décrits avec chaque fonction
• Les paramètres /host/key et (sec|#num)<:time shift> ne doivent jamais être entre guillemets

forecast(/hôte/key,(sec|#num)<:décalage temporel>,time,<fit>,<mode>)

La valeur future, maximale, minimale, la différence ou la moyenne de l'élément.
Types de valeurs pris en charge : Float, Integer.

Paramètres :

• Voir les paramètres communs ;
  
• time - l'horizon de prévision en secondes (par exemple, 1, 60) (les suffixes de temps peuvent être utilisés (par exemple, 30s, 1m)) ; les valeurs négatives sont prises en charge ;
  
• fit (facultatif ; doit être placé entre guillemets doubles) - la fonction utilisée pour ajuster les données historiques. Ajustements pris en charge :
  linear - fonction linéaire (par défaut)
  polynomialN - polynôme de degré N (1 <= N <= 6)
  exponential - fonction exponentielle
  logarithmic - fonction logarithmique
  power - fonction puissance
  Notez que polynomial1 est équivalent à linear ;
• mode (facultatif ; doit être placé entre guillemets doubles) - le résultat demandé. Modes pris en charge :
  value - valeur (par défaut)
  max - maximum
  min - minimum
  delta - max-min
  avg - moyenne
  Notez que value estime la valeur de l'élément au moment now + time ; max, min, delta et avg évaluent l'estimation de la valeur de l'élément sur l'intervalle entre now et now + time.

Commentaires :

• Si la valeur à retourner est supérieure à 1.7976931348623158E+308 ou inférieure à -1.7976931348623158E+308, la valeur retournée est limitée respectivement à 1.7976931348623158E+308 ou -1.7976931348623158E+308 ;
• Devient non pris en charge uniquement en cas de mauvaise utilisation dans l'expression (type d'élément incorrect, paramètres non valides) ; sinon, retourne -1 en cas d'erreur ;
• Consultez également les informations supplémentaires sur les fonctions de déclencheur prédictives.

Exemples :

forecast(/hôte/key,#10,1h) #prévoir la valeur de l'élément dans une heure sur la base des 10 dernières valeurs
forecast(/hôte/key,1h,30m) #prévoir la valeur de l'élément dans 30 minutes sur la base des données de la dernière heure
forecast(/hôte/key,1h:now-1d,12h) #prévoir la valeur de l'élément dans 12 heures sur la base des données d'une heure datant d'un jour
forecast(/hôte/key,1h,10m,"exponential") #prévoir la valeur de l'élément dans 10 minutes sur la base des données de la dernière heure et d'une fonction exponentielle
forecast(/hôte/key,1h,2h,"polynomial3","max") #prévoir la valeur maximale que l'élément peut atteindre au cours des deux prochaines heures sur la base des données de la dernière heure et d'un polynôme cubique (du troisième degré)
forecast(/hôte/key,#2,-20m) #estimer la valeur de l'élément il y a 20 minutes sur la base des deux dernières valeurs (cela peut être plus précis que l'utilisation de last(), en particulier si l'élément est mis à jour rarement, par exemple une fois par heure)

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

Le temps en secondes nécessaire pour qu’un élément de données atteigne le seuil spécifié.
Types de valeurs pris en charge : Float, Integer.

Paramètres :

• Voir les paramètres communs ;
  
• threshold - la valeur à atteindre (les suffixes d’unité peuvent être utilisés) ;
• fit (facultatif ; doit être entre guillemets doubles) - voir forecast().

Commentaires :

• Si la valeur à renvoyer est supérieure à 1.7976931348623158E+308, la valeur renvoyée est ramenée à 1.7976931348623158E+308 ;
• Renvoie 1.7976931348623158E+308 si le seuil ne peut pas être atteint ;
• Devient non pris en charge uniquement en cas d’utilisation incorrecte dans l’expression (type d’élément de données incorrect, paramètres invalides), sinon renvoie -1 en cas d’erreurs ;
• Voir également les informations supplémentaires sur les fonctions de déclencheur prédictives.

Exemples :

timeleft(/host/key,#10,0) #le temps jusqu’à ce que la valeur de l’élément de données atteigne zéro sur la base des 10 dernières valeurs
timeleft(/host/key,1h,100) #le temps jusqu’à ce que la valeur de l’élément de données atteigne 100 sur la base des données de la dernière heure
timeleft(/host/key,1h:now-1d,100) #le temps jusqu’à ce que la valeur de l’élément de données atteigne 100 sur la base d’une heure de données il y a un jour
timeleft(/host/key,1h,200,"polynomial2") #le temps jusqu’à ce que la valeur de l’élément de données atteigne 200 sur la base des données de la dernière heure et de l’hypothèse que l’élément se comporte comme un polynôme quadratique (du second degré)

Voir toutes les fonctions prises en charge.