Configurar contentores do Detetor de Anomalias

O ambiente de funcionamento do detetor de anomalias é configurado utilizando os argumentos de docker run comando. Este recipiente tem várias configurações necessárias, juntamente com algumas configurações opcionais. Vários exemplos do comando estão disponíveis. As definições específicas do contentor são as definições de faturação.

Definições de configuração

Este recipiente tem as seguintes definições de configuração:

Necessário Definição Objetivo
Yes ApiKey Usado para rastrear informação de faturação.
No ApplicationInsights Permite-lhe adicionar suporte de telemetria Azure Application Insights ao seu recipiente.
Yes Faturação Especifica o ponto final URI do recurso de serviço no Azure.
Yes Eula Indica que aceitou a licença para o contentor.
No Fluente Escreva log e, opcionalmente, dados métricos para um servidor Fluentd.
No Http Proxy Configure um representante HTTP para fazer pedidos de saída.
No Registo Fornece ASP.NET suporte de registo de registo do núcleo para o seu recipiente.
No Montes Leia e escreva dados do computador anfitrião para o recipiente e do recipiente de volta ao computador anfitrião.

Importante

As ApiKey Billing definições , e Eula configurações são utilizadas em conjunto, e deve fornecer valores válidos para os três; caso contrário, o seu recipiente não arranca. Para obter mais informações sobre a utilização destas configurações para instantaneaizar um recipiente, consulte Billing.

Definição de configuração apikey

A ApiKey definição especifica a chave de recursos Azure utilizada para rastrear as informações de faturação do recipiente. Tem de especificar um valor para o ApiKey e o valor deve ser uma chave válida para o recurso de detetor de anomalias especificado para a definição de Billing configuração.

Esta definição pode ser encontrada no seguinte local:

  • Portal Azure: Gestão de Recursos do Detetor de Anomalias, em Chaves

Configuração de AplicaçõesInsights

A ApplicationInsights definição permite-lhe adicionar suporte de telemetria Azure Application Insights ao seu recipiente. O Application Insights fornece uma monitorização aprofundada do seu recipiente. Pode monitorizar facilmente o seu recipiente para obter disponibilidade, desempenho e utilização. Também pode identificar e diagnosticar rapidamente erros no seu recipiente.

A tabela seguinte descreve as definições de configuração suportadas na ApplicationInsights secção.

Necessário Name Tipo de dados Descrição
Não InstrumentationKey String A chave de instrumentação da instância Application Insights para a qual são enviados os dados de telemetria do recipiente. Para obter mais informações, consulte Insights de Aplicação para ASP.NET Core.

Exemplo:
InstrumentationKey=123456789

Definição de configuração de faturação

A Billing definição especifica o ponto final URI do recurso de detetor de anomalias no Azure utilizado para medir informações de faturação para o recipiente. Tem de especificar um valor para esta definição de configuração, e o valor deve ser um URI de ponto final válido para um recurso de detetor de anomalias no Azure.

Esta definição pode ser encontrada no seguinte local:

  • Portal Azure: Visão geral do Detetor de Anomalias, etiquetada Endpoint
Necessário Name Tipo de dados Descrição
Sim Billing String URI de faturação. Para obter mais informações sobre a obtenção do URI de faturação, consulte a recolha dos parâmetros necessários. Para obter mais informações e uma lista completa de pontos finais regionais, consulte os nomes de subdomínio personalizados para serviços cognitivos.

Definição de Eula

A Eula definição indica que aceitou a licença para o contentor. Tem de especificar um valor para esta definição de configuração e o valor deve ser definido para accept .

Necessário Name Tipo de dados Descrição
Sim Eula String Aceitação de licença

Exemplo:
Eula=accept

Os contentores dos Serviços Cognitivos são licenciados ao abrigo do seu acordo que rege o seu uso do Azure. Se não tiver um acordo existente que regule a sua utilização do Azure, concorda que o seu acordo que rege a utilização do Azure é o Microsoft Online Subscription Agreement, que incorpora os Termos de Serviços Online. Para pré-visualizações, também concorda com os Termos Complementares de Utilização para pré-visualizações do Microsoft Azure. Ao utilizar o recipiente, concorda com estes termos.

Configurações fluentes

Fluentd é um colecionador de dados de código aberto para registos de registos unificados. As Fluentd definições gerem a ligação do contentor a um servidor Fluentd. O recipiente inclui um fornecedor de registo fluente, que permite ao seu recipiente escrever registos e, opcionalmente, dados métricos para um servidor Fluentd.

A tabela seguinte descreve as definições de configuração suportadas na Fluentd secção.

Name Tipo de dados Descrição
Host String O endereço IP ou o nome de anfitrião DNS do servidor Fluentd.
Port Número inteiro A porta do servidor Fluentd.
O valor predefinido é 24224.
HeartbeatMs Número inteiro O intervalo do batimento cardíaco, em milissegundos. Se não tiver sido enviado tráfego de eventos antes de este intervalo expirar, é enviado um batimento cardíaco para o servidor Fluentd. O valor predefinido é de 60000 milissegundos (1 minuto).
SendBufferSize Número inteiro O espaço tampão da rede, em bytes, atribuído para operações de envio. O valor predefinido é de 32768 bytes (32 quilobytes).
TlsConnectionEstablishmentTimeoutMs Número inteiro O tempo limite, em milissegundos, para estabelecer uma ligação SSL/TLS com o servidor Fluentd. O valor predefinido é de 10000 milissegundos (10 segundos).
Se UseTLS for definido como falso, este valor é ignorado.
UseTLS Booleano Indica se o recipiente deve utilizar SSL/TLS para comunicar com o servidor Fluentd. O valor predefinido é false.

Definições de credenciais de procuração http

Se precisar de configurar um representante HTTP para fazer pedidos de saída, utilize estes dois argumentos:

Name Tipo de dados Descrição
HTTP_PROXY string O representante para usar, por exemplo, http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDS string Quaisquer credenciais necessárias para autenticar contra o representante, por exemplo, username:password . Este valor deve ser em minúsculas.
<proxy-user> string O utilizador do representante.
<proxy-password> string A palavra-passe associada <proxy-user> ao representante.
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> \

Definições de registo

As Logging definições gerem ASP.NET suporte de registo do Núcleo para o seu recipiente. Pode utilizar as mesmas definições e valores de configuração para o seu recipiente que utiliza para uma aplicação Core ASP.NET.

Os seguintes prestadores de serviços de exploração madeireira são suportados pelo contentor:

Fornecedor Objetivo
Consola O fornecedor de registo de Console ASP.NET Core. Todas as definições de configuração do núcleo ASP.NET e os valores predefinidos para este fornecedor de registos são suportados.
Depurar O fornecedor de registo de Debug ASP.NET Core. Todas as definições de configuração do núcleo ASP.NET e os valores predefinidos para este fornecedor de registos são suportados.
Disco O provedor de registo JSON. Este fornecedor de registos escreve dados de registo para o suporte de saída.

Este comando de contentor armazena informações no formato JSON para o suporte de saída:

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

Este comando do contentor mostra informações de depurar, prefixadas dbug com, enquanto o contentor está em funcionamento:

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

Registo de discos

O Disk fornecedor de registos suporta as seguintes definições de configuração:

Name Tipo de dados Descrição
Format String O formato de saída para ficheiros de registo.
Nota: Este valor deve ser definido json para permitir o fornecedor de registos. Se este valor for especificado sem especificar também um suporte de saída durante a instantânea de um recipiente, ocorre um erro.
MaxFileSize Número inteiro O tamanho máximo, em megabytes (MB), de um ficheiro de log. Quando o tamanho do ficheiro de registo atual se encontra ou excede este valor, um novo ficheiro de registo é iniciado pelo fornecedor de registo. Se for especificado -1, o tamanho do ficheiro de registo é limitado apenas pelo tamanho máximo do ficheiro, se houver, para o suporte de saída. O valor predefinido é 1.

Para obter mais informações sobre a configuração ASP.NET suporte de registo do núcleo, consulte a configuração do ficheiro Definições.

Configurações de montagem

Utilize suportes de ligação para ler e escrever dados de e para o recipiente. Pode especificar um suporte de entrada ou de saída especificando a --mount opção no comando de execução do estivador.

Os recipientes do Detetor de Anomalias não utilizam suportes de entrada ou saída para armazenar dados de treino ou de serviço.

A sintaxe exata da localização do suporte do hospedeiro varia consoante o sistema operativo do hospedeiro. Além disso, a localização do suporte do computador anfitriãopode não estar acessível devido a um conflito entre permissões utilizadas pela conta de serviço Docker e as permissões de localização do anfitrião.

Opcional Name Tipo de dados Descrição
Não permitido Input String Os recipientes do Detetor de Anomalias não usam isto.
Opcional Output String O alvo do suporte de saída. O valor predefinido é /output. Esta é a localização dos registos. Isto inclui registos de contentores.

Exemplo:
--mount type=bind,src=c:\output,target=/output

Exemplo de estivador executar comandos

Os exemplos a seguir utilizam as definições de configuração para ilustrar como escrever e utilizar docker run comandos. Uma vez em funcionamento, o recipiente continua a funcionar até o parar.

  • Carácter de continuação da linha: Os comandos do Docker nas seguintes secções usam o corte traseiro, \ como um personagem de continuação de linha para uma casca de bash. Substitua ou remova isto com base nos requisitos do seu sistema operativo anfitrião. Por exemplo, o carácter de continuação da linha para janelas é um cuidado, ^ . Substitua o corte traseiro pelo cuidado.
  • Ordem de argumento: Não altere a ordem dos argumentos a menos que esteja muito familiarizado com os recipientes docker.

Substitua o valor nos parênteses, {} com os seus próprios valores:

Marcador de posição Valor Formato ou exemplo
{API_KEY} A chave de ponta final do Anomaly Detector recurso na página Azure Anomaly Detector Keys. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{ENDPOINT_URI} O valor do ponto final de faturação está disponível na página Azure Anomaly Detector Overview. Consulte os parâmetros necessários para obter exemplos explícitos.

Nota

Os novos recursos criados após 1 de julho de 2019, usarão nomes de subdomínios personalizados. Para obter mais informações e uma lista completa de pontos finais regionais, consulte os nomes de subdomínio personalizados para serviços cognitivos.

Importante

As Eula Billing opções , e ApiKey opções devem ser especificadas para executar o recipiente; caso contrário, o recipiente não arranca. Para mais informações, consulte Billing. O valor ApiKey é a chave da página de teclas de detetor de anomalias Azure.

Exemplos de estivadores de detetor de anomalias

Os seguintes exemplos do Docker são para o detetor de anomalias.

Exemplo básico

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

Registar exemplo com argumentos de linha de comando

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

Passos seguintes