Konfigurace Detektor anomálií jednorozměrné kontejnery

Prostředí Detektor anomálií kontejneru se konfiguruje pomocí docker run argumentů příkazu. Tento kontejner má několik požadovaných nastavení a několik volitelných nastavení. K dispozici je několik příkladů příkazu . Nastavení specifická pro kontejner jsou nastavení fakturace.

Nastavení konfigurace

Tento kontejner má následující nastavení konfigurace:

Vyžadováno Nastavení Účel
Yes Klíč rozhraní API Slouží ke sledování fakturačních údajů.
No ApplicationInsights Umožňuje přidat do kontejneru podporu Přehledy telemetrie služby Azure Application.
Yes Fakturace Určuje identifikátor URI koncového bodu prostředku služby v Azure.
Yes Eula Označuje, že jste přijali licenci pro kontejner.
No Fluentd (Plynule) Zápis protokolu a volitelně dat metrik na server Fluentd
No Http Proxy Nakonfigurujte proxy server HTTP pro provádění odchozích požadavků.
No Protokolování Poskytuje ASP.NET Core protokolování pro váš kontejner.
No Koně Čtení a zápis dat z hostitelského počítače do kontejneru a z kontejneru zpět do hostitelského počítače.

Důležité

Nastavení , a se používají společně a musíte zadat platné hodnoty pro všechny tři z nich, jinak se kontejner ApiKey Billing Eula nespustí. Další informace o použití těchto nastavení konfigurace k vytvoření instance kontejneru najdete v tématu Fakturace.

Nastavení konfigurace ApiKey

Nastavení ApiKey určuje klíč prostředku Azure, který se použije ke sledování fakturačních údajů pro kontejner. Musíte zadat hodnotu ApiKey a hodnota musí být platným klíčem pro prostředek Detektor anomálií určený pro Billing nastavení konfigurace.

Toto nastavení najdete na následujícím místě:

  • Azure Portal: Detektor anomálií správy prostředků v části Klíče

Nastavení ApplicationInsights

Toto ApplicationInsights nastavení umožňuje přidat do svého kontejneru podporu telemetrie Azure Application Insights . Application Insights poskytuje podrobné monitorování vašeho kontejneru. Svůj kontejner můžete snadno monitorovat z důvodu dostupnosti, výkonu a využití. Můžete také rychle identifikovat a diagnostikovat chyby ve vašem kontejneru.

Následující tabulka popisuje nastavení konfigurace podporovaná v ApplicationInsights části.

Vyžadováno Name Datový typ Popis
No InstrumentationKey Řetězec Klíč instrumentace instance Application Insights, do které se odesílají data telemetrie kontejneru. Další informace najdete v tématu Application Insights pro ASP.NET Core.

Příklad:
InstrumentationKey=123456789

Nastavení konfigurace fakturace

Nastavení určuje identifikátor URI koncového bodu prostředku Detektor anomálií v Azure, který se používá Billing k měření fakturačních údajů pro kontejner. Pro toto nastavení konfigurace musíte zadat hodnotu a hodnota musí být platným identifikátorem URI koncového bodu pro Detektor anomálií prostředků v Azure.

Toto nastavení najdete na následujícím místě:

  • Azure Portal: Detektor anomálií přehledu s popiskem Endpoint
Vyžadováno Name Datový typ Popis
Ano Billing Řetězec Identifikátor URI koncového bodu fakturace. Další informace o získání identifikátoru URI pro fakturaci najdete v tématu shromažďování požadovaných parametrů. Další informace a úplný seznam regionálních koncových bodů najdete v tématu Vlastní názvy subdomén pro Cognitive Services.

Nastavení eula

EulaNastavení indikuje, že jste přijali licenci pro kontejner. Je nutné zadat hodnotu pro toto nastavení konfigurace a tato hodnota musí být nastavena na accept .

Vyžadováno Name Datový typ Popis
Ano Eula Řetězec Přijetí licence

Příklad:
Eula=accept

Cognitive Services kontejnery se licencují podle vaší smlouvy upravující používání Azure. Pokud nemáte stávající smlouvu upravující používání Azure, souhlasíte s tím, že smlouva upravující použití Azure je Microsoft Online Subscription Agreement, která zahrnuje podmínky používání služeb Online Services. Pro verze Preview Souhlasíte také s doplňkovými podmínkami použití pro Microsoft Azureverze Preview. Pomocí kontejneru, který souhlasíte s těmito podmínkami.

Plynule nastavení

Fluent je open source kolekce dat pro jednotné protokolování. FluentdNastavení spravují připojení kontejneru k serveru, na který se hovoří . Kontejner obsahuje poskytovatele s mikroprotokolem, který umožňuje kontejneru zapisovat protokoly a volitelně také data metriky na server, který je na něj.

Následující tabulka popisuje nastavení konfigurace podporovaná v Fluentd části.

Name Datový typ Popis
Host Řetězec IP adresa nebo název hostitele DNS serveru.
Port Integer Port serverového serveru.
Výchozí hodnota je 24224.
HeartbeatMs Integer Interval prezenčního signálu v milisekundách. Pokud se před uplynutím tohoto intervalu nepošle žádný přenos události, pošle se na tento server prezenční signál. Výchozí hodnota je 60000 milisekund (1 minuta).
SendBufferSize Integer Velikost vyrovnávací paměti sítě (v bajtech) přidělená pro operace odeslání. Výchozí hodnota je 32768 bajtů (32 kilobajtů).
TlsConnectionEstablishmentTimeoutMs Integer Časový limit (v milisekundách) k navázání připojení SSL/TLS k tomuto serveru. Výchozí hodnota je 10000 milisekund (10 sekund).
Pokud UseTLS je hodnota nastavena na false, bude tato hodnota ignorována.
UseTLS Logická hodnota Určuje, jestli má kontejner pro komunikaci se serverem používat protokol SSL/TLS. Výchozí hodnota je False.

Nastavení přihlašovacích údajů proxy serveru HTTP

Pokud potřebujete nakonfigurovat proxy server HTTP pro vytváření odchozích požadavků, použijte tyto dva argumenty:

Name Datový typ Popis
HTTP_PROXY řetězec Proxy, který se má použít, například http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDS řetězec Jakékoli přihlašovací údaje potřebné k ověření vůči proxy serveru, například username:password . Tato hodnota musí být malými písmeny.
<proxy-user> řetězec Uživatel pro proxy
<proxy-password> řetězec Heslo spojené s <proxy-user> pro proxy server.
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> \

Nastavení protokolování

LoggingNastavení spravovat ASP.NET Core podporu protokolování pro váš kontejner. Můžete použít stejné nastavení konfigurace a hodnoty pro váš kontejner, který používáte pro aplikaci ASP.NET Core.

Kontejner podporuje následující zprostředkovatele protokolování:

Poskytovatel Účel
Konzola ConsoleZprostředkovatel protokolování ASP.NET Core. Všechna nastavení konfigurace ASP.NET Core a výchozí hodnoty pro tohoto zprostředkovatele protokolování jsou podporovány.
Ladění DebugZprostředkovatel protokolování ASP.NET Core. Všechna nastavení konfigurace ASP.NET Core a výchozí hodnoty pro tohoto zprostředkovatele protokolování jsou podporovány.
Disk Zprostředkovatel protokolování JSON. Tento zprostředkovatel protokolování zapisuje data protokolu do výstupního připojení.

Tento příkaz kontejneru ukládá do výstupního připojení informace o protokolování ve formátu JSON:

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

Tento příkaz kontejneru zobrazuje informace o ladění s předponou dbug , zatímco je spuštěný kontejner:

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

Protokolování disku

DiskZprostředkovatel protokolování podporuje následující nastavení konfigurace:

Name Datový typ Popis
Format Řetězec Výstupní formát pro soubory protokolu.
Poznámka: Tato hodnota musí být nastavena na hodnotu json pro povolení poskytovatele protokolování. Pokud je tato hodnota zadána bez zadání výstupního připojení při vytváření instance kontejneru, dojde k chybě.
MaxFileSize Integer Maximální velikost souboru protokolu v megabajtech (MB). Když velikost aktuálního souboru protokolu splňuje nebo překračuje tuto hodnotu, spustí zprostředkovatel protokolování nový soubor protokolu. Je-li zadána hodnota-1, velikost souboru protokolu je omezena pouze maximální velikostí souboru (pokud existuje) pro připojení pro výstup. Výchozí hodnota je 1.

Další informace o konfiguraci podpory protokolování ASP.NET Core najdete v tématu nastavení souboru konfigurace.

Nastavení připojení

Ke čtení a zápisu dat do kontejneru a z kontejneru použijte připojení vazby. Zadáním možnosti v příkazu docker run můžete zadat vstupní nebo výstupní --mount připojení.

Kontejnery Detektor anomálií používají vstupní ani výstupní připojení k ukládání trénovací nebo servisních dat.

Přesná syntaxe umístění připojení hostitele se liší v závislosti na hostitelském operačním systému. Navíc umístění připojeníhostitelského počítače nemusí být přístupné kvůli konfliktu mezi oprávněními používanými účtem služby Docker a oprávněními umístění pro připojení hostitele.

Volitelné Name Datový typ Popis
Nepovolené Input Řetězec Detektor anomálií kontejnery toto nepoužívejte.
Volitelné Output Řetězec Cíl výstupního připojení. Výchozí hodnota je /output. Toto je umístění protokolů. To zahrnuje protokoly kontejneru.

Příklad:
--mount type=bind,src=c:\output,target=/output

Příklad příkazů docker run

Následující příklady používají nastavení konfigurace k ilustraci, jak psát a používat docker run příkazy. Po spuštění bude kontejner dál běžet, dokud ho nezastavíte.

  • Znak pokračování řádku: Příkazy Dockeru v následujících částech používají zpětné lomítko ( ) jako znak pokračování řádku \ pro prostředí Bash. Tuto možnost nahraďte nebo odeberte na základě požadavků hostitelského operačního systému. Znak pro pokračování řádku pro Windows je například tečka ^ ( ). Zpětné lomítko nahraďte tečkou.
  • Pořadí argumentů: Neměňte pořadí argumentů, pokud nejste velmi obeznámeni s kontejnery Dockeru.

Nahraďte hodnotu v hranatých {} závorkách vlastními hodnotami:

Zástupný symbol Hodnota Formát nebo příklad
{API_KEY} Klíč koncového bodu Anomaly Detector prostředku na stránce Klíče Anomaly Detector Azure. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{ENDPOINT_URI} Hodnota fakturačního koncového bodu je k dispozici na stránce Přehled Anomaly Detector Azure. Explicitní příklady najdete v tématu shromažďování požadovaných parametrů.

Poznámka

Nové prostředky vytvořené po 1. červenci 2019 budou používat názvy vlastních subdomén. Další informace a úplný seznam regionálních koncových bodů najdete v tématu názvy vlastních subdomén pro Cognitive Services.

Důležité

Eula Billing ApiKey Aby bylo možné spustit kontejner, musí být zadány možnosti, a. v opačném případě se kontejner nespustí. Další informace najdete v tématu fakturace. Hodnota ApiKey je klíč ze stránky klíče prostředků služby Azure anomálie detektor.

Příklady Docker kontejneru detektoru anomálií

Následující příklady Docker jsou pro kontejner detektoru anomálií.

Základní příklad

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} 

Příklad protokolování s argumenty příkazového řádku

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

Další kroky