Anomali Algılayıcısı API için Docker kapsayıcılarını yükleme ve çalıştırma

Önemli

20 Eylül 2023 tarihinden itibaren yeni Anomali Algılayıcısı kaynakları oluşturamayacaksınız. Anomali Algılayıcısı hizmeti 1 Ekim 2026'da kullanımdan kaldırılıyor.

Dekont

Kapsayıcı görüntüsü konumu yakın zamanda değiştirildi. Bu kapsayıcının güncelleştirilmiş konumunu görmek için bu makaleyi okuyun.

Kapsayıcılar, Anomali Algılayıcısı API'sini kendi ortamınızda kullanmanızı sağlar. Kapsayıcılar, belirli güvenlik ve veri idare gereksinimleri için çok kullanışlıdır. Bu makalede bir Anomali Algılayıcısı kapsayıcısını indirmeyi, yüklemeyi ve çalıştırmayı öğreneceksiniz.

Anomali Algılayıcısı, şirket içi API'yi kullanmak için tek bir Docker kapsayıcısı sunar. Kapsayıcıyı kullanarak:

• Verilerinizde Anomali Algılayıcısı algoritmalarını kullanma
• Akış verilerini izleyin ve anomalileri gerçek zamanlı olarak oluştukları gibi algılayın.
• Veri kümenizdeki anomalileri toplu olarak algılayın.
• Veri kümenizdeki eğilim değişiklik noktalarını toplu iş olarak algılayın.
• Anomali algılama algoritmasının duyarlılığını verilerinize daha uygun olacak şekilde ayarlayın.

API hakkında ayrıntılı bilgi için bkz:

• Anomali Algılayıcısı API hizmeti hakkında daha fazla bilgi edinin

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Ön koşullar

Anomali Algılayıcısı kapsayıcılarını kullanmadan önce aşağıdaki önkoşulları karşılamanız gerekir:

Zorunlu	Purpose
Docker altyapısı	Docker Altyapısı'nın bir ana bilgisayarda yüklü olması gerekir. Docker, macOS, Windows ve Linux üzerinde Docker ortamını yapılandıran paketler sağlar. Docker ve kapsayıcı temel bilgileri ile ilgili giriş yapmak için Docker’a genel bakış bölümüne bakın. Docker, kapsayıcıların Azure'a bağlanmasına ve faturalama verileri göndermesine izin verecek şekilde yapılandırılmalıdır. Windows'da Docker,Linux kapsayıcılarını destekleyecek şekilde de yapılandırılmalıdır.
Docker hakkında bilgi	Kayıt defterleri, depolar, kapsayıcılar ve kapsayıcı görüntüleri gibi Docker kavramlarının yanı sıra temel docker komutlar hakkında bilgi sahibi olmanız gerekir.
Anomali Algılayıcısı kaynağı	Bu kapsayıcıları kullanmak için şunlara sahip olmanız gerekir: İlişkili API anahtarını ve uç nokta URI'sini almak için bir Azure Anomali Algılayıcısı kaynağı. Her iki değer de Azure portalının Anomali Algılayıcısı Genel Bakış ve Anahtarlar sayfalarında bulunur ve kapsayıcıyı başlatmak için gereklidir. {API_KEY}: Anahtarlar sayfasındaki kullanılabilir iki kaynak anahtarından biri {ENDPOINT_URI}: Genel Bakış sayfasında sağlanan uç nokta

Gerekli parametreleri toplama

Tüm Azure AI kapsayıcıları için üç birincil parametre gereklidir. Microsoft Yazılım Lisans Koşulları kabul değeriyle birlikte mevcut olmalıdır. Uç Nokta URI'si ve API anahtarı da gereklidir.

Uç nokta URI'si

Bu {ENDPOINT_URI} değere karşılık gelen Azure AI hizmetleri kaynağının Azure portalı genel bakış sayfasından ulaşabilirsiniz. Genel Bakış sayfasına gidin, uç noktanın üzerine gelin ve Panoya kopyala simgesi görüntülenir. Gerektiğinde uç noktayı kopyalayın ve kullanın.

Anahtarlar

Bu {API_KEY} değer kapsayıcıyı başlatmak için kullanılır ve ilgili Azure AI hizmetleri kaynağının Azure portalının Anahtarlar sayfasında kullanılabilir. Anahtarlar sayfasına gidin ve Panoya kopyala simgesini seçin.

Önemli

Bu abonelik anahtarları, Azure AI hizmetleri API'nize erişmek için kullanılır. Anahtarlarınızı paylaşmayın. Bunları güvenli bir şekilde depolayın. Örneğin, Azure Key Vault kullanın. Ayrıca bu anahtarları düzenli olarak yeniden oluşturmanızı öneririz. API çağrısı yapmak için yalnızca bir anahtar gerekir. İlk anahtarı yeniden oluştururken hizmete sürekli erişim için ikinci anahtarı kullanabilirsiniz.

Ana bilgisayar

Konak, Docker kapsayıcısını çalıştıran x64 tabanlı bir bilgisayardır. Şirket içi bir bilgisayar veya Azure'da Docker barındırma hizmeti olabilir, örneğin:

• Azure Kubernetes Service.
• Azure Container Instances.
• Azure Stack'e dağıtılan bir Kubernetes kümesi. Daha fazla bilgi için bkz . Kubernetes'i Azure Stack'e dağıtma.

Kapsayıcı gereksinimleri ve önerileri

Aşağıdaki tabloda, Anomali Algılayıcısı kapsayıcısı için ayrılacak en düşük ve önerilen CPU çekirdekleri ve bellek açıklanmaktadır.

QPS(Saniye başına sorgu sayısı)	En Küçük	Önerilen
10 QPS	4 çekirdek, 1 GB bellek	8 çekirdek 2 GB bellek
20 QPS	8 çekirdek, 2 GB bellek	16 çekirdek 4 GB bellek

Her çekirdek en az 2,6 gigahertz (GHz) veya daha hızlı olmalıdır.

Çekirdek ve bellek, komutun --cpus bir parçası olarak kullanılan ve --memory ayarlarına docker run karşılık gelir.

ile kapsayıcı görüntüsünü alma docker pull

Anomali Algılayıcısı kapsayıcı görüntüsü kapsayıcı kayıt defteri dağıtımında mcr.microsoft.com bulunabilir. Depoda azure-cognitive-services/decision bulunur ve olarak adlandırılır anomaly-detector. Tam kapsayıcı görüntüsü adıdır mcr.microsoft.com/azure-cognitive-services/decision/anomaly-detector.

Kapsayıcının en son sürümünü kullanmak için etiketini kullanabilirsiniz latest . Ayrıca MCR'de görüntü etiketlerinin tam listesini de bulabilirsiniz.

docker pull Kapsayıcı görüntüsünü indirmek için komutunu kullanın.

Kapsayıcı	Depo
bilişsel hizmetler-anomali algılayıcısı	mcr.microsoft.com/azure-cognitive-services/decision/anomaly-detector:latest

Bahşiş

kullanırken docker pullkapsayıcı kayıt defteri, depo, kapsayıcı görüntüsü adı ve ilgili etiketin büyük/küçük harf kullanımına dikkat edin. Büyük/küçük harfe duyarlıdırlar.

Bahşiş

İndirdiğiniz kapsayıcı görüntülerini listelemek için docker images komutunu kullanabilirsiniz. Örneğin, aşağıdaki komut indirilen her kapsayıcı görüntüsünün kimliğini, deposunu ve etiketini tablo olarak biçimlendirilmiş olarak listeler:

docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

IMAGE ID         REPOSITORY                TAG
<image-id>       <repository-path/name>    <tag-name>

Anomali Algılayıcısı kapsayıcısı için Docker çekme

docker pull mcr.microsoft.com/azure-cognitive-services/anomaly-detector:latest

Kapsayıcıyı kullanma

Kapsayıcı konak bilgisayarda olduğunda, kapsayıcıyla çalışmak için aşağıdaki işlemi kullanın.

1. Gerekli faturalama ayarlarıyla kapsayıcıyı çalıştırın. Komutun docker run diğer örnekleri mevcuttur.
2. Kapsayıcının tahmin uç noktasını sorgula.

Kapsayıcıyı ile çalıştırma docker run

Kapsayıcıyı çalıştırmak için docker run komutunu kullanın. ve {API_KEY} değerlerini alma hakkında ayrıntılı bilgi için gerekli parametreleri toplama bölümüne {ENDPOINT_URI} bakın.

docker run Komut örnekleri mevcuttur.

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

Şu komut:

• Kapsayıcı görüntüsünden bir Anomali Algılayıcısı kapsayıcısı çalıştırır
• Bir CPU çekirdeği ve 4 gigabayt (GB) bellek ayırır
• TCP bağlantı noktası 5000'i kullanıma sunar ve kapsayıcı için sahte TTY ayırır
• Kapsayıcı çıktıktan sonra otomatik olarak kaldırılır. Kapsayıcı görüntüsü ana bilgisayarda hala kullanılabilir.

Önemli

Kapsayıcıyı Eulaçalıştırmak için , Billingve ApiKey seçenekleri belirtilmelidir; aksi takdirde kapsayıcı başlatılmaz. Daha fazla bilgi için bkz . Faturalama.

Aynı konakta birden çok kapsayıcı çalıştırma

Kullanıma sunulan bağlantı noktalarıyla birden çok kapsayıcı çalıştırmak istiyorsanız, her kapsayıcıyı farklı bir bağlantı noktasıyla çalıştırdığınızdan emin olun. Örneğin, ilk kapsayıcıyı 5000 numaralı bağlantı noktasında, ikinci kapsayıcıyı da 5001 numaralı bağlantı noktasında çalıştırın.

ve <container-name> değerini <container-registry> kullandığınız kapsayıcıların değerleriyle değiştirin. Bunların aynı kapsayıcı olması gerekmez. Anomali Algılayıcısı kapsayıcısını ve LUIS kapsayıcısını HOST üzerinde birlikte çalıştırabilir veya birden çok Anomali Algılayıcısı kapsayıcısı çalıştırabilirsiniz.

5000 numaralı konak bağlantı noktasında ilk kapsayıcıyı çalıştırın.

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
<container-registry>/microsoft/<container-name> \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

5001 numaralı konak bağlantı noktasında ikinci kapsayıcıyı çalıştırın.

docker run --rm -it -p 5001:5000 --memory 4g --cpus 1 \
<container-registry>/microsoft/<container-name> \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Sonraki her kapsayıcı farklı bir bağlantı noktasında olmalıdır.

Kapsayıcının tahmin uç noktasını sorgulama

Kapsayıcı REST tabanlı sorgu tahmin uç noktası API’lerini sağlar.

Kapsayıcı API’leri için http://localhost:5000 konağını kullanın.

Kapsayıcının çalıştığını doğrulama

Kapsayıcının çalıştığını doğrulamanın çeşitli yolları vardır. Dış IP adresini ve söz konusu kapsayıcının kullanıma sunulan bağlantı noktasını bulun ve sık kullandığınız web tarayıcısını açın. Kapsayıcının çalıştığını doğrulamak için aşağıdaki çeşitli istek URL'lerini kullanın. Burada listelenen örnek istek URL'leri şunlardır http://localhost:5000; ancak kapsayıcınız farklılık gösterebilir. Kapsayıcınızın Dış IP adresine ve kullanıma sunulan bağlantı noktasına bağlı olduğundan emin olun.

İstek URL'si	Purpose
http://localhost:5000/	Kapsayıcı bir giriş sayfası sağlar.
http://localhost:5000/ready	GET ile istenen bu URL, kapsayıcının modele karşı sorgu kabul etmeye hazır olduğunu doğrulamayı sağlar. Bu istek Kubernetes canlılığı ve hazır olma yoklamaları için kullanılabilir.
http://localhost:5000/status	Get ile de istenen bu URL, kapsayıcıyı başlatmak için kullanılan api anahtarının bir uç nokta sorgusuna neden olmadan geçerli olup olmadığını doğrular. Bu istek Kubernetes canlılığı ve hazır olma yoklamaları için kullanılabilir.
http://localhost:5000/swagger	Kapsayıcı uç noktalar için tüm belgeleri ve bir de Deneyin özelliği sağlar. Bu özellik sayesinde, ayarlarınızı web tabanlı bir HTML formuna girebilir ve herhangi bir kod yazmak zorunda kalmadan sorguyu yapabilirsiniz. Sorgu döndürüldikten sonra, gerekli HTTP üst bilgilerini ve gövde biçimini göstermek için örnek bir CURL komutu sağlanır.

Kapsayıcıyı durdurma

Kapsayıcıyı kapatmak için, kapsayıcının çalıştığı komut satırı ortamında Ctrl+C tuşlarına basın.

Sorun giderme

Kapsayıcıyı bir çıkış bağlaması ve günlüğe kaydetme etkin olarak çalıştırırsanız kapsayıcı, kapsayıcıyı başlatırken veya çalıştırırken karşılaşılan sorunları gidermeye yardımcı olan günlük dosyaları oluşturur.

Bahşiş

Daha fazla sorun giderme bilgisi ve kılavuzu için bkz . Azure AI kapsayıcıları hakkında sık sorulan sorular (SSS).

Azure AI hizmetleri kapsayıcısını çalıştırırken sorun yaşıyorsanız Microsoft tanılama kapsayıcısını kullanmayı deneyebilirsiniz. Dağıtım ortamınızda Azure AI kapsayıcılarının beklendiği gibi çalışmasını engelleyebilecek yaygın hataları tanılamak için bu kapsayıcıyı kullanın.

Kapsayıcıyı almak için aşağıdaki docker pull komutu kullanın:

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

Ardından kapsayıcıyı çalıştırın. değerini {ENDPOINT_URI} uç noktanızla değiştirin ve değerini kaynağınızın anahtarıyla değiştirin {API_KEY} :

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Kapsayıcı, faturalama uç noktasına ağ bağlantısını test eder.

Faturalama

Anomali Algılayıcısı kapsayıcıları, Azure hesabınızdaki bir Anomali Algılayıcısı kaynağı kullanarak faturalama bilgilerini Azure'a gönderir.

Kapsayıcıya yönelik sorgular, parametre için kullanılan Azure kaynağının fiyatlandırma katmanında ApiKey faturalandırılır.

Azure AI hizmetleri kapsayıcıları, ölçüm veya faturalama uç noktasına bağlı olmadan çalıştırılma lisansına sahip değildir. Faturalama bilgilerini faturalama uç noktasıyla her zaman iletmek için kapsayıcıları etkinleştirmeniz gerekir. Azure AI hizmetleri kapsayıcıları, analiz edilen görüntü veya metin gibi müşteri verilerini Microsoft'a göndermez.

Azure'a bağlanma

Kapsayıcının çalışması için faturalama bağımsız değişkeni değerleri gerekir. Bu değerler kapsayıcının faturalama uç noktasına bağlanmasına olanak sağlar. Kapsayıcı yaklaşık 10-15 dakikada bir kullanımı bildirir. Kapsayıcı izin verilen zaman penceresinde Azure'a bağlanmazsa, kapsayıcı çalışmaya devam eder ancak faturalama uç noktası geri yüklenene kadar sorgular sunmaz. Bağlantı, 10 ile 15 dakika aynı zaman aralığında 10 kez denenir. 10 denemede faturalama uç noktasına bağlanamazsa kapsayıcı isteklerin sunulmasını durdurur. Faturalama için Microsoft'a gönderilen bilgilerin bir örneği için bkz. Azure AI hizmetleri kapsayıcısı SSS .

Faturalama bağımsız değişkenleri

Komut, docker run aşağıdaki seçeneklerin üçü de geçerli değerlerle sağlandığında kapsayıcıyı başlatır:

Seçenek	Tanım
ApiKey	Faturalama bilgilerini izlemek için kullanılan Azure AI hizmetleri kaynağının API anahtarı. Bu seçeneğin değeri, içinde belirtilen sağlanan kaynak için bir API anahtarına Billingayarlanmalıdır.
Billing	Faturalama bilgilerini izlemek için kullanılan Azure AI hizmetleri kaynağının uç noktası. Bu seçeneğin değeri, sağlanan bir Azure kaynağının uç nokta URI'sine ayarlanmalıdır.
Eula	Kapsayıcının lisansını kabul ettiğinizi gösterir. Bu seçeneğin değeri kabul edilecek şekilde ayarlanmalıdır.

Bu seçenekler hakkında daha fazla bilgi için bkz . Kapsayıcıları yapılandırma.

Özet

Bu makalede, Anomali Algılayıcısı kapsayıcılarını indirmeye, yüklemeye ve çalıştırmaya yönelik kavramları ve iş akışını öğrendiniz. Özet:

• Anomali Algılayıcısı Docker için tek bir Linux kapsayıcısı sağlar ve anomali algılamayı toplu iş ve akış, beklenen aralık çıkarımı ve duyarlılık ayarlama ile kapsüller.
• Kapsayıcı görüntüleri, kapsayıcılar için ayrılmış özel bir Azure Container Registry'den indirilir.
• Kapsayıcı görüntüleri Docker'da çalışır.
• Kapsayıcının konak URI'sini belirterek Anomali Algılayıcısı kapsayıcılardaki işlemleri çağırmak için REST API veya SDK kullanabilirsiniz.
• Kapsayıcı örneği oluştururken faturalama bilgilerini belirtmeniz gerekir.

Önemli

Azure yapay zeka kapsayıcıları, ölçüm için Azure'a bağlanmadan çalıştırılma lisansına sahip değildir. Müşterilerin, kapsayıcıların faturalama bilgilerini ölçüm hizmetiyle her zaman iletmesini sağlaması gerekir. Azure AI kapsayıcıları müşteri verilerini (örneğin analiz edilen zaman serisi verileri) Microsoft'a göndermez.

Sonraki adımlar

• Yapılandırma ayarları için kapsayıcıları yapılandırma'ya göz atın
• Azure Container Instances'a Anomali Algılayıcısı kapsayıcı dağıtma
• Anomali Algılayıcısı API hizmeti hakkında daha fazla bilgi edinin