Instrukcje: używanie interfejsu API bezwariancji Narzędzie do wykrywania anomalii na danych szeregów czasowych
Ważne
Od 20 września 2023 r. nie będzie można tworzyć nowych zasobów Narzędzie do wykrywania anomalii. Usługa Narzędzie do wykrywania anomalii jest wycofywana 1 października 2026 r.
Interfejs API Narzędzie do wykrywania anomalii udostępnia dwie metody wykrywania anomalii. Możesz wykryć anomalie jako partię w ciągu szeregu czasowego lub w miarę generowania danych, wykrywając stan anomalii najnowszego punktu danych. Model wykrywania zwraca wyniki anomalii wraz z oczekiwaną wartością każdego punktu danych oraz górne i dolne granice wykrywania anomalii. Tych wartości można użyć do wizualizacji zakresu wartości normalnych i anomalii w danych.
Tryby wykrywania anomalii
Interfejs API Narzędzie do wykrywania anomalii zapewnia tryby wykrywania: wsadowe i przesyłane strumieniowo.
Uwaga
Następujące adresy URL żądań muszą zostać połączone z odpowiednim punktem końcowym dla subskrypcji. Na przykład: https://<your-custom-subdomain>.api.cognitive.microsoft.com/anomalydetector/v1.0/timeseries/entire/detect.
Wykrywanie wsadowe
Aby wykryć anomalie w całej partii punktów danych w danym zakresie czasu, użyj następującego identyfikatora URI żądania z danymi szeregów czasowych:
/timeseries/entire/detect.
Wysyłając dane szeregów czasowych jednocześnie, interfejs API wygeneruje model przy użyciu całej serii i analizuje poszczególne punkty danych.
Wykrywanie przesyłania strumieniowego
Aby stale wykrywać anomalie danych przesyłanych strumieniowo, użyj następującego identyfikatora URI żądania z najnowszym punktem danych:
/timeseries/last/detect.
Wysyłając nowe punkty danych podczas ich generowania, możesz monitorować dane w czasie rzeczywistym. Model zostanie wygenerowany przy użyciu wysyłanych punktów danych, a interfejs API określi, czy ostatni punkt w szeregach czasowych jest anomalią.
Dostosowywanie dolnych i górnych granic wykrywania anomalii
Domyślnie górne i dolne granice wykrywania anomalii są obliczane przy użyciu wartości expectedValue, upperMargini lowerMargin. Jeśli potrzebujesz różnych granic, zalecamy zastosowanie elementu marginScale do elementu upperMargin lub lowerMargin. Granice zostaną obliczone w następujący sposób:
| Granica | Obliczenia |
|---|---|
upperBoundary |
expectedValue + (100 - marginScale) * upperMargin |
lowerBoundary |
expectedValue - (100 - marginScale) * lowerMargin |
W poniższych przykładach pokazano wynik interfejsu API Narzędzie do wykrywania anomalii z różnymi poufnościami.
Przykład z poufnością na poziomie 99
Przykład z poufnością na poziomie 95
Przykład z poufnością na poziomie 85
