Calculer
Fonction | Calculer de nouvelles valeurs en combinant ou en agrégeant d'autres mesures de tâches SKOOR à l'aide de scripts Python. Un ou plusieurs filtres peuvent être configurés pour rechercher des tâches par type, nom, propriétés personnalisées ou autres critères. Toutes les valeurs de retour ou valeurs agrégées des tâches filtrées peuvent être utilisées pour le calcul |
|---|---|
Alarmes | Temps d'exécution, Temps de script, Code d'erreur, Valeur de retour <0-n>, Valeur de chaîne <0-n>, Nombre de tâches <0-n> |
Les tâches Calculate ne peuvent être créées ou modifiées que par des utilisateurs de type Administrator, car elles permettent d'exécuter du code arbitraire sur le collecteur SKOOR ou le server (dans le cas de collector-local).
L'exécutable ou le code saisi dans la zone de texte en ligne est exécuté avec les autorisations de l'utilisateur eranger. Par conséquent, seules des commandes limitées peuvent être exécutées, sauf si l'administrateur Linux (root) autorise des commandes supplémentaires à l'aide de sudo, par exemple.
Détails de Calculate
Comme les tâches Calculate s'exécutent sur le server et exploitent les mesures d'autres tâches, aucun collecteur n'est utilisé pour l'exécution. Le collecteur sélectionné dans la section Job Execution n'a pas d'importance
Pour calculer une valeur, au moins une tâche SKOOR existante doit être sélectionnée sur le système. À partir de cette ou ces tâches, toutes les valeurs de retour peuvent être utilisées pour le calcul.
Tout d'abord, un objet parent doit être sélectionné pour les filtres de recherche. Cliquez sur le bouton Browse et sur la liste déroulante à côté de Search below pour définir l'objet parent. Cliquez sur le bouton + près de Filter 1 pour ajouter d'autres filtres si nécessaire :
Ajoutez ou supprimez des critères de filtre à l'aide des boutons + / - d'un filtre. Dans l'exemple ci-dessous, toutes les tâches Execute sont recherchées avec la propriété personnalisée Kanton définie sur Zurich :
Pour chaque filtre, le type de valeurs doit maintenant être sélectionné à l'aide de la liste déroulante Values for script . Les options suivantes sont disponibles :
Catégorie | Type |
Agrégé | Moyenne, min, max, etc. |
Pour chaque tâche | Pics de la dernière heure |
Enfin, cliquez sur refresh à côté de la liste déroulante Values pour remplir le menu avec les valeurs disponibles issues des tâches filtrées et sélectionnez dans la liste déroulante l'une des valeurs qui sera alors disponible pour le calcul :
Script en ligne
Cette section constitue la partie principale de la configuration de la tâche Calculate. Maintenant que les valeurs de la tâche ont été sélectionnées, un script Python doit être créé pour les traiter. Cliquez sur le bouton d'information dans le coin supérieur droit de la section Job Parameters pour ouvrir la page d'aide contenant des exemples de scripts :
Dans la définition de la tâche, un modèle de script est fourni. Ce script contient la variable data avec tous les résultats des tâches filtrées, formatés en JSON. Cette chaîne JSON ressemble à la suivante, selon le type de valeur et la valeur de retour sélectionnés (légèrement modifiée pour plus de lisibilité) :
{
"arguments": [],
"thisJob": {
"type": "jobInfo",
"jobId": 4769,
"jobType": 10,
"jobTypeName": "calculate",
"jobState": 0,
"jobStateName": "Undefined",
"lastTs": 0,
"values": {}
},
"results": [
{
"type": "jobAggregateValues",
"filter": 1,
"value": "return_value1",
"count": 43,
"average": -24882040.997674418,
"max": 24648.0,
"min": -1070000000.0
}
],
"info": [
{
"filter": 0,
"warning": false
}
]
}
Élément JSON | Description |
|---|---|
arguments | Tableau d'arguments ajoutés au script. Aucun n'a été ajouté dans l'exemple ci-dessus |
thisJob | Données de la tâche Calculate elle-même |
results | Valeurs des tâches résultantes par filtre. Elles seront utilisées pour le calcul |
info | Informations supplémentaires sur la tâche. Message Warning si, par exemple, aucune tâche n'est trouvée par une définition de filtre |
Comme décrit également dans la page d'information/d'aide de la tâche, la ligne de code Python suivante permet de placer les valeurs dans les valeurs de retour SKOOR de la tâche Calculate (l'exemple correspond au JSON ci-dessus) :
setErangerValues(data["results"][0]["average"],data["results"][0]["max"],data["results"][0]["min"])
Les fonctions requises pour affecter les valeurs de résultat SKOOR sont disponibles dans la liste déroulante Tags . Ajoutez les arguments et les valeurs de retour sous le champ Inline script de la configuration :




