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.
Picchi dell'ultima ora
Picchi delle ultime 24 ore

Per ogni job

Picchi dell'ultima ora
Picchi delle ultime 24 ore
Tutti i valori del job

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: