Anomali algılayıcı API 'SI için Docker Kapsayıcıları yükleyip çalıştırın
Not
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, kendi ortamınızı anomali algılayıcı API 'sini kullanmanıza olanak sağlar. Kapsayıcılar, belirli güvenlik ve veri idare gereksinimleri için çok kullanışlıdır. Bu makalede anomali algılayıcı kapsayıcısını indirme, yükleme ve çalıştırma hakkında bilgi edineceksiniz.
Anomali algılayıcısı, şirket içi API 'yi kullanmak için tek bir Docker kapsayıcısı sunar. Kapsayıcıyı şu şekilde kullanın:
- Verileriniz üzerinde anomali algılayıcısının algoritmalarını kullanın
- Akış verilerini izleyin ve gerçek zamanlı olarak gerçekleştikleri gibi bozukluklar tespit edin.
- Veri kümesinin tamamında bir toplu iş olarak, anormallikleri tespit edin.
- Veri kümesindeki bir toplu iş olarak eğilim değişiklik noktalarını tespit edin.
- Anomali algılama algoritmasının duyarlılığını verilerinize daha iyi uyacak şekilde ayarlayın.
API hakkında ayrıntılı bilgi için lütfen bkz:
Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Önkoşullar
Anomali algılayıcı kapsayıcılarını kullanmadan önce aşağıdaki önkoşulları karşılamanız gerekir:
| Gerekli | Amaç |
|---|---|
| Docker altyapısı | Bir ana bilgisayardaDocker altyapısının 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. Kapsayıcıların Azure 'a bağlanıp faturalandırma verilerini göndermesini sağlamak için Docker yapılandırılmalıdır. Windows, docker 'ın de Linux kapsayıcılarını destekleyecek şekilde yapılandırılması gerekir. |
| Docker ile benzerlik | Kayıt defterleri, depolar, kapsayıcılar ve kapsayıcı görüntüleri gibi Docker kavramlarının yanı sıra temel komutlar hakkında bilgi sahibi olmanız gerekir docker . |
| Anomali algılayıcı kaynağı | Bu kapsayıcıları kullanabilmeniz için, şunları yapmanı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 anomali algılayıcısının genel bakış ve anahtarlar sayfalarında bulunur ve kapsayıcıyı başlatmak için gereklidir. {API_KEY}: anahtarlar sayfasında kullanılabilir iki kaynak anahtardan biri {ENDPOINT_URI}: genel bakış sayfasında belirtilen bitiş noktası |
Gerekli parametreler toplanıyor
Gerekli olan tüm bilişsel hizmetler için üç birincil parametre vardır. Son Kullanıcı Lisans Sözleşmesi 'nin (EULA) değeri ile mevcut olması gerekir accept . Ayrıca, hem bir uç nokta URL 'SI hem de API anahtarı gereklidir.
Uç nokta URI 'SI {ENDPOINT_URI}
Uç nokta URI değeri, karşılık gelen bilişsel hizmet kaynağının Azure Portal genel bakış sayfasında bulunur. Genel bakış sayfasına gidin, uç noktanın üzerine gelin ve bir Copy to clipboard simge görüntülenir. Gerektiğinde kopyalayın ve kullanın.

Belirlenmesine {API_KEY}
Bu anahtar, kapsayıcıyı başlatmak için kullanılır ve ilgili bilişsel hizmet kaynağının Azure portal tuşları sayfasında kullanılabilir. Anahtarlar sayfasına gidin ve Copy to clipboard simgesine tıklayın.

Önemli
Bu abonelik anahtarları bilişsel hizmet API 'nize erişmek için kullanılır. Anahtarlarınızı paylaşmayın. Azure Key Vault kullanarak güvenli bir şekilde depolayın. Ayrıca, bu anahtarların düzenli olarak yeniden oluşturulması önerilir. API çağrısı yapmak için yalnızca bir anahtar gereklidir. İlk anahtarı yeniden oluştururken, hizmete devam eden erişim için ikinci anahtarı kullanabilirsiniz.
Ana bilgisayar
Ana bilgisayar, Docker kapsayıcısını çalıştıran x64 tabanlı bir bilgisayardır. Şirket içinde veya Azure 'da bir Docker barındırma hizmeti olan bir bilgisayar olabilir; Örneğin:
- Azure Kubernetes hizmeti.
- Azure Container Instances.
- Azure Stackiçin dağıtılan bir Kubernetes kümesi. Daha fazla bilgi için bkz. Azure Stack Için Kubernetes dağıtma.
Kapsayıcı gereksinimleri ve önerileri
Aşağıdaki tabloda, anomali algılayıcı kapsayıcısı için ayrılacak minimum ve önerilen CPU çekirdekleri ve bellek açıklanmaktadır.
| QPS (saniye başına sorgu) | Minimum | Önerilen |
|---|---|---|
| 10 QPS | 4 çekirdek, 1 GB bellek | 8 çekirdekli 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, --cpus --memory komutunun bir parçası olarak kullanılan ve ayarlarına karşılık gelir docker run .
Kapsayıcı görüntüsünü al docker pull
docker pullBir kapsayıcı görüntüsünü indirmek için komutunu kullanın.
| Kapsayıcı | Depo |
|---|---|
| bilişsel hizmetler-anomali-algılayıcı | mcr.microsoft.com/azure-cognitive-services/decision/anomaly-detector:latest |
İpucu
İndirilen kapsayıcı görüntülerinizi listelemek için Docker görüntüleri komutunu kullanabilirsiniz. Örneğin, aşağıdaki komut, indirilen her bir kapsayıcı görüntüsünün KIMLIĞINI, deposunu ve etiketini listeler ve tablo olarak biçimlendirilir:
docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"
IMAGE ID REPOSITORY TAG
<image-id> <repository-path/name> <tag-name>
Anomali algılayıcı kapsayıcısı için Docker Pull
docker pull mcr.microsoft.com/azure-cognitive-services/anomaly-detector:latest
Kapsayıcıyı kullanma
Kapsayıcı ana bilgisayardanolduktan sonra, kapsayıcında çalışmak için aşağıdaki işlemi kullanın.
- Kapsayıcıyıgerekli faturalandırma ayarlarıyla çalıştırın. Komuta daha fazla örnek
docker runkullanılabilir. - Kapsayıcının tahmin uç noktasını sorgulayın.
Kapsayıcıyı ile çalıştırma docker run
Kapsayıcıyı çalıştırmak için Docker Run komutunu kullanın. Ve değerlerini alma hakkında ayrıntılar için gerekli parametreleri toplama bölümüne bakın {ENDPOINT_URI} {API_KEY} .
Komut örnekleri docker run 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ı 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 bir sözde TTY ayırır
- Kapsayıcıyı çıktıktan sonra otomatik olarak kaldırır. Kapsayıcı görüntüsü hala ana bilgisayarda kullanılabilir.
Ö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.
Aynı konakta birden çok kapsayıcı çalıştırma
Birden çok kapsayıcıyı açığa çıkarılan bağlantı noktalarıyla çalıştırmayı düşünüyorsanız, her kapsayıcıyı farklı bir bağlantı noktasıyla çalıştırdığınızdan emin olun. Örneğin, bağlantı noktası 5000 ' deki ilk kapsayıcıyı ve bağlantı noktası 5001 üzerindeki ikinci kapsayıcıyı çalıştırın.
<container-registry>Ve <container-name> değerlerini kullandığınız kapsayıcıların değerleriyle değiştirin. Bunların aynı kapsayıcı olması gerekmez. Anomali algılayıcı kapsayıcısının ve LUSıS kapsayıcısının KONAKTA birlikte çalışmasını sağlayabilir veya çalışan birden fazla anomali algılayıcı kapsayıcınıza sahip olabilirsiniz.
Birinci kapsayıcıyı 5000 ana bilgisayar bağlantı noktasında ç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}
İkinci kapsayıcıyı 5001 ana bilgisayar bağlantı noktasında ç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.
Bir kapsayıcının çalıştığını doğrulama
Kapsayıcının çalıştığını doğrulamak için birkaç yol vardır. Dış IP adresini ve söz konusu kapsayıcının bağlantı noktasını bulun ve en sevdiğiniz web tarayıcınızı açın. Kapsayıcının çalıştığını doğrulamak için aşağıdaki çeşitli istek URL 'Lerini kullanın. Aşağıda listelenen örnek URL 'Ler aşağıda verilmiştir http://localhost:5000 ancak belirli Kapsayıcınız farklılık gösterebilir. Kapsayıcının dış IP adresine ve açığa çıkarılan bağlantı noktasına güvendiğini aklınızda bulundurun.
| İstek URL’si | Amaç |
|---|---|
http://localhost:5000/ |
Kapsayıcı bir giriş sayfası sağlar. |
http://localhost:5000/ready |
GET ile istendi, bu, kapsayıcının modelde bir sorgu kabul etmeye hazırlandığından emin olmak için bir doğrulama sağlar. Bu istek, Kubernetes limize ve hazırlık araştırmalarıiçin kullanılabilir. |
http://localhost:5000/status |
GET ile de istenirse, bu, 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 limize ve hazırlık araştırmaları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 özellikle, ayarlarınızı bir Web tabanlı HTML biçiminde girebilir ve herhangi bir kod yazmak zorunda kalmadan sorguyu oluşturabilirsiniz. Sorgu çağrıldıktan sonra, gereken HTTP üst bilgilerini ve gövde biçimini göstermek için örnek bir KıVRıMLı komut 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' yi seçin.
Sorun giderme
Kapsayıcıyı bir çıkış bağlaması ve günlüğü etkin olarak çalıştırırsanız kapsayıcı, kapsayıcıyı başlatırken veya çalıştırırken oluşan sorunları gidermek için yararlı olan günlük dosyaları oluşturur.
İpucu
Daha fazla sorun giderme bilgisi ve Kılavuzu için bkz. bilişsel Hizmetler kapsayıcıları hakkında sık sorulan sorular (SSS).
Bilişsel Hizmetler 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 Bilişsel Hizmetler 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 komutunu kullanın:
docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic
Ardından kapsayıcıyı çalıştırın, uç noktanızla değiştirin {ENDPOINT_URI} ve kendi {API_KEY} anahtarınızla değiştirin:
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ı kapsayıcıları, Azure hesabınızda bir anomali algılayıcı kaynağı kullanarak faturalandırma bilgilerini Azure 'a gönderir.
Kapsayıcıya yönelik sorgular, parametresi için kullanılan Azure kaynağının fiyatlandırma katmanında faturalandırılır ApiKey .
Azure bilişsel hizmetler kapsayıcıları, ölçüm/faturalandırma uç noktasına bağlı kalmadan çalıştırılmak üzere lisanslanmaz. Her zaman Faturalandırma bitiş noktasıyla faturalandırma bilgilerini iletmek için kapsayıcıları etkinleştirmeniz gerekir. Bilişsel hizmetler kapsayıcıları, müşteri verilerini (örneğin, çözümlenen resim veya metin gibi) Microsoft 'a göndermez.
Azure'a Bağlanma
Kapsayıcının çalışması için faturalandırma bağımsız değişken değerlerinin olması gerekir. Bu değerler kapsayıcının faturalandırma uç noktasına bağlanmasına izin verir. Kapsayıcı her 10 ila 15 dakikada bir kullanım raporu sağlar. Kapsayıcı, izin verilen zaman penceresinde Azure 'a bağlanmazsa, kapsayıcı çalışmaya devam eder, ancak faturalandırma uç noktası geri yüklenene kadar sorgu hizmeti vermez. Bağlantı, 10 ila 15 dakika aynı zaman aralığında 10 kez denenir. 10 deneciler içindeki faturalandırma uç noktasına bağlanamıyorsa kapsayıcı, istekleri sunmaya yanıt vermez. Faturalandırma için Microsoft 'a gönderilen bilgilerin bir örneği için bilişsel Hizmetler kapsayıcısı hakkında SSS bölümüne bakın.
Faturalandırma bağımsız değişkenleri
Aşağıdaki seçeneklerden üçü de geçerli değerlerle sağlandığında komut kapsayıcıyı başlatır: docker run
| Seçenek | Açıklama |
|---|---|
ApiKey |
Fatura bilgilerini izlemek için kullanılan bilişsel hizmetler kaynağının API anahtarı. Bu seçeneğin değeri, içinde belirtilen sağlanan kaynak için bir API anahtarı olarak ayarlanmalıdır Billing . |
Billing |
Fatura bilgilerini izlemek için kullanılan bilişsel hizmetler 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ı kapsayıcılarını indirmek, yüklemek ve çalıştırmak için kavramlar ve iş akışı öğrendiniz. Özet:
- Anomali algılayıcısı, Docker için bir Linux kapsayıcısı, toplu iş vs akışı, beklenen Aralık çıkarımı ve duyarlık ayarlama ile Kapsülleyici algılama sağlar.
- Kapsayıcı görüntüleri, kapsayıcılar için ayrılmış özel bir Azure Container Registry indirilir.
- Kapsayıcı görüntüleri Docker 'da çalışır.
- Kapsayıcının ana bilgisayar URI 'sini belirterek anomali algılayıcı kapsayıcılarındaki işlemleri çağırmak için REST API veya SDK kullanabilirsiniz.
- Bir kapsayıcıyı örnekledikten sonra faturalandırma bilgilerini belirtmeniz gerekir.
Önemli
Bilişsel hizmetler kapsayıcıları, ölçüm için Azure 'a bağlı kalmadan çalıştırılmak üzere lisanslanmaz. Müşterilerin, ödeme bilgilerini her zaman ölçüm hizmetiyle iletişimine olanak tanımak için kapsayıcıların etkinleştirilmesi gerekir. Bilişsel Hizmetler kapsayıcıları müşteri verilerini (örneğin, analiz ediliyor olan zaman serisi verileri) Microsoft'a göndermez.
Sonraki adımlar
- Yapılandırma ayarları için kapsayıcıları yapılandırma'ya gidin
- Sanal Anomali Algılayıcısı dağıtma Azure Container Instances
- API hizmeti hakkında daha Anomali Algılayıcısı bilgi edinin