Anomaly Detector 컨테이너 구성Configure Anomaly Detector containers

변칙 탐지기 컨테이너 런타임 환경은 명령 인수를 사용 하 여 구성 됩니다 docker run .The Anomaly Detector container runtime environment is configured using the docker run command arguments. 이 컨테이너에는 여러 필수 설정과 몇 가지 선택적 설정이 있습니다.This container has several required settings, along with a few optional settings. 몇 가지 명령의 예제를 사용할 수 있습니다.Several examples of the command are available. 청구 설정은 컨테이너별로 다릅니다.The container-specific settings are the billing settings.

구성 설정Configuration settings

이 컨테이너에는 다음 구성 설정을 사용합니다.This container has the following configuration settings:

필수Required 설정Setting 용도Purpose
Yes ApiKeyApiKey 청구 정보를 추적하는 데 사용됩니다.Used to track billing information.
아니요No ApplicationInsightsApplicationInsights Azure Application Insights 원격 분석 지원을 컨테이너에 추가할 수 있습니다.Allows you to add Azure Application Insights telemetry support to your container.
Yes 청구Billing Azure에서 서비스 리소스의 엔드포인트 URI를 지정합니다.Specifies the endpoint URI of the service resource on Azure.
Yes EulaEula 컨테이너에 대한 라이선스에 동의했음을 나타냅니다.Indicates that you've accepted the license for the container.
아니요No FluentdFluentd 로그 및 메트릭 데이터(선택 사항)를 Fluentd 서버에 씁니다.Write log and, optionally, metric data to a Fluentd server.
아니요No Http 프록시Http Proxy 아웃바운드 요청을 만들기 위한 HTTP 프록시를 구성합니다.Configure an HTTP proxy for making outbound requests.
아니요No LoggingLogging 컨테이너에 대한 ASP.NET Core 로깅 지원을 제공합니다.Provides ASP.NET Core logging support for your container.
아니요No MountsMounts 호스트 컴퓨터에서 컨테이너로 데이터를 읽고 쓰고, 컨테이너에서 호스트 컴퓨터로 다시 데이터를 읽고 씁니다.Read and write data from host computer to container and from container back to host computer.

중요

ApiKey, BillingEula 설정이 함께 사용 되며, 그 중 세 가지 모두에 대해 유효한 값을 제공 해야 합니다. 그렇지 않으면 컨테이너가 시작 되지 않습니다.The ApiKey, Billing, and Eula settings are used together, and you must provide valid values for all three of them; otherwise your container won't start. 이러한 구성 설정을 사용하여 컨테이너를 인스턴스화하는 방법에 대한 자세한 내용은 청구를 참조하세요.For more information about using these configuration settings to instantiate a container, see Billing.

ApiKey 구성 설정ApiKey configuration setting

ApiKey 설정은 컨테이너에 대한 청구 정보를 추적하는 데 사용되는 Azure 리소스 키를 지정합니다.The ApiKey setting specifies the Azure resource key used to track billing information for the container. ApiKey에 대 한 값을 지정 해야 하며,이 값은 구성 설정에 대해 지정 된 변칙 탐지기 리소스의 유효한 키 여야 합니다 Billing .You must specify a value for the ApiKey and the value must be a valid key for the Anomaly Detector resource specified for the Billing configuration setting.

이 설정은 다음 위치에서 찾을 수 있습니다.This setting can be found in the following place:

  • Azure Portal: 변칙 탐지기의 리소스 관리, 아래Azure portal: Anomaly Detector's Resource Management, under Keys

ApplicationInsights 설정ApplicationInsights setting

ApplicationInsights 설정으로 Azure Application Insights 원격 분석 지원을 컨테이너에 추가할 수 있습니다.The ApplicationInsights setting allows you to add Azure Application Insights telemetry support to your container. Application Insights는 컨테이너의 심층 모니터링을 제공합니다.Application Insights provides in-depth monitoring of your container. 컨테이너의 가용성, 성능 및 사용량을 쉽게 모니터링할 수 있습니다.You can easily monitor your container for availability, performance, and usage. 또한 컨테이너의 오류를 빠르게 식별하고 진단할 수 있습니다.You can also quickly identify and diagnose errors in your container.

다음 표에서는 ApplicationInsights 섹션에서 지원되는 구성 설정을 설명합니다.The following table describes the configuration settings supported under the ApplicationInsights section.

필수Required 속성Name 데이터 형식Data type DescriptionDescription
No InstrumentationKey 문자열String 컨테이너에 대한 원격 분석 데이터가 전송되는 Application Insights 인스턴스의 계측 키입니다.The instrumentation key of the Application Insights instance to which telemetry data for the container is sent. 자세한 내용은 ASP.NET Core용 Application Insights를 참조하세요.For more information, see Application Insights for ASP.NET Core.

예제:Example:
InstrumentationKey=123456789

청구 구성 설정Billing configuration setting

Billing설정은 Azure에서 컨테이너에 대 한 청구 정보를 측정 하는 데 사용 되는 변칙 탐지기 리소스의 끝점 URI를 지정 합니다.The Billing setting specifies the endpoint URI of the Anomaly Detector resource on Azure used to meter billing information for the container. 이 구성 설정의 값을 지정 해야 하며,이 값은 Azure의 변칙 탐지기 리소스에 대 한 올바른 끝점 URI 여야 합니다.You must specify a value for this configuration setting, and the value must be a valid endpoint URI for an Anomaly Detector resource on Azure.

이 설정은 다음 위치에서 찾을 수 있습니다.This setting can be found in the following place:

  • Azure Portal: 변칙 탐지기 개요, 레이블EndpointAzure portal: Anomaly Detector's Overview, labeled Endpoint
필수Required 이름Name 데이터 형식Data type DescriptionDescription
Yes Billing StringString 청구 끝점 URI입니다.Billing endpoint URI. 청구 URI를 얻는 방법에 대 한 자세한 내용은 필수 매개 변수 수집을 참조 하세요.For more information on obtaining the billing URI, see gathering required parameters. 자세한 내용 및 지역별 엔드포인트의 전체 목록은 Cognitive Services에 대한 사용자 지정 하위 도메인 이름을 참조하세요.For more information and a complete list of regional endpoints, see Custom subdomain names for Cognitive Services.

Eula 설정Eula setting

Eula 설정은 컨테이너에 대한 라이선스에 동의했음을 나타냅니다.The Eula setting indicates that you've accepted the license for the container. 이 구성 설정에 대한 값을 지정해야 하며, 이 값은 accept로 설정해야 합니다.You must specify a value for this configuration setting, and the value must be set to accept.

필수Required 속성Name 데이터 형식Data type DescriptionDescription
Yes Eula StringString 라이선스 승인License acceptance

예제:Example:
Eula=accept

Cognitive Services 컨테이너는 Azure 사용에 관한 계약에 따라 사용 허가됩니다.Cognitive Services containers are licensed under your agreement governing your use of Azure. Azure 사용을 관리 하는 기존 계약이 없는 경우 Azure 사용을 제어 하는 계약은 Online Services 약관을 포함 하는 Microsoft 온라인 정기가입 계약에 동의 하는 것입니다.If you do not have an existing agreement governing your use of Azure, you agree that your agreement governing use of Azure is the Microsoft Online Subscription Agreement, which incorporates the Online Services Terms. 미리 보기의 경우 Microsoft Azure 미리 보기에 대한 추가 사용 약관에도 동의합니다.For previews, you also agree to the Supplemental Terms of Use for Microsoft Azure Previews. 컨테이너를 사용하여 이 사용 약관에 동의합니다.By using the container you agree to these terms.

Fluentd 설정Fluentd settings

Fluentd는 통합된 로깅에 대한 오픈 소스 데이터 수집기입니다.Fluentd is an open-source data collector for unified logging. Fluentd 설정은 Fluentd 서버에 컨테이너의 연결을 관리합니다.The Fluentd settings manage the container's connection to a Fluentd server. 컨테이너에는 Fluentd 로깅 공급자가 포함되어 있어 컨테이너에서 로그 및 메트릭 데이터(선택 사항)를 Fluentd 서버에 쓸 수 있습니다.The container includes a Fluentd logging provider, which allows your container to write logs and, optionally, metric data to a Fluentd server.

다음 표에서는 Fluentd 섹션에서 지원되는 구성 설정을 설명합니다.The following table describes the configuration settings supported under the Fluentd section.

속성Name 데이터 형식Data type DescriptionDescription
Host 문자열String Fluentd 서버의 IP 주소 또는 DNS 호스트 이름입니다.The IP address or DNS host name of the Fluentd server.
Port 정수Integer Fluentd 서버의 포트입니다.The port of the Fluentd server.
기본값은 24224입니다.The default value is 24224.
HeartbeatMs 정수Integer 하트비트 간격(밀리초)입니다.The heartbeat interval, in milliseconds. 이 간격이 만료되기 전에 전송된 이벤트 트래픽이 없을 경우 하트 비트는 Fluentd 서버로 전송됩니다.If no event traffic has been sent before this interval expires, a heartbeat is sent to the Fluentd server. 기본값은 60000밀리초(1분)입니다.The default value is 60000 milliseconds (1 minute).
SendBufferSize 정수Integer 전송 작업에 할당된 네트워크 버퍼 공간(바이트)입니다.The network buffer space, in bytes, allocated for send operations. 기본값은 32768바이트(32킬로바이트)입니다.The default value is 32768 bytes (32 kilobytes).
TlsConnectionEstablishmentTimeoutMs 정수Integer Fluentd 서버와 SSL/TLS 연결을 설정하기 위한 시간 제한(밀리초)입니다.The timeout, in milliseconds, to establish a SSL/TLS connection with the Fluentd server. 기본값은 10000밀리초(10초)입니다.The default value is 10000 milliseconds (10 seconds).
UseTLS가 false로 설정되어 있는 경우 이 값은 무시됩니다.If UseTLS is set to false, this value is ignored.
UseTLS 부울Boolean 컨테이너가 Fluentd 서버와 통신하기 위해 SSL/TLS를 사용해야 하는지 여부를 나타냅니다.Indicates whether the container should use SSL/TLS for communicating with the Fluentd server. 기본값은 False입니다.The default value is false.

Http 프록시 자격 증명 설정Http proxy credentials settings

아웃바운드 요청을 만들기 위한 HTTP 프록시를 구성해야 하는 경우 다음 두 인수를 사용합니다.If you need to configure an HTTP proxy for making outbound requests, use these two arguments:

속성Name 데이터 형식Data type DescriptionDescription
HTTP_PROXYHTTP_PROXY stringstring 사용할 프록시(예: http://proxy:8888)The proxy to use, for example, http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDSHTTP_PROXY_CREDS stringstring 프록시를 인증하는 데 필요한 자격 증명(예: username:password).Any credentials needed to authenticate against the proxy, for example, username:password.
<proxy-user> stringstring 프록시 사용자입니다.The user for the proxy.
<proxy-password> stringstring 프록시에 대해 <proxy-user>에 연결된 암호입니다.The password associated with <proxy-user> for the proxy.
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
HTTP_PROXY=<proxy-url> \
HTTP_PROXY_CREDS=<proxy-user>:<proxy-password> \

로깅 설정Logging settings

Logging 설정은 컨테이너에 대한 ASP.NET Core 로깅 지원을 관리합니다.The Logging settings manage ASP.NET Core logging support for your container. ASP.NET Core 애플리케이션에 사용하는 컨테이너에 대한 동일한 구성 설정 및 값을 사용할 수 있습니다.You can use the same configuration settings and values for your container that you use for an ASP.NET Core application.

컨테이너에서 지원되는 로깅 공급자는 다음과 같습니다.The following logging providers are supported by the container:

공급자Provider 목적Purpose
콘솔Console ASP.NET Core Console 로깅 공급자입니다.The ASP.NET Core Console logging provider. 이 로깅 공급자에 대한 모든 ASP.NET Core 구성 설정 및 기본값이 지원됩니다.All of the ASP.NET Core configuration settings and default values for this logging provider are supported.
디버그Debug ASP.NET Core Debug 로깅 공급자입니다.The ASP.NET Core Debug logging provider. 이 로깅 공급자에 대한 모든 ASP.NET Core 구성 설정 및 기본값이 지원됩니다.All of the ASP.NET Core configuration settings and default values for this logging provider are supported.
디스크로Disk JSON 로깅 공급자입니다.The JSON logging provider. 이 로깅 공급자는 출력 탑재에 로그 데이터를 씁니다.This logging provider writes log data to the output mount.

이 컨테이너 명령은 출력 탑재에 대한 JSON 형식의 로깅 정보를 저장합니다.This container command stores logging information in the JSON format to the output mount:

docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Disk:Format=json

이 컨테이너 명령은 컨테이너가 실행되는 동안 접두사가 dbug인 디버깅 정보를 보여줍니다.This container command shows debugging information, prefixed with dbug, while the container is running:

docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Console:LogLevel:Default=Debug

디스크 로깅Disk logging

Disk 로깅 공급자는 다음과 같은 구성 설정을 지원합니다.The Disk logging provider supports the following configuration settings:

속성Name 데이터 형식Data type DescriptionDescription
Format 문자열String 로그 파일에 대한 출력 형식입니다.The output format for log files.
참고: 로깅 공급자를 사용 설정하려면 이 값을 json으로 설정해야 합니다.Note: This value must be set to json to enable the logging provider. 또한 컨테이너를 인스턴스화하는 동안 출력 탑재를 지정하지 않고 이 값이 지정된 경우에는 오류가 발생합니다.If this value is specified without also specifying an output mount while instantiating a container, an error occurs.
MaxFileSize 정수Integer 로그 파일의 최대 크기(MB)입니다.The maximum size, in megabytes (MB), of a log file. 현재 로그 파일의 크기가 이 값을 충족하거나 초과할 경우 로깅 공급자가 새 로그 파일을 시작합니다.When the size of the current log file meets or exceeds this value, a new log file is started by the logging provider. -1을 지정하면 로그 파일의 크기는 출력 탑재(있는 경우)에 대한 최대 파일 크기에 의해서만 제한됩니다.If -1 is specified, the size of the log file is limited only by the maximum file size, if any, for the output mount. 기본값은 1입니다.The default value is 1.

ASP.NET Core 로깅 지원 구성에 대한 자세한 내용은 설정 파일 구성을 참조하세요.For more information about configuring ASP.NET Core logging support, see Settings file configuration.

탑재 설정Mount settings

바인딩 탑재를 사용하여 컨테이너에서 또는 컨테이너로 읽고 씁니다.Use bind mounts to read and write data to and from the container. Docker 실행 명령의 --mount옵션을 지정하여 입력 탑재 또는 출력 탑재를 지정할 수 있습니다.You can specify an input mount or output mount by specifying the --mount option in the docker run command.

변칙 탐지기 컨테이너는 입력 또는 출력 탑재를 사용 하 여 학습 또는 서비스 데이터를 저장 하지 않습니다.The Anomaly Detector containers don't use input or output mounts to store training or service data.

호스트 탑재 위치의 정확한 구문은 호스트 운영 체제에 따라 다릅니다.The exact syntax of the host mount location varies depending on the host operating system. 또한 Docker 서비스 계정에서 사용 하는 사용 권한 및 호스트 탑재 위치 권한에 따라 호스트 컴퓨터의 탑재 위치에 액세스할 수 없습니다.Additionally, the host computer's mount location may not be accessible due to a conflict between permissions used by the Docker service account and the host mount location permissions.

선택 사항Optional 이름Name 데이터 형식Data type DescriptionDescription
허용되지 않음Not allowed Input 문자열String 변칙 탐지기 컨테이너는이를 사용 하지 않습니다.Anomaly Detector containers do not use this.
선택Optional Output 문자열String 출력 탑재의 대상입니다.The target of the output mount. 기본값은 /output입니다.The default value is /output. 로그의 위치입니다.This is the location of the logs. 컨테이너 로그가 포함됩니다.This includes container logs.

예제:Example:
--mount type=bind,src=c:\output,target=/output

Docker 실행 명령 예제Example docker run commands

다음 예제에서는 구성 설정을 사용하여 docker run 명령을 쓰고 사용하는 방법을 설명합니다.The following examples use the configuration settings to illustrate how to write and use docker run commands. 한번 실행되면 컨테이너는 중지할 때까지 계속 실행됩니다.Once running, the container continues to run until you stop it.

  • 줄 연속 문자: 다음 섹션의 Docker 명령은 \ bash 셸에서 줄 연속 문자로 백슬래시를 사용 합니다.Line-continuation character: The Docker commands in the following sections use the back slash, \, as a line continuation character for a bash shell. 호스트 운영 체제의 요구 사항에서 이 기준을 바꾸거나 제거합니다.Replace or remove this based on your host operating system's requirements. 예를 들어, Windows에 대한 줄 연속 문자는 캐럿(^)입니다.For example, the line continuation character for windows is a caret, ^. 백슬래시를 캐렛으로 바꿉니다.Replace the back slash with the caret.
  • 인수 순서: Docker 컨테이너에 대해 잘 알고 있지 않으면 인수의 순서를 변경 하지 마세요.Argument order: Do not change the order of the arguments unless you are very familiar with Docker containers.

대괄호 ()의 값을 {} 고유한 값으로 바꿉니다.Replace value in brackets, {}, with your own values:

자리 표시자Placeholder Value 형식 또는 예Format or example
{API_KEY}{API_KEY} Anomaly DetectorAzure 키 페이지에 있는 리소스의 끝점 키 Anomaly Detector 입니다.The endpoint key of the Anomaly Detector resource on the Azure Anomaly Detector Keys page. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{ENDPOINT_URI}{ENDPOINT_URI} 청구 끝점 값은 Azure 개요 페이지에서 사용할 수 있습니다 Anomaly Detector .The billing endpoint value is available on the Azure Anomaly Detector Overview page. 명시적 예제에 대 한 필수 매개 변수 수집 을 참조 하세요.See gathering required parameters for explicit examples.

참고

2019년 7월 1일 이후에 만들어진 새 리소스는 사용자 지정 하위 도메인 이름을 사용합니다.New resources created after July 1, 2019, will use custom subdomain names. 자세한 내용 및 지역별 엔드포인트의 전체 목록은 Cognitive Services에 대한 사용자 지정 하위 도메인 이름을 참조하세요.For more information and a complete list of regional endpoints, see Custom subdomain names for Cognitive Services.

중요

컨테이너를 인스턴스화하려면 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. ApiKey 값은 Azure 변칙 탐지기 리소스 키 페이지의 입니다.The ApiKey value is the Key from the Azure Anomaly Detector Resource keys page.

변칙 탐지기 컨테이너 Docker 예Anomaly Detector container Docker examples

다음 Docker 예는 변칙 탐지기 컨테이너를 위한 것입니다.The following Docker examples are for the Anomaly Detector container.

기본 예제Basic example

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

명령줄 인수를 사용한 로깅 예제Logging example with command-line arguments

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

다음 단계Next steps