IoT Central-toepassingen beheren en bewaken

U kunt Azure Portal, Azure CLI of Azure PowerShell gebruiken om IoT Central-toepassingen te beheren en te bewaken.

Als u liever een taal zoals JavaScript, Python, C#, Ruby of Go gebruikt om Azure IoT Central-toepassingen te maken, bij te werken, weer te geven en te verwijderen, raadpleegt u de opslagplaats met ARM SDK-voorbeelden van Azure IoT Central.

Zie Een IoT Central-toepassing maken voor meer informatie over het maken van een IoT Central-toepassing.

Toepassingen weergeven

Azure-portal

Als u alle IoT Central-apps in uw abonnement wilt weergeven, gaat u naar IoT Central-toepassingen.

Azure-CLI

Gebruik de opdracht az iot central app list om uw IoT Central-toepassingen weer te geven en metagegevens weer te geven.

Powershell

Gebruik de cmdlet Get-AzIotCentralApp om uw IoT Central-toepassingen weer te geven en metagegevens weer te geven.

Een toepassing verwijderen

Azure-portal

Als u een IoT Central-toepassing in Azure Portal wilt verwijderen, gaat u naar de pagina Overzicht van de toepassing in de portal en selecteert u Verwijderen.

Azure-CLI

Gebruik de opdracht az iot central app delete om een IoT Central-toepassing te verwijderen.

Powershell

Gebruik de cmdlet Remove-AzIotCentralApp om een IoT Central-toepassing te verwijderen.

Netwerken beheren

U kunt privé-IP-adressen uit een adresruimte van een virtueel netwerk gebruiken wanneer u uw apparaten beheert in de IoT Central-toepassing om blootstelling op het openbare internet te elimineren. Zie Een privé-eindpunt maken en configureren voor IoT Central voor meer informatie.

Een beheerde identiteit configureren

Wanneer u een gegevensexport in uw IoT Central-toepassing configureert, kunt u ervoor kiezen om de verbinding met de bestemming te configureren met een verbindingsreeks of een beheerde identiteit. Beheerde identiteiten zijn veiliger omdat:

• U slaat de referenties voor uw resource niet op in een verbindingsreeks in uw IoT Central-toepassing.
• De referenties worden automatisch gekoppeld aan de levensduur van uw IoT Central-toepassing.
• Beheerde identiteiten draaien hun beveiligingssleutels automatisch regelmatig.

IoT Central maakt momenteel gebruik van door het systeem toegewezen beheerde identiteiten. Als u de beheerde identiteit voor uw toepassing wilt maken, gebruikt u Azure Portal of de REST API.

Wanneer u een beheerde identiteit configureert, bevat de configuratie een bereik en een rol:

• Het bereik definieert waar u de beheerde identiteit kunt gebruiken. U kunt bijvoorbeeld een Azure-resourcegroep gebruiken als bereik. In dit geval moeten zowel de IoT Central-toepassing als de bestemming zich in dezelfde resourcegroep bevinden.
• De rol bepaalt welke machtigingen de IoT Central-toepassing wordt verleend in de doelservice. Voor een IoT Central-toepassing voor het verzenden van gegevens naar een Event Hub heeft de beheerde identiteit bijvoorbeeld de roltoewijzing Azure Event Hubs-gegevenszender nodig.

Azure-portal

De beheerde identiteit configureren waarmee uw IoT Central-toepassing veilig gegevens naar uw Azure-resource kan exporteren:

1. Navigeer in Azure Portal naar uw IoT Central-toepassing.

   Tip

   Standaard worden IoT Central-toepassingen gemaakt in de IOTC-resourcegroep in uw abonnement.

2. Selecteer Identiteit. Wijzig vervolgens op de pagina Toegewezen systeem de status in Aan en selecteer Opslaan.

3. Na enkele seconden is de door het systeem toegewezen beheerde identiteit voor uw IoT Central-toepassing ingeschakeld en kunt u Azure-roltoewijzingen selecteren:

   

4. Selecteer + Roltoewijzing toevoegen op de pagina Azure-roltoewijzingen.

Azure-CLI

U kunt de beheerde identiteit inschakelen wanneer u een IoT Central-toepassing maakt:

# Create an IoT Central application with a managed identity
az iot central app create \
  --resource-group "MyIoTCentralResourceGroup" \
  --name "myiotcentralapp" --subdomain "mysubdomain" \
  --sku ST1 --template "iotc-pnp-preview" \
  --display-name "My Custom Display Name" \
  --mi-system-assigned

U kunt ook een beheerde identiteit inschakelen voor een bestaande IoT Central-toepassing:

# Enable a system-assigned managed identity
az iot central app identity assign --name "myiotcentralapp" \
  --resource-group "MyIoTCentralResourceGroup" \
  --system-assigned

Nadat u de beheerde identiteit hebt ingeschakeld, kunt u de CLI gebruiken om de roltoewijzingen te configureren.

Gebruik de opdracht az role assignment create om een roltoewijzing te maken. Met de volgende opdrachten wordt bijvoorbeeld eerst de principal-id van de beheerde identiteit opgehaald. Met de tweede opdracht wordt de Azure Event Hubs Data Sender rol toegewezen aan de principal-id in het bereik van de MyIoTCentralResourceGroup resourcegroep:

scope=$(az group show -n "MyIoTCentralResourceGroup" --query "id" --output tsv)
spID=$(az iot central app identity show \
  --name "myiotcentralapp" \
  --resource-group "MyIoTCentralResourceGroup" \
  --query "principalId" --output tsv)
az role assignment create --assignee $spID --role "Azure Event Hubs Data Sender" \
  --scope $scope

Powershell

U kunt de beheerde identiteit inschakelen wanneer u een IoT Central-toepassing maakt:

# Create an IoT Central application with a managed identity
New-AzIotCentralApp -ResourceGroupName "MyIoTCentralResourceGroup" `
  -Name "myiotcentralapp" -Subdomain "mysubdomain" `
  -Sku "ST1" -Template "iotc-pnp-preview" `
  -DisplayName "My Custom Display Name" -Identity "SystemAssigned"

U kunt ook een beheerde identiteit inschakelen voor een bestaande IoT Central-toepassing:

# Enable a system-assigned managed identity
Set-AzIotCentralApp -ResourceGroupName "MyIoTCentralResourceGroup" `
  -Name "myiotcentralapp" -Identity "SystemAssigned"

Nadat u de beheerde identiteit hebt ingeschakeld, kunt u PowerShell gebruiken om de roltoewijzingen te configureren.

Gebruik de cmdlet New-AzRoleAssignment om een roltoewijzing te maken. Met de volgende opdrachten wordt bijvoorbeeld eerst de principal-id van de beheerde identiteit opgehaald. Met de tweede opdracht wordt de Azure Event Hubs Data Sender rol toegewezen aan de principal-id in het bereik van de MyIoTCentralResourceGroup resourcegroep:

$resourceGroup = Get-AzResourceGroup -Name "MyIoTCentralResourceGroup"
$app = Get-AzIotCentralApp -ResourceGroupName $resourceGroup.ResourceGroupName -Name "myiotcentralapp"
$sp = Get-AzADServicePrincipal -ObjectId $app.Identity.PrincipalId
New-AzRoleAssignment -RoleDefinitionName "Azure Event Hubs Data Sender" `
  -ObjectId $sp.Id -Scope $resourceGroup.ResourceId

Zie voor meer informatie over de roltoewijzingen:

• Ingebouwde rollen voor Azure Event Hubs
• Ingebouwde rollen voor Azure Service Bus
• Ingebouwde rollen voor Azure Storage Services

De status van de toepassing bewaken

U kunt de set metrische gegevens van IoT Central gebruiken om de status te beoordelen van apparaten die zijn verbonden met uw IoT Central-toepassing en de status van uw actieve gegevensexports.

Notitie

IoT Central-toepassingen hebben ook een intern auditlogboek om activiteiten binnen de toepassing bij te houden.

Metrische gegevens zijn standaard ingeschakeld voor uw IoT Central-toepassing en u opent deze vanuit Azure Portal. Het Azure Monitor-gegevensplatform toont deze metrische gegevens en biedt verschillende manieren om ermee te communiceren. U kunt bijvoorbeeld grafieken gebruiken in Azure Portal, een REST API of query's in PowerShell of de Azure CLI.

Op rollen gebaseerd toegangsbeheer van Azure beheert de toegang tot metrische gegevens in Azure Portal. Gebruik Azure Portal om gebruikers toe te voegen aan de IoT Central-toepassing/-resourcegroep/-abonnement om hen toegang te verlenen. U moet een gebruiker toevoegen in de portal, zelfs als deze al is toegevoegd aan de IoT Central-toepassing. Gebruik ingebouwde Azure-rollen voor nauwkeuriger toegangsbeheer.

Metrische gegevens weergeven in Azure Portal

Op de volgende voorbeeldpagina met metrische gegevens ziet u een plot van het aantal apparaten dat is verbonden met uw IoT Central-toepassing. Zie Ondersteunde metrische gegevens met Azure Monitor voor een lijst met metrische gegevens die momenteel beschikbaar zijn voor IoT Central.

Metrische ioT Central-gegevens weergeven in de portal:

1. Navigeer naar uw IoT Central-toepassingsresource in de portal. IoT Central-resources bevinden zich standaard in een resourcegroep met de naam IOTC.
2. Als u een grafiek wilt maken op basis van de metrische gegevens van uw toepassing, selecteert u Metrische gegevens in de sectie Bewaking .

Logboeken en metrische gegevens exporteren

Gebruik de pagina Diagnostische instellingen om het exporteren van metrische gegevens en logboeken naar verschillende bestemmingen te configureren. Zie Diagnostische instellingen in Azure Monitor voor meer informatie.

Logboeken en metrische gegevens analyseren

Gebruik de pagina Workbooks om logboeken te analyseren en visuele rapporten te maken. Zie Azure Workbooks voor meer informatie.

Metrische gegevens en facturen

Metrische gegevens kunnen verschillen van de getallen die worden weergegeven op uw Azure IoT Central-factuur. Deze situatie treedt op om redenen zoals:

• Standaardprijzen voor IoT Central omvatten twee apparaten en verschillende berichtquota gratis. Hoewel de gratis items worden uitgesloten van facturering, worden ze nog steeds meegeteld in de metrische gegevens.

• IoT Central registreert automatisch één testapparaat-id voor elke apparaatsjabloon in de toepassing. Deze apparaat-id is zichtbaar op de pagina Testapparaat beheren voor een apparaatsjabloon. U kunt uw apparaatsjablonen valideren voordat u ze publiceert door code te genereren die gebruikmaakt van deze testapparaat-id's. Hoewel deze apparaten worden uitgesloten van facturering, worden ze nog steeds meegeteld in de metrische gegevens.

• Hoewel metrische gegevens een subset van apparaat-naar-cloud-communicatie kunnen weergeven, telt alle communicatie tussen het apparaat en de cloud als een bericht voor facturering.

Verbonden IoT Edge-apparaten bewaken

Als uw toepassing Gebruikmaakt van IoT Edge-apparaten, kunt u de status van uw IoT Edge-apparaten en -modules bewaken met behulp van Azure Monitor. Zie Metrische gegevens van Azure IoT Edge verzamelen en transporteren voor meer informatie.