Telemetri och felsökning

Rumslig analys innehåller en uppsättning funktioner för att övervaka systemets hälsotillstånd och hjälpa till med diagnostiseringsproblem.

Aktivera visualiseringar

Om du vill aktivera en visualisering av AI Insight-händelser i en videoram måste du använda versionen av en spatial analysåtgärd på en stationär dator .debug eller virtuell Azure-dator. Visualiseringen är inte möjlig på Azure Stack Edge enheter. Det finns fyra tillgängliga felsökningsåtgärder.

Om enheten är en lokal dator eller virtuell Azure GPU-dator (med fjärrskrivbord aktiverat) kan du växla till version av valfri åtgärd .debug och visualisera utdata.

1. Öppna skrivbordet antingen lokalt eller med hjälp av en fjärrskrivbordsklient på värddatorn som kör Spatial Analysis.

2. I terminalkörningen xhost +

3. Uppdatera distributionsmanifestet spaceanalytics under modulen med värdet för DISPLAY miljövariabeln. Du hittar dess värde genom att echo $DISPLAY köra i terminalen på värddatorn.

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

4. Uppdatera diagrammet i distributionsmanifestet som du vill köra i felsökningsläge. I exemplet nedan uppdaterar vi operationId till cognitiveservices.vision.spatialanalysis-personcrossingpolygon.debug. En ny parameter VISUALIZER_NODE_CONFIG krävs för att aktivera visualiseringsfönstret. Alla åtgärder är tillgängliga i felsöknings smak. När du använder delade noder använder du åtgärden cognitiveservices.vision.spatialanalysis.debug och lägger VISUALIZER_NODE_CONFIG till i instansparametrarna.

   "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. Omdistribuera visas visualiserarfönstret på värddatorn

6. När distributionen är klar kan du behöva kopiera filen .Xauthority från värddatorn till containern och starta om den. I exemplet nedan peopleanalytics är namnet på containern på värddatorn.

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

Samla in telemetri om systemhälsa

Telegraf är en bild med öppen källkod som fungerar med rumslig analys och är tillgänglig i Microsoft Container Registry. Den tar följande indata och skickar dem till Azure Monitor. Telegraf-modulen kan byggas med önskade anpassade indata och utdata. Telegraf-modulkonfigurationen i Spatial Analysis är en del av distributionsmanifestet (länkat ovan). Den här modulen är valfri och kan tas bort från manifestet om du inte behöver den.

Ingångar:

1. Mått för rumslig analys
2. Diskmått
3. CPU-mått
4. Docker-mått
5. GPU-mått

Utgångar:

1. Azure Monitor

Den angivna telegraf-modulen för rumslig analys publicerar alla telemetridata som skickas av containern för rumslig analys till Azure Monitor. Se Azure Monitor information om hur du lägger Azure Monitor till din prenumeration.

När du Azure Monitor måste du skapa autentiseringsuppgifter som gör att modulen kan skicka telemetri. Du kan använda Azure Portal för att skapa ett nytt huvudnamn för tjänsten eller använda Azure CLI-kommandot nedan för att skapa ett.

# 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>"

I distributionsmanifestet för din Azure Stack Edge-enhet, stationär dator eller virtuell Azure-datormed GPU letar du upp telegraf-modulen och ersätter följande värden med informationen om tjänstens huvudnamn från föregående steg och distribuerar om.

"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}"
    },
...

När telegraf-modulen har distribuerats kan de rapporterade måtten nås antingen via Azure Monitor-tjänsten eller genom att välja Övervakning i IoT Hub på Azure Portal.

Systemhälsohändelser

Felsöka en IoT Edge enhet

Du kan använda iotedge kommandoradsverktyget för att kontrollera status och loggar för de moduler som körs. Exempel:

• iotedge list: Rapporterar en lista över moduler som körs. Du kan ytterligare söka efter fel med iotedge logs edgeAgent . Om iotedge fastnar kan du prova att starta om den med iotedge restart edgeAgent
• iotedge logs <module-name>
• iotedge restart <module-name> för att starta om en specifik modul

Samla in loggfiler med diagnostikcontainern

Rumslig analys genererar Docker-felsökningsloggar som du kan använda för att diagnostisera körningsproblem eller inkludera dem i supportärenden. Modulen Diagnostik för rumslig analys finns i Microsoft Container Registry som du kan ladda ned. Leta upp diagnostikmodulen i manifestdistributionsfilen förAzure Stack Edge enhet,stationär dator eller virtuell Azure-dator med GPU.

I avsnittet "env" lägger du till följande konfiguration:

"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\"}}}}"
  }

Om du vill optimera loggar som laddats upp till en fjärrslutpunkt, till exempel Azure Blob Storage, rekommenderar vi att du behåller en liten filstorlek. Se exemplet nedan för den rekommenderade konfigurationen av Docker-loggar.

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

Konfigurera loggnivån

Med loggnivåkonfigurationen kan du styra hur utförliga de genererade loggarna är. Loggnivåer som stöds är: none , , , och verbose info warning error . Standardloggens utförliga nivå för både noder och plattform är info .

Loggnivåer kan ändras globalt genom att ange ARCHON_LOG_LEVEL miljövariabeln till något av de tillåtna värdena. Det kan också anges via dokumentet IoT Edge-modultvilling antingen globalt, för alla distribuerade färdigheter eller för varje specifik kunskap genom att ange värdena för och platformLogLevel nodesLogLevel enligt nedan.

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

Samla in loggar

Exempeldistributionsmanifestfilen för din Azure Stack Edge,stationär dator eller virtuell Azure-dator med GPU innehåller en modul med namnet som samlar in och laddar upp diagnostics loggar. Den här modulen är inaktiverad som standard och bör aktiveras via IoT Edge-modulkonfigurationen när du behöver åtkomst till loggar.

Samlingen är på begäran och styrs via en IoT Edge direktmetod och kan skicka loggar till diagnostics en Azure Blob Storage.

Konfigurera mål för uppladdning av diagnostik

Från IoT Edge portalen väljer du din enhet och sedan diagnostikmodulen. I exemplet på distributionsmanifestfil för din Azure Stack Edge enhet,stationära datorer eller virtuella Azure-datorer med GPU letar du efter avsnittet Miljövariabler för diagnostik med namnet och lägger till följande env information:

Konfigurera Upload till Azure Blob Storage

1. Skapa ett eget Azure Blob Storage-konto, om du inte redan har gjort det.
2. Hämta anslutningssträngen för ditt lagringskonto från Azure Portal. Den finns i Åtkomstnycklar.
3. Loggar för rumslig analys laddas automatiskt upp till en Blob Storage-container med namnet rtcvlogs med följande filnamnsformat: {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"
}

Ladda upp loggar för rumslig analys

Loggar laddas upp på begäran med getRTCVLogs IoT Edge-metoden i diagnostics modulen.

1. Gå till IoT Hub portalsida, välj Edge-enheter och välj sedan din enhet och diagnostikmodulen.
2. Gå till informationssidan för modulen och klicka på fliken Direktmetod.
3. Skriv getRTCVLogs på Metodnamn och en json-formatsträng i nyttolasten. Du kan ange {} , som är en tom nyttolast.
4. Ange tidsgränser för anslutningar och metoder och klicka på Anropa metod.
5. Välj målcontainern och skapa en json-sträng för nyttolasten med hjälp av parametrarna som beskrivs i avsnittet Loggningssyntax. Klicka på Anropa metod för att utföra begäran.

Loggningssyntax

I tabellen nedan visas de parametrar som du kan använda när du frågar loggar.

I följande tabell visas attributen i frågesvaret.

Exempelbegäran

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

Exempelsvar

{
    "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
        }
    }
}

Kontrollera hämtningsloggens rader, tider och storlekar. Om de inställningarna ser bra ut ersätter du DoPost till så push-hämtas loggarna med samma true filter till mål.

Du kan exportera loggar från Azure Blob-Storage när du felsöker problem.

Felsöka Azure Stack Edge enhet

Följande avsnitt innehåller hjälp med felsökning och verifiering av statusen för din Azure Stack Edge enhet.

Åtkomst till Kubernetes API-slutpunkten.

1. I enhetens lokala användargränssnitt går du till sidan Enheter.
2. Under Enhetsslutpunkter kopierar du Kubernetes API-tjänstslutpunkten. Den här slutpunkten är en sträng i följande format: https://compute..[device-IP-address] .
3. Spara slutpunktssträngen. Du kommer att använda detta senare när du kubectl konfigurerar för åtkomst till Kubernetes-klustret.

Anslut till PowerShell-gränssnitt

Fjärranslut från en Windows klient. När Kubernetes-klustret har skapats kan du hantera programmen via det här klustret. Du måste ansluta till Enhetens PowerShell-gränssnitt. Beroende på klientoperativsystemet kan procedurerna för att fjärransluta till enheten vara olika. Följande steg gäller för en Windows som kör PowerShell.

1. Kör en Windows PowerShell-session som administratör.

   1. Kontrollera att Windows Remote Management-tjänsten körs på klienten. Skriv i winrm quickconfig kommandotolken.

2. Tilldela en variabel för enhetens IP-adress. Till exempel $ip = "<device-ip-address>".

3. Använd följande kommando för att lägga till IP-adressen för enheten i klientens lista över betrodda värdar.

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

4. Starta en Windows PowerShell-session på enheten.

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

5. Ange lösenordet när du uppmanas att göra det. Använd samma lösenord som används för att logga in på det lokala webbgränssnittet. Standardlösenordet för det lokala webbgränssnittet är Password1 .

Åtkomst till Kubernetes-klustret

När Kubernetes-klustret har skapats kan du använda kubectl kommandoradsverktyget för att komma åt klustret.

1. Skapa ett nytt namnområde.

   New-HcsKubernetesNamespace -Namespace
   

2. Skapa en användare och hämta en konfigurationsfil. Det här kommandot matar ut konfigurationsinformation för Kubernetes-klustret. Kopiera den här informationen och spara den i en fil med namnet config. Spara inte filen med ett filnamnstillägg.

   New-HcsKubernetesUser -UserName
   

3. Lägg till konfigurationsfilen i .kube-mappen i din användarprofil på den lokala datorn.

4. Associera namnområdet med den användare som du skapade.

   Grant-HcsKubernetesNamespaceAccess -Namespace -UserName
   

5. Installera kubectl på Windows-klienten med följande kommando:

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

6. Lägg till en DNS-post i värdfilen på datorn.

   1. Kör Anteckningar administratör och öppna värdfilen som finns på C:\windows\system32\drivers\etc\hosts .
   2. Skapa en post i värdfilen med enhetens IP-adress och DNS-domän som du fick från sidan Enhet i det lokala användargränssnittet. Den slutpunkt som du bör använda ser ut ungefär så här: https://compute.asedevice.microsoftdatabox.com/10.100.10.10 .

7. Kontrollera att du kan ansluta till Kubernetes-poddarna.

   kubectl get pods -n "iotedge"
   

Kör följande kommando för att hämta containerloggar:

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

Användbara kommandon

Så här gör du för att skapa en supportbiljett för rumslig analys

Om du behöver mer support för att hitta en lösning på ett problem som du har med containern Spatial Analysis följer du dessa steg för att fylla i och skicka en supportbiljett. Vårt team kommer att gå tillbaka till dig med ytterligare vägledning.

Fyll i grunderna

Skapa en ny supportbegäran på sidan Ny supportbegäran. Följ anvisningarna för att fylla i följande parametrar:

1. Ange Problemtyp till Technical .
2. Välj den prenumeration som du använder för att distribuera containern spatial analys.
3. Välj My services och välj som Cognitive Services tjänst.
4. Välj den resurs som du använder för att distribuera containern spatial analys.
5. Skriv en kort beskrivning som beskriver problemet.
6. Välj Spatial Analysis som problemtyp.
7. Välj lämplig undertyp i listrutan.
8. Välj Nästa: Lösningar för att gå vidare till nästa sida.

Rekommenderade lösningar

Nästa steg erbjuder rekommenderade lösningar för den problemtyp som du har valt. Dessa lösningar löser de vanligaste problemen, men om det inte är användbart för din lösning väljer du Nästa: Information för att gå till nästa steg.

Information

På den här sidan lägger du till ytterligare information om det problem som du har haft. Var noga med att ta med så mycket information som möjligt, eftersom det hjälper våra tekniker att bättre begränsa problemet. Ta med din önskade kontaktmetod och problemets allvarlighetsgrad så att vi kan kontakta dig på rätt sätt och välj Nästa: Granska + skapa för att gå vidare till nästa steg.

Granska och skapa

Granska informationen i din supportbegäran för att se till att allt är korrekt och representerar problemet effektivt. När du är klar väljer du Skapa för att skicka biljetten till vårt team! Du får en e-postbekräftelse när din biljett har tagits emot och vårt team kommer att arbeta för att komma tillbaka till dig så snart som möjligt. Du kan visa status för din biljett i Azure Portal.

Nästa steg

• Distribuera en webbapp för att räkna personer
• Konfigurera åtgärder för rumslig analys
• Guide för kameraplacering
• Guide för zon- och radplacering