Telemetrie en probleemoplossing

Ruimtelijke analyse bevat een set functies voor het bewaken van de status van het systeem en hulp bij het diagnosticeren van problemen.

Visualisaties inschakelen

Als u een visualisatie van AI Insight-gebeurtenissen in een videoframe wilt inschakelen, moet u de versie van een ruimtelijke analysebewerking gebruiken op een .debug desktopcomputer of Azure-VM. De visualisatie is niet mogelijk op Azure Stack Edge apparaten. Er zijn vier foutopsporingsbewerkingen beschikbaar.

Als uw apparaat een lokale desktopcomputer of Azure GPU-VM is (met extern bureaublad ingeschakeld), kunt u overschakelen naar de versie van een bewerking en .debug de uitvoer visualiseren.

1. Open het bureaublad lokaal of met behulp van een extern bureaublad-client op de hostcomputer met Ruimtelijke analyse.

2. Voer in de terminal uit xhost +

3. Werk het implementatiemanifest onder de spaceanalytics module bij met de waarde van de DISPLAY omgevingsvariabele. U kunt de waarde ervan vinden door uit te echo $DISPLAY werken in de terminal op de hostcomputer.

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

4. Werk de grafiek bij in het implementatiemanifest dat u wilt uitvoeren in de foutopsporingsmodus. In het onderstaande voorbeeld werken we de operationId bij naar cognitiveservices.vision.spatialanalysis-personcrossingpolygon.debug. Er is een nieuwe parameter VISUALIZER_NODE_CONFIG vereist om het visualisatievenster in te kunnenschakelen. Alle bewerkingen zijn beschikbaar in de foutopsporingssmaak. Wanneer u gedeelde knooppunten gebruikt, gebruikt u de bewerking cognitiveservices.vision.spatialanalysis.debug en voegt u toe VISUALIZER_NODE_CONFIG aan de instantieparameters.

   "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. Als u opnieuw wilt gaan, ziet u het visualisatievenster op de hostcomputer

6. Nadat de implementatie is voltooid, moet u het bestand mogelijk van de hostcomputer naar de container kopiëren .Xauthority en opnieuw opstarten. In het onderstaande voorbeeld peopleanalytics is de naam van de container op de hostcomputer.

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

Systeemtoestand telemetrie verzamelen

Telegraf is een open source die werkt met ruimtelijke analyse en beschikbaar is in de Microsoft Container Registry. De volgende invoer wordt gebruikt en naar de Azure Monitor. De telegraf-module kan worden gebouwd met de gewenste aangepaste invoer en uitvoer. De configuratie van de telegraf-module in ruimtelijke analyse maakt deel uit van het implementatiemanifest (hierboven gekoppeld). Deze module is optioneel en kan worden verwijderd uit het manifest als u deze niet nodig hebt.

Invoer:

1. Metrische gegevens voor ruimtelijke analyse
2. Metrische schijfgegevens
3. Metrische CPU-gegevens
4. Metrische gegevens van Docker
5. Metrische GPU-gegevens

Uitvoer:

1. Azure Monitor

Met de meegeleverde ruimtelijke analyse-telegraf-module worden alle telemetriegegevens gepubliceerd die door de container ruimtelijke analyse zijn Azure Monitor. Zie de Azure Monitor voor meer informatie over het toevoegen Azure Monitor aan uw abonnement.

Nadat u de Azure Monitor, moet u referenties maken waarmee de module telemetrie kan verzenden. U kunt de Azure Portal om een nieuwe service-principal te maken of de onderstaande Azure CLI-opdracht gebruiken om er een te maken.

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

Zoek in het implementatiemanifest voor uw Azure Stack Edge-apparaat, desktopcomputer of Azure VMmet GPU naar de telegraf-module en vervang de volgende waarden door de service-principalgegevens uit de vorige stap en de implementatie opnieuw.

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

Zodra de telegraf-module is geïmplementeerd, zijn de gerapporteerde metrische gegevens toegankelijk via de Azure Monitor-service of door Bewaking te selecteren in de IoT Hub op de Azure Portal.

Systeem statusgebeurtenissen

Problemen met een IoT Edge oplossen

U kunt het iotedge opdrachtregelprogramma gebruiken om de status en logboeken van de modules die worden uitgevoerd te controleren. Bijvoorbeeld:

• iotedge list: Rapporteert een lijst met modules die worden uitgevoerd. U kunt verder controleren op fouten met iotedge logs edgeAgent . Als iotedge het vastloopt, kunt u proberen het opnieuw te starten met iotedge restart edgeAgent
• iotedge logs <module-name>
• iotedge restart <module-name> om een specifieke module opnieuw op te starten

Logboekbestanden verzamelen met de diagnostische container

Ruimtelijke analyse genereert docker-foutenlogboeken die u kunt gebruiken om runtimeproblemen vast te stellen of op te nemen in ondersteuningstickets. De diagnostische module ruimtelijke analyse is beschikbaar in de Microsoft Container Registry u kunt downloaden. Zoek in het manifestimplementatiebestand voor Azure Stack Edge apparaat, desktopcomputerof Azure VM met GPU naar de diagnostische module.

Voeg in de sectie env de volgende configuratie toe:

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

Als u logboeken wilt optimaliseren die zijn geüpload naar een extern eindpunt, zoals Azure Blob Storage, raden we u aan een kleine bestandsgrootte te onderhouden. Zie het onderstaande voorbeeld voor de aanbevolen configuratie van Docker-logboeken.

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

Het logboekniveau configureren

Met configuratie op logboekniveau kunt u de complexiteit van de gegenereerde logboeken bepalen. Ondersteunde logboekniveaus zijn: none , , , en verbose info warning error . Het standaard uitgebreide logboekniveau voor zowel knooppunten als platform is info .

Logboekniveaus kunnen globaal worden gewijzigd door de ARCHON_LOG_LEVEL omgevingsvariabele in te stellen op een van de toegestane waarden. Het kan ook worden ingesteld via het document IoT Edge Module Twin, voor alle geïmplementeerde vaardigheden of voor elke specifieke vaardigheid door de waarden voor en in te stellen, zoals hieronder platformLogLevel nodesLogLevel wordt weergegeven.

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

Logboeken verzamelen

Het voorbeeld van een distributiemanifestbestand voor uw Azure Stack Edge, desktopcomputerof Azure VM met GPU bevat een module met de naam die logboeken verzamelt diagnostics en uploadt. Deze module is standaard uitgeschakeld en moet worden ingeschakeld via de configuratie van IoT Edge module wanneer u logboeken moet openen.

De verzameling wordt op aanvraag uitgevoerd en beheerd via IoT Edge directe methode en kan logboeken verzenden naar diagnostics een Azure Blob-Storage.

Uploaddoelen voor diagnostische gegevens configureren

Selecteer in IoT Edge portal uw apparaat en vervolgens de diagnostische module. Zoek in het voorbeeldbestand Implementatiemanifest voor uw Azure Stack Edge-apparaat, desktopcomputersof Azure VM met GPU naar de sectie Omgevingsvariabelen voor diagnostische gegevens, met de naam , en voeg de env volgende informatie toe:

Een Upload configureren voor Azure Blob Storage

1. Maak uw eigen Azure Blob Storage account, als u dat nog niet hebt gedaan.
2. Haal de verbindingsreeks voor uw opslagaccount op uit Azure Portal. Deze bevindt zich in Toegangssleutels.
3. Logboeken voor ruimtelijke analyse worden automatisch geüpload naar een Blob Storage container met de naam rtcvlogs met de volgende bestandsnaamindeling: {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"
}

Logboeken voor ruimtelijke analyse uploaden

Logboeken worden op aanvraag geüpload met getRTCVLogs de IoT Edge in de diagnostics module.

1. Ga naar de IoT Hub portalpagina, selecteer Edge-apparaten en selecteer vervolgens uw apparaat en uw diagnostische module.
2. Ga naar de detailpagina van de module en klik op het tabblad Directe methode.
3. Typ getRTCVLogs bij Methodenaam en een tekenreeks in json-indeling in nettolading. U kunt {} invoeren. Dit is een lege nettolading.
4. Stel de time-outs voor de verbinding en methode in en klik op Methode aanroepen.
5. Selecteer uw doelcontainer en bouw een json-tekenreeks voor de nettolading met behulp van de parameters die worden beschreven in de sectie Syntaxis voor logboekregistratie. Klik op Methode aanroepen om de aanvraag uit te voeren.

Syntaxis voor logboekregistratie

De onderstaande tabel bevat de parameters die u kunt gebruiken bij het uitvoeren van query's op logboeken.

De volgende tabel bevat de kenmerken in het query-antwoord.

Voorbeeldaanvraag

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

Voorbeeld van een antwoord

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

Controleer de regels, tijden en grootten van het logboek ophalen. Als deze instellingen er goed uitzien, vervangt u DoPost naar en die de logboeken met dezelfde filters naar true bestemmingen pusht.

U kunt logboeken exporteren vanuit de Azure Blob-Storage bij het oplossen van problemen.

Problemen met het Azure Stack Edge oplossen

De volgende sectie is bedoeld voor hulp bij het debuggen en verifiëren van de status van Azure Stack Edge apparaat.

Toegang tot het Kubernetes API-eindpunt.

1. Ga in de lokale gebruikersinterface van uw apparaat naar de pagina Apparaten.
2. Kopieer onder Apparaat-eindpunten het service-eindpunt van de Kubernetes-API. Dit eindpunt is een tekenreeks met de volgende indeling: https://compute..[device-IP-address].
3. Sla de tekenreeks met het eindpunt op. U gebruikt deze later bij het configureren voor kubectl toegang tot het Kubernetes-cluster.

Verbinding maken powershell-interface

Maak op afstand verbinding vanaf een Windows client. Nadat het Kubernetes-cluster is gemaakt, kunt u de toepassingen beheren via dit cluster. U moet verbinding maken met de PowerShell-interface van het apparaat. Afhankelijk van het besturingssysteem van de client kunnen de procedures voor het extern verbinden met het apparaat verschillen. De volgende stappen zijn voor een Windows-client met PowerShell.

1. Voer een Windows PowerShell uit als beheerder.

   1. Zorg ervoor dat de Windows Remote Management-service wordt uitgevoerd op uw client. Typ bij de winrm quickconfig opdrachtprompt.

2. Wijs een variabele toe voor het IP-adres van het apparaat. Bijvoorbeeld $ip = "<device-ip-address>".

3. Gebruik de volgende opdracht om het IP-adres van uw apparaat toe te voegen aan de lijst met vertrouwde hosts van de client.

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

4. Start een Windows PowerShell op het apparaat.

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

5. Geef het wachtwoord op wanneer u hier om wordt gevraagd. Gebruik hetzelfde wachtwoord dat wordt gebruikt om u aan te melden bij de lokale webinterface. Het standaardwachtwoord voor de lokale webinterface is Password1 .

Toegang tot het Kubernetes-cluster

Nadat het Kubernetes-cluster is gemaakt, kunt u het kubectl opdrachtregelprogramma gebruiken om toegang te krijgen tot het cluster.

1. Maak een nieuwe naamruimte.

   New-HcsKubernetesNamespace -Namespace
   

2. Maak een gebruiker en haal een configuratiebestand op. Met deze opdracht worden configuratiegegevens voor het Kubernetes-cluster uitgevoerd. Kopieer deze informatie en sla deze op in een bestand met de naam config. Sla het bestand niet op als bestandsextensie.

   New-HcsKubernetesUser -UserName
   

3. Voeg het configuratiebestand toe aan de map .kube in uw gebruikersprofiel op de lokale computer.

4. Koppel de naamruimte aan de gebruiker die u hebt gemaakt.

   Grant-HcsKubernetesNamespaceAccess -Namespace -UserName
   

5. Installeer kubectl op uw Windows client met behulp van de volgende opdracht:

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

6. Voeg een DNS-vermelding toe aan het hosts-bestand op uw systeem.

   1. Voer Kladblok uit als beheerder en open het hosts-bestand dat zich bevindt op C:\windows\system32\drivers\etc\hosts .
   2. Maak een vermelding in het hosts-bestand met het IP-adres van het apparaat en het DNS-domein dat u hebt ontvangen van de pagina Apparaat in de lokale gebruikersinterface. Het eindpunt dat u moet gebruiken, ziet er ongeveer als het volgende uit: https://compute.asedevice.microsoftdatabox.com/10.100.10.10 .

7. Controleer of u verbinding kunt maken met de Kubernetes-pods.

   kubectl get pods -n "iotedge"
   

Voer de volgende opdracht uit om containerlogboeken op te halen:

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

Nuttige opdrachten

Een ondersteuningsticket indienen voor ruimtelijke analyse

Als u meer ondersteuning nodig hebt bij het vinden van een oplossing voor een probleem met de container voor ruimtelijke analyse, volgt u deze stappen om een ondersteuningsticket in te vullen en in te dienen. Ons team neemt contact met u op met aanvullende richtlijnen.

De basisbeginselen invullen

Maak een nieuw ondersteuningsticket op de pagina Nieuwe ondersteuningsaanvraag. Volg de aanwijzingen om de volgende parameters in te vullen:

1. Stel Probleemtype in op Technical .
2. Selecteer het abonnement dat u gebruikt om de ruimtelijke analysecontainer te implementeren.
3. Selecteer My services en selecteer als de Cognitive Services service.
4. Selecteer de resource die u gebruikt om de ruimtelijke analysecontainer te implementeren.
5. Schrijf een korte beschrijving van het probleem waarmee u te maken hebt.
6. Selecteer Spatial Analysis als uw probleemtype.
7. Selecteer het juiste subtype in de vervolgkeuzekeuze.
8. Selecteer Volgende: Oplossingen om door te gaan naar de volgende pagina.

Aanbevolen oplossingen

De volgende fase biedt aanbevolen oplossingen voor het probleemtype dat u hebt geselecteerd. Met deze oplossingen worden de meest voorkomende problemen opgelost, maar als dit niet nuttig is voor uw oplossing, selecteert u Volgende: Details om naar de volgende stap te gaan.

Details

Voeg op deze pagina aanvullende informatie toe over het probleem waarmee u te maken hebt. Zorg ervoor dat u zo veel mogelijk details op neemt, omdat dit onze technici helpt het probleem beter te beperken. Neem de gewenste contactmethode en de ernst van het probleem op, zodat we op de juiste wijze contact met u kunnen opnemen en selecteer Volgende: Beoordelen en maken om door te gaan naar de volgende stap.

Controleren en maken

Bekijk de details van uw ondersteuningsaanvraag om er zeker van te zijn dat alles klopt en het probleem effectief vertegenwoordigt. Wanneer u klaar bent, selecteert u Maken om het ticket naar ons team te verzenden. U ontvangt een e-mailbevestiging zodra uw ticket is ontvangen. Ons team zal er dan aan werken om zo snel mogelijk contact met u op te nemen. U kunt de status van uw ticket bekijken in de Azure Portal.

Volgende stappen

• Een webtoepassing voor het tellen van personen implementeren
• Bewerkingen voor ruimtelijke analyse configureren
• Handleiding voor cameraplaatsing
• Handleiding voor zone- en regelplaatsing