Afwijkende detector containers installeren en uitvoeren (preview-versie)Install and run Anomaly Detector containers (Preview)

De afwijkings detector heeft de volgende functionaliteit voor container functies:The Anomaly Detector has the following container feature functionality:

FunctieFunction FunctiesFeatures
Anomalie detectieAnomaly detector
  • Detecteert afwijkingen die in realtime optreden.Detects anomalies as they occur in real-time.
  • Detecteert afwijkingen in uw gegevensset als een batch.Detects anomalies throughout your data set as a batch.
  • Het verwachte normale bereik van uw gegevens afleiden.Infers the expected normal range of your data.
  • Ondersteunt de gevoeligheids aanpassing van anomalie detectie om uw gegevens beter aan te passen.Supports anomaly detection sensitivity adjustment to better fit your data.
  • Voor gedetailleerde informatie over de Api's raadpleegt u:For detailed information about the APIs, please see:

    Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.If you don't have an Azure subscription, create a free account before you begin.

    VereistenPrerequisites

    U moet voldoen aan de volgende vereisten voordat u afwijkende detector containers gebruikt:You must meet the following prerequisites before using Anomaly Detector containers:

    VereistRequired DoelPurpose
    Docker-engineDocker Engine De docker-engine moet zijn geïnstalleerd op een hostcomputer.You need the Docker Engine installed on a host computer. Docker biedt pakketten voor het configureren van de docker-omgeving op macOS, Windowsen Linux.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. Zie het docker-overzichtvoor een primer op basis van docker en container.For a primer on Docker and container basics, see the Docker overview.

    Docker moet worden geconfigureerd, zodat de containers om te verbinden met en facturering gegevens verzenden naar Azure.Docker must be configured to allow the containers to connect with and send billing data to Azure.

    In Windowsmoet docker ook worden geconfigureerd voor de ondersteuning van Linux-containers.On Windows, Docker must also be configured to support Linux containers.

    Vertrouwd met dockerFamiliarity with Docker U moet een basis kennis hebben van docker-concepten, zoals registers, opslag plaatsen, containers en container installatie kopieën, en kennis van basis docker-opdrachten.You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic docker commands.
    Anomalie detector bronAnomaly Detector resource Als u deze containers wilt gebruiken, hebt u het volgende nodig:In order to use these containers, you must have:

    Een Azure anomalie detector -bron om de bijbehorende API-sleutel en eind punt-URI op te halen.An Azure Anomaly Detector resource to get the associated API key and endpoint URI. Beide waarden zijn beschikbaar op het overzicht van de anomalie detectie en de pagina's van de Azure Portal en zijn vereist om de container te starten.Both values are available on the Azure portal's Anomaly Detector Overview and Keys pages and are required to start the container.

    {API_KEY} : een van de twee beschik bare bron sleutels op de pagina sleutels{API_KEY}: One of the two available resource keys on the Keys page

    {ENDPOINT_URI} : het eind punt op de pagina overzicht{ENDPOINT_URI}: The endpoint as provided on the Overview page

    Vereiste para meters verzamelenGathering required parameters

    Er zijn drie primaire para meters voor alle vereiste containers van Cognitive Services.There are three primary parameters for all Cognitive Services' containers that are required. De gebruiksrecht overeenkomst (EULA) moet aanwezig zijn met een waarde van accept.The end-user license agreement (EULA) must be present with a value of accept. Daarnaast zijn zowel een eind punt-URL als een API-sleutel nodig.Additionally, both an Endpoint URL and API Key are needed.

    {ENDPOINT_URI} van eind punt-URIEndpoint URI {ENDPOINT_URI}

    De URI-waarde van het eind punt is beschikbaar op de pagina overzicht van Azure portal van de bijbehorende cognitieve service resource.The Endpoint URI value is available on the Azure portal Overview page of the corresponding Cognitive Service resource. Ga naar de overzichts pagina, beweeg de muis aanwijzer over het eind punt en er wordt een Copy to clipboard pictogram weer gegeven.Navigate to the Overview page, hover over the Endpoint, and a Copy to clipboard icon will appear. Kopieer en gebruik waar nodig.Copy and use where needed.

    De URI van het eind punt verzamelen voor later gebruik

    Sleutels {API_KEY}Keys {API_KEY}

    Deze sleutel wordt gebruikt om de container te starten en is beschikbaar op de pagina sleutels van de Azure Portal van de bijbehorende cognitieve service resource.This key is used to start the container, and is available on the Azure portal's Keys page of the corresponding Cognitive Service resource. Ga naar de pagina sleutels en klik op het pictogram Copy to clipboard .Navigate to the Keys page, and click on the Copy to clipboard icon.

    Een van de twee sleutels ophalen voor later gebruik

    Belangrijk

    Deze abonnements sleutels worden gebruikt om toegang te krijgen tot uw API voor de cognitieve service.These subscription keys are used to access your Cognitive Service API. Deel uw sleutels niet.Do not share your keys. Sla ze veilig op, bijvoorbeeld met behulp van Azure Key Vault.Store them securely, for example, using Azure Key Vault. We raden u ook aan deze sleutels regel matig opnieuw te genereren.We also recommend regenerating these keys regularly. Er is slechts één sleutel nodig om een API-aanroep te maken.Only one key is necessary to make an API call. Wanneer u de eerste sleutel opnieuw genereert, kunt u de tweede sleutel gebruiken voor verdere toegang tot de service.When regenerating the first key, you can use the second key for continued access to the service.

    Toegang aanvragen tot het container registerRequest access to the container registry

    U moet eerst het aanvraag formulier voor de afwijkings detectie container volt ooien en verzenden om toegang tot de container aan te vragen.You must first complete and submit the Anomaly Detector Container Request form to request access to the container.

    Het formulier vraagt om informatie over u, uw bedrijf en het scenario voor gebruikers waarvoor u de container gebruikt.The form requests information about you, your company, and the user scenario for which you'll use the container. Nadat u het formulier hebt verzonden, wordt het door het Azure Cognitive Services-team beoordeeld om te controleren of u voldoet aan de criteria voor toegang tot het persoonlijke container register.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.

    Belangrijk

    U moet een e-mail adres gebruiken dat is gekoppeld aan een account van een micro soft-account (MSA) of Azure Active Directory (Azure AD) in het formulier.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.

    Als uw aanvraag is goedgekeurd, ontvangt u een e-mail bericht met instructies voor het verkrijgen van uw referenties en het openen van het persoonlijke container register.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.

    De docker-CLI gebruiken om het persoonlijke container register te verifiërenUse the Docker CLI to authenticate the private container registry

    U kunt zich op verschillende manieren verifiëren met het persoonlijke container register voor Cognitive Services containers, maar de aanbevolen methode van de opdracht regel is het gebruik van de 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.

    Gebruik de opdrachtdocker login, zoals in het volgende voor beeld wordt weer gegeven, om u aan te melden bij containerpreview.azurecr.io, het persoonlijke container register voor Cognitive Services containers.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. Vervang <gebruikersnaam> door de gebruikers naam<en het wacht woord> door het wacht woord dat is opgegeven in de referenties die u hebt ontvangen van het Cognitive Services team van Azure.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>
    

    Als u uw referenties in een tekst bestand hebt beveiligd, kunt u de inhoud van het tekst bestand samen voegen met behulp van de cat opdracht tot de docker login opdracht, zoals in het volgende voor beeld wordt weer gegeven.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. Vervang <passwordFile> door het pad en de naam van het tekst bestand dat het wacht woord bevat en <username> met de gebruikers naam die is opgegeven in uw referenties.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
    

    De hostcomputerThe host computer

    De host is een op x64 gebaseerde computer waarop de docker-container wordt uitgevoerd.The host is a x64-based computer that runs the Docker container. Dit kan een computer in uw locatie zijn of een docker-hosting service in azure, zoals:It can be a computer on your premises or a Docker hosting service in Azure, such as:

    Containervereisten en aanbevelingenContainer requirements and recommendations

    In de volgende tabel worden de minimale en aanbevolen CPU-kernen en het geheugen beschreven die moeten worden toegewezen aan een afwijkende detector-container.The following table describes the minimum and recommended CPU cores and memory to allocate for Anomaly Detector container.

    QPS (Query's per seconde)QPS(Queries per second) MinimumMinimum AanbevolenRecommended
    10 QPS10 QPS 4-core, 1 GB geheugen4 core, 1-GB memory 8 kern geheugen van 2 GB8 core 2-GB memory
    20 QPS20 QPS 8-core, 2 GB geheugen8 core, 2-GB memory 16-core 4 GB geheugen16 core 4-GB memory

    Elke kern moet ten minste 2,6 gigahertz (GHz) of sneller zijn.Each core must be at least 2.6 gigahertz (GHz) or faster.

    Core en geheugen komen overeen met de instellingen --cpus en --memory die worden gebruikt als onderdeel van de docker run opdracht.Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

    De container installatie kopie met docker pull ophalenGet the container image with docker pull

    Gebruik de opdracht docker pull om een container installatie kopie te downloaden.Use the docker pull command to download a container image.

    ContainerContainer OpslagplaatsRepository
    cognitieve Services-anomaliey-detectorcognitive-services-anomaly-detector containerpreview.azurecr.io/microsoft/cognitive-services-anomaly-detector:latest

    Tip

    U kunt de docker-installatiekopieën opdracht om een lijst van uw gedownloade containerinstallatiekopieën.You can use the docker images command to list your downloaded container images. De volgende opdracht worden bijvoorbeeld de ID, de opslagplaats en het label van elke gedownloade containerinstallatiekopie, opgemaakt als een tabel: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-pull voor de anomalie detectie containerDocker pull for the Anomaly Detector container

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

    De container gebruikenHow to use the container

    Wanneer de container zich op de hostcomputerbevindt, gebruikt u het volgende proces om met de container te werken.Once the container is on the host computer, use the following process to work with the container.

    1. Voer de container uitmet de vereiste facturerings instellingen.Run the container, with the required billing settings. Er zijn meer voor beelden van de docker run-opdracht beschikbaar.More examples of the docker run command are available.
    2. Zoek het Voorspellings eindpunt van de containerop.Query the container's prediction endpoint.

    De container met docker run uitvoerenRun the container with docker run

    Gebruik de opdracht docker run om de container uit te voeren.Use the docker run command to run the container. Raadpleeg de vereiste para meters verzamelen voor meer informatie over het ophalen van de {ENDPOINT_URI} en {API_KEY} waarden.Refer to gathering required parameters for details on how to get the {ENDPOINT_URI} and {API_KEY} values.

    Voor beelden van de opdracht docker run zijn beschikbaar.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}
    

    Deze opdracht:This command:

    • Voert een anomalie detectie container uit vanuit de container installatie kopieRuns an Anomaly Detector container from the container image
    • Wijst een CPU-kern en 4 GB aan geheugen toeAllocates one CPU core and 4 gigabytes (GB) of memory
    • Gebruikt TCP-poort 5000 en wijst er een pseudo-TTY voor de containerExposes TCP port 5000 and allocates a pseudo-TTY for the container
    • Verwijdert de container automatisch nadat deze is afgesloten.Automatically removes the container after it exits. De container installatie kopie is nog steeds beschikbaar op de hostcomputer.The container image is still available on the host computer.

    Belangrijk

    De opties Eula, Billingen ApiKey moeten worden opgegeven om de container uit te voeren. anders wordt de container niet gestart.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Zie factureringvoor meer informatie.For more information, see Billing.

    Meerdere containers op dezelfde host uitvoerenRunning multiple containers on the same host

    Als u van plan bent om meerdere containers met blootgestelde poorten uit te voeren, moet u ervoor zorgen dat elke container met een andere poort wordt uitgevoerd.If you intend to run multiple containers with exposed ports, make sure to run each container with a different port. Voer bijvoorbeeld de eerste container uit op poort 5000 en de tweede container op poort 5001.For example, run the first container on port 5000 and the second container on port 5001.

    Vervang de <container-registry> en <container-name> door de waarden van de containers die u gebruikt.Replace the <container-registry> and <container-name> with the values of the containers you use. Deze hoeven niet dezelfde container te zijn.These do not have to be the same container. U kunt de afwijkende detector container en de LUIS-container samen op de HOST uitvoeren, maar u kunt ook meerdere afwijkende detector containers uitvoeren.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.

    Voer de eerste container uit op poort 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}
    

    Voer de tweede container uit op poort 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}
    

    Elke volgende container moet zich op een andere poort bevinden.Each subsequent container should be on a different port.

    Query uitvoeren op het prediction-eind punt van de containerQuery the container's prediction endpoint

    De container bevat op REST gebaseerde query Voorspellings eindpunt-Api's.The container provides REST-based query prediction endpoint APIs.

    Gebruik de host, http://localhost:5000voor container-Api's.Use the host, http://localhost:5000, for container APIs.

    Controleren of een container wordt uitgevoerdValidate that a container is running

    Er zijn verschillende manieren om te controleren of de container wordt uitgevoerd.There are several ways to validate that the container is running. Zoek het externe IP- adres en de weer gegeven poort van de betreffende container en open uw favoriete webbrowser.Locate the External IP address and exposed port of the container in question, and open your favorite web browser. Gebruik de onderstaande aanvraag-Url's om te controleren of de container wordt uitgevoerd.Use the various request URLs below to validate the container is running. De onderstaande voorbeeld aanvraag-Url's zijn http://localhost:5000, maar uw specifieke container kan verschillen.The example request URLs listed below are http://localhost:5000, but your specific container may vary. Houd er rekening mee dat u afhankelijk bent van het externe IP- adres van uw container en de weer gegeven poort.Keep in mind that you're to rely on your container's External IP address and exposed port.

    Aanvraag-URLRequest URL DoelPurpose
    http://localhost:5000/ De container bevat een start pagina.The container provides a home page.
    http://localhost:5000/status Er wordt met een HTTP GET-aanvraag gecontroleerd of de container wordt uitgevoerd zonder dat dit een eindpunt query veroorzaakt.Requested with an HTTP GET, to validate that the container is running without causing an endpoint query. Deze aanvraag kan worden gebruikt voor Kubernetes- en gereedheids tests.This request can be used for Kubernetes liveness and readiness probes.
    http://localhost:5000/swagger De container bevat een volledige documentatie voor de eind punten en een try- out -functie.The container provides a full set of documentation for the endpoints and a Try it out feature. Met deze functie kunt u uw instellingen invoeren in een HTML-formulier op het web en de query maken zonder dat u code hoeft te schrijven.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. Nadat de query is geretourneerd, wordt een voor beeld van een krul opdracht weer gegeven om te demonstreren welke HTTP-headers en hoofdtekst indeling vereist zijn.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

    Start pagina van container

    De container stoppenStop the container

    Als u de container wilt afsluiten, selecteert u in de opdracht regel omgeving waar de container wordt uitgevoerd, CTRL + C.To shut down the container, in the command-line environment where the container is running, select Ctrl+C.

    Problemen oplossenTroubleshooting

    Als u de container uitvoert met een uitvoer koppeling en logboek registratie ingeschakeld, genereert de container logboek bestanden die handig zijn om problemen op te lossen die optreden tijdens het starten of uitvoeren van de container.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.

    Tip

    Zie Cognitive Services containers Veelgestelde vragen (FAQ)voor meer informatie en richt lijnen voor probleem oplossing.For more troubleshooting information and guidance, see Cognitive Services containers frequently asked questions (FAQ).

    BillingBilling

    De afwijkende detector containers verzenden facturerings gegevens naar Azure met behulp van een afwijkende detector bron in uw Azure-account.The Anomaly Detector containers send billing information to Azure, using an Anomaly Detector resource on your Azure account.

    Query's naar de container worden gefactureerd op de prijs categorie van de Azure-resource die wordt gebruikt voor de ApiKey.Queries to the container are billed at the pricing tier of the Azure resource that's used for the ApiKey.

    Azure Cognitive Services-containers mogen niet worden uitgevoerd zonder dat ze zijn verbonden met het eind punt voor meting/facturering.Azure Cognitive Services containers aren't licensed to run without being connected to the metering / billing endpoint. U moet de containers in staat stellen om de facturerings gegevens te allen tijde te communiceren met het eind punt.You must enable the containers to communicate billing information with the billing endpoint at all times. Cognitive Services containers verzenden geen klant gegevens, zoals de afbeelding of de tekst die wordt geanalyseerd, naar micro soft.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

    Verbinding maken met AzureConnect to Azure

    De voor de container vereiste facturerings argument waarden moeten worden uitgevoerd.The container needs the billing argument values to run. Met deze waarden kan de container verbinding maken met het eind punt van de facturering.These values allow the container to connect to the billing endpoint. De container rapporteert het gebruik ongeveer elke 10 tot 15 minuten.The container reports usage about every 10 to 15 minutes. Als de container geen verbinding maakt met Azure binnen het toegestane tijd venster, blijft de container actief, maar worden er geen query's verwerkt totdat het eind punt van de facturering is hersteld.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. De verbinding wordt 10 keer in hetzelfde tijds interval van 10 tot 15 minuten uitgevoerd.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Als er geen verbinding kan worden gemaakt met het facturerings eindpunt binnen de 10 pogingen, stopt de container met het door sturen van aanvragen.If it can't connect to the billing endpoint within the 10 tries, the container stops serving requests.

    Facturerings argumentenBilling arguments

    Met de opdracht docker run wordt de container gestart wanneer de drie van de volgende opties zijn voorzien van geldige waarden:The docker run command will start the container when all three of the following options are provided with valid values:

    OptieOption BeschrijvingDescription
    ApiKey De API-sleutel van de Cognitive Services resource die wordt gebruikt voor het bijhouden van facturerings gegevens.The API key of the Cognitive Services resource that's used to track billing information.
    De waarde van deze optie moet worden ingesteld op een API-sleutel voor de ingerichte resource die is opgegeven in Billing.The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
    Billing Het eind punt van de Cognitive Services resource die wordt gebruikt voor het bijhouden van facturerings gegevens.The endpoint of the Cognitive Services resource that's used to track billing information.
    De waarde van deze optie moet worden ingesteld op de eindpunt-URI van een ingerichte Azure-resource.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
    Eula Geeft aan dat u de licentie voor de container hebt geaccepteerd.Indicates that you accepted the license for the container.
    De waarde van deze optie moet worden ingesteld op accepteren.The value of this option must be set to accept.

    Zie containers configurerenvoor meer informatie over deze opties.For more information about these options, see Configure containers.

    BlogberichtenBlog posts

    Voorbeelden voor ontwikkelaarsDeveloper samples

    Voor beelden van ontwikkel aars zijn beschikbaar in onze github-opslag plaats.Developer samples are available at our GitHub repository.

    Webinar bekijkenView webinar

    Doe mee aan de webinar voor meer informatie over:Join the webinar to learn about:

    • Cognitive Services op elke machine implementeren met behulp van dockerHow to deploy Cognitive Services to any machine using Docker
    • Cognitive Services implementeren op AKSHow to deploy Cognitive Services to AKS

    SamenvattingSummary

    In dit artikel hebt u concepten en werk stromen geleerd voor het downloaden, installeren en uitvoeren van afwijkende detector containers.In this article, you learned concepts and workflow for downloading, installing, and running Anomaly Detector containers. Samenvatting:In summary:

    • Afwijkings detectie biedt één Linux-container voor docker, die anomalie detectie inkapselt met batch versus streaming, verwachte bereik reductie en gevoeligheids afstemming.Anomaly Detector provides one Linux container for Docker, encapsulating anomaly detection with batch vs streaming, expected range inference, and sensitivity tuning.
    • Container installatie kopieën worden gedownload van een persoonlijke Azure Container Registry toegewezen voor containers preview.Container images are downloaded from a private Azure Container Registry dedicated for containers preview.
    • Containerinstallatiekopieën uitvoeren in Docker.Container images run in Docker.
    • U kunt de REST API of SDK gebruiken voor het aanroepen van bewerkingen in afwijkende detector containers door de URI van de host op te geven van de container.You can use either the REST API or SDK to call operations in Anomaly Detector containers by specifying the host URI of the container.
    • Bij het instantiëren van een container, moet u informatie over facturering opgeven.You must specify billing information when instantiating a container.

    Belangrijk

    Cognitive Services-containers zijn geen licentie om uit te voeren zonder verbinding met Azure voor het meten.Cognitive Services containers are not licensed to run without being connected to Azure for metering. Klanten moeten de containers om te communiceren factureringsgegevens met de softwarelicentiecontrole-service te allen tijde inschakelen.Customers need to enable the containers to communicate billing information with the metering service at all times. Cognitive Services containers verzenden geen klant gegevens (zoals de gegevens van de tijd reeks die worden geanalyseerd) naar micro soft.Cognitive Services containers do not send customer data (e.g., the time series data that is being analyzed) to Microsoft.

    Volgende stappenNext steps