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