Configurare il profilo del flusso di dati

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 i 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, che determina il numero di istanze che eseguono i flussi di dati. 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

Per impostazione predefinita, viene creato un profilo del flusso di dati denominato "default" quando vengono distribuite le operazioni di Azure IoT. 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.

Attualmente, quando si usa il portale dell'esperienza operativa, il profilo del flusso di dati predefinito viene usato per tutti i flussi di dati.

Bicep

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
  }
}

Kubernetes (anteprima)

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.

Bicep

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

Kubernetes (anteprima)

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. 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:

Bicep

properties: {
  instanceCount: 3
}

Kubernetes (anteprima)

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 e l'intervallo delle 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

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

Kubernetes (anteprima)

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.