Telemetri ve sorun giderme

Uzamsal analizler sistemin sistem durumunu izlemeye yönelik bir dizi özellik içerir ve sorunları tanılamanıza yardımcı olur.

Görselleştirmeleri etkinleştir

Bir video çerçevesindeki bir AI Insight etkinlikleri görselleştirmesini etkinleştirmek için, .debug bir masaüstü makinesinde veya Azure VM 'de bir uzamsal analiz işleminin sürümünü kullanmanız gerekir. Görselleştirme Azure Stack Edge cihazlarında mümkün değildir. Dört hata ayıklama işlemi kullanılabilir.

Cihazınız yerel bir masaüstü makinesi veya Azure GPU VM 'si (Uzak Masaüstü etkin) ise, .debug herhangi bir işlemin sürümüne geçebilir ve çıktıyı görselleştirebilirsiniz.

1. Masaüstünü yerel olarak veya uzamsal analiz çalıştıran ana bilgisayarda Uzak Masaüstü istemcisi 'ni kullanarak açın.

2. Terminal çalıştırmasında xhost +

3. Modül altındaki dağıtım bildirimini spaceanalytics DISPLAY ortam değişkeninin değeriyle güncelleştirin. echo $DISPLAYAna bilgisayardaki terminalde çalıştırarak değerini bulabilirsiniz.

   "env": {        
       "DISPLAY": {
           "value": ":11"
           }
   }
   

4. Hata ayıklama modunda çalıştırmak istediğiniz dağıtım bildiriminde grafiği güncelleştirin. Aşağıdaki örnekte, operationId 'yi biliveservices. Vision. spatialanalysis-personcrossingçokgen. Debug olarak güncelleştiririz. VISUALIZER_NODE_CONFIGGörselleştirici penceresini etkinleştirmek için yeni bir parametre gereklidir. Tüm işlemler hata ayıklama türü ' nde kullanılabilir. Paylaşılan düğümleri kullanırken, biliveservices. Vision. spatialanalysis. Debug işlemini kullanın ve VISUALIZER_NODE_CONFIG örnek parametrelerine ekleyin.

   "zonecrossing": {
       "operationId" : "cognitiveservices.vision.spatialanalysis-personcrossingpolygon.debug",
       "version": 1,
       "enabled": true,
       "parameters": {
           "VIDEO_URL": "Replace http url here",
           "VIDEO_SOURCE_ID": "zonecrossingcamera",
           "VIDEO_IS_LIVE": false,
           "VIDEO_DECODE_GPU_INDEX": 0,
           "DETECTOR_NODE_CONFIG": "{ \"gpu_index\": 0 }",
           "CAMERACALIBRATOR_NODE_CONFIG": "{ \"gpu_index\": 0}",
           "VISUALIZER_NODE_CONFIG": "{ \"show_debug_video\": 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]], \"threshold\":35.0}]}"
       }
   }
   

5. Yeniden dağıtın ve konak bilgisayarda Görselleştirici penceresini görürsünüz

6. Dağıtım tamamlandıktan sonra, .Xauthority dosyayı ana bilgisayardan kapsayıcıya kopyalamanız ve yeniden başlatmanız gerekebilir. Aşağıdaki örnekte, peopleanalytics ana bilgisayardaki kapsayıcının adıdır.

   sudo docker cp $XAUTHORITY peopleanalytics:/root/.Xauthority
   sudo docker stop peopleanalytics
   sudo docker start peopleanalytics
   xhost +
   

Sistem durumu telemetrisini topla

Telegraf, uzamsal analiz ile birlikte çalışarak açık kaynaklı bir görüntüdür ve Microsoft Container Registry kullanılabilir. Aşağıdaki girişleri alır ve Azure Izleyici 'ye gönderir. Telegraf modülü, istenen özel girişler ve çıktılar ile oluşturulabilir. Uzamsal analizde telegraf Module yapılandırması, dağıtım bildiriminin bir parçasıdır (yukarıda bağlantılı). Bu modül isteğe bağlıdır ve ihtiyacınız yoksa bildirimden kaldırılabilir.

Girişi

1. Uzamsal analiz ölçümleri
2. Disk Ölçümleri
3. CPU ölçümleri
4. Docker ölçümleri
5. GPU ölçümleri

Çıkışı

1. Azure İzleyici

Sağlanan uzamsal analiz telegraf modülü, uzamsal analiz kapsayıcısı tarafından sunulan tüm telemetri verilerini Azure Izleyici 'ye yayımlar. Aboneliğinize Azure Izleyici ekleme hakkında bilgi için bkz. Azure izleyici .

Azure Izleyici 'yi ayarladıktan sonra, modülün telemetri göndermesini sağlayan kimlik bilgileri oluşturmanız gerekir. Yeni bir hizmet sorumlusu oluşturmak için Azure portal kullanabilir veya bir tane oluşturmak için aşağıdaki Azure CLı komutunu kullanabilirsiniz.

# Find your Azure IoT Hub resource ID by running this command. The resource ID  should start with something like 
# "/subscriptions/b60d6458-1234-4be4-9885-c7e73af9ced8/resourceGroups/..."
az iot hub list

# Create a Service Principal with `Monitoring Metrics Publisher` role in the IoTHub resource:
# Save the output from this command. The values will be used in the deployment manifest. The password won't be shown again so make sure to write it down
az ad sp create-for-rbac --role="Monitoring Metrics Publisher" --name "<principal name>" --scopes="<resource ID of IoT Hub>"

Azure Stack Edge cihazınız, Masaüstü makinenizveya GPU ile Azure VM'nizin dağıtım bildiriminde, telegraf modülünü arayın ve aşağıdaki değerleri önceki adımda bulunan hizmet sorumlusu bilgileriyle değiştirin ve yeniden dağıtın.

"telegraf": { 
  "settings": {
  "image":   "mcr.microsoft.com/azure-cognitive-services/vision/spatial-analysis/telegraf:1.0",
  "createOptions":   "{\"HostConfig\":{\"Runtime\":\"nvidia\",\"NetworkMode\":\"azure-iot-edge\",\"Memory\":33554432,\"Binds\":[\"/var/run/docker.sock:/var/run/docker.sock\"]}}"
},
"type": "docker",
"env": {
    "AZURE_TENANT_ID": {
        "value": "<Tenant Id>"
    },
    "AZURE_CLIENT_ID": {
        "value": "Application Id"
    },
    "AZURE_CLIENT_SECRET": {
        "value": "<Password>"
    },
    "region": {
        "value": "<Region>"
    },
    "resource_id": {
        "value": "/subscriptions/{subscriptionId}/resourceGroups/{resoureGroupName}/providers/Microsoft.Devices/IotHubs/{IotHub}"
    },
...

Telegraf modülü dağıtıldıktan sonra, bildirilen ölçümlere Azure Izleyici hizmeti aracılığıyla ya da Azure portal IoT Hub izleme seçilerek erişilebilir.

Sistem durumu olayları

IoT Edge cihaz sorunlarını giderme

iotedgeÇalışan modüllerin durumunu ve günlüklerini denetlemek için komut satırı aracını kullanabilirsiniz. Örnek:

• iotedge list: Çalışan modüllerin listesini raporlar. İle ilgili hataları daha fazla kontrol edebilirsiniz iotedge logs edgeAgent . iotedgeTakıldığında, ile yeniden başlatmayı deneyebilirsiniziotedge restart edgeAgent
• iotedge logs <module-name>
• iotedge restart <module-name> belirli bir modülü yeniden başlatmak için

Tanılama kapsayıcısı ile günlük dosyalarını toplama

Uzamsal analiz, çalışma zamanı sorunlarını tanılamak için kullanabileceğiniz veya destek biletlerinin dahil olduğu Docker hata ayıklama günlüklerini oluşturur. uzamsal analiz tanılama modülü, indirmeniz için Microsoft Container Registry kullanılabilir. Azure Stack Edge cihazınız, Masaüstü makinenizveya GPU ile Azure VM için bildirim dağıtım dosyasında, Tanılama modülünü bulun.

"Env" bölümünde aşağıdaki yapılandırmayı ekleyin:

"diagnostics": {  
  "settings": {
  "image":   "mcr.microsoft.com/azure-cognitive-services/vision/spatial-analysis/diagnostics:1.0",
  "createOptions":   "{\"HostConfig\":{\"Mounts\":[{\"Target\":\"/usr/bin/docker\",\"Source\":\"/home/data/docker\",\"Type\":\"bind\"},{\"Target\":\"/var/run\",\"Source\":\"/run\",\"Type\":\"bind\"}],\"LogConfig\":{\"Config\":{\"max-size\":\"500m\"}}}}"
  }

Azure Blob Depolama gibi uzak bir uç noktaya yüklenen günlükleri iyileştirmek için küçük bir dosya boyutu sürdürülmesi önerilir. Önerilen Docker günlükleri yapılandırması için aşağıdaki örneğe bakın.

{
    "HostConfig": {
        "LogConfig": {
            "Config": {
                "max-size": "500m",
                "max-file": "1000"
            }
        }
    }
}

Günlük düzeyini yapılandırma

Günlük düzeyi yapılandırması, oluşturulan günlüklerin ayrıntı düzeyini denetlemenize olanak tanır. Desteklenen günlük düzeyleri şunlardır: none , verbose , info , warning ve error . Her iki düğüm ve platform için varsayılan günlük ayrıntı düzeyi info .

ARCHON_LOG_LEVELOrtam değişkeni, izin verilen değerlerden birine ayarlanarak, günlük düzeyleri genel olarak değiştirilebilir. Ayrıca, tüm dağıtılan yetenekler için IoT Edge modülü Ikizi belgesi aracılığıyla ya da değerleri platformLogLevel aşağıda gösterildiği gibi ayarlayarak her belirli yetenek için de ayarlanabilir nodesLogLevel .

{
    "version": 1,
    "properties": {
        "desired": {
            "globalSettings": {
                "platformLogLevel": "verbose"
            },
            "graphs": {
                "samplegraph": {
                    "nodesLogLevel": "verbose",
                    "platformLogLevel": "verbose"
                }
            }
        }
    }
}

Günlükleri toplama

Azure Stack Edge cihazınız, masaüstümakineniz veya GPU içeren Azure VM'niz için örnek dağıtım bildirimi dosyası, günlükleri toplayıp karşıya yüklayan adlı diagnostics bir modül içerir. Bu modül varsayılan olarak devre dışıdır ve günlüklere erişme IoT Edge modül yapılandırması aracılığıyla etkinleştirilmesi gerekir.

Koleksiyon isteğe bağlıdır ve doğrudan IoT Edge yöntemiyle denetlenr ve günlükleri diagnostics Azure Blob depolama Depolama.

Tanılama karşıya yükleme hedeflerini yapılandırma

IoT Edge portalında cihazınızı ve ardından tanılama modülünü seçin. Azure Stack Edge cihazınız, masaüstümakineleriniz veya GPU ile Azure VM'niz için örnek Dağıtım bildirimi dosyasında adlı tanılama için Ortam Değişkenleri bölümünü bulun ve aşağıdaki env bilgileri ekleyin:

Azure Blob Upload için yapılandırma Depolama

1. Henüz oluşturmadıysanız Depolama Azure Blob depolama hesabı oluşturun.
2. Depolama hesabınız için Bağlantı Dizesini Azure portal. Erişim Anahtarları'nın içinde bulunur.
3. Uzamsal Analiz günlükleri otomatik olarak rtcvlogs Depolama blob depolama kapsayıcısı içine şu dosya adı biçimiyle yüklenir: {CONTAINER_NAME}/{START_TIME}-{END_TIME}-{QUERY_TIME}.log .

"env":{
    "IOTEDGE_WORKLOADURI":"fd://iotedge.socket",
    "AZURE_STORAGE_CONNECTION_STRING":"XXXXXX",   //from the Azure Blob Storage account
    "ARCHON_LOG_LEVEL":"info"
}

Uzamsal Analiz günlüklerini karşıya yükleme

Günlükler, modülde IoT Edge getRTCVLogs yöntemiyle isteğe bağlı olarak diagnostics karşıya yüklendi.

1. IoT Hub portalı sayfanıza gidin, Edge Cihazları'nın ardından cihazınızı ve tanılama modülünü seçin.
2. Modülün ayrıntılar sayfasına gidin ve doğrudan yöntem sekmesine tıklayın.
3. Yöntem getRTCVLogs Adı'nın üzerine ve yükte bir json biçim dizesi yazın. Boş bir {} yük olan girsiniz.
4. Bağlantı ve yöntem zaman aşımını ayarlayın ve Yöntemi Çağır'a tıklayın.
5. Hedef kapsayıcınızı seçin ve Günlük söz dizimi bölümünde açıklanan parametreleri kullanarak bir yük json dizesi derleme. İsteği gerçekleştirmek için Yöntem Çağır'a tıklayın.

Günlük söz dizimi

Aşağıdaki tabloda, günlükleri sorgularken kullanabileceğiniz parametreler listelenmiştir.

Aşağıdaki tabloda sorgu yanıtını öznitelikler listele.

Örnek istek

{
    "StartTime": -1,
    "EndTime": -1,
    "ContainerId": "5fa17e4d8056e8d16a5a998318716a77becc01b36fde25b3de9fde98a64bf29b",
    "DoPost": false,
    "Filters": null
}

Örnek yanıt

{
    "status": 200,
    "payload": {
        "DoPost": false,
        "TimeFilter": [-1, 1581310339411],
        "ValueFilters": {},
        "Metas": {
            "TimeStamp": "2020-02-10T04:52:19.4365389+00:00",
            "ContainerId": "5fa17e4d8056e8d16a5a998318716a77becc01b36fde25b3de9fde98a64bf29b",
            "FetchCounter": 61,
            "FetchSizeInByte": 20470,
            "MatchCounter": 61,
            "MatchSizeInByte": 20470,
            "FilterCount": 61,
            "FilterSizeInByte": 20470,
            "FetchLogsDurationInMiliSec": 0,
            "PaseLogsDurationInMiliSec": 0,
            "PostLogsDurationInMiliSec": 0
        }
    }
}

Getirme günlüğünün satırlarını, saatlerini ve boyutlarını kontrol edin; bu ayarlar iyi görünüyorsa DoPost yerine kullanın ve günlükleri aynı filtrelerle true hedeflere iletir.

Sorunları giderirken Azure Blob depolama Depolama dışarı aktarabilirsiniz.

Azure Stack Edge giderme

Hata ayıklama ve cihazınızın durumunu doğrulama ile ilgili yardım için aşağıdaki Azure Stack Edge verilmektedir.

Kubernetes API Uç Noktasına erişin.

1. Cihazınızın yerel kullanıcı arabiriminde Cihazlar sayfasına gidin.
2. Cihaz uç noktaları altında Kubernetes API'si hizmet uç noktasını kopyalayın. Bu uç nokta şu biçimdeki bir dizedir: https://compute..[device-IP-address] .
3. Uç nokta dizesini kaydedin. Bunu daha sonra kubectl Kubernetes kümesine erişecek şekilde yapılandırarak kullanacağız.

PowerShell arabirimine Bağlan

uzaktan, bir Windows istemcisinden bağlanın. Kubernetes kümesi oluşturulduktan sonra, bu küme aracılığıyla uygulamaları yönetebilirsiniz. Cihazın PowerShell arabirimine bağlanmanız gerekir. İstemci işletim sistemine bağlı olarak, cihaza uzaktan bağlanma yordamları farklı olabilir. aşağıdaki adımlar PowerShell çalıştıran Windows istemci içindir.

1. yönetici olarak bir Windows PowerShell oturumu çalıştırın.

   1. Windows Uzaktan Yönetimi hizmetinin istemciniz üzerinde çalıştığından emin olun. Komut istemine yazın winrm quickconfig .

2. Cihaz IP adresi için bir değişken atayın. Örneğin, $ip = "<device-ip-address>".

3. Cihazınızın IP adresini istemcinin güvenilen konaklar listesine eklemek için aşağıdaki komutu kullanın.

   Set-Item WSMan:\localhost\Client\TrustedHosts $ip -Concatenate -Force
   

4. cihazda Windows PowerShell oturumu başlatın.

   Enter-PSSession -ComputerName $ip -Credential $ip\EdgeUser -ConfigurationName Minishell
   

5. İstendiğinde parolayı girin. Yerel Web arabiriminde oturum açmak için kullanılan parolayı kullanın. Varsayılan yerel Web arabirimi parolası Password1 .

Kubernetes kümesine erişme

Kubernetes kümesi oluşturulduktan sonra, kubectl kümeye erişmek için komut satırı aracını kullanabilirsiniz.

1. Yeni bir ad alanı oluşturun.

   New-HcsKubernetesNamespace -Namespace
   

2. Bir kullanıcı oluşturun ve bir yapılandırma dosyası alın. Bu komut, Kubernetes kümesi için yapılandırma bilgilerini çıktısını alacak. Bu bilgileri kopyalayın ve config adlı bir dosyaya kaydedin. Dosyayı bir dosya uzantısı olarak kaydetmeyin.

   New-HcsKubernetesUser -UserName
   

3. Yapılandırma dosyasını yerel makinedeki kullanıcı profilinize . kuin klasörüne ekleyin.

4. Ad alanını oluşturduğunuz kullanıcıyla ilişkilendirin.

   Grant-HcsKubernetesNamespaceAccess -Namespace -UserName
   

5. kubectlaşağıdaki komutu kullanarak Windows istemcinizi yüklersiniz:

   curl https://storage.googleapis.com/kubernetesrelease/release/v1.15.2/bin/windows/amd64/kubectl.exe -O kubectl.exe
   

6. Sisteminizdeki Hosts dosyasına bir DNS girişi ekleyin.

   1. Not Defteri yönetici olarak çalıştırın ve konumunda bulunan hosts dosyasını açın C:\windows\system32\drivers\etc\hosts .
   2. Hosts dosyasında, yerel kullanıcı arabirimindeki cihaz sayfasından ALDıĞıNıZ cihaz IP adresı ve DNS etki alanı ile bir giriş oluşturun. Kullanmanız gereken uç nokta şuna benzer: https://compute.asedevice.microsoftdatabox.com/10.100.10.10 .

7. Kubernetes pods 'ye bağlanabildiğinizi doğrulayın.

   kubectl get pods -n "iotedge"
   

Kapsayıcı günlüklerini almak için aşağıdaki komutu çalıştırın:

kubectl logs <pod-name> -n <namespace> --all-containers

Faydalı komutlar

Uzamsal analiz için destek bileti dosyası oluşturma

Uzamsal analiz kapsayıcısına sahip olduğunuz bir soruna çözüm bulma konusunda daha fazla desteğe ihtiyacınız varsa, bir destek bileti almak ve göndermek için aşağıdaki adımları izleyin. Ekibimiz size ek rehberlik vererek sizi geri alacak.

Temel bilgileri doldurun

Yeni destek isteği sayfasında yeni bir destek bileti oluşturun. Aşağıdaki parametreleri doldurmanız için istemleri izleyin:

1. Sorun türünü olarak ayarlayın Technical .
2. Uzamsal analiz kapsayıcısını dağıtmak için kullandığınız aboneliği seçin.
3. My servicesHizmet olarak seçin ve seçin Cognitive Services .
4. Uzamsal analiz kapsayıcısını dağıtmak için kullandığınız kaynağı seçin.
5. Karşılaştığınız sorunun ayrıntılarını açıklayan kısa bir açıklama yazın.
6. Spatial AnalysisSorun türü olarak öğesini seçin.
7. Açılan listeden uygun alt türü seçin.
8. Ileri ' yi seçin: sonraki sayfada geçiş yapılacak çözümler .

Önerilen çözümler

Sonraki aşamada, seçtiğiniz sorun türü için önerilen çözümler sunulacaktır. Bu çözümler en sık karşılaşılan sorunları çözebilir, ancak çözümünüz için yararlı değilse, Ileri ' yi seçin. Ayrıntılar için sonraki adıma gidin.

Ayrıntılar

Bu sayfada, karşılaştığınız sorun hakkında bazı ek ayrıntılar ekleyin. Mühendisimizin sorunu daha iyi daraltabilmesini sağlamak için mümkün olduğunca fazla ayrıntı eklediğinizden emin olun. Size uygun iletişim kurabilmemiz için tercih ettiğiniz iletişim yöntemini ve sorunun önem derecesini ekleyin ve İleri ' yi seçin. sonraki adıma geçmek için bir sonraki adıma geçin.

Gözden geçir ve oluştur

Her şeyin doğru olduğundan emin olmak için destek isteğinizin ayrıntılarını gözden geçirin ve sorunu etkili bir şekilde temsil edin. Hazırsanız, bileti ekibimize göndermek için Oluştur ' u seçin! Bilet alındıktan sonra ekibimiz bir e-posta onayı alacaksınız ve takımımız en kısa sürede size geri dönmek için çalışacaktır. Azure portal biletinin durumunu görüntüleyebilirsiniz.

Sonraki adımlar

• Web uygulaması sayımını yapan bir kişi dağıtın
• Uzamsal analiz işlemlerini yapılandırma
• Kamera Yerleştirme Kılavuzu
• Bölge ve satır yerleştirme Kılavuzu