Tek Anomali Algılayıcısı kapsayıcıları yapılandırma

Kapsayıcı Anomali Algılayıcısı çalışma zamanı ortamı, komut bağımsız değişkenleri docker run kullanılarak yapılandırılır. Bu kapsayıcının birkaç gerekli ayarı ve birkaç isteğe bağlı ayarı vardır. Komutun birkaç örneği kullanılabilir. Kapsayıcıya özgü ayarlar faturalama ayarlarıdır.

Yapılandırma ayarları

Bu kapsayıcı aşağıdaki yapılandırma ayarlarına sahip:

Gerekli Ayar Amaç
Yes ApiKey Faturalama bilgilerini izlemek için kullanılır.
Hayır ApplicationInsights Kapsayıcınıza Azure Application Analizler telemetri desteği eklemenize olanak sağlar.
Yes Faturalandırma Azure'da hizmet kaynağının uç nokta URI'lerini belirtir.
Yes Eula Kapsayıcı için lisansı kabul etmişsinizdir.
Hayır Fluentd Günlük ve isteğe bağlı olarak ölçüm verilerini Fluentd sunucusuna yazın.
Hayır Http Proxy Giden istekler yapmak için bir HTTP ara sunucusu yapılandırma.
Hayır Günlüğe kaydetme Kapsayıcınız ASP.NET Core günlük kaydı desteği sağlar.
Hayır Bağlar Konak bilgisayardan kapsayıcıya ve kapsayıcıdan konak bilgisayara veri okuma ve yazma.

Önemli

, ve ayarları birlikte kullanılır ve üçü için de geçerli değerler ApiKey Billing sağlamalıyız; aksi takdirde Eula kapsayıcınız başlamaz. Kapsayıcı örneği için bu yapılandırma ayarlarını kullanma hakkında daha fazla bilgi için bkz. Faturalama.

ApiKey yapılandırma ayarı

ayarı, ApiKey kapsayıcının faturalama bilgilerini izlemek için kullanılan Azure kaynak anahtarını belirtir. ApiKey için bir değer belirtmeniz gerekir ve değer yapılandırma ayarı için belirtilen Anomali Algılayıcısı için geçerli bir anahtar Billing olmalıdır.

Bu ayar aşağıdaki yerde bulunabilir:

  • Azure portal: Anomali Algılayıcısı Altında Kaynak Yönetimi

ApplicationInsights ayarı

ApplicationInsightsAyar, kapsayıcınıza Azure Application Insights telemetri desteği eklemenize olanak tanır. Application Insights kapsayıcının derinlemesine izlenmesini sağlar. Kapsayıcınızı kullanılabilirlik, performans ve kullanım açısından kolayca izleyebilirsiniz. Ayrıca, kapsayıcıınızda hataları hızlıca tanımlayabilir ve tanılayabilirsiniz.

Aşağıdaki tabloda, bölümünde desteklenen yapılandırma ayarları açıklanmaktadır ApplicationInsights .

Gerekli Name Veri türü Açıklama
Hayır InstrumentationKey Dize Kapsayıcı için Telemetri verilerinin gönderildiği Application Insights örneğinin izleme anahtarı. Daha fazla bilgi için bkz. ASP.NET Core Application Insights.

Örnek:
InstrumentationKey=123456789

Faturalama yapılandırma ayarı

ayarı, Azure'da kapsayıcı için faturalama bilgilerini Anomali Algılayıcısı kaynak uç Billing noktası URI'lerini belirtir. Bu yapılandırma ayarı için bir değer belirtmeniz gerekir ve değerin Azure'da bir kaynak için geçerli Anomali Algılayıcısı uç nokta URI'si olması gerekir.

Bu ayar aşağıdaki yerde bulunabilir:

  • Azure portal: Anomali Algılayıcısı genel bakış, etiketli Endpoint
Gerekli Name Veri türü Açıklama
Evet Billing Dize Faturalama uç noktası URI'sı. Faturalama URI'lerini alma hakkında daha fazla bilgi için bkz. gerekli parametreleri toplama. Daha fazla bilgi ve bölgesel uç noktaların tam listesi için bkz. Bilişsel Hizmetler için özel alt etki alanı adları.

Eula ayarı

EulaAyar, kapsayıcının lisansını kabul ettiğinizi gösterir. Bu yapılandırma ayarı için bir değer belirtmeniz gerekir ve değer olarak ayarlanmalıdır accept .

Gerekli Name Veri türü Açıklama
Evet Eula Dize Lisans kabulü

Örnek:
Eula=accept

Bilişsel hizmetler kapsayıcıları, Azure kullanımınızı düzenleyen sözleşmeniz kapsamında lisanslanır. Azure kullanımınızı yöneten mevcut bir anlaşmanız yoksa, Azure 'un kullanımını yöneten sözleşmenizin, çevrimiçi hizmet koşulları'nı içeren Microsoft çevrimiçi abonelik sözleşmesiolduğunu kabul etmiş olursunuz. Önizlemeler için Ayrıca, Microsoft Azure önizlemeleri Için ek kullanım koşulları'nı kabul etmiş olursunuz. Kapsayıcıyı kullanarak bu koşulları kabul etmiş olursunuz.

Fluentd ayarları

Floentd, Birleşik günlük kaydına yönelik açık kaynaklı bir veri toplayıcıdır. FluentdAyarlar, kapsayıcının bir Floentd sunucusuyla bağlantısını yönetir. Kapsayıcı, kapsayıcının günlükleri ve isteğe bağlı olarak ölçüm verilerini Floentd sunucusuna yazmasını sağlayan bir Floentd günlüğe kaydetme sağlayıcısı içerir.

Aşağıdaki tabloda, bölümünde desteklenen yapılandırma ayarları açıklanmaktadır Fluentd .

Name Veri türü Açıklama
Host Dize Floentd sunucusunun IP adresi veya DNS ana bilgisayar adı.
Port Tamsayı Floentd sunucusunun bağlantı noktası.
Varsayılan değer 24224 ' dir.
HeartbeatMs Tamsayı Sinyal aralığı (milisaniye cinsinden). Bu Aralık sona ermeden önce hiçbir olay trafiği gönderilmezse, Floentd sunucusuna bir sinyal gönderilir. Varsayılan değer 60000 milisaniyedir (1 dakika).
SendBufferSize Tamsayı Gönderme işlemleri için ayrılan, bayt cinsinden ağ arabelleği alanı. Varsayılan değer 32768 bayttır (32 kilobayt).
TlsConnectionEstablishmentTimeoutMs Tamsayı Akıcı Entd sunucusuyla SSL/TLS bağlantısı kurmak için milisaniye cinsinden zaman aşımı. Varsayılan değer 10000 milisaniyedir (10 saniye).
UseTLSFalse olarak ayarlanırsa, bu değer yoksayılır.
UseTLS Boole Kapsayıcının, Floentd sunucusuyla iletişim kurmak için SSL/TLS kullanması gerekip gerekmediğini belirtir. Varsayılan değer false'tur.

Http proxy kimlik bilgileri ayarları

Giden istekler oluşturmak için bir HTTP proxy 'si yapılandırmanız gerekiyorsa şu iki bağımsız değişkeni kullanın:

Name Veri türü Açıklama
HTTP_PROXY string Kullanılacak proxy, örneğin, http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDS string Proxy için kimlik doğrulaması yapmak için gereken tüm kimlik bilgileri, örneğin, username:password . Bu değer küçük harf olmalıdır.
<proxy-user> string Proxy için Kullanıcı.
<proxy-password> string <proxy-user>Ara sunucu için ile ilişkili parola.
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> \

Oturum açma ayarları

LoggingAyarlar, Kapsayıcınız için ASP.NET Core günlük desteğini yönetir. ASP.NET Core bir uygulama için kullandığınız, Kapsayıcınız için aynı yapılandırma ayarlarını ve değerlerini kullanabilirsiniz.

Aşağıdaki günlük oluşturma sağlayıcıları kapsayıcı tarafından desteklenir:

Sağlayıcı Amaç
Konsol ASP.NET Core Console günlük sağlayıcısı. Bu günlüğe kaydetme sağlayıcısı için ASP.NET Core yapılandırma ayarları ve varsayılan değerler desteklenir.
Hata Ayıklama ASP.NET Core Debug günlük sağlayıcısı. Bu günlüğe kaydetme sağlayıcısı için ASP.NET Core yapılandırma ayarları ve varsayılan değerler desteklenir.
Disk JSON günlük sağlayıcısı. Bu günlüğe kaydetme sağlayıcısı günlük verilerini çıkış bağlamalarına yazar.

Bu kapsayıcı komutu, günlük bilgilerini JSON biçiminde çıktı bağlamaya depolar:

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

Bu kapsayıcı komutu, kapsayıcı çalışırken, ön eki olan hata ayıklama bilgilerini gösterir dbug :

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 günlüğü

DiskGünlük sağlayıcısı aşağıdaki yapılandırma ayarlarını destekler:

Name Veri türü Açıklama
Format Dize Günlük dosyaları için çıkış biçimi.
Note: json Günlüğe kaydetme sağlayıcısını etkinleştirmek için bu değerin olarak ayarlanması gerekir. Bu değer, bir kapsayıcıyı örneklarken bir çıkış bağlaması belirtilmeden belirtilirse bir hata oluşur.
MaxFileSize Tamsayı Günlük dosyasının megabayt (MB) cinsinden en büyük boyutu. Geçerli günlük dosyasının boyutu bu değeri karşıladığında veya aştığında, günlük sağlayıcısı tarafından yeni bir günlük dosyası başlatılır. -1 belirtilirse, günlük dosyasının boyutu, varsa çıkış bağlaması için en fazla dosya boyutuyla sınırlıdır. Varsayılan değer 1’dir.

ASP.NET Core günlüğü desteğini yapılandırma hakkında daha fazla bilgi için bkz. Ayarlar dosya yapılandırması.

Bağlama ayarları

Kapsayıcıya veri okumak ve kapsayıcıdan veri yazmak için bağlama bağlamalarını kullanın. docker run komutunda seçeneğini belirterek bir giriş --mount bağlaması veya çıkış bağlaması belirtebilirsiniz.

Anomali Algılayıcısı kapsayıcıları, eğitim veya hizmet verilerini depolamak için giriş veya çıkış bağlamalarını kullanmaz.

Konak bağlama konumunun tam söz dizimi, konak işletim sistemine bağlı olarak değişir. Buna ek olarak,Docker hizmet hesabı tarafından kullanılan izinler ile konak bağlama konumu izinleri arasındaki bir çakışma nedeniyle konak bilgisayarın bağlama konumu erişilemez olabilir.

İsteğe Bağlı Name Veri türü Açıklama
İzin verilmiyor Input Dize Anomali Algılayıcısı kapsayıcılar bunu kullanmaz.
İsteğe Bağlı Output Dize Çıkış bağlamanın hedefi. /output varsayılan değerdir. Bu, günlüklerin konumu. Kapsayıcı günlükleri de buna dahildir.

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

Örnek docker çalıştırma komutları

Aşağıdaki örneklerde komut yazma ve kullanma adımları göstermek için yapılandırma ayarları docker run kullanılır. Çalıştırdıktan sonra kapsayıcı siz durdurana kadar çalıştırmaya devam eder.

  • Satır devamlılığı karakteri: Aşağıdaki bölümlerde yer alan Docker komutları, bash kabuğu için satır devamlılığı karakteri olarak \ eğik çizgi ( ) kullanır. Bunu, konak işletim sisteminin gereksinimlerine göre değiştirin veya kaldırın. Örneğin, windows için satır devamlılığı karakteri, bir caret'tir. ^ Eğik çizgiyi eğik çizgiyle değiştirin.
  • Bağımsız değişken sırası: Docker kapsayıcılarını çok iyi tanımadıkça bağımsız değişkenlerin sıralamasını değiştirme.

Köşeli ayraç içindeki değeri {} kendi değerleriniz ile değiştirin:

Yer tutucu Değer Biçim veya örnek
{API_KEY} Azure Anahtarları sayfasında Anomaly Detector kaynağın uç Anomaly Detector nokta anahtarı. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{ENDPOINT_URI} Faturalama uç noktası değeri Azure'a Genel Bakış Anomaly Detector sayfasında mevcuttur. Açık örnekler için gerekli parametreleri toplamaya bakın.

Not

1 Temmuz 2019 ' den sonra oluşturulan yeni kaynaklar özel alt etki alanı adları kullanır. Daha fazla bilgi ve bölgesel uç noktaların tamamen listesi için bkz. bilişsel Hizmetler Için özel alt etki alanı adları.

Önemli

Eula Billing ApiKey Kapsayıcıyı çalıştırmak için, ve seçenekleri belirtilmelidir; Aksi takdirde kapsayıcı başlatılmaz. Daha fazla bilgi için bkz. faturalandırma. ApiKey değeri, Azure anomali algılayıcısı kaynak anahtarları sayfasından alınan anahtardır .

Anomali algılayıcı kapsayıcısı Docker örnekleri

Aşağıdaki Docker örnekleri anomali algılayıcı kapsayıcısı içindir.

Temel örnek

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} 

Komut satırı bağımsız değişkenleriyle günlüğe kaydetme örneği

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

Sonraki adımlar