Documentation
Table of Contents
8 Fonctions prédictives
Toutes les fonctions répertoriées ici sont prises en charge dans :
Quelques notes générales sur les paramètres de fonction :
- Les paramètres de fonction sont séparés par une virgule
- Les paramètres de fonction optionnels (ou parties de paramètres) sont indiqués par
<> - Les paramètres spécifiques à la fonction sont décrits avec chaque fonction
- Les paramètres
/host/keyet(sec|#num)<:time shift>ne doivent jamais être entre guillemets
Paramètres communs
/host/keyest un premier paramètre commun obligatoire pour les fonctions se référant à l'historique de l'élément d'hôte(sec|#num)<:time shift>est un deuxième paramètre courant pour les fonctions faisant référence à l'historique de l'élément d'hôte, où :- sec - période d'évaluation maximum en secondes (les suffixes peuvent être utilisés), ou
- #num - période d'évaluation maximum en nombre de valeurs collectées (si précédées d'un signe dièse)
- décalage horaire (facultatif) permet de déplacer le point d'évaluation dans le temps. Voir plus de détails sur la spécification du décalage horaire.
Fonctions de prédiction
| FONCTION | ||
|---|---|---|
| Description | Paramètres spécifiques à la fonction | Commentaires |
| forecast (/host/key,(sec|#num)<:time shift>,time,<fit>,<mode>) | ||
| Valeur future, max, min, delta ou moyenne de l'élément. | Voir paramètres communs. time - horizon de prévision en secondes (des suffixes de temps peuvent être utilisés ); les valeurs négatives sont prises en charge fit (facultatif ; doit être entre guillemets doubles) – fonction utilisée pour ajuster les données historiques 'fits pris en charge :modespris en charge :now+timeetnow+time` |
Types de valeurs pris en charge : float, int Si la valeur à renvoyer est supérieure à 1,7976931348623157E+308 ou moins supérieur à -1,7976931348623157E+308, la valeur de retour est réduite à 1,79769313486231 57E+308 ou -1.7976931348623157E+308 en conséquence. N'est plus pris en charge uniquement s'il est mal utilisé dans l'expression (mauvais type d'élément, paramètres invalides), sinon renvoie -1 en cas d'erreurs. Exemples : => forecast(/host/key,#10,1h) → valeur de l'élément de prévision dans une heure sur la base des 10 dernières valeurs => forecast(/host/key,1h,30m) → valeur de l'élément prévue dans 30 minutes sur la base des données de la dernière heure => forecast(/host/key, 1h:now-1d,12h) → valeur de l'élément prévue dans 12 heures sur la base d'une heure il y a un jour => forecast(/host/key,**1h* *,10m,"exponential") → valeur de l'élément de prévision dans 10 minutes en fonction des données de la dernière heure et de la fonction exponentielle => forecast(/host/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 du polynôme cubique (troisième degré) => forecast (/host/key,#2,-20m) → estimer la valeur de l'élément il y a 20 minutes en se basant sur les deux dernières valeurs (cela peut être plus précis que l'utilisation de last(), surtout si l'élément est rarement mis à jour, disons une fois par heure) Voir aussi des informations supplémentaires sur les fonctions de déclenchement prédictives . |
| timeleft (/host/key,(sec|#num)<:time shift>,threshold,<fit>) | ||
| Temps en secondes nécessaire pour qu'un élément atteigne un seuil spécifié. | Voir paramètres communs. threshold - valeur à atteindre (suffixes d'unité peuvent être utilisés) fit (facultatif ; doit être entre guillemets doubles) – voir forecast() |
Types de valeur pris en charge : float, int Si la valeur à renvoyer est supérieur à 1,7976931348623157E+308, la valeur renvoyée est réduite à 1,7976931348623157E+308. Renvoie 1,7976931348623157E+308 si le seuil ne peut pas être atteint. N'est plus pris en charge uniquement en cas d'utilisation abusive dans le expression (mauvais type d'élément, paramètres invalides), sinon renvoie -1 en cas d'erreur. Exemples : => timeleft(/host/key,#10 ,0) → temps jusqu'à ce que la valeur de l'élément atteigne zéro sur la base des 10 dernières valeurs => timeleft(/host/key,1h,100) → temps jusqu'à ce que la valeur de l'élément atteigne 100 sur la base des données de la dernière heure => timeleft(/host/key,1h:now-1d,100) → temps jusqu'à ce que la valeur de l'élément atteigne 100 sur la base d'une heure il y a un jour => timeleft(/host/key,1h,200,"polynomial2") → temps jusqu'à ce que la valeur de l'élément atteigne 200 sur la base des données de la dernière heure et en supposant que l'élément se comporte comme un polynôme quadratique (deuxième degré) Voir aussi des informations supplémentaires sur les fonctions de déclenchement prédictives. |