Configuración del perfil de flujo de datos

2025-06-20

Importante

En esta página se incluyen instrucciones para administrar componentes de Azure IoT Operations mediante manifiestos de implementación de Kubernetes, que se encuentra en versión preliminar. Esta característica se proporciona con varias limitaciones y no debe usarse para cargas de trabajo de producción.

Consulte los Términos de uso complementarios de las versiones preliminares de Microsoft Azure para conocer los términos legales que se aplican a las características de Azure que se encuentran en versión beta, versión preliminar o, de lo contrario, aún no se han publicado en disponibilidad general.

Los perfiles de flujo de datos se pueden usar para agrupar flujos de datos para que compartan la misma configuración. Puede crear varios perfiles de flujo de datos para administrar conjuntos de distintas configuraciones de flujo de datos.

La configuración más importante es el recuento de instancias. Para un flujo de datos determinado, el recuento de instancias determina el número de copias que se ejecutan en el clúster. Por ejemplo, puede tener un perfil de flujo de datos con una sola instancia para desarrollo y pruebas, y otro perfil con varias instancias para producción. O bien, puede usar un perfil de flujo de datos con un recuento de instancias bajo para los flujos de datos de bajo rendimiento y un perfil con un recuento de instancias alto para los flujos de datos de alto rendimiento. Del mismo modo, puede crear un perfil de flujo de datos con diferentes opciones de diagnóstico con fines de depuración.

Debe evitar asociar demasiados flujos de datos con un único perfil de flujo de datos. Si tiene un gran número de flujos de datos, cree varios perfiles de flujo de datos para reducir el riesgo de superar el límite de tamaño de configuración del perfil de flujo de datos.

Perfil de flujo de datos predeterminado

Se crea un perfil de flujo de datos denominado predeterminado cuando se implementa Azure IoT Operations. Puede usar este perfil de flujo de datos para empezar a trabajar con Operaciones de IoT de Azure.

Para ver el perfil de flujo de datos predeterminado, vaya a la instancia de operaciones de IoT en Azure Portal.
En el panel izquierdo, en Componentes, seleccione Perfiles de flujo de datos.
Seleccione el perfil de flujo de datos predeterminado .

Use el comando az iot operations dataflow profile show para ver el perfil de flujo de datos predeterminado:

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

Este es el comando de ejemplo y para ver el perfil de flujo de datos predeterminado:

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 menos que necesite rendimiento o redundancia adicional, puede usar el perfil de flujo de datos predeterminado para los flujos de datos. Si necesita ajustar el recuento de instancias u otra configuración, puede crear un nuevo perfil de flujo de datos.

Creación de un nuevo perfil de flujo de datos

Para crear un nuevo perfil de flujo de datos, especifique el nombre del perfil y el recuento de instancias.

Importante

La longitud del nombre del perfil de datos debe tener entre 1 y 39 caracteres.

En Azure Portal, vaya a la instancia de operaciones de IoT.
En el panel izquierdo, en Componentes, seleccione Perfiles de flujo de datos.
Seleccione + Perfil de flujo de datos para crear un nuevo perfil de flujo de datos.
En el panel Crear perfil de flujo de datos , escriba un nombre para el perfil de flujo de datos y establezca el recuento de instancias. También puede establecer otras opciones, como la configuración de diagnóstico.

Use el comando az iot operations dataflow profile create para crear un nuevo perfil de flujo de datos:

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

Este es un comando de ejemplo para crear un nuevo perfil de flujo de datos denominado 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>

Ampliación

Puede escalar el perfil de flujo de datos para ajustar el número de instancias que ejecutan los flujos de datos. Para un flujo de datos determinado, el recuento de instancias es el número de copias que se ejecutan en el clúster. Aumentar el recuento de instancias puede mejorar el rendimiento de los flujos de datos mediante la creación de varios clientes para procesar los datos. Al usar flujos de datos con servicios en la nube que tienen límites de velocidad por cliente, aumentar el número de instancias puede ayudarle a mantenerse dentro de los límites de velocidad.

El escalado también puede mejorar la resistencia de los flujos de datos proporcionando redundancia en caso de errores.

Para escalar manualmente el perfil de flujo de datos, especifique el número de instancias que desea ejecutar. Por ejemplo, para establecer el recuento de instancias en 3:

En Azure Portal, vaya a la instancia de operaciones de IoT.
En el panel izquierdo, en Componentes, seleccione Perfiles de flujo de datos.
Seleccione el perfil de flujo de datos que desea configurar.
Use el control deslizante para establecer el recuento de instancias.

Use el comando az iot operations dataflow profile update para actualizar el recuento de instancias de un perfil de flujo de datos:

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

Este es un comando de ejemplo para establecer el recuento de instancias en tres para el perfil myDataFlowProfilede flujo de datos :

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

properties: {
  instanceCount: 3
}

spec:
  instanceCount: 3

Configuración de diagnóstico

Puede configurar otras opciones de diagnóstico para un perfil de flujo de datos, como el nivel de registro.

En la mayoría de los casos, la configuración predeterminada es suficiente. Sin embargo, puede invalidar el nivel de registro u otra configuración para la depuración.

Para obtener información sobre cómo configurar estas opciones de diagnóstico, consulte ProfileDiagnostics.

En Azure Portal, vaya a la instancia de operaciones de IoT.
En Componentes, seleccione Perfiles de flujo de datos.
Seleccione el perfil de flujo de datos que desea configurar.

Use el comando az iot operations dataflow profile update para actualizar la configuración de diagnóstico de un perfil de flujo de datos:

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

Este es un comando de ejemplo para establecer el nivel de registro en debug para el perfil de flujo de datos myDataFlowProfile:

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

Pasos siguientes

Para más información sobre los flujos de datos, consulte Creación de un flujo de datos.