Útmutató: Az anomáliadetektor univariate API használata az idősoradatokon
Fontos
2023. szeptember 20-tól nem hozhat létre új anomáliadetektor erőforrásokat. A anomáliadetektor szolgáltatás 2026. október 1-jén megszűnik.
A anomáliadetektor API két anomáliadetektálási módszert biztosít. Az idősorok során kötegként is észlelheti az anomáliákat, vagy az adatok a legújabb adatpont rendellenességi állapotának észlelésével jönnek létre. Az észlelési modell az egyes adatpont várt értékével, valamint a felső és alsó anomáliadetektálási határokkal együtt anomáliadetektálási eredményeket ad vissza. Ezekkel az értékekkel megjelenítheti a normál értékek tartományát és az adatok rendellenességeit.
Anomáliadetektálási módok
A anomáliadetektor API észlelési módokat biztosít: köteg és streamelés.
Feljegyzés
A következő kérelem URL-címeit össze kell kapcsolni az előfizetés megfelelő végpontjával. Például: https://<your-custom-subdomain>.api.cognitive.microsoft.com/anomalydetector/v1.0/timeseries/entire/detect
Kötegészlelés
Ha az adatpontok kötegében egy adott időtartományon keresztül szeretné észlelni az anomáliákat, használja a következő kérelem URI-ját az idősoradatokkal:
/timeseries/entire/detect
.
Az idősoradatok egyidejű elküldésével az API létrehoz egy modellt a teljes adatsor használatával, és elemzi az egyes adatpontokat.
Streamészlelés
A streamelési adatok rendellenességeinek folyamatos észleléséhez használja a következő kérés URI-t a legújabb adatponttal:
/timeseries/last/detect
.
Ha új adatpontokat küld a létrehozásuk során, valós időben figyelheti az adatokat. A rendszer létrehoz egy modellt az elküldött adatpontokkal, és az API megállapítja, hogy az idősor legújabb pontja anomália-e.
Alsó és felső anomáliadetektálási határok beállítása
Alapértelmezés szerint az anomáliadetektáláshoz használt felső és alsó határokat a rendszer az expectedValue
, upperMargin
és lowerMargin
az . Ha eltérő határokra van szüksége, javasoljuk, hogy alkalmazza marginScale
a vagy a lowerMargin
értéket. A határokat a következőképpen számítjuk ki:
Határ | Számítás |
---|---|
upperBoundary |
expectedValue + (100 - marginScale) * upperMargin |
lowerBoundary |
expectedValue - (100 - marginScale) * lowerMargin |
Az alábbi példák egy anomáliadetektor API-eredményt mutatnak különböző bizalmassági szinten.