변칙 탐지기 컨테이너 설치 및 실행 (미리 보기)Install and run Anomaly Detector containers (Preview)

변칙 탐지기에는 다음과 같은 컨테이너 기능 기능이 있습니다.The Anomaly Detector has the following container feature functionality:

기능Function 기능Features
Anomaly DetectorAnomaly detector
  • 는 실시간으로 발생 하는 변칙을 검색 합니다.Detects anomalies as they occur in real-time.
  • 일괄 처리로 데이터 집합 전체에서 변칙을 검색 합니다.Detects anomalies throughout your data set as a batch.
  • 데이터의 정상적인 범위를 유추 합니다.Infers the expected normal range of your data.
  • 데이터에 더 잘 맞도록 변칙 검색 민감도 조정을 지원 합니다.Supports anomaly detection sensitivity adjustment to better fit your data.
  • Api에 대 한 자세한 내용은 다음을 참조 하세요.For detailed information about the APIs, please see:

    Azure 구독이 아직 없는 경우 시작하기 전에 체험 계정을 만듭니다.If you don't have an Azure subscription, create a free account before you begin.

    사전 요구 사항Prerequisites

    변칙 탐지기 컨테이너를 사용 하기 전에 다음 필수 구성 요소를 충족 해야 합니다.You must meet the following prerequisites before using Anomaly Detector containers:

    필수Required 용도Purpose
    Docker 엔진Docker Engine 호스트 컴퓨터에 설치된 Docker 엔진이 필요합니다.You need the Docker Engine installed on a host computer. Docker는 macOS, WindowsLinux에 Docker 환경을 구성하는 패키지를 제공합니다.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. Docker 및 컨테이너에 대한 기본 사항은 Docker 개요를 참조하세요.For a primer on Docker and container basics, see the Docker overview.

    Docker는 컨테이너에서 Azure에 연결하여 청구 데이터를 보낼 수 있도록 구성해야 합니다.Docker must be configured to allow the containers to connect with and send billing data to Azure.

    Windows에서 Docker는 Linux 컨테이너를 지원하도록 구성해야 합니다.On Windows, Docker must also be configured to support Linux containers.

    Docker 사용 경험Familiarity with Docker 기본 docker명령에 대한 지식뿐만 아니라 레지스트리, 리포지토리, 컨테이너 및 컨테이너 이미지와 같은 Docker 개념에 대해 기본적으로 이해해야 합니다.You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic docker commands.
    변칙 탐지기 리소스Anomaly Detector resource 이러한 컨테이너를 사용하려면 다음이 있어야 합니다.In order to use these containers, you must have:

    연결 된 API 키와 끝점 URI를 가져오는 Azure 변칙 탐지기 리소스입니다.An Azure Anomaly Detector resource to get the associated API key and endpoint URI. 두 값은 모두 Azure Portal의 변칙 탐지기 개요 및 키 페이지에서 사용할 수 있으며 컨테이너를 시작 하는 데 필요 합니다.Both values are available on the Azure portal's Anomaly Detector Overview and Keys pages and are required to start the container.

    {API_KEY}: 페이지에서 사용 가능한 두 리소스 키 중 하나{API_KEY}: One of the two available resource keys on the Keys page

    {ENDPOINT_URI}: 개요 페이지에 제공 된 끝점입니다.{ENDPOINT_URI}: The endpoint as provided on the Overview page

    필수 매개 변수 수집Gathering required parameters

    필요한 모든 Cognitive Services의 컨테이너에 대 한 세 가지 기본 매개 변수가 필요 합니다.There are three primary parameters for all Cognitive Services' containers that are required. 최종 사용자 사용권 계약 (EULA)은 값과 함께 제공 되어야 합니다 accept.The end-user license agreement (EULA) must be present with a value of accept. 또한 끝점 URL과 API 키가 모두 필요 합니다.Additionally, both an Endpoint URL and API Key are needed.

    끝점 URI{ENDPOINT_URI}Endpoint URI {ENDPOINT_URI}

    끝점 URI 값은 해당 하는 인지 서비스 리소스의 Azure Portal 개요 페이지에서 사용할 수 있습니다.The Endpoint URI value is available on the Azure portal Overview page of the corresponding Cognitive Service resource. 개요 페이지로 이동 하 고 끝점 Copy to clipboard 을 마우스로 가리키면 아이콘이 표시 됩니다.Navigate to the Overview page, hover over the Endpoint, and a Copy to clipboard icon will appear. 필요에 따라 복사 하 여 사용 합니다.Copy and use where needed.

    나중에 사용할 끝점 uri 수집

    {API_KEY}Keys {API_KEY}

    이 키는 컨테이너를 시작 하는 데 사용 되며 해당 하는 인지 서비스 리소스의 Azure Portal 키 페이지에서 사용할 수 있습니다.This key is used to start the container, and is available on the Azure portal's Keys page of the corresponding Cognitive Service resource. 페이지로 이동 하 여 Copy to clipboard 아이콘을 클릭 합니다.Navigate to the Keys page, and click on the Copy to clipboard icon.

    나중에 사용 하기 위해 두 키 중 하나를 가져옵니다.

    중요

    이러한 구독 키는 인식 서비스 API에 액세스 하는 데 사용 됩니다.These subscription keys are used to access your Cognitive Service API. 키를 공유 하지 마세요.Do not share your keys. 예를 들어 Azure Key Vault를 사용 하 여 안전 하 게 저장 합니다.Store them securely, for example, using Azure Key Vault. 또한 이러한 키를 정기적으로 다시 생성 하는 것이 좋습니다.We also recommend regenerating these keys regularly. API 호출을 수행 하는 데는 키가 하나만 필요 합니다.Only one key is necessary to make an API call. 첫 번째 키를 다시 생성 하는 경우 두 번째 키를 사용 하 여 서비스에 계속 액세스할 수 있습니다.When regenerating the first key, you can use the second key for continued access to the service.

    호스트 컴퓨터The host computer

    호스트는 Docker 컨테이너를 실행하는 x64 기반 컴퓨터입니다.The host is a x64-based computer that runs the Docker container. 다음과 같이 Azure에서 컴퓨터 온-프레미스 또는 Docker 호스팅 서비스일 수 있습니다.It can be a computer on your premises or a Docker hosting service in Azure, such as:

    컨테이너 요구 사항 및 추천Container requirements and recommendations

    다음 표에서는 변칙 탐지기 컨테이너에 할당 하는 데 필요한 최소 및 권장 CPU 코어 및 메모리를 설명 합니다.The following table describes the minimum and recommended CPU cores and memory to allocate for Anomaly Detector container.

    QPS (초당 쿼리 수)QPS(Queries per second) 최소값Minimum 권장Recommended
    10 QPS10 QPS 4 코어, 1gb 메모리4 core, 1-GB memory 8 코어 2gb 메모리8 core 2-GB memory
    20 QPS20 QPS 8 코어, 2gb 메모리8 core, 2-GB memory 16 코어 4gb 메모리16 core 4-GB memory

    각 코어는 속도가 2.6GHz 이상이어야 합니다.Each core must be at least 2.6 gigahertz (GHz) or faster.

    docker run 명령의 일부로 사용되는 --cpus--memory 설정에 해당하는 코어 및 메모리.Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

    docker pull을 사용하여 컨테이너 이미지 가져오기Get the container image with docker pull

    명령을 사용 docker pull 하 여 컨테이너 이미지를 다운로드 합니다.Use the docker pull command to download a container image.

    컨테이너Container 리포지토리Repository
    cognitive-services-anomaly-detectorcognitive-services-anomaly-detector mcr.microsoft.com/azure-cognitive-services/anomaly-detector:latest

    docker images 명령을 사용하여 다운로드한 컨테이너 이미지를 나열할 수 있습니다.You can use the docker images command to list your downloaded container images. 예를 들어 다음 명령은 다운로드한 각 컨테이너 이미지의 ID, 리포지토리 및 태그를 테이블 형식으로 나열합니다.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 풀Docker pull for the Anomaly Detector container

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

    컨테이너사용 방법How to use the container

    컨테이너가 호스트 컴퓨터에 있으면 다음 프로세스를 사용하여 컨테이너 작업을 수행합니다.Once the container is on the host computer, use the following process to work with the container.

    1. 필수 청구 설정을 사용하여 컨테이너를 실행합니다.Run the container, with the required billing settings. docker run 명령의 자세한 예제를 사용할 수 있습니다.More examples of the docker run command are available.
    2. 컨테이너의 예측 끝점을 쿼리합니다.Query the container's prediction endpoint.

    docker run을 사용하여 컨테이너 실행Run the container with docker run

    Docker 실행 명령을 사용하여 컨테이너를 실행합니다.Use the docker run command to run the container. {ENDPOINT_URI}{API_KEY} 값을 가져오는 방법에 대한 자세한 내용은 필수 매개 변수 수집을 참조 하세요.Refer to gathering required parameters for details on how to get the {ENDPOINT_URI} and {API_KEY} values.

    docker run명령의 를 사용할 수 있습니다.Examples of the docker run command are available.

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

    이 명령은 다음을 수행합니다.This command:

    • 컨테이너 이미지에서 변칙 탐지기 컨테이너를 실행 합니다.Runs an Anomaly Detector container from the container image
    • 1개 CPU 코어 및 4GB 메모리 할당Allocates one CPU core and 4 gigabytes (GB) of memory
    • 5000 TCP 포트 표시 및 컨테이너에 의사-TTY 할당Exposes TCP port 5000 and allocates a pseudo-TTY for the container
    • 종료 후 자동으로 컨테이너를 제거합니다.Automatically removes the container after it exits. 컨테이너 이미지는 호스트 컴퓨터에서 계속 사용할 수 있습니다.The container image is still available on the host computer.

    중요

    컨테이너를 인스턴스화하려면 Eula, BillingApiKey 옵션을 지정해야 합니다. 그렇지 않으면 컨테이너가 시작되지 않습니다.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. 자세한 내용은 Billing를 참조하세요.For more information, see Billing.

    동일한 호스트에서 여러 컨테이너 실행Running multiple containers on the same host

    노출된 포트로 여러 컨테이너를 실행하려는 경우, 각 컨테이너를 다른 포트로 실행해야 합니다.If you intend to run multiple containers with exposed ports, make sure to run each container with a different port. 예를 들어 첫 번째 컨테이너는 포트 5000에서 실행하고 두 번째 컨테이너는 포트 5001에서 실행합니다.For example, run the first container on port 5000 and the second container on port 5001.

    <container-registry><container-name>을 사용하는 컨테이너의 값으로 대체합니다.Replace the <container-registry> and <container-name> with the values of the containers you use. 동일한 컨테이너일 필요는 없습니다.These do not have to be the same container. 변칙 탐지기 컨테이너와 호스트에서 LUIS 컨테이너를 함께 실행 하거나 여러 변칙 탐지기 컨테이너를 실행할 수 있습니다.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.

    포트 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}
    

    포트 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}
    

    이후의 각 컨테이너는 다른 포트에 있어야 합니다.Each subsequent container should be on a different port.

    컨테이너의 예측 엔드포인트 쿼리Query the container's prediction endpoint

    컨테이너는 REST 기반 쿼리 예측 엔드포인트 API를 제공합니다.The container provides REST-based query prediction endpoint APIs.

    컨테이너 API에 대한 호스트, http://localhost:5000을 사용합니다.Use the host, http://localhost:5000, for container APIs.

    컨테이너가 실행 중인지 확인Validate that a container is running

    컨테이너가 실행되고 있는지 확인하는 방법은 여러 가지가 있습니다.There are several ways to validate that the container is running. 해당 하는 컨테이너의 외부 IP 주소 및 노출 된 포트를 찾아 즐겨 찾는 웹 브라우저를 엽니다.Locate the External IP address and exposed port of the container in question, and open your favorite web browser. 아래에서 다양 한 요청 Url을 사용 하 여 컨테이너가 실행 중인지 확인 합니다.Use the various request URLs below to validate the container is running. 아래 나열 된 예제 요청 Url은 http://localhost:5000이지만 특정 컨테이너는 다를 수 있습니다.The example request URLs listed below are http://localhost:5000, but your specific container may vary. 컨테이너의 외부 IP 주소 및 노출 된 포트를 사용 해야 한다는 점에 유의 하세요.Keep in mind that you're to rely on your container's External IP address and exposed port.

    요청 URLRequest URL 목적Purpose
    http://localhost:5000/ 컨테이너는 홈페이지를 제공합니다.The container provides a home page.
    http://localhost:5000/status 끝점 쿼리를 발생 시 키 지 않고 컨테이너가 실행 중인지 유효성을 검사 하기 위해 HTTP GET을 사용 하 여 요청 됩니다.Requested with an HTTP GET, to validate that the container is running without causing an endpoint query. 이 요청은 Kubernetes 활동성 및 준비 상태 프로브에 사용될 수 있습니다.This request can be used for Kubernetes liveness and readiness probes.
    http://localhost:5000/swagger 컨테이너는 끝점에 대 한 전체 설명서 집합과 사용해 보기 기능을 제공 합니다.The container provides a full set of documentation for the endpoints and a Try it out feature. 이 기능을 사용하면 웹 기반 HTML 양식으로 설정을 입력할 수 있고 코드 작성 없이 쿼리를 만들 수 있습니다.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. 쿼리가 반환되면 필요한 HTTP 헤더 및 본문 형식을 보여주기 위해 예제 CURL 명령이 제공됩니다.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

    컨테이너의 홈페이지

    컨테이너 중지Stop the container

    컨테이너를 종료 하려면 컨테이너가 실행 되는 명령줄 환경에서 Ctrl + C를 선택 합니다.To shut down the container, in the command-line environment where the container is running, select Ctrl+C.

    문제 해결Troubleshooting

    출력 탑재 및 활성화된 로깅을 사용하여 컨테이너를 실행하는 경우 컨테이너는 컨테이너를 시작 또는 실행하는 동안 발생하는 문제를 해결하는 데 도움이 되는 로그 파일을 생성합니다.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.

    자세한 문제 해결 정보 및 지침은 Cognitive Services 컨테이너 faq (질문과 대답)를 참조 하세요.For more troubleshooting information and guidance, see Cognitive Services containers frequently asked questions (FAQ).

    청구Billing

    변칙 탐지기 컨테이너는 Azure 계정에서 변칙 탐지기 리소스를 사용 하 여 azure로 청구 정보를 보냅니다.The Anomaly Detector containers send billing information to Azure, using an Anomaly Detector resource on your Azure account.

    컨테이너에 대 한 쿼리는에 사용 되는 Azure 리소스의 가격 책정 계층에서 청구 됩니다 ApiKey.Queries to the container are billed at the pricing tier of the Azure resource that's used for the ApiKey.

    Azure Cognitive Services 컨테이너는 계량/청구 끝점에 연결 하지 않고 실행할 수 있는 권한이 없습니다.Azure Cognitive Services containers aren't licensed to run without being connected to the metering / billing endpoint. 사용자는 컨테이너가 항상 청구 엔드포인트와 청구 정보를 통신할 수 있도록 설정해야 합니다.You must enable the containers to communicate billing information with the billing endpoint at all times. Cognitive Services 컨테이너는 고객 데이터(예: 분석 중인 이미지 또는 텍스트)를 Microsoft에 보내지 않습니다.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

    Azure 연결Connect to Azure

    컨테이너에는 실행할 청구 인수 값이 필요합니다.The container needs the billing argument values to run. 이러한 값을 통해 컨테이너는 청구 엔드포인트에 연결할 수 있습니다.These values allow the container to connect to the billing endpoint. 컨테이너는 약 10 ~ 15분마다 사용량을 보고합니다.The container reports usage about every 10 to 15 minutes. 컨테이너가 허용되는 시간 내에서 Azure에 연결되지 않으면 컨테이너는 계속 실행되지만 청구 엔드포인트가 복원될 때까지 쿼리를 처리하지 않습니다.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. 10 ~ 15분 간격으로 동시에 10회 동안 연결이 시도됩니다.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. 10 번의 시도 내에서 청구 끝점에 연결할 수 없는 경우 컨테이너는 요청 처리를 중지 합니다.If it can't connect to the billing endpoint within the 10 tries, the container stops serving requests.

    청구 인수Billing arguments

    이 명령은 다음 중 세 가지 옵션을 모두 유효한 값으로 제공 하면 컨테이너를 시작 합니다. docker run The docker run command will start the container when all three of the following options are provided with valid values:

    옵션Option DescriptionDescription
    ApiKey 청구 정보를 추적 하는 데 사용 되는 Cognitive Services 리소스의 API 키입니다.The API key of the Cognitive Services resource that's used to track billing information.
    이 옵션의 값은에 Billing지정 된 프로 비전 된 리소스에 대 한 API 키로 설정 되어야 합니다.The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
    Billing 청구 정보를 추적 하는 데 사용 되는 Cognitive Services 리소스의 끝점입니다.The endpoint of the Cognitive Services resource that's used to track billing information.
    이 옵션의 값은 프로비저닝된 Azure 리소스의 엔드포인트 URI로 설정해야 합니다.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
    Eula 컨테이너에 대한 라이선스에 동의했음을 나타냅니다.Indicates that you accepted the license for the container.
    이 옵션의 값은 accept로 설정 되어야 합니다.The value of this option must be set to accept.

    이러한 옵션에 대한 자세한 내용은 컨테이너 구성을 참조하세요.For more information about these options, see Configure containers.

    블로그 게시물Blog posts

    개발자 샘플Developer samples

    개발자 샘플은 GitHub 리포지토리에 있습니다.Developer samples are available at our GitHub repository.

    웹 세미나 보기View webinar

    웹 세미나에 조인하여 다음에 대해 알아봅니다.Join the webinar to learn about:

    • Docker를 사용하여 머신에 Cognitive Services를 배포하는 방법How to deploy Cognitive Services to any machine using Docker
    • Cognitive Services를 AKS에 배포하는 방법How to deploy Cognitive Services to AKS

    요약Summary

    이 문서에서는 변칙 탐지기 컨테이너를 다운로드, 설치 및 실행 하기 위한 개념과 워크플로를 배웠습니다.In this article, you learned concepts and workflow for downloading, installing, and running Anomaly Detector containers. 요약하면 다음과 같습니다.In summary:

    • 변칙 탐지기는 Docker에 대해 하나의 Linux 컨테이너를 제공 하 고, batch vs 스트리밍을 사용 하 여 변칙 검색을 캡슐화 하 고, 예상 범위 유추와 민감도 조정을 제공 합니다.Anomaly Detector provides one Linux container for Docker, encapsulating anomaly detection with batch vs streaming, expected range inference, and sensitivity tuning.
    • 컨테이너 이미지는 컨테이너 미리 보기 전용 전용 Azure Container Registry에서 다운로드 됩니다.Container images are downloaded from a private Azure Container Registry dedicated for containers preview.
    • 컨테이너 이미지는 Docker에서 실행됩니다.Container images run in Docker.
    • 컨테이너의 호스트 URI를 지정 하 여 변칙 탐지기 컨테이너에서 작업을 호출 하는 데 REST API 또는 SDK를 사용할 수 있습니다.You can use either the REST API or SDK to call operations in Anomaly Detector containers by specifying the host URI of the container.
    • 컨테이너를 인스턴스화할 때 청구 정보를 지정해야 합니다.You must specify billing information when instantiating a container.

    중요

    Cognitive Services 컨테이너는 측광을 위해 Azure에 연결되지 않은 상태에서 실행할 수 있는 권한이 없습니다.Cognitive Services containers are not licensed to run without being connected to Azure for metering. 고객은 컨테이너에서 항상 계량 서비스와 청구 정보를 통신할 수 있도록 설정해야 합니다.Customers need to enable the containers to communicate billing information with the metering service at all times. Cognitive Services 컨테이너는 고객 데이터 (예: 분석 중인 시계열 데이터)를 Microsoft에 보내지 않습니다.Cognitive Services containers do not send customer data (e.g., the time series data that is being analyzed) to Microsoft.

    다음 단계Next steps