Docker-tárolók telepítése és futtatása a anomáliadetektor API-hoz

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.

Feljegyzés

A tároló lemezképének helye nemrég megváltozott. Ez a cikk a tároló frissített helyének megtekintéséhez olvassa el.

A tárolók lehetővé teszik, hogy a anomáliadetektor API-t saját környezetében használja. A tárolók kiválóan alkalmasak adott biztonsági és adatszabályozási követelményekhez. Ebből a cikkből megtudhatja, hogyan tölthet le, telepíthet és futtathat anomáliadetektor tárolót.

anomáliadetektor egyetlen Docker-tárolót kínál a helyszíni API használatához. A tároló használatával:

• A anomáliadetektor algoritmusainak használata az adatokon
• Monitorozza a streamelési adatokat, és észlelje a rendellenességek valós időben történő előfordulását.
• Az adatkészletben kötegként észlelt anomáliákat.
• Trendváltozási pontok észlelése kötegként az adatkészletben.
• Állítsa be az anomáliadetektálási algoritmus érzékenységét, hogy jobban illeszkedjen az adatokhoz.

Az API-val kapcsolatos részletes információkért lásd:

• További információ a anomáliadetektor API-szolgáltatásról

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

Előfeltételek

A anomáliadetektor tárolók használata előtt meg kell felelnie a következő előfeltételeknek:

Kötelező	Cél
A Docker-motor	A gazdaszámítógépen telepítve kell lennie a Docker-motornak. A Docker csomagokat biztosít a Docker-környezet konfigurálásához macOS, Windows és Linux rendszereken. A Docker és a tárolók alapszintű ismertetéséért lásd a Docker felhasználói útmutatóját. A Dockert úgy kell konfigurálni, hogy a tárolók kapcsolódhassanak és számlázási adatokat küldjenek az Azure-ba. Windows rendszeren a Dockert úgy is konfigurálnia kell, hogy támogassa a Linux-tárolókat.
A Docker ismerete	Ismernie kell a Docker-fogalmakat, például a regisztrációs adatbázisokat, az adattárakat, a tárolókat és a tárolórendszerképeket, valamint ismernie kell az alapvető docker parancsokat.
anomáliadetektor erőforrás	A tárolók használatához a következőkre van szükség: Egy Azure-anomáliadetektor erőforrás a társított API-kulcs és a végpont URI lekéréséhez. Mindkét érték elérhető az Azure Portal anomáliadetektor Áttekintés és Kulcsok lapján, és a tároló elindításához szükséges. {API_KEY}: A Kulcsok lapon elérhető két erőforráskulcs egyike {ENDPOINT_URI}: Az Áttekintés lapon megadott végpont

A szükséges paraméterek összegyűjtése

Három elsődleges paraméter szükséges az összes Azure AI-tárolóhoz. A Microsoft szoftverlicenc-feltételeinek elfogadási értékkel kell rendelkeznie. Végponti URI- és API-kulcsra is szükség van.

Végpont URI-ja

Az {ENDPOINT_URI} érték a megfelelő Azure AI-szolgáltatási erőforrás Azure Portal áttekintési oldalán érhető el. Lépjen az Áttekintés lapra, mutasson a végpont fölé, és megjelenik egy Másolás vágólapra ikon. Szükség esetén másolja és használja a végpontot.

Kulcsok

Az {API_KEY} érték a tároló elindítására szolgál, és elérhető a megfelelő Azure AI-szolgáltatási erőforrás Kulcsok lapján. Lépjen a Kulcsok lapra, és válassza a Vágólapra másolás ikont.

Fontos

Ezek az előfizetési kulcsok az Azure AI-szolgáltatások API-ját használják. Ne ossza meg a kulcsait. Biztonságosan tárolja őket. Használja például az Azure Key Vaultot. Azt is javasoljuk, hogy ezeket a kulcsokat rendszeresen újragenerálja. API-hívás létrehozásához csak egy kulcs szükséges. Az első kulcs újragenerálása után a második kulcsot használhatja a szolgáltatáshoz való folyamatos hozzáféréshez.

A gazdaszámítógép

A gazdagép egy x64-alapú számítógép, amely a Docker-tárolót futtatja. Ez lehet egy számítógép a helyszínen vagy egy Docker-üzemeltetési szolgáltatás az Azure-ban, például:

• Azure Kubernetes Service.
• Azure Container Instances.
• Az Azure Stackben üzembe helyezett Kubernetes-fürt. További információ: Kubernetes üzembe helyezése az Azure Stackben.

Tárolókövetelmények és javaslatok

Az alábbi táblázat ismerteti azokat a minimális és ajánlott processzormagokat és memóriát, amelyet anomáliadetektor tárolóhoz kell lefoglalni.

QPS(Lekérdezések másodpercenként)	Minimum	Ajánlott
10 QPS	4 magos, 1 GB-os memória	8 magos 2 GB-os memória
20 QPS	8 magos, 2 GB-os memória	16 magos 4 GB-os memória

Minden magnak legalább 2,6 gigahertzesnek (GHz) vagy gyorsabbnak kell lennie.

A mag és a memória megfelel a --cpus parancs részeként használt beállításoknak és --memory beállításoknak docker run .

A tároló lemezképének lekérése docker pull

A anomáliadetektor tárolórendszerkép a mcr.microsoft.com tárolóregisztrációs adatbázis szindikátumában található. Az adattárban azure-cognitive-services/decision található, és neve anomaly-detector. A teljes tárolórendszerkép neve .mcr.microsoft.com/azure-cognitive-services/decision/anomaly-detector

A tároló legújabb verziójának használatához használhatja a címkét latest . Az MCR-en a képcímkék teljes listája is megtalálható.

docker pull A parancs használatával töltse le a tárolólemezképet.

Tároló	Adattár
cognitive-services-anomáliadetektor	mcr.microsoft.com/azure-cognitive-services/decision/anomaly-detector:latest

Tipp.

A használat során docker pullügyeljen a tárolóregisztrációs adatbázis, az adattár, a tárolórendszerkép neve és a megfelelő címke burkolatára. Megkülönböztetik a kis- és nagybetűket.

Tipp.

A docker images paranccsal listázhatja a letöltött tárolólemezképeket. Az alábbi parancs például az egyes letöltött tárolólemezképek azonosítóját, adattárát és címkéjét sorolja fel táblázatként formázva:

docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

IMAGE ID         REPOSITORY                TAG
<image-id>       <repository-path/name>    <tag-name>

Docker-lekérés a anomáliadetektor tárolóhoz

docker pull mcr.microsoft.com/azure-cognitive-services/anomaly-detector:latest

A tároló használata

Ha a tároló a gazdaszámítógépen van, az alábbi eljárással dolgozhat a tárolóval.

1. Futtassa a tárolót a szükséges számlázási beállításokkal. További példák a docker run parancsra.
2. A tároló előrejelzési végpontjának lekérdezése.

A tároló futtatása a következővel: docker run

A tároló futtatásához használja a docker-futtatási parancsot. Az adatok és {API_KEY} értékek lekérésének részleteiért tekintse meg a {ENDPOINT_URI} szükséges paramétereket.

Példák a docker run parancsra.

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
mcr.microsoft.com/azure-cognitive-services/decision/anomaly-detector:latest \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

A parancs a következőket hajtja végre:

• Anomáliadetektor tároló futtatása a tárolólemezképből
• Egy processzormag és 4 gigabájt (GB) memória lefoglalása
• Az 5000-s TCP-portot teszi elérhetővé, és pszeudo-TTY-t foglal le a tárolóhoz
• A tárolót a kilépés után automatikusan eltávolítja. A tárolólemezkép továbbra is elérhető a gazdaszámítógépen.

Fontos

A Eulatároló futtatásához meg kell adni a , Billingés ApiKey a beállításokat, ellenkező esetben a tároló nem indul el. További információ: Számlázás.

Több tároló futtatása ugyanazon a gazdagépen

Ha több tárolót szeretne futtatni a közzétett portokkal, mindenképpen futtassa az egyes tárolókat egy másik porttal. Futtassa például az első tárolót az 5000-s porton, a másodikat pedig az 5001-s porton.

Cserélje le a <container-registry> <container-name> használt tárolók értékeit. Ezeknek nem kell azonos tárolónak lenniük. A anomáliadetektor tároló és a LUIS-tároló együtt futhat a GAZDAGÉPen, vagy több anomáliadetektor tároló is futhat.

Futtassa az első tárolót az 5000-s gazdagépporton.

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
<container-registry>/microsoft/<container-name> \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Futtassa a második tárolót az 5001-ös gazdagépporton.

docker run --rm -it -p 5001:5000 --memory 4g --cpus 1 \
<container-registry>/microsoft/<container-name> \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Minden további tárolónak egy másik porton kell lennie.

A tároló előrejelzési végpontjának lekérdezése

A tároló REST-alapú lekérdezés-előrejelzési végpont API-kat nyújt.

A tároló API-khoz használja a gazdagépet (http://localhost:5000).

Ellenőrizze, hogy fut-e egy tároló

A tároló futásának ellenőrzésére többféleképpen is van lehetőség. Keresse meg a szóban forgó tároló külső IP-címét és közzétett portját, és nyissa meg a kedvenc webböngészőt. A tároló futásának ellenőrzéséhez használja az alábbi kérési URL-címeket. Az itt felsorolt példakérési URL-címek eltérőek http://localhost:5000lehetnek, de az adott tároló eltérő lehet. Ügyeljen arra, hogy a tároló külső IP-címére és közzétett portjára támaszkodjon.

URL-cím kérése	Cél
http://localhost:5000/	A tároló egy kezdőlappal rendelkezik.
http://localhost:5000/ready	A GET használatával kért URL-cím ellenőrzi, hogy a tároló készen áll-e egy lekérdezés elfogadására a modellen. Ez a kérés használható a Kubernetes-beli élő- és készültségi mintavételekhez.
http://localhost:5000/status	A GET szolgáltatással is kért, ez az URL-cím ellenőrzi, hogy a tároló elindításához használt API-kulcs érvényes-e végpontlekérdezés nélkül. Ez a kérés használható a Kubernetes-beli élő- és készültségi mintavételekhez.
http://localhost:5000/swagger	A tároló átfogó dokumentációval is rendelkezik a végpontokhoz, valamint egy kipróbálás funkcióval is. Ezzel a funkcióval beírhatja a beállításokat egy webes HTML-űrlapba, és kódírás nélkül is elvégezheti a lekérdezést. A lekérdezés visszatérése után megjelenik egy példa CURL-parancs, amely bemutatja a szükséges HTTP-fejléceket és törzsformátumot.

A tároló leállítása

A tároló leállításához a tárolót futtató parancssori környezetben válassza a Ctrl+C billentyűkombinációt.

Hibaelhárítás

Ha a tárolót kimeneti csatlakoztatással és naplózással futtatja, a tároló olyan naplófájlokat hoz létre, amelyek segítenek elhárítani a tároló indításakor vagy futtatásakor felmerülő problémákat.

Tipp.

További hibaelhárítási információkért és útmutatásért tekintse meg az Azure AI-tárolókkal kapcsolatos gyakori kérdéseket (GYIK).

Ha problémákat tapasztal egy Azure AI-szolgáltatástároló futtatásával, próbálja meg használni a Microsoft diagnosztikai tárolóját. Ezzel a tárolóval diagnosztizálhatja az üzembehelyezési környezetben előforduló gyakori hibákat, amelyek megakadályozhatják, hogy az Azure AI-tárolók a várt módon működjenek.

A tároló lekéréséhez használja a következő docker pull parancsot:

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

Ezután futtassa a tárolót. Cserélje le {ENDPOINT_URI} a végpontot, és cserélje le {API_KEY} az erőforrás kulcsára:

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

A tároló teszteli a számlázási végponthoz való hálózati kapcsolatot.

Számlázás

A anomáliadetektor-tárolók számlázási adatokat küldenek az Azure-nak egy anomáliadetektor erőforrás használatával az Azure-fiókban.

A tárolóba irányuló lekérdezések számlázása a paraméterhez használt Azure-erőforrás tarifacsomagján ApiKey lesz.

Az Azure AI-szolgáltatások tárolói nem rendelkeznek licenceléssel anélkül, hogy a mérési vagy számlázási végponthoz csatlakozna. Engedélyeznie kell a tárolók számára, hogy mindig közöljék a számlázási adatokat a számlázási végponttal. Az Azure AI-szolgáltatások tárolói nem küldenek ügyféladatokat, például az elemezni kívánt képet vagy szöveget a Microsoftnak.

Csatlakozás az Azure szolgáltatáshoz

A tárolónak futtatnia kell a számlázási argumentum értékeit. Ezek az értékek lehetővé teszik, hogy a tároló csatlakozzon a számlázási végponthoz. A tároló körülbelül 10–15 percenként jelenti a használatot. Ha a tároló az engedélyezett időkereten belül nem csatlakozik az Azure-hoz, a tároló továbbra is fut, de nem szolgál ki lekérdezéseket, amíg vissza nem állítja a számlázási végpontot. A kapcsolat 10 alkalommal, 10–15 perces időintervallumban történik. Ha a 10 próbálkozáson belül nem tud csatlakozni a számlázási végponthoz, a tároló leállítja a kérések kiszolgálását. Tekintse meg az Azure AI-szolgáltatások tárolójának gyakori kérdéseit a Microsoftnak a számlázáshoz küldött információk példájáért.

Számlázási argumentumok

A docker run parancs akkor indítja el a tárolót, ha az alábbi lehetőségek közül mind a három érvényes értéket tartalmazza:

Lehetőség	Leírás
ApiKey	Az Azure AI-szolgáltatások erőforrásának API-kulcsa, amely a számlázási adatok nyomon követésére szolgál. Ennek a beállításnak az értékét api-kulcsra kell állítani a kiépített erőforráshoz, amely a következőben Billingvan megadva: .
Billing	Az Azure AI-szolgáltatások erőforrásának végpontja, amely a számlázási adatok nyomon követésére szolgál. Ennek a beállításnak az értékét egy kiépített Azure-erőforrás végponti URI-jára kell állítani.
Eula	Azt jelzi, hogy elfogadta a tároló licencét. Ennek a beállításnak az értékét el kell fogadni.

Ezekről a lehetőségekről további információt a Tárolók konfigurálása című témakörben talál.

Összegzés

Ebben a cikkben megismerhette az anomáliadetektor-tárolók letöltésével, telepítésével és futtatásával kapcsolatos fogalmakat és munkafolyamatokat. Összegezve:

• anomáliadetektor egy Linux-tárolót biztosít a Dockerhez, amely anomáliadetektálást foglal magában a köteg és a streamelés, a várható tartománykövető és a bizalmassági hangolás használatával.
• A tárolólemezképek egy tárolókhoz dedikált privát Azure Container Registryből töltődnek le.
• A tárolólemezképek a Dockerben futnak.
• A REST API vagy az SDK használatával meghívhatja a műveleteket anomáliadetektor tárolókban a tároló gazdagépének URI-jának megadásával.
• A tárolók példányosításakor meg kell adnia a számlázási adatokat.

Fontos

Az Azure AI-tárolók nem rendelkeznek licenceléssel anélkül, hogy az Azure-hoz csatlakozna mérési célokra. Az ügyfeleknek engedélyeznie kell a tárolóknak, hogy mindig közöljék a számlázási adatokat a mérési szolgáltatással. Az Azure AI-tárolók nem küldenek ügyféladatokat (például az elemezni kívánt idősoradatokat) a Microsoftnak.

Következő lépések

• Konfigurálási beállítások tárolóinak konfigurálása
• Anomáliadetektor-tároló üzembe helyezése az Azure Container Instancesben
• További információ a anomáliadetektor API-szolgáltatásról