Procedura: Usare l'API univariata Rilevamento anomalie nei dati delle serie temporali
Importante
A partire dal 20 settembre 2023 non sarà possibile creare nuove risorse Rilevamento anomalie. Il servizio Rilevamento anomalie viene ritirato il 1° ottobre 2026.
L'API Rilevamento anomalie fornisce due metodi di rilevamento anomalie. È possibile rilevare anomalie come batch in tutta la serie temporale oppure quando i dati vengono generati rilevando lo stato anomalie del punto dati più recente. Il modello di rilevamento restituisce i risultati delle anomalie insieme al valore previsto di ogni punto dati e ai limiti di rilevamento anomalie superiore e inferiore. è possibile usare questi valori per visualizzare l'intervallo di valori normali e le anomalie nei dati.
Modalità di rilevamento anomalie
L'API Rilevamento anomalie fornisce modalità di rilevamento: batch e streaming.
Nota
Gli URL di richiesta seguenti devono essere combinati con l'endpoint appropriato per la sottoscrizione. Ad esempio: https://<your-custom-subdomain>.api.cognitive.microsoft.com/anomalydetector/v1.0/timeseries/entire/detect
Rilevamento in batch
Per rilevare anomalie in un batch di punti dati in un determinato intervallo di tempo, usare l'URI della richiesta seguente con i dati delle serie temporali:
/timeseries/entire/detect
.
Inviando i dati delle serie temporali contemporaneamente, l'API genererà un modello usando l'intera serie e analizzerà ogni punto dati con esso.
Rilevamento di streaming
Per rilevare continuamente anomalie sui dati di streaming, usare l'URI di richiesta seguente con il punto dati più recente:
/timeseries/last/detect
.
Inviando nuovi punti dati durante la loro generazione, è possibile monitorare i dati in tempo reale. Verrà generato un modello con i punti dati inviati e l'API determinerà se l'ultimo punto della serie temporale è un'anomalia.
Regolazione dei limiti di rilevamento anomalie inferiore e superiore
Per impostazione predefinita, i limiti superiori e inferiori per il rilevamento anomalie vengono calcolati usando expectedValue
, upperMargin
e lowerMargin
. Se sono necessari limiti diversi, è consigliabile applicare un marginScale
oggetto a upperMargin
o lowerMargin
. I limiti verranno calcolati nel modo seguente:
Limite | Calcolo |
---|---|
upperBoundary |
expectedValue + (100 - marginScale) * upperMargin |
lowerBoundary |
expectedValue - (100 - marginScale) * lowerMargin |
Gli esempi seguenti mostrano un risultato dell'API Rilevamento anomalie con sensibilità diverse.