Hantera och övervaka IoT Central-program

Du kan använda Azure-portalen, Azure CLI eller Azure PowerShell för att hantera och övervaka IoT Central-program.

Om du föredrar att använda ett språk som JavaScript, Python, C#, Ruby eller Go för att skapa, uppdatera, lista och ta bort Azure IoT Central-program kan du läsa azure IoT Central ARM SDK-exempellagringsplatsen .

Information om hur du skapar ett IoT Central-program finns i Skapa ett IoT Central-program.

Visa program

Azure-portalen

Om du vill visa en lista över alla IoT Central-appar i din prenumeration går du till IoT Central-program.

Azure CLI

Använd kommandot az iot central app list för att visa dina IoT Central-program och visa metadata.

PowerShell

Använd cmdleten Get-AzIotCentralApp för att visa dina IoT Central-program och visa metadata.

Ta bort ett program

Azure-portalen

Om du vill ta bort ett IoT Central-program i Azure-portalen går du till översiktssidan för programmet i portalen och väljer Ta bort.

Azure CLI

Använd kommandot az iot central app delete för att ta bort ett IoT Central-program.

PowerShell

Använd cmdleten Remove-AzIotCentralApp för att ta bort ett IoT Central-program.

Hantera nätverk

Du kan använda privata IP-adresser från ett virtuellt nätverksadressutrymme när du hanterar dina enheter i IoT Central-programmet för att eliminera exponering på det offentliga Internet. Mer information finns i Skapa och konfigurera en privat slutpunkt för IoT Central.

Konfigurera en hanterad identitet

När du konfigurerar en dataexport i IoT Central-programmet kan du välja att konfigurera anslutningen till målet med en anslutningssträng eller en hanterad identitet. Hanterade identiteter är säkrare eftersom:

• Du lagrar inte autentiseringsuppgifterna för resursen i en anslutningssträng i IoT Central-programmet.
• Autentiseringsuppgifterna kopplas automatiskt till livslängden för ditt IoT Central-program.
• Hanterade identiteter roterar automatiskt sina säkerhetsnycklar regelbundet.

IoT Central använder för närvarande systemtilldelade hanterade identiteter. Om du vill skapa den hanterade identiteten för ditt program använder du antingen Azure-portalen eller REST-API:et.

När du konfigurerar en hanterad identitet innehåller konfigurationen ett omfång och en roll:

• Omfånget definierar var du kan använda den hanterade identiteten. Du kan till exempel använda en Azure-resursgrupp som omfång. I det här fallet måste både IoT Central-programmet och målet finnas i samma resursgrupp.
• Rollen definierar vilka behörigheter IoT Central-programmet beviljas i måltjänsten. För att ett IoT Central-program till exempel ska kunna skicka data till en händelsehubb behöver den hanterade identiteten rolltilldelningen Azure Event Hubs Data Sender .

Azure-portalen

Så här konfigurerar du den hanterade identitet som gör det möjligt för ditt IoT Central-program att på ett säkert sätt exportera data till din Azure-resurs:

1. Gå till ditt IoT Central-program i Azure-portalen.

   Dricks

   Som standard skapas IoT Central-program i IOTC-resursgruppen i din prenumeration.

2. Välj Identitet. På sidan Systemtilldelat ändrar du sedan statusen till På och väljer sedan Spara.

3. Efter några sekunder aktiveras den systemtilldelade hanterade identiteten för ditt IoT Central-program och du kan välja Azure-rolltilldelningar:

   

4. På sidan Azure-rolltilldelningar väljer du + Lägg till rolltilldelning.

Azure CLI

Du kan aktivera den hanterade identiteten när du skapar ett IoT Central-program:

# 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

Du kan också aktivera en hanterad identitet i ett befintligt IoT Central-program:

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

När du har aktiverat den hanterade identiteten kan du använda CLI för att konfigurera rolltilldelningarna.

Använd kommandot az role assignment create för att skapa en rolltilldelning. Följande kommandon hämtar till exempel först huvud-ID:t för den hanterade identiteten. Det andra kommandot tilldelar Azure Event Hubs Data Sender rollen till huvud-ID:t i resursgruppens MyIoTCentralResourceGroup omfång:

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

Du kan aktivera den hanterade identiteten när du skapar ett IoT Central-program:

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

Du kan också aktivera en hanterad identitet i ett befintligt IoT Central-program:

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

När du har aktiverat den hanterade identiteten kan du använda PowerShell för att konfigurera rolltilldelningarna.

Använd cmdleten New-AzRoleAssignment för att skapa en rolltilldelning. Följande kommandon hämtar till exempel först huvud-ID:t för den hanterade identiteten. Det andra kommandot tilldelar Azure Event Hubs Data Sender rollen till huvud-ID:t i resursgruppens MyIoTCentralResourceGroup omfång:

$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

Mer information om rolltilldelningarna finns i:

• Inbyggda roller för Azure Event Hubs
• Inbyggda roller för Azure Service Bus
• Inbyggda roller för Azure Storage Services

Övervaka programhälsa

Du kan använda den uppsättning mått som tillhandahålls av IoT Central för att utvärdera hälsotillståndet för enheter som är anslutna till ditt IoT Central-program och hälsotillståndet för dina dataexporter som körs.

Kommentar

IoT Central-program har också en intern granskningslogg för att spåra aktivitet i programmet.

Mått är aktiverade som standard för ditt IoT Central-program och du kommer åt dem från Azure-portalen. Azure Monitor-dataplattformen exponerar dessa mått och ger dig flera sätt att interagera med dem. Du kan till exempel använda diagram i Azure-portalen, ett REST-API eller frågor i PowerShell eller Azure CLI.

Rollbaserad åtkomstkontroll i Azure hanterar åtkomst till mått i Azure-portalen. Använd Azure-portalen för att lägga till användare i IoT Central-programmet/resursgruppen/prenumerationen för att ge dem åtkomst. Du måste lägga till en användare i portalen även om de redan har lagts till i IoT Central-programmet. Använd inbyggda Azure-roller för finare detaljerad åtkomstkontroll.

Visa mått i Azure-portalen

Följande exempel på sidan Mått visar ett diagram över antalet enheter som är anslutna till ditt IoT Central-program. En lista över de mått som för närvarande är tillgängliga för IoT Central finns i Mått som stöds med Azure Monitor.

Så här visar du IoT Central-mått i portalen:

1. Gå till din IoT Central-programresurs i portalen. Som standard finns IoT Central-resurser i en resursgrupp med namnet IOTC.
2. Om du vill skapa ett diagram från programmets mått väljer du Mått i avsnittet Övervakning .

Exportera loggar och mått

Använd sidan Diagnostikinställningar för att konfigurera export av mått och loggar till olika mål. Mer information finns i Diagnostikinställningar i Azure Monitor.

Analysera loggar och mått

Använd sidan Arbetsböcker för att analysera loggar och skapa visuella rapporter. Mer information finns i Azure-arbetsböcker.

Mått och fakturor

Mått kan skilja sig från de tal som visas på din Azure IoT Central-faktura. Den här situationen inträffar av orsaker som:

• Prisplaner för IoT Central-standard inkluderar två enheter och varierande meddelandekvoter kostnadsfritt. Även om de kostnadsfria objekten undantas från fakturering räknas de fortfarande i måtten.

• IoT Central skapar automatiskt ett testenhets-ID för varje enhetsmall i programmet. Det här enhets-ID:t visas på sidan Hantera testenhet för en enhetsmall. Du kan verifiera enhetsmallarna innan du publicerar dem genom att generera kod som använder dessa testenhets-ID:n. Även om dessa enheter undantas från fakturering räknas de fortfarande i måtten.

• Mått kan visa en delmängd av kommunikation från enhet till moln, men all kommunikation mellan enheten och molnet räknas som ett meddelande för fakturering.

Övervaka anslutna IoT Edge-enheter

Om ditt program använder IoT Edge-enheter kan du övervaka hälsotillståndet för dina IoT Edge-enheter och -moduler med hjälp av Azure Monitor. Mer information finns i Samla in och transportera Azure IoT Edge-mått.