Uzamsal analiz kapsayıcısını (Önizleme) yükleyip çalıştırın
Uzamsal analiz kapsayıcısı, kişiler, taşınanlar ve fiziksel ortamlardaki nesnelerle etkileşimler arasındaki uzamsal ilişkileri anlamak için gerçek zamanlı akış videosunu analiz etmenizi sağlar. Kapsayıcılar, belirli güvenlik ve veri idare gereksinimleri için çok kullanışlıdır.
Önkoşullar
- Azure aboneliği- ücretsiz olarak bir tane oluşturun
- Sorumlu AI koşullarını kabul etmek ve kaynak oluşturmak için Azure hesabınıza bir Bilişsel Hizmetler Katkıda Bulunanı rolü atanmış olması gerekir. Bu rolü hesabınıza ataması için yöneticinize başvurun.
- Azure aboneliğiniz olduktan sonra, anahtarınızı ve uç noktanızı almak Için Azure Portal Standart S1 katmanı için bir Görüntü İşleme kaynağı oluşturun görüntü işleme bir kaynak oluşturun. Dağıtıldıktan sonra Kaynağa Git ' e tıklayın.
- Uzamsal analiz kapsayıcısını çalıştırmak için oluşturduğunuz kaynaktaki anahtar ve uç nokta gerekir. Anahtarınızı ve uç noktanızı daha sonra kullanacaksınız.
Uzamsal analiz kapsayıcısı gereksinimleri
Uzamsal analiz kapsayıcısını çalıştırmak için, NVIDIA Tesla T4 GPU 'suolan bir işlem cihazına ihtiyacınız vardır. GPU hızlandırmalı Azure Stack Edge kullanmanızı öneririz, ancak kapsayıcı, en düşük gereksinimleri karşılayan diğer masaüstü makineler üzerinde çalışır. Bu cihaza ana bilgisayar olarak başvuracağız.
Azure Stack Edge, ağ veri aktarımı özelliklerine sahip bir hizmet olarak donanım ve bir AI özellikli sınır bilgi işlem aygıtıdır. Ayrıntılı hazırlık ve kurulum yönergeleri için Azure Stack Edge belgelerinebakın.
| Gereksinim | Açıklama |
|---|---|
| Kamera | Uzamsal analiz kapsayıcısı belirli bir kamera markasına bağlı değil. Kamera cihazının şunları yapması gerekir: Real-Time Akış Protokolü (RTSP) ve H. IBU kodlamayı destekler, ana bilgisayar için erişilebilir olur ve 15 fps ve 1080p çözünürlükte akış yapabilir. |
| Linux işletim sistemi | Ubuntu Desktop 18,04 LTS , ana bilgisayarda yüklü olmalıdır. |
Ana bilgisayarı ayarlama
Ana bilgisayarınız için bir Azure Stack Edge cihazı kullanmanız önerilir. Farklı bir cihaz yapılandırıyorsanız Masaüstü makinesi ' ne veya bir VM kullanıyorsanız sanal makine ' ye tıklayın.
Azure Stack Edge portalında işlem yapılandırma
Uzamsal analiz, bir AI çözümünü çalıştırmak için Azure Stack ucunun işlem özelliklerini kullanır. İşlem özelliklerini etkinleştirmek için aşağıdakileri yaptığınızdan emin olun:
- Azure Stack Edge cihazınızı bağladınız ve etkinleştirdiniz .
- cihaza erişmek için PowerShell 5,0 veya üzeri bir sürümü çalıştıran bir Windows istemci sisteminiz vardır.
- Bir Kubernetes kümesi dağıtmak için, Azure Stack Edge cihazınızı Azure Portal Yerel Kullanıcı arabirimi aracılığıyla yapılandırmanız gerekir:
- Azure Stack Edge cihazınızda işlem özelliğini etkinleştirin. İşlem özelliğini etkinleştirmek için, cihazınızın web arabirimindeki işlem sayfasına gidin.
- İşlem için etkinleştirmek istediğiniz bir ağ arabirimi seçin ve ardından Etkinleştir' e tıklayın. Bu, cihazınızda bu ağ arabiriminde bir sanal anahtar oluşturur.
- Kubernetes sınama düğümü IP adreslerini ve Kubernetes dış hizmetler IP adreslerini boş bırakın.
- Uygula’ya tıklayın. Bu işlem, iki dakika sürebilir.

Bir uç işlem rolü ayarlama ve bir IoT Hub kaynağı oluşturma
Azure Portal, Azure Stack Edge kaynağına gidin. Genel bakış sayfasında veya gezinti listesinde Edge COMPUTE Başlarken düğmesine tıklayın. Uç Işlem yapılandırma kutucuğunda Yapılandır' ı tıklatın.

Edge Işlem yapılandırma sayfasında, mevcut bir IoT Hub seçin veya yenisini oluşturmayı seçin. Varsayılan olarak, bir IoT Hub kaynağı oluşturmak için standart (S1) Fiyatlandırma Katmanı kullanılır. Boş bir katman IoT Hub kullanmak için, bir tane oluşturun ve ardından seçin. IoT Hub kaynak, Azure Stack Edge kaynağı tarafından kullanılan aynı abonelik ve kaynak grubunu kullanır
Oluştur’a tıklayın. IoT Hub kaynak oluşturma birkaç dakika sürebilir. IoT Hub kaynağı oluşturulduktan sonra, yeni yapılandırmayı göstermek için Edge işlem bölmesini Yapılandır ' ı güncellecektir. Edge işlem rolünün yapılandırıldığını doğrulamak için, Işlem yapılandırma kutucuğunda yapılandırmayı görüntüle ' yi seçin .
Edge cihazında Edge hesaplama rolü ayarlandığında, iki cihaz oluşturur: bir IoT cihazı ve bir IoT Edge cihaz. Her iki cihaz de IoT Hub kaynağında görüntülenebilir. Azure IoT Edge çalışma zamanı IoT Edge cihazda zaten çalışıyor.
Not
- Şu anda yalnızca Linux platformu IoT Edge cihazlar için desteklenir. Azure Stack Edge cihazında sorun giderme konusunda yardım için bkz. günlük ve sorun giderme makalesi.
- Bir proxy sunucusu üzerinden iletişim kurmak üzere bir IoT Edge cihazının nasıl yapılandırılacağı hakkında daha fazla bilgi edinmek için bkz. bir IoT Edge cihazını bir ara sunucu üzerinden iletişim kurmak Için yapılandırma
Azure Stack Edge üzerinde MPS 'yi etkinleştirme
bir Windows istemcisinden uzaktan bağlanmak için aşağıdaki adımları izleyin.
yönetici olarak bir Windows PowerShell oturumu çalıştırın.
Windows Uzaktan Yönetimi hizmetinin istemciniz üzerinde çalıştığından emin olun. Komut istemine şunları yazın:
winrm quickconfigdaha fazla bilgi için bkz. Windows Uzaktan Yönetimi için yükleme ve yapılandırma.
Dosyada kullanılan bağlantı dizesine bir değişken atayın
hosts.$Name = "<Node serial number>.<DNS domain of the device>"<Node serial number>Ve<DNS domain of the device>, cihazınızın seri numarasını ve DNS etki alanını değiştirin. Cihazların yerel Web Kullanıcı arabirimindeki cihaz sayfasından SERTIFIKALAR sayfasından ve DNS etki alanından düğüm seri numarası değerlerini alabilirsiniz.Cihazınızın bu bağlantı dizesini istemcinin güvenilen konaklar listesine eklemek için aşağıdaki komutu yazın:
Set-Item WSMan:\localhost\Client\TrustedHosts $Name -Concatenate -Forcecihazda bir Windows PowerShell oturumu başlatın:
Enter-PSSession -ComputerName $Name -Credential ~\EdgeUser -ConfigurationName Minishell -UseSSLGüven ilişkisiyle ilgili bir hata görürseniz, cihazınıza yüklenen düğüm sertifikasının imzalama zincirinin cihazınıza erişen istemciye de yüklenip yüklenmediğini kontrol edin.
İstendiğinde parolayı girin. Yerel Web Kullanıcı arabiriminde oturum açmak için kullanılan parolayı kullanın. Varsayılan yerel Web UI parolası Parola1'dır. Uzak PowerShell kullanarak cihaza başarıyla bağlandığınızda aşağıdaki örnek çıktıyı görürsünüz:
Windows PowerShell Copyright (C) Microsoft Corporation. All rights reserved. PS C:\WINDOWS\system32> winrm quickconfig WinRM service is already running on this machine. PS C:\WINDOWS\system32> $Name = "1HXQG13.wdshcsso.com" PS C:\WINDOWS\system32> Set-Item WSMan:\localhost\Client\TrustedHosts $Name -Concatenate -Force PS C:\WINDOWS\system32> Enter-PSSession -ComputerName $Name -Credential ~\EdgeUser -ConfigurationName Minishell -UseSSL WARNING: The Windows PowerShell interface of your device is intended to be used only for the initial network configuration. Please engage Microsoft Support if you need to access this interface to troubleshoot any potential issues you may be experiencing. Changes made through this interface without involving Microsoft Support could result in an unsupported configuration. [1HXQG13.wdshcsso.com]: PS>
IoT Dağıtım bildirimi
Birden çok konak bilgisayarda kapsayıcı dağıtımını basit hale getirmek için, kapsayıcı oluşturma seçeneklerini ve ortam değişkenlerini belirtmek için bir dağıtım bildirim dosyası oluşturabilirsiniz. Azure Stack Edge, diğer masaüstü makineleri ve sanal makinelerde GPU ileAzure VM için bir dağıtım bildirimi GitHub.
Aşağıdaki tabloda, IoT Edge Modülü tarafından kullanılan çeşitli Ortam Değişkenleri yer alır. Ayrıca, içinde özniteliğini kullanarak bunları yukarıda bağlantılı dağıtım bildiriminde env de spatialanalysis ayarlayın:
| Ayar Adı | Değer | Açıklama |
|---|---|---|
| ARCHON_LOG_LEVEL | Bilgi; Ayrıntılı | Günlük düzeyi, iki değerden birini seçin |
| ARCHON_SHARED_BUFFER_LIMIT | 377487360 | Değiştirmeyin |
| ARCHON_PERF_MARKER | yanlış | Performans günlüğü için bunu true olarak ayarlayın, aksi takdirde false olması gerekir |
| ARCHON_NODES_LOG_LEVEL | Bilgi; Ayrıntılı | Günlük düzeyi, iki değerden birini seçin |
| OMP_WAIT_POLICY | PASİF | Değiştirmeyin |
| QT_X11_NO_MITSHM | 1 | Değiştirmeyin |
| APIKEY | API Anahtarınız | Bu değeri Azure portal kaynağından Görüntü İşleme toplayın. Kaynağınız için Anahtar ve uç nokta bölümünde bulabilirsiniz. |
| FATURALAMA | Uç Nokta URI'niz | Bu değeri Azure portal kaynağından Görüntü İşleme toplayın. Kaynağınız için Anahtar ve uç nokta bölümünde bulabilirsiniz. |
| EULA | Kabul | Kapsayıcının çalışması için bu değerin kabul edilecek şekilde ayarlanmış olması gerekir |
| GÖRÜNTÜ | :1 | Bu değerin, konak bilgisayarın echo $DISPLAY çıktısı ile aynı olması gerekir. Azure Stack Edge cihazların ekranı yok. Bu ayar geçerli değildir |
| ARCHON_GRAPH_READY_TIMEOUT | 600 | GPU'nız T4 veya NVIDIA 2080 Ti değilse bu ortam değişkenini ekleyin |
| ORT_TENSORRT_ENGINE_CACHE_ENABLE | 0 | GPU'nız T4 veya NVIDIA 2080 Ti değilse bu ortam değişkenini ekleyin |
| KEY_ENV | ASE Şifreleme anahtarı | Bu ortam değişkeni, Video_URL bir dize ise ekleyin |
| IV_ENV | Başlatma vektörü | Bu ortam değişkeni, Video_URL bir dize ise ekleyin |
Önemli
Kapsayıcıyı çalıştırmak için , Eula Billing ve seçenekleri ApiKey belirtilmelidir; aksi takdirde kapsayıcı başlamaz. Daha fazla bilgi için bkz. Faturalama.
Azure Stack Edge cihazları, masaüstü makinesi veya Gpu ile Azure VM için dağıtım bildirimini kendi ayarlarınıza ve işlemlerinize göre güncelleştirin ve aşağıdaki Azure CLI komutunu kullanarak kapsayıcıyı konak bilgisayara bir IoT Edge Modülü olarak dağıtabilirsiniz.
sudo az login
sudo az extension add --name azure-iot
sudo az iot edge set-modules --hub-name "<iothub-name>" --device-id "<device-name>" --content DeploymentManifest.json --subscription "<name or ID of Azure Subscription>"
| Parametre | Açıklama |
|---|---|
--hub-name |
Azure IoT Hub adı. |
--content |
Dağıtım dosyasının adı. |
--target-condition |
Konak IoT Edge için cihaz adınız. |
-–subscription |
Abonelik kimliği veya adı. |
Bu komut dağıtımı başlatacak. Dağıtım durumunu görmek için Azure IoT Hub örneğinin Azure portal sayfasına gidin. Durum 417 olarak gösterebilir – Cihaz kapsayıcı görüntülerini indirmeyi bitirip çalışmaya başlayana kadar cihazın dağıtım yapılandırması ayarlanmaz.
Dağıtımın başarılı olduğunu doğrulama
Kapsayıcının çalıştırlı olduğunu doğrulamanın birkaç yolu vardır. Çalışma Zamanı Durumu'IoT Edge modülünün Ayarlar modülünün Çalışma Zamanı Azure IoT Hub modülünün çalışma zamanı Azure portal. Çalışma Zamanı Durumu için İstenen Değer ve Bildirilen Değer'in Çalışıyor olduğunu onaylar.

Dağıtım tamamlandıktan ve kapsayıcı çalışmaya başladıktan sonra, konak bilgisayar olayları sunucuya Azure IoT Hub. İşlemlerin sürümünü kullandıysanız, dağıtım bildiriminde yapılandırılan her kamera .debug için bir görselleştirici penceresi görüntülenir. Artık dağıtım bildiriminde izlemek istediğiniz satırları ve bölgeleri tanımlayabilir ve yeniden dağıtmak için yönergeleri izleyebilirsiniz.
Uzamsal Analiz tarafından gerçekleştirilen işlemleri yapılandırma
Kapsayıcıyı bağlı kameraları kullanmak, işlemleri yapılandırmak ve daha fazlasını yapmak üzere yapılandırmak için Uzamsal Analiz işlemlerini kullanabilirsiniz. Yapılandırılan her kamera cihazı için Uzamsal Analiz işlemleri, JSON iletilerinin çıkış akışını oluşturur ve bu akışlar Azure IoT Hub.
Kapsayıcı tarafından oluşturulan çıkışı kullanma
Kapsayıcı tarafından oluşturulan çıkışı tüketmek için aşağıdaki makalelere bakın:
- Seçtiğiniz programlama dili için Azure Olay Hub'ı SDK'sı kullanarak Azure IoT Hub ve olayları alırsınız. Daha fazla bilgi için bkz. Yerleşik uç noktadan cihazdan buluta iletileri okuma.
- Olayları diğer uç noktalara Azure IoT Hub veya olayları Azure Blob Depolama'ya vb. kaydetmek için Depolama ayarlayın. Daha IoT Hub için bkz. İleti Yönlendirme.
Uzamsal Analizi kayıtlı bir video dosyasıyla çalıştırma
Uzamsal Analizi hem kayıtlı hem de canlı video ile kullanabilirsiniz. Uzamsal Analizi kayıtlı video için kullanmak üzere bir video dosyasını kaydetmeyi ve mp4 dosyası olarak kaydetmeyi deneyin. Azure'da bir blob depolama hesabı oluşturun veya var olan bir hesabı kullanın. Ardından aşağıdaki blob depolama ayarlarını Azure portal: 1. Güvenli aktarım gerekli'i Devre Dışı olarak değiştirme 2. Blob genel erişimine izin ver'i Etkin olarak değiştirme
Kapsayıcı bölümüne gidin ve yeni bir kapsayıcı oluşturun veya var olan bir kapsayıcıyı kullanın. Ardından video dosyasını kapsayıcıya yükleyin. Karşıya yüklenen dosyanın dosya ayarlarını genişletin ve SAS Oluştur'a tıklayın. Sona Erme Tarihi'nin test süresini kapsayacak kadar uzun olduğundan emin olun. İzin Verilen Protokoller'i HTTP olarak ayarlayın (HTTPS desteklenmiyor).
SAS Belirteci ve URL'si Oluştur'a tıklayın ve Blob SAS URL'sini kopyalayın. ile başlayanı https değiştirin http ve URL'yi video kayıttan yürütmeyi destekleyen bir tarayıcıda test edin.
Azure Stack Edge cihazınızın, masaüstü makinenizin veya Azure VM'nizin dağıtım bildiriminde ifadesini tüm grafikler için oluşturduğunuz URL ile VIDEO_URL GPU ile değiştirin. olarak VIDEO_IS_LIVE ayarlayın false ve Güncelleştirilmiş bildirimle Uzamsal Analiz kapsayıcısı yenidenploy. Aşağıdaki örneğe bakın.
Uzamsal Analiz modülü video dosyasını tüketerek başlayacak ve sürekli olarak otomatik olarak yeniden oynatacak.
"zonecrossing": {
"operationId" : "cognitiveservices.vision.spatialanalysis-personcrossingpolygon",
"version": 1,
"enabled": true,
"parameters": {
"VIDEO_URL": "Replace http url here",
"VIDEO_SOURCE_ID": "personcountgraph",
"VIDEO_IS_LIVE": false,
"VIDEO_DECODE_GPU_INDEX": 0,
"DETECTOR_NODE_CONFIG": "{ \"gpu_index\": 0, \"do_calibration\": true }",
"SPACEANALYTICS_CONFIG": "{\"zones\":[{\"name\":\"queue\",\"polygon\":[[0.3,0.3],[0.3,0.9],[0.6,0.9],[0.6,0.3],[0.3,0.3]], \"events\": [{\"type\": \"zonecrossing\", \"config\": {\"threshold\": 16.0, \"focus\": \"footprint\"}}]}]}"
}
},
Sorun giderme
Kapsayıcıyı başlatma veya çalıştırma sırasında sorunlarla karşılaşırsanız yaygın sorunlar için telemetri verilerine ve sorun gidermeye bakın. Bu makale ayrıca günlük oluşturma, toplama ve sistem durumunu toplama hakkında bilgi içerir.
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
Uzamsal Analiz kapsayıcısı, Azure hesabınıza Görüntü İşleme bir kaynak kullanarak faturalama bilgilerini Azure'a gönderir. Genel önizlemede Uzamsal Analiz kullanımı şu anda ücretsizdir.
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ı, Microsoft 'a, analiz edilen video veya resim gibi müşteri verileri göndermez.
Özet
Bu makalede, uzamsal analiz kapsayıcısını indirmek, yüklemek ve çalıştırmak için kavramların ve iş akışının öğrenmiş olursunuz. Özet:
- Uzamsal analiz, Docker için bir Linux kapsayıcısıdır.
- Kapsayıcı görüntüleri Microsoft Container Registry indirilir.
- Kapsayıcı görüntüleri Azure IoT Edge ' de IoT modülleri olarak çalışır.
- Kapsayıcıyı yapılandırma ve bir konak makinesine dağıtma.
