Calcola
Funzione | Calcola nuovi valori combinando o aggregando altre misurazioni di job SKOOR tramite script Python. È possibile configurare uno o più filtri per cercare i job per tipo, nome, proprietà personalizzate o altri criteri. Tutti i valori di ritorno o i valori aggregati dei job filtrati possono essere utilizzati per il calcolo |
|---|---|
Allarmi | Tempo di esecuzione, Tempo dello script, Codice di errore, Valore di ritorno <0-n>, Valore stringa <0-n>, Conteggio job <0-n> |
I job Calculate possono essere creati/modificati solo da utenti di tipo Administrator poiché consentono di eseguire codice arbitrario sullo SKOOR Collector o sul server (nel caso del collector locale).
L'eseguibile o il codice inserito nella casella di testo inline viene eseguito con i permessi dell'utente eranger. Pertanto è possibile eseguire solo un numero limitato di comandi, a meno che l'amministratore Linux (root) non abiliti comandi aggiuntivi utilizzando ad es. sudo.
Dettagli Calculate
Poiché i job Calculate vengono eseguiti sul server e lavorano con le misurazioni di altri job, per l'esecuzione non viene utilizzato alcun collector. Il collector selezionato nella sezione Job Execution è irrilevante
Per calcolare un valore, è necessario selezionare almeno un job SKOOR esistente nel sistema. Da questo job o da questi job, tutti i valori di ritorno possono essere utilizzati per il calcolo.
Innanzitutto, è necessario selezionare un oggetto padre per i filtri di ricerca. Fare clic sul pulsante Browse e sul menu a discesa accanto a Search below per definire l'oggetto padre. Fare clic sul pulsante + accanto a Filter 1 per aggiungere altri filtri, se necessario:
Aggiungere o rimuovere criteri di filtro utilizzando i pulsanti + / - di un filtro. Nell'esempio seguente vengono cercati tutti i job Execute con la proprietà personalizzata Kanton impostata su Zurich:
Per ogni filtro, è ora necessario selezionare il tipo di valori utilizzando il menu a discesa Values for script . Sono disponibili le seguenti opzioni:
Categoria | Tipo |
Aggregati | Media, min, max, ecc. |
Per ogni job | Picchi dell'ultima ora |
Infine, fare clic su refresh accanto al menu a discesa Values per popolare il menu con i valori disponibili dai job filtrati e selezionare dal menu a discesa uno dei valori che sarà quindi disponibile per il calcolo:
Script inline
Questa sezione rappresenta la parte principale del lavoro relativo al job Calculate. Ora che i valori del job sono stati selezionati, è necessario creare uno script Python per elaborarli. Fare clic sul pulsante delle informazioni nell'angolo in alto a destra della sezione Job Parameters per aprire la pagina della guida con gli script di esempio:
Nella definizione del job viene fornito uno script modello. Questo script contiene la variabile data con tutti i risultati dei job filtrati, formattati come JSON. Questa stringa JSON ha l'aspetto seguente, a seconda del tipo di valore e del valore di ritorno selezionati (leggermente modificata per leggibilità):
{
"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
}
]
}
Elemento JSON | Descrizione |
|---|---|
arguments | Array di argomenti aggiunti allo script. Nell'esempio precedente non ne è stato aggiunto alcuno |
thisJob | Dati del job Calculate stesso |
results | Valori dei job risultanti per filtro. Questi verranno utilizzati per il calcolo |
info | Informazioni aggiuntive sul job. Messaggio di Warning se, ad esempio, nessun job viene trovato da una definizione di filtro |
Come descritto anche nella pagina delle informazioni/guida del job, con la seguente riga di codice Python è possibile inserire i valori nei valori di ritorno SKOOR del job Calculate (l'esempio corrisponde al JSON precedente):
setErangerValues(data["results"][0]["average"],data["results"][0]["max"],data["results"][0]["min"])
Le funzioni necessarie per assegnare i valori dei risultati SKOOR sono disponibili nel menu a discesa Tags . Aggiungere gli argomenti e i valori di ritorno sotto il campo Inline script della configurazione:




