Installera och kör avvikelseidentifieringscontainrarInstall and run Anomaly Detector containers

Avvikelse detektorn har följande behållare:The Anomaly Detector has the following container:

FunktionFunction FunktionerFeatures
AvvikelseidentifieringAnomaly detector
  • Identifierar avvikelser när de inträffar i real tid.Detects anomalies as they occur in real-time.
  • Identifierar avvikelser i alla data uppsättningar som en batch.Detects anomalies throughout your data set as a batch.
  • Härleder det förväntade normala intervallet av dina data.Infers the expected normal range of your data.
  • Stöder känslighets justering för avvikelse identifiering så att den bättre passar dina data.Supports anomaly detection sensitivity adjustment to better fit your data.
  • Detaljerad information om API: er finns i:For detailed information about the APIs, please see:

    Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.If you don't have an Azure subscription, create a free account before you begin.

    FörutsättningarPrerequisites

    Du måste uppfylla följande krav innan du använder behållare för avvikelse detektor:You must meet the following prerequisites before using Anomaly Detector containers:

    ObligatoriskRequired SyftePurpose
    Docker-motorDocker Engine Du behöver Docker-motorn installerad på en värddator.You need the Docker Engine installed on a host computer. Docker innehåller paket som konfigurerar Docker-miljön på MacOS, Windowsoch Linux.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. Få en genomgång om grunderna för Docker och behållare finns i den översikt över Docker.For a primer on Docker and container basics, see the Docker overview.

    Docker måste konfigureras för att tillåta behållarna för att ansluta till och skicka faktureringsdata till Azure.Docker must be configured to allow the containers to connect with and send billing data to Azure.

    I Windowsmåste Docker också konfigureras för att stödja Linux-behållare.On Windows, Docker must also be configured to support Linux containers.

    Bekant med DockerFamiliarity with Docker Du bör ha grundläggande kunskaper om Docker-koncept, t. ex. register, databaser, behållare och behållar avbildningar, samt kunskaper docker om grundläggande kommandon.You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic docker commands.
    Avvikelse detektor resursAnomaly Detector resource Du måste ha följande för att kunna använda dessa behållare:In order to use these containers, you must have:

    En Azure- avvikelses detektor resurs för att hämta tillhör ande API-nyckel och slut punkts-URI.An Azure Anomaly Detector resource to get the associated API key and endpoint URI. Båda värdena är tillgängliga på Azure Portalens avvikelse detektor översikt och nycklar sidor och krävs för att starta behållaren.Both values are available on the Azure portal's Anomaly Detector Overview and Keys pages and are required to start the container.

    {API_KEY} : En av de två tillgängliga resurs nycklarna på sidan nycklar{API_KEY}: One of the two available resource keys on the Keys page

    {ENDPOINT_URI} : Slut punkten enligt vad som anges på sidan Översikt{ENDPOINT_URI}: The endpoint as provided on the Overview page

    Nödvändiga parametrar samlas inGathering required parameters

    Det finns tre primära parametrar för alla Cognitive Services behållare som krävs.There are three primary parameters for all Cognitive Services' containers that are required. Licens avtalet för slutanvändare (EULA) måste förekomma med värdet accept.The end-user license agreement (EULA) must be present with a value of accept. Dessutom behövs både en slut punkts-URL och API-nyckel.Additionally, both an Endpoint URL and API Key are needed.

    Slut punkts-URI {ENDPOINT_URI}Endpoint 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.The Endpoint URI value is available on the Azure portal Overview page of the corresponding Cognitive Service resource. Gå till sidan Översikt , Hovra över slut punkten och en Copy to clipboard ikon visas.Navigate to the Overview page, hover over the Endpoint, and a Copy to clipboard icon will appear. Kopiera och använd vid behov.Copy and use where needed.

    Samla in slut punkts-URI för senare användning

    Nycklar {API_KEY}Keys {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.This key is used to start the container, and is available on the Azure portal's Keys page of the corresponding Cognitive Service resource. Gå till sidan nycklar och klicka på ikonen Copy to clipboard .Navigate to the Keys page, and click on the Copy to clipboard icon.

    Hämta en av de två nycklarna för senare användning

    Viktigt

    Dessa prenumerations nycklar används för att få åtkomst till ditt kognitiva tjänst-API.These subscription keys are used to access your Cognitive Service API. Dela inte dina nycklar.Do not share your keys. Lagra dem på ett säkert sätt, till exempel med hjälp av Azure Key Vault.Store them securely, for example, using Azure Key Vault. Vi rekommenderar också att du återskapar nycklarna regelbundet.We also recommend regenerating these keys regularly. Endast en nyckel krävs för att göra ett API-anrop.Only one key is necessary to make an API call. När du återskapar den första nyckeln kan du använda den andra nyckeln för fortsatt åtkomst till tjänsten.When regenerating the first key, you can use the second key for continued access to the service.

    Begär åtkomst till behållar registretRequest access to the container registry

    Du måste först fylla i och skicka in ett formulär för avvikelse detektor container för att begära åtkomst till behållaren.You must first complete and submit the Anomaly Detector Container Request form to request access to the container.

    Formuläret begär information om dig, ditt företag och Användarscenario som du använder behållaren.The form requests information about you, your company, and the user scenario for which you'll use the container. När du har skickat formuläret, Azure Cognitive Services-teamet har granskat den för att kontrollera att du uppfyller villkoren för åtkomst till det privata behållarregistret.After you've submitted the form, the Azure Cognitive Services team reviews it to ensure that you meet the criteria for access to the private container registry.

    Viktigt

    Du måste använda en e-postadress som är associerat med ett Microsoft-konto (MSA) eller Azure Active Directory (Azure AD)-konto i formuläret.You must use an email address that's associated with either a Microsoft Account (MSA) or Azure Active Directory (Azure AD) account in the form.

    Om din begäran har godkänts får du ett e-postmeddelande med instruktioner som beskriver hur du hämtar dina autentiseringsuppgifter och komma åt det privata behållarregistret.If your request is approved, you'll receive an email with instructions that describe how to obtain your credentials and access the private container registry.

    Använda Docker CLI för att autentisera privat behållarregisterUse the Docker CLI to authenticate the private container registry

    Du kan autentisera med det privata behållarregistret för Cognitive Services-behållare i ett antal olika sätt, men den rekommenderade metoden från kommandoraden är att använda den Docker CLI.You can authenticate with the private container registry for Cognitive Services Containers in any of several ways, but the recommended method from the command line is to use the Docker CLI.

    Använd den docker login kommandot, vilket visas i följande exempel för att logga in på containerpreview.azurecr.io, privat behållarregister för Cognitive Services-behållare.Use the docker login command, as shown in the following example, to log in to containerpreview.azurecr.io, the private container registry for Cognitive Services Containers. Ersätt <användarnamn> med användarnamnet och <lösenord> med lösenordet som angavs i autentiseringsuppgifterna som du har fått från den Azure Cognitive Services-teamet.Replace <username> with the user name and <password> with the password that's provided in the credentials you received from the Azure Cognitive Services team.

    docker login containerpreview.azurecr.io -u <username> -p <password>
    

    Om du har skyddat dina autentiseringsuppgifter i en textfil kan du sammanfoga innehållet i den textfilen med hjälp av den cat för att den docker login kommandot, som visas i följande exempel.If you've secured your credentials in a text file, you can concatenate the contents of that text file, by using the cat command, to the docker login command, as shown in the following example. Ersätt <{passwordFile> med sökvägen och namnet på textfilen som innehåller lösenordet och <användarnamn> med användarnamnet som tillhandahålls i dina autentiseringsuppgifter.Replace <passwordFile> with the path and name of the text file that contains the password and <username> with the user name that's provided in your credentials.

    cat <passwordFile> | docker login containerpreview.azurecr.io -u <username> --password-stdin
    

    VärddatornThe host computer

    Värden är en x64-baserad dator som kör Docker-behållaren.The host is a x64-based computer that runs the Docker container. Det kan vara en dator i din lokala enhet eller en värdtjänst för Docker i Azure, till exempel:It can be a computer on your premises or a Docker hosting service in Azure, such as:

    Behållarkrav och rekommendationerContainer requirements and recommendations

    I följande tabell beskrivs de minsta och rekommenderade processor kärnor och minne som ska allokeras för avvikelse detektor behållare.The following table describes the minimum and recommended CPU cores and memory to allocate for Anomaly Detector container.

    FRÅGOR per sekund (frågor per sekund)QPS(Queries per second) MinimumMinimum RekommenderasRecommended
    10 FRÅGOR PER SEKUND10 QPS 4 kärnor, 1 GB minne4 core, 1-GB memory 8 kärnor, 2 GB minne8 core 2-GB memory
    20 FRÅGOR PER SEKUND20 QPS 8 kärnor, 2 GB minne8 core, 2-GB memory 16 kärnor 4 GB minne16 core 4-GB memory

    Varje kärna måste vara minst 2,6 gigahertz (GHz) eller snabbare.Each core must be at least 2.6 gigahertz (GHz) or faster.

    Core och minne motsvarar --cpus inställningarna och --memory som docker run används som en del av kommandot.Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

    Hämta behållar avbildningen meddocker pullGet the container image with docker pull

    docker pull Använd kommandot för att ladda ned en behållar avbildning.Use the docker pull command to download a container image.

    ContainerContainer LagringsplatsRepository
    cognitive-services-anomaly-detectorcognitive-services-anomaly-detector containerpreview.azurecr.io/microsoft/cognitive-services-anomaly-detector:latest

    Tips

    Du kan använda den docker-avbildningar kommando för att lista din hämtade behållaravbildningar.You can use the docker images command to list your downloaded container images. Till exempel visar följande kommando ID, databasen och taggen för varje hämtade behållaravbildningen, formaterad som en tabell:For example, the following command lists the ID, repository, and tag of each downloaded container image, formatted as a table:

    docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"
    
    IMAGE ID         REPOSITORY                TAG
    <image-id>       <repository-path/name>    <tag-name>
    

    Docker-hämtning för avvikelse detektor behållarenDocker pull for the Anomaly Detector container

    docker pull containerpreview.azurecr.io/microsoft/cognitive-services-anomaly-detector:latest
    

    Använda behållarenHow to use the container

    När behållaren är på värddatorn använder du följande process för att arbeta med behållaren.Once the container is on the host computer, use the following process to work with the container.

    1. Kör behållarenmed de fakturerings inställningar som krävs.Run the container, with the required billing settings. Fler exempeldocker run kommandot är tillgängliga.More examples of the docker run command are available.
    2. Fråga behållarens förutsägelse slut punkt.Query the container's prediction endpoint.

    Kör behållaren meddocker runRun the container with docker run

    Använd kommandot Docker Run för att köra behållaren.Use the docker run command to run the container. Läs om hur du samlar in nödvändiga parametrar för information om hur {ENDPOINT_URI} du {API_KEY} hämtar och-värden.Refer to gathering required parameters for details on how to get the {ENDPOINT_URI} and {API_KEY} values.

    Exempeldocker run kommandot är tillgängliga.Examples of the docker run command are available.

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

    Det här kommandot:This command:

    • Kör en avvikelse detektor behållare från behållar avbildningenRuns an Anomaly Detector container from the container image
    • Allokerar en processor kärna och 4 GB minneAllocates one CPU core and 4 gigabytes (GB) of memory
    • Visar TCP-port 5000 och allokerar en pseudo-TTY för behållarenExposes TCP port 5000 and allocates a pseudo-TTY for the container
    • Tar automatiskt bort behållaren när den har avslut ATS.Automatically removes the container after it exits. Behållar avbildningen är fortfarande tillgänglig på värddatorn.The container image is still available on the host computer.

    Viktigt

    Den Eula, Billing, och ApiKey alternativ måste anges för att köra behållaren, i annat fall startar inte behållaren.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Mer information finns i fakturering.For more information, see Billing.

    Köra flera behållare på samma värdRunning multiple containers on the same host

    Om du tänker köra flera behållare med exponerade portar ska du se till att köra varje behållare med en annan port.If you intend to run multiple containers with exposed ports, make sure to run each container with a different port. Kör till exempel den första behållaren på port 5000 och den andra behållaren på port 5001.For example, run the first container on port 5000 and the second container on port 5001.

    <container-registry> Ersätt och <container-name> med värdena för de behållare som du använder.Replace the <container-registry> and <container-name> with the values of the containers you use. De behöver inte vara samma behållare.These do not have to be the same container. Du kan ha en avvikande detektor behållare och LUIS-behållaren som körs på värden tillsammans eller så kan du ha flera avvikande detektor behållare som kör.You can have the Anomaly Detector container and the LUIS container running on the HOST together or you can have multiple Anomaly Detector containers running.

    Kör den första behållaren på port 5000.Run the first container on port 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 behållaren på port 5001.Run the second container on port 5001.

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

    Varje efterföljande behållare bör finnas på en annan port.Each subsequent container should be on a different port.

    Fråga behållarens förutsägelse slut punktQuery the container's prediction endpoint

    Behållaren innehåller REST-baserade slut punkts-API: er för frågor förutsägelse.The container provides REST-based query prediction endpoint APIs.

    Använd värden, http://localhost:5000 för behållar-API: er.Use the host, http://localhost:5000, for container APIs.

    Verifiera att en behållare körsValidate that a container is running

    Det finns flera sätt att verifiera att behållaren körs.There are several ways to validate that the container is running. Leta reda på den externa IP- adressen och den exponerade porten för den aktuella behållaren och öppna din favorit webbläsare.Locate the External IP address and exposed port of the container in question, and open your favorite web browser. Använd de olika URL: erna för begäran nedan för att verifiera att behållaren körs.Use the various request URLs below to validate the container is running. URL: erna för exempel begär Anden http://localhost:5000som anges nedan är, men din speciella behållare kan variera.The example request URLs listed below are http://localhost:5000, but your specific container may vary. Tänk på att du är beroende av behållarens externa IP -adress och exponerad port.Keep in mind that you're to rely on your container's External IP address and exposed port.

    URL för begäranRequest URL SyftePurpose
    http://localhost:5000/ Behållaren är en start sida.The container provides a home page.
    http://localhost:5000/status Begärde med en HTTP GET för att verifiera att behållaren körs utan att orsaka en slut punkts fråga.Requested with an HTTP GET, to validate that the container is running without causing an endpoint query. Den här begäran kan användas för Kubernetes Live ochberedskaps avsökningar.This request can be used for Kubernetes liveness and readiness probes.
    http://localhost:5000/swagger Behållaren innehåller en fullständig uppsättning dokumentation för slut punkterna och en funktion för att testa den .The container provides a full set of documentation for the endpoints and a Try it out feature. Med den här funktionen kan du ange dina inställningar i ett webbaserat HTML-formulär och göra frågan utan att behöva skriva någon kod.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. När frågan returnerar visas ett exempel på ett spiral kommando som visar de HTTP-rubriker och det text format som krävs.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

    Behållarens start sida

    Stoppa behållarenStop the container

    Om du vill stänga av behållaren i kommandoradsmiljön där behållaren körs, Välj Ctrl + C.To shut down the container, in the command-line environment where the container is running, select Ctrl+C.

    FelsökningTroubleshooting

    Om du kör behållaren med en utgående montering och loggning aktive rad genererar behållaren loggfiler som är till hjälp vid fel sökning av problem som inträffar när du startar eller kör behållaren.If you run the container with an output mount and logging enabled, the container generates log files that are helpful to troubleshoot issues that happen while starting or running the container.

    Tips

    Mer felsöknings information och vägledning finns i Cognitive Services behållare vanliga frågor och svar.For more troubleshooting information and guidance, see Cognitive Services containers frequently asked questions (FAQ).

    FaktureringBilling

    Avvikelse detektor behållare skickar fakturerings information till Azure med hjälp av en avvikelse resurs på ditt Azure-konto.The Anomaly Detector containers send billing information to Azure, using an Anomaly Detector resource on your Azure account.

    Frågor till behållaren debiteras enligt prisnivån för Azure-resursen som används för den <ApiKey>.Queries to the container are billed at the pricing tier of the Azure resource that's used for the <ApiKey>.

    Azure Cognitive Services-behållare är inte licensierad för att köra inte är ansluten till fakturering slutpunkten för Avläsning av programvara.Azure Cognitive Services containers aren't licensed to run without being connected to the billing endpoint for metering. Du måste aktivera behållarna för att kommunicera faktureringsinformation med fakturering slutpunkten hela tiden.You must enable the containers to communicate billing information with the billing endpoint at all times. Cognitive Services-behållare Skicka inte kundinformation, till exempel bild eller text som analyseras, till Microsoft.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

    Anslut till AzureConnect to Azure

    Behållaren måste fakturering argumentvärden ska köras.The container needs the billing argument values to run. Dessa värden kan behållaren att ansluta till slutpunkten för fakturering.These values allow the container to connect to the billing endpoint. Behållaren rapporterar användning ungefär var 10 – 15 minuter.The container reports usage about every 10 to 15 minutes. Om behållaren inte går att ansluta till Azure inom den tillåtna tidsperioden behållaren fortsätter att köras men leverera inte frågor tills fakturering slutpunkten har återställts.If the container doesn't connect to Azure within the allowed time window, the container continues to run but doesn't serve queries until the billing endpoint is restored. Anslutningen görs 10 gånger på samma tidsintervallet 10 – 15 minuter.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Om den inte kan ansluta till den fakturering slutpunkten inom 10 försök kan behållaren stoppas.If it can't connect to the billing endpoint within the 10 tries, the container stops running.

    Fakturering argumentBilling arguments

    För den docker run kommando för att starta behållaren måste alla tre av följande alternativ måste anges med giltiga värden:For the docker run command to start the container, all three of the following options must be specified with valid values:

    AlternativOption BeskrivningDescription
    ApiKey API-nyckel för Cognitive Services-resurs som används för att spåra faktureringsinformation.The API key of the Cognitive Services resource that's used to track billing information.
    Värdet för det här alternativet måste anges till en API-nyckel för den etablerade resursen som anges i Billing.The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
    Billing Slutpunkten för Cognitive Services-resurs som används för att spåra faktureringsinformation.The endpoint of the Cognitive Services resource that's used to track billing information.
    Värdet för det här alternativet måste anges till en etablerade Azure-resurs-URI-slutpunkten.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
    Eula Anger att du godkänt licensen för behållaren.Indicates that you accepted the license for the container.
    Värdet för det här alternativet måste anges till acceptera.The value of this option must be set to accept.

    Mer information om alternativen finns i konfigurera behållare.For more information about these options, see Configure containers.

    BlogginläggBlog posts

    UtvecklarexempelDeveloper samples

    Exempel på utvecklare finns på vår GitHub-lagringsplats.Developer samples are available at our GitHub repository.

    Visa webbseminariumView webinar

    Delta i webb seminarium för att lära dig mer om:Join the webinar to learn about:

    • Distribuera Cognitive Services till vilken dator som helst med hjälp av DockerHow to deploy Cognitive Services to any machine using Docker
    • Så här distribuerar du Cognitive Services till AKSHow to deploy Cognitive Services to AKS

    SammanfattningSummary

    I den här artikeln har du lärt dig begrepp och arbets flöde för att ladda ned, installera och köra avvikelser som behållare.In this article, you learned concepts and workflow for downloading, installing, and running Anomaly Detector containers. Sammanfattningsvis:In summary:

    • Avvikelse detektor tillhandahåller en Linux-behållare för Docker, inkapsling av avvikelse identifiering med batch vs streaming, förväntat intervalls-härledning och känslighets justering.Anomaly Detector provides one Linux container for Docker, encapsulating anomaly detection with batch vs streaming, expected range inference, and sensitivity tuning.
    • Behållar avbildningar laddas ned från ett privat Azure Container Registry dedikerat för för hands version.Container images are downloaded from a private Azure Container Registry dedicated for containers preview.
    • Behållaravbildningar som körs i Docker.Container images run in Docker.
    • Du kan använda antingen REST API eller SDK för att anropa åtgärder i avvikande detektor behållare genom att ange behållarens värd-URI.You can use either the REST API or SDK to call operations in Anomaly Detector containers by specifying the host URI of the container.
    • Du måste ange faktureringsinformation när instanser skapades av en behållare.You must specify billing information when instantiating a container.

    Viktigt

    Cognitive Services-behållare är inte licensierad för att köra inte är ansluten till Azure för att mäta.Cognitive Services containers are not licensed to run without being connected to Azure for metering. Kunder måste du aktivera behållarna för att kommunicera faktureringsinformation med tjänsten Avläsning av programvara vid alla tidpunkter.Customers need to enable the containers to communicate billing information with the metering service at all times. Cognitive Services behållare skickar inte kund information (t. ex. tids serie data som analyseras) till Microsoft.Cognitive Services containers do not send customer data (e.g., the time series data that is being analyzed) to Microsoft.

    Nästa stegNext steps