Configurare il profilo del flusso di dati

Articolo
11/07/2024

Importante

Anteprima di Operazioni di Azure IoT – Abilitata da Azure Arc è attualmente in anteprima. Non è consigliabile usare questo software di anteprima negli ambienti di produzione.

Sarà necessario distribuire una nuova installazione di Operazioni di Azure IoT quando sarà messa a disposizione una versione disponibile a livello generale. Non sarà possibile aggiornare un'installazione di anteprima.

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 configurazioni di flussi di dati diverse.

L'impostazione più importante è il numero di istanze, che determina il numero di istanze che eseguono i flussi di dati. Ad esempio, potrebbe essere disponibile un profilo di 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

Per impostazione predefinita, viene creato un profilo di flusso di dati denominato "default" quando viene distribuito Azure IoT Operations. Questo profilo del flusso di dati ha un solo numero di istanze. È possibile usare questo profilo del flusso di dati per iniziare a usare le operazioni di Azure IoT.

Bicep
Kubernetes

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-09-15-preview' 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 dataflow profile
resource defaultDataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2024-09-15-preview' = {
  parent: aioInstance
  name: 'default'
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    instanceCount: 1
  }
}

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

A meno che non sia necessaria una velocità effettiva o una ridondanza aggiuntive, è 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.

Bicep
Kubernetes

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

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

Scalabilità

È possibile ridimensionare il profilo del flusso di dati per regolare il numero di istanze che eseguono i flussi di dati. 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 dimensionare manualmente il profilo del flusso di dati, specificare il numero massimo di istanze da eseguire. Ad esempio, per impostare il numero di istanze su 3:

Bicep
Kubernetes

resource dataflowProfile 'Microsoft.IoTOperations/instances/dataflowProfiles@2024-09-15-preview' = {
  parent: aioInstance
  name: '<NAME>'
  properties: {
    instanceCount: 3
  }
}

spec:
  instanceCount: 3

Attenzione

Attualmente in anteprima pubblica, la modifica del numero di istanze può comportare la perdita o la duplicazione dei messaggi. In questo momento, è consigliabile non modificare il numero di istanze per un profilo con flussi di dati attivi.

Impostazioni di diagnostica

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

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.

Ad esempio, per impostare il livello di log su debug:

Bicep
Kubernetes

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

apiVersion: connectivity.iotoperations.azure.com/v1beta1
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