Sistem durumu docker kapsayıcıları için Metin Analizi'ni yapılandırma
Sistem durumu için Metin Analizi her kapsayıcıya ortak bir yapılandırma çerçevesi sağlar; böylece kapsayıcılarınız için depolamayı, günlüğe kaydetmeyi ve telemetriyi ve güvenlik ayarlarını kolayca yapılandırabilir ve yönetebilirsiniz. Birkaç örnek docker çalıştırma komutu da mevcuttur.
Yapılandırma ayarları
Kapsayıcı aşağıdaki yapılandırma ayarlarına sahiptir:
| Gerekli | Ayar | Amaç |
|---|---|---|
| Yes | ApiKey | Fatura bilgilerini izler. |
| Hayır | ApplicationInsights | Kapsayıcınıza Azure Application Insights telemetri desteği eklemeyi etkinleştirir. |
| Yes | Faturalandırma | Azure'daki hizmet kaynağının uç nokta URI'sini belirtir. |
| Yes | Eula | Kapsayıcının lisansını kabul ettiğinizi gösterir. |
| Hayır | Fluentd | Günlük ve isteğe bağlı olarak ölçüm verilerini Fluentd sunucusuna yazar. |
| Hayır | HTTP Ara Sunucusu | Giden istekler yapmak için bir HTTP ara sunucusu yapılandırılır. |
| Hayır | Günlüğe kaydetme | Kapsayıcınız için 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 geri veri okur ve yazar. |
Önemli
ApiKey, Billingve Eula ayarları birlikte kullanılır ve bunların üçü için de geçerli değerler sağlamanız gerekir; aksi takdirde kapsayıcınız başlatılmaz. Kapsayıcı örneği oluşturmak 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 ve değerin yapılandırma ayarı için belirtilen Dil kaynağı için Billing geçerli bir anahtar olması gerekir.
Bu ayar aşağıdaki yerde bulunabilir:
- Azure portalı: Anahtarlar ve uç nokta altında dil kaynak yönetimi
ApplicationInsights ayarı
Bu ApplicationInsights ayar, kapsayıcınıza Azure Application Insights telemetri desteği eklemenize olanak tanır. Application Insights, kapsayıcınızı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ızdaki hataları hızla belirleyebilir ve tanılayabilirsiniz.
Aşağıdaki tabloda bölümü altında ApplicationInsights desteklenen yapılandırma ayarları açıklanmaktadır.
| 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 için Application Insights. Örnek: InstrumentationKey=123456789 |
Faturalama yapılandırma ayarı
ayarı, Billing Azure'da kapsayıcının faturalama bilgilerini ölçerken kullanılan Dil kaynağının uç nokta URI'sini belirtir. Bu yapılandırma ayarı için bir değer belirtmeniz ve değerin Azure'daki bir Dil kaynağı için geçerli bir uç nokta URI'si olması gerekir. Kapsayıcı yaklaşık 10-15 dakikada bir kullanımı bildirir.
Bu ayar aşağıdaki yerde bulunabilir:
- Azure portalı: Dile Genel Bakış, etiketli
Endpoint
| Gerekli | Name | Veri türü | Açıklama |
|---|---|---|---|
| Evet | Billing |
Dize | Faturalama uç noktası URI'si. Faturalama URI'sini 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. Azure AI hizmetleri için özel alt etki alanı adları. |
Eula ayarı
ayarı, Eula kapsayıcının lisansını kabul ettiğinizi gösterir. Bu yapılandırma ayarı için bir değer belirtmeniz ve değerin olarak acceptayarlanması gerekir.
| Gerekli | Name | Veri türü | Açıklama |
|---|---|---|---|
| Evet | Eula |
Dize | Lisans kabulü Örnek: Eula=accept |
Azure AI hizmetleri kapsayıcıları, Azure kullanımınızı yöneten sözleşmeniz kapsamında lisanslandırılır. Azure kullanımınızı yöneten mevcut bir sözleşmeniz yoksa, Azure kullanımını yöneten sözleşmenizin, Çevrimiçi Hizmet Koşulları'nı içeren Microsoft Çevrimiçi Abonelik Sözleşmesi olduğunu kabul edersiniz. Önizlemeler için, Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları'nı da kabul edersiniz. Kapsayıcıyı kullanarak bu koşulları kabul etmiş olursunuz.
Fluentd ayarları
Fluentd, birleşik günlük kaydı için açık kaynak bir veri toplayıcıdır. Ayarlar kapsayıcının FluentdFluentd sunucusuyla bağlantısını yönetir. Kapsayıcı, kapsayıcınızın fluentd sunucusuna günlükler ve isteğe bağlı olarak ölçüm verileri yazmasına olanak tanıyan fluentd günlük sağlayıcısı içerir.
Aşağıdaki tabloda bölümü altında Fluentd desteklenen yapılandırma ayarları açıklanmaktadır.
| Name | Veri türü | Açıklama |
|---|---|---|
Host |
Dize | Fluentd sunucusunun IP adresi veya DNS ana bilgisayar adı. |
Port |
Tamsayı | Fluentd sunucusunun bağlantı noktası. Varsayılan değer 24224'dür. |
HeartbeatMs |
Tamsayı | Milisaniye cinsinden sinyal aralığı. Bu süre dolmadan önce hiçbir olay trafiği gönderilmediyse Fluentd 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ğ arabellek alanı. Varsayılan değer 32768 bayttır (32 kilobayt). |
TlsConnectionEstablishmentTimeoutMs |
Tamsayı | Fluentd sunucusuyla SSL/TLS bağlantısı kurmak için milisaniye cinsinden zaman aşımı. Varsayılan değer 10000 milisaniyedir (10 saniye). false olarak ayarlanırsa UseTLS , bu değer yoksayılır. |
UseTLS |
Boole | Kapsayıcının Fluentd sunucusuyla iletişim kurmak için SSL/TLS kullanıp kullanmayacağını gösterir. Varsayılan değer false'tur. |
Http proxy kimlik bilgileri ayarları
Giden istekler yapmak için bir HTTP ara sunucusu 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 ara sunucu, örneğin, http://proxy:8888<proxy-url> |
| HTTP_PROXY_CREDS | string | Proxy'de kimlik doğrulaması yapmak için gereken tüm kimlik bilgileri, örneğin, username:password. Bu değer küçük harfle yazılmalıdır. |
<proxy-user> |
string | Ara sunucu için kullanıcı. |
<proxy-password> |
string | Ara sunucu için ile <proxy-user> ilişkilendirilmiş 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ı
Ayarlar, Logging kapsayıcınız için ASP.NET Core günlük desteğini yönetir. Kapsayıcınız için bir ASP.NET Core uygulaması için kullandığınız yapılandırma ayarlarını ve değerlerini kullanabilirsiniz.
Aşağıdaki günlük 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ük sağlayıcısı için tüm ASP.NET Core yapılandırma ayarları ve varsayılan değerler desteklenir. |
| Debug | ASP.NET Core Debug günlük sağlayıcısı. Bu günlük sağlayıcısı için tüm 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ük sağlayıcısı günlük verilerini çıkış bağlamasına yazar. |
Bu kapsayıcı komutu günlük bilgilerini çıkış bağlamasına JSON biçiminde 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 \
Mounts:Output=/output
Bu kapsayıcı komutu, kapsayıcı çalışırken ön ekini dbugiçeren hata ayıklama bilgilerini gösterir:
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üğü
Günlük Disk 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ının çıkış biçimi. Not: Günlüğe kaydetme sağlayıcısını json etkinleştirmek için bu değer olarak ayarlanmalıdır. Bu değer kapsayıcı örneği oluşturulurken çıkış bağlaması belirtilmeden belirtilirse bir hata oluşur. |
MaxFileSize |
Tamsayı | Günlük dosyasının megabayt (MB) cinsinden boyut üst sınırı. 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 yalnızca çıkış bağlaması için en büyük dosya boyutuyla (varsa) sınırlıdır. Varsayılan değer 1’dir. |
ASP.NET Core günlük 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 --mount bir giriş bağlaması veya çıkış bağlaması belirtebilirsiniz.
Sistem durumu kapsayıcıları için Metin Analizi, 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 izinlerle konak bağlama konumu izinleri arasındaki bir çakışma nedeniyle ana bilgisayarın bağlama konumuna erişilemiyor olabilir.
| İsteğe Bağlı | Name | Veri türü | Açıklama |
|---|---|---|---|
| İzin verilmiyor | Input |
Dize | Sistem durumu kapsayıcıları için Metin Analizi bunu kullanmaz. |
| İsteğe Bağlı | Output |
Dize | Çıkış bağlamasının hedefi. /output varsayılan değerdir. Bu, günlüklerin konumudur. Buna kapsayıcı günlükleri de dahildir. Örnek: --mount type=bind,src=c:\output,target=/output |
Sonraki adımlar
- Kapsayıcıları yükleme ve çalıştırma bölümünü gözden geçirin
- Daha fazla Azure AI kapsayıcısı kullanma