Configurare il profilo del flusso di dati

I profili del flusso di dati possono essere usati per raggruppare i flussi di dati in modo da condividere la stessa configurazione. È possibile creare più profili di flusso di dati per gestire set di diverse configurazioni del flusso di dati.

L'impostazione più importante è il numero di istanze. Per un determinato flusso di dati, il numero di istanze determina il numero di copie eseguite nel cluster. Ad esempio, è possibile avere un profilo del flusso di dati con una singola istanza per lo sviluppo e il test, e un altro profilo con più istanze per la produzione. In alternativa, è possibile usare un profilo del flusso di dati con un numero ridotto di istanze per i flussi di dati a bassa velocità effettiva e un profilo con numero elevato di istanze per flussi di dati con velocità effettiva elevata. Analogamente, è possibile creare un profilo del flusso di dati con impostazioni di diagnostica diverse a scopo di debug.

È consigliabile evitare di associare troppi flussi di dati a un singolo profilo del flusso di dati. Se si dispone di un numero elevato di flussi di dati, creare più profili di flusso di dati per ridurre il rischio di superare il limite di dimensioni di configurazione del profilo del flusso di dati pari a 70.

Impostare le variabili di ambiente

Gli esempi interfaccia della riga di comando di Azure in questo articolo usano variabili di ambiente così puoi impostare ogni valore una volta e poi copiare e incollare i comandi as-is. Se stai usando l'ambiente Operazioni di Azure IoT Codespaces dal quickstart, queste variabili sono già impostate per te e puoi saltare questo passaggio. Altrimenti, imposta le seguenti variabili di ambiente nella tua shell prima di eseguire i comandi.

I seguenti script impostano le variabili di ambiente più comunemente utilizzate:

Variabile di ambiente	Description
`SUBSCRIPTION_ID`	L'ID dell'abbonamento che contiene la tua istanza Operazioni di Azure IoT.
`RESOURCE_GROUP`	Il nome del gruppo di risorse che contiene la tua istanza Operazioni di Azure IoT.
`AIO_INSTANCE_NAME`	Il nome della tua istanza Operazioni di Azure IoT. Per elencare le tue istanze, esegui `az iot ops list -o table`.
`CLUSTER_NAME`	Il nome del cluster Kubernetes abilitato Azure Arc che ospita la tua istanza.
`LOCATION`	La regione Azure da utilizzare per nuove risorse, ad esempio `eastus`.

Bash
PowerShell

SUBSCRIPTION_ID=<subscription-id>
RESOURCE_GROUP=<resource-group-name>
AIO_INSTANCE_NAME=<instance-name>
CLUSTER_NAME=<cluster-name>
LOCATION=<region>

$SUBSCRIPTION_ID = "<subscription-id>"
$RESOURCE_GROUP = "<resource-group-name>"
$AIO_INSTANCE_NAME = "<instance-name>"
$CLUSTER_NAME = "<cluster-name>"
$LOCATION = "<region>"

Devi solo impostare le variabili utilizzate in questo articolo. Questo articolo potrebbe utilizzare variabili ambientali aggiuntive per i nomi delle risorse che scegli. L'articolo spiega come posizionarli dove vengono introdotti.

Questo articolo utilizza anche le seguenti variabili di ambiente per i valori che scegli: PROFILE (il nome del profilo di flusso dati), INSTANCE_COUNT, e LOG_LEVEL. Imposta ognuno prima di eseguire i comandi correlati.

Profilo flusso di dati predefinito

Quando viene distribuito Operazioni di Azure IoT, viene creato un profilo di flusso di dati denominato predefinito . È possibile usare questo profilo del flusso di dati per iniziare a usare le operazioni di Azure IoT.

Per visualizzare il profilo del flusso di dati predefinito, passare all'istanza di Operazioni IoT nel portale di Azure.
Nel riquadro sinistro in Componenti selezionare Profili flusso di dati.
Selezionare il profilo del flusso di dati predefinito .

Usa il comando az iot ops dataflow profile show per visualizzare il profilo di flusso di dati predefinito:

az iot ops dataflow profile show --resource-group $RESOURCE_GROUP --instance $AIO_INSTANCE_NAME --name default

Ecco un comando di esempio per visualizzare il profilo predefinito del flusso dati:

az iot ops dataflow profile show --resource-group myResourceGroup --instance myAioInstance --name default

param aioInstanceName string = '<AIO_INSTANCE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'

// Pointer to the Azure IoT Operations instance
resource aioInstance 'Microsoft.IoTOperations/instances@2026-03-01' existing = {
  name: aioInstanceName
}

// Pointer to your custom location where Azure IoT Operations is deployed
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
  name: customLocationName
}

// Pointer to the default data flow profile
resource defaultDataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2026-03-01' = {
  parent: aioInstance
  name: 'default'
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    instanceCount: 1
  }
}

Importante

L'uso dei manifesti di distribuzione Kubernetes non è supportato negli ambienti di produzione e deve essere usato solo per il debug e il test.

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowProfile
metadata:
  name: default
  namespace: azure-iot-operations
spec:
  instanceCount: 1

A meno che non sia necessaria una maggiore velocità effettiva o ridondanza, è possibile usare il profilo del flusso di dati predefinito per i flussi di dati. Se è necessario modificare il numero di istanze o altre impostazioni, è possibile creare un nuovo profilo del flusso di dati.

Creare un nuovo profilo del flusso di dati

Per creare un nuovo profilo del flusso di dati, specificare il nome del profilo e il numero di istanze.

Importante

La lunghezza del nome del profilo dati deve essere compresa tra 1 e 39 caratteri.

Nel portale di Azure passare all'istanza di Operazioni IoT.
Nel riquadro sinistro in Componenti selezionare Profili flusso di dati.
Selezionare + Profilo flusso di dati per creare un nuovo profilo del flusso di dati.
Nel riquadro Crea profilo flusso di dati immettere un nome per il profilo del flusso di dati e impostare il numero di istanze. È anche possibile impostare altre impostazioni, ad esempio le impostazioni di diagnostica.

Usa il comando az iot ops dataflow profile create per creare un nuovo profilo di flusso di dati:

az iot ops dataflow profile create --resource-group $RESOURCE_GROUP --instance $AIO_INSTANCE_NAME --name $PROFILE

Ecco un comando di esempio per creare un nuovo profilo del flusso di dati denominato my-dataflow-profile:

az iot ops dataflow profile create --resource-group myResourceGroup --instance myAioInstance --name my-dataflow-profile

resource dataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2026-03-01' = {
  parent: aioInstance
  name: '<NAME>'
  properties: {
    instanceCount: <COUNT>
  }
}

Importante

L'uso dei manifesti di distribuzione Kubernetes non è supportato negli ambienti di produzione e deve essere usato solo per il debug e il test.

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowProfile
metadata:
  name: '<NAME>'
  namespace: azure-iot-operations
spec:
  instanceCount: <COUNT>

Scalabilità

È possibile ridimensionare il profilo del flusso di dati per modificare il numero di istanze che eseguono i flussi di dati. Per un determinato flusso di dati, il numero di istanze è il numero di copie eseguite nel cluster. L'aumento del numero di istanze può migliorare la velocità effettiva dei flussi di dati creando più client per elaborare i dati. Quando si usano flussi di dati con servizi cloud con limiti di frequenza per client, l'aumento del numero di istanze consente di rimanere entro i limiti di frequenza.

Il ridimensionamento può anche migliorare la resilienza dei flussi di dati fornendo ridondanza in caso di errori.

Importante

Le trasformazioni con stato mantengono uno stato separato in ogni istanza. Quando il numero di istanze è superiore a uno, le iscrizioni condivise distribuiscono i messaggi in arrivo tra le istanze e le istanze non condividono lo stato tra loro. Una trasformazione a finestra pertanto aggrega solo un sottoinsieme dei messaggi per ogni istanza e deve utilizzare un conteggio delle istanze pari a 1. Una trasformata dell'acceleratore impone indipendentemente la sua velocità configurata in ogni istanza. Usa un conteggio di istanze pari a 1 quando il limite di velocità di accelerazione deve applicarsi su tutti i messaggi nel grafico.

Per ridimensionare manualmente il profilo del flusso di dati, specificare il numero di istanze da eseguire. Ad esempio, per impostare il numero di istanze su 3:

Nel portale di Azure passare all'istanza di Operazioni IoT.
Nel riquadro sinistro in Componenti selezionare Profili flusso di dati.
Selezionare il profilo del flusso di dati da configurare.
Usare il dispositivo di scorrimento per impostare il numero di istanze.

Usa il comando az iot ops dataflow profile update per aggiornare il numero di istanze di un profilo di flusso di dati:

az iot ops dataflow profile update --resource-group $RESOURCE_GROUP --instance $AIO_INSTANCE_NAME --name $PROFILE --profile-instances $INSTANCE_COUNT

Ecco un comando di esempio per impostare il numero di istanze su tre per il profilo my-dataflow-profiledel flusso di dati:

az iot ops dataflow profile update --resource-group myResourceGroup --instance myAioInstance --name my-dataflow-profile --profile-instances 3

properties: {
  instanceCount: 3
}

Importante

L'uso dei manifesti di distribuzione Kubernetes non è supportato negli ambienti di produzione e deve essere usato solo per il debug e il test.

spec:
  instanceCount: 3

Impostazioni di diagnostica

È possibile configurare altre impostazioni di diagnostica per un profilo del flusso di dati, ad esempio il livello di log.

Nella maggior parte dei casi, le impostazioni predefinite sono sufficienti. Tuttavia, è possibile eseguire l'override del livello di log o di altre impostazioni per il debug.

Per informazioni su come configurare queste impostazioni di diagnostica, vedere ProfileDiagnostics.

Nel portale di Azure passare all'istanza di Operazioni IoT.
In Componenti selezionare Profili flusso di dati.
Selezionare il profilo del flusso di dati da configurare.

Usa il comando az iot ops dataflow profile update per aggiornare le impostazioni di diagnostica di un profilo di flusso di dati:

az iot ops dataflow profile update --resource-group $RESOURCE_GROUP --instance $AIO_INSTANCE_NAME --name $PROFILE --log-level $LOG_LEVEL

Ecco un comando di esempio che imposta il livello logaritmico a debug per il profilo my-dataflow-profiledel flusso dati :

az iot ops dataflow profile update --resource-group myResourceGroup --instance myAioInstance --name my-dataflow-profile --log-level debug

resource dataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2026-03-01' = {
  parent: aioInstance
  name: '<NAME>'
  properties: {
    instanceCount: 1
    diagnostics: {
      {
        logs: {
          level: 'debug'
        }
      }
    }
  }
}

Importante

L'uso dei manifesti di distribuzione Kubernetes non è supportato negli ambienti di produzione e deve essere usato solo per il debug e il test.

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowProfile
metadata:
  name: '<NAME>'
  namespace: azure-iot-operations
spec:
  instanceCount: 1
  diagnostics:
    logs:
      level: debug

Passaggi successivi

Per altre informazioni sui flussi di dati, vedere Creare un flusso di dati.

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-07-31

Configurare il profilo del flusso di dati

Impostare le variabili di ambiente

Profilo flusso di dati predefinito

Creare un nuovo profilo del flusso di dati

Scalabilità

Impostazioni di diagnostica

Passaggi successivi

Commenti e suggerimenti

Risorse aggiuntive