Configurare il profilo del flusso di dati

2025-06-22

Importante

Questa pagina include istruzioni per la gestione dei componenti di Operazioni IoT di Azure usando i manifesti di distribuzione kubernetes, disponibile in anteprima. Questa funzionalità viene fornita con diverse limitazioni e non deve essere usata per carichi di lavoro di produzione.

Vedere le condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure per termini legali aggiuntivi che si applicano a funzionalità di Azure in versione beta, in anteprima o in altro modo non ancora disponibili a livello generale.

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.

Profilo flusso di dati predefinito

Quando viene distribuito Azure IoT Operations, 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 .

Usare il comando az iot operations dataflow profile show per visualizzare il profilo del flusso di dati predefinito:

az iot operations dataflow profile show --resource-group <ResourceGroupName> --instance <AioInstanceName> --name default

Di seguito è riportato un comando di esempio per visualizzare il profilo del flusso di dati predefinito:

az iot operations 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@2024-11-01' existing = {
  name: aioInstanceName
}

// Pointer to your custom location where AIO 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@2024-11-01' = {
  parent: aioInstance
  name: 'default'
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    instanceCount: 1
  }
}

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.

Usare il comando az iot operations dataflow profile create per creare un nuovo profilo del flusso di dati:

az iot operations dataflow profile create --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <ProfileName>

Ecco un comando di esempio per creare un nuovo profilo del flusso di dati denominato myDataFlowProfile:

az iot operations dataflow profile create --resource-group myResourceGroup --instance myAioInstance --name myDataFlowProfile

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

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.

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.

Usare il comando az iot operations dataflow profile update per aggiornare il numero di istanze di un profilo del flusso di dati:

az iot operations dataflow profile update --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <ProfileName> --profile-instance <InstanceCount>

Ecco un comando di esempio per impostare il numero di istanze su tre per il profilo myDataFlowProfiledel flusso di dati:

az iot operations dataflow profile update --resource-group myResourceGroup --instance myAioInstance --name myDataFlowProfile --profile-instances 3

properties: {
  instanceCount: 3
}

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.

Usare il comando az iot operations dataflow profile update per aggiornare le impostazioni di diagnostica di un profilo del flusso di dati:

az iot operations dataflow profile update --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <ProfileName> --log-level <level>

Ecco un comando di esempio per impostare il livello di log su debug per il profilo myDataFlowProfiledel flusso di dati :

az iot operations dataflow profile update --resource-group myResourceGroup --instance myAioInstance --name myDataFlowProfile --log-level debug

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

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.

Condividi tramite