Installera och köra Docker-containrar för Avvikelseidentifiering API

Med containrar kan du använda Avvikelseidentifiering API i din egen miljö. Containrar är bra för specifika säkerhets- och datastyrningskrav. I den här artikeln lär du dig att ladda ned, installera och köra en Avvikelseidentifiering container.

Avvikelseidentifiering erbjuder en enda Docker-container för användning av API:et lokalt. Använd containern för att:

• Använda Avvikelseidentifiering algoritmer för dina data
• Övervaka strömmande data och identifiera avvikelser när de inträffar i realtid.
• Identifiera avvikelser i hela datauppsättningen som en batch.
• Identifiera trendändringspunkter i datauppsättningen som en batch.
• Justera avvikelseidentifieringsalgoritmens känslighet så att den bättre passar dina data.

Detaljerad information om API:et finns i:

• Läs mer om Avvikelseidentifiering API-tjänsten

Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

Förutsättningar

Du måste uppfylla följande krav innan du använder Avvikelseidentifiering containrar:

Nödvändiga parametrar samlas in

Det finns tre primära parametrar för alla Cognitive Services behållare som krävs. Licens avtalet för slutanvändare (EULA) måste vara närvarande med värdet accept . Dessutom behövs både en slut punkts-URL och API-nyckel.

Slut punkts-URI {ENDPOINT_URI}

URI-värdet för slut punkten är tillgängligt på sidan Azure Portal Översikt för motsvarande kognitiva tjänst resurs. Gå till sidan Översikt , Hovra över slut punkten och en Copy to clipboard ikon visas. Kopiera och använd vid behov.

Nyckel {API_KEY}

Den här nyckeln används för att starta behållaren och är tillgänglig på sidan Azure Portals nycklar för motsvarande kognitiva tjänst resurser. Gå till sidan nycklar och klicka på Copy to clipboard ikonen.

Värddatorn

Värden är en x64-baserad dator som kör Docker-behållaren. Det kan vara en dator på din lokala dator eller en Docker-värd tjänst i Azure, till exempel:

• Azure Kubernetes-tjänsten.
• Azure Container instances.
• Ett Kubernetes -kluster distribuerat till Azure Stack. Mer information finns i distribuera Kubernetes till Azure Stack.

Krav och rekommendationer för containrar

I följande tabell beskrivs de minsta och rekommenderade processorkärnor och det minne som ska allokeras för Avvikelseidentifiering container.

Varje kärna måste vara minst 2,6 gigahertz (GHz) eller snabbare.

Kärna och minne motsvarar inställningarna --cpus och , som används som en del av kommandot --memory docker run .

Hämta containeravbildningen med docker pull

Använd kommandot docker pull för att ladda ned en containeravbildning.

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

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

Docker-pull för Avvikelseidentifiering containern

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

Så här använder du containern

När containern finns på värddatornanvänder du följande process för att arbeta med containern.

1. Kör containernmed de faktureringsinställningar som krävs. Fler exempel på docker run kommandot är tillgängliga.
2. Fråga containerns förutsägelseslutpunkt.

Kör containern med docker run

Använd kommandot docker run för att köra containern. Information om hur du hämtar värdena och finns i samla in obligatoriska {ENDPOINT_URI} {API_KEY} parametrar.

Exempel på docker run kommandot är tillgängliga.

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}

Det här kommandot:

• Kör en Avvikelseidentifiering container från containeravbildningen
• Allokerar en processorkärna och 4 GIGABYTE (GB) minne
• Exponerar TCP-port 5000 och allokerar en pseudo-TTY för containern
• Tar automatiskt bort containern när den avslutas. Containeravbildningen är fortfarande tillgänglig på värddatorn.

Köra flera containrar på samma värd

Om du tänker köra flera containrar med exponerade portar måste du köra varje container med en annan port. Kör till exempel den första containern på port 5000 och den andra containern på port 5001.

Ersätt och <container-registry> med värdena för de <container-name> containrar som du använder. Dessa behöver inte vara samma container. Du kan köra Avvikelseidentifiering och LUIS-containern på VÄRDEN tillsammans, eller så kan du ha flera Avvikelseidentifiering containrar som körs.

Kör den första containern på värdporten 5000.

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

Kör den andra containern på värdporten 5001.

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

Varje efterföljande container ska finnas på en annan port.

Köra frågor mot containerns förutsägelseslutpunkt

Containern innehåller REST-baserade slutpunkts-API:er för frågeförutsägelse.

Använd värden, http://localhost:5000, för container-API:er.

Verifiera att en behållare körs

Det finns flera sätt att verifiera att behållaren körs. Leta reda på den externa IP- adressen och den exponerade porten för den aktuella behållaren och öppna din favorit webbläsare. Använd de olika URL: erna för begäran nedan för att verifiera att behållaren körs. URL: erna för exempel begär Anden som anges nedan är http://localhost:5000 , men din speciella behållare kan variera. Tänk på att du är beroende av behållarens externa IP -adress och exponerad port.

Stoppa containern

Om du vill stänga av behållaren går du till kommando rads miljön där behållaren körs och väljer CTRL + C.

Felsökning

Om du kör containern med en aktiverad montering och loggning av utdata genererar containern loggfiler som är användbara för att felsöka problem som inträffar när du startar eller kör containern.

Om du har problem med att köra en Cognitive Services-container kan du prova att använda Microsofts diagnostikcontainer. Använd den här containern till att diagnostisera vanliga fel i distributionsmiljön som kan förhindra att Cognitive Services-containrar fungerar som förväntat.

Hämta containern med följande Docker pull-kommando:

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

Kör sedan containern, {ENDPOINT_URI} ersätt med slutpunkten och ersätt {API_KEY} med din nyckel till din resurs:

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

Containern testar nätverksanslutningen till faktureringsslutpunkten.

Fakturering

Containern Avvikelseidentifiering faktureringsinformation till Azure med hjälp av en Avvikelseidentifiering på ditt Azure-konto.

Frågor till containern debiteras på prisnivån för den Azure-resurs som används för ApiKey parametern .

Azure Cognitive Services-containrar är inte licensierade att köras utan att vara anslutna till slutpunkten för mätning/fakturering. Du måste göra så att containrarna alltid kan kommunicera faktureringsinformation med faktureringsslutpunkten. Cognitive Services-containrar skickar inte kunddata, till exempel den bild eller text som analyseras, till Microsoft.

Anslut till Azure

Containern behöver faktureringsargumentvärdena för att köras. Dessa värden gör att containern kan ansluta till faktureringsslutpunkten. Containern rapporterar användning var 10:e till 15:e minut. Om containern inte ansluter till Azure inom den tillåtna tidsperioden fortsätter containern att köras men kör inte frågor förrän faktureringsslutpunkten har återställts. Anslutningen görs 10 gånger med samma tidsintervall på 10 till 15 minuter. Om den inte kan ansluta till faktureringsslutpunkten inom de 10 försöken slutar containern att betjäna begäranden. Se vanliga Cognitive Services vanliga frågor och svar om containrar för ett exempel på den information som skickas till Microsoft för fakturering.

Faktureringsargument

docker run Kommandot startar containern när alla tre av följande alternativ har angetts med giltiga värden:

Mer information om dessa alternativ finns i Konfigurera containrar.

Sammanfattning

I den här artikeln har du lärt dig begrepp och arbetsflöden för att ladda ned, installera och köra Avvikelseidentifiering containrar. Sammanfattningsvis:

• Avvikelseidentifiering en Linux-container för Docker, kapsla in avvikelseidentifiering med batch jämfört med strömning, förväntad intervallinferens och känslighetsjustering.
• Containeravbildningar laddas ned från en privat Azure Container Registry dedikerad för containrar.
• Containeravbildningar körs i Docker.
• Du kan använda antingen REST API eller SDK för att anropa åtgärder i Avvikelseidentifiering-containrar genom att ange värd-URI för containern.
• Du måste ange faktureringsinformation när du instansierar en container.

Nästa steg

• Granska Konfigurera containrar för konfigurationsinställningar
• Distribuera en Avvikelseidentifiering container till Azure Container Instances
• Läs mer om Avvikelseidentifiering API-tjänsten