Configurar perfil de fluxo de dados

2025-06-30

Importante

Esta página inclui instruções para gerenciar componentes das Operações do Azure IoT usando manifestos de implantação do Kubernetes, que estão em versão prévia. Esse recurso é fornecido com várias limitações e não deve ser usado para cargas de trabalho de produção.

Confira os Termos de uso complementares para versões prévias do Microsoft Azure para obter os termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que, de outra forma, ainda não foram lançados em disponibilidade geral.

Os perfis de fluxo de dados podem ser usados para agrupar fluxos de dados para que eles compartilhem a mesma configuração. Você pode criar vários perfis de fluxo de dados para gerenciar conjuntos de diferentes configurações de fluxo de dados.

A configuração mais importante é a contagem de instâncias. Para um determinado fluxo de dados, a contagem de instâncias determina o número de cópias executadas em seu cluster. Por exemplo, você pode ter um perfil de fluxo de dados com uma única instância para desenvolvimento e teste, e outro perfil com várias instâncias para produção. Ou você pode usar um perfil de fluxo de dados com baixa contagem de instâncias para fluxos de dados de baixo rendimento e um perfil com alta contagem de instâncias para fluxos de dados de alta taxa de transferência. Da mesma forma, você pode criar um perfil de fluxo de dados com diferentes configurações de diagnóstico para fins de depuração.

Você deve evitar associar muitos fluxos de dados a um único perfil de fluxo de dados. Se você tiver um grande número de fluxos de dados, crie vários perfis de fluxo de dados para reduzir o risco de exceder o limite de tamanho de configuração do perfil de fluxo de dados.

Perfil de fluxo de dados padrão

Um perfil de fluxo de dados chamado padrão é criado quando as Operações de IoT do Azure são implantadas. Você pode usar esse perfil de fluxo de dados para começar a usar as Operações do Azure IoT.

Para exibir o perfil de fluxo de dados padrão, vá para a instância de Operações de IoT no portal do Azure.
No painel esquerdo em Componentes, selecione Perfis de fluxo de dados.
Selecione o perfil de fluxo de dados padrão .

Use o comando mostrar o perfil de fluxo de dados de operações az iot para exibir o perfil de fluxo de dados padrão:

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

Aqui está um exemplo de comando para exibir o perfil de fluxo de dados padrão:

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 você precise de taxa de transferência ou redundância adicionais, você pode usar o perfil de fluxo de dados padrão para seus fluxos de dados. Se precisar ajustar a contagem de instâncias ou outras configurações, você pode criar um novo perfil de fluxo de dados.

Criar um novo perfil de fluxo de dados

Para criar um novo perfil de fluxo de dados, especifique o nome do perfil e a contagem de instâncias.

Importante

O comprimento do nome do perfil de dados deve ter entre 1 e 39 caracteres.

No portal do Azure, navegue até a instância de Operações de IoT.
No painel esquerdo em Componentes, selecione Perfis de fluxo de dados.
Selecione + Perfil de fluxo de dados para criar um novo perfil de fluxo de dados.
No painel Criar perfil de fluxo de dados , insira um nome para o perfil de fluxo de dados e defina a contagem de instâncias. Você também pode definir outras configurações, como configurações de diagnóstico.

Use o comando az iot operations dataflow profile create para criar um novo perfil de fluxo de dados:

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

Aqui está um comando de exemplo para criar um novo perfil de fluxo de dados chamado 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>

Dimensionamento

Você pode dimensionar o perfil de fluxo de dados para ajustar o número de instâncias que executam os fluxos de dados. Para um determinado fluxo de dados, a contagem de instâncias é o número de cópias executadas em seu cluster. Aumentar a contagem de instâncias pode melhorar a taxa de transferência dos fluxos de dados criando vários clientes para processar os dados. Ao usar fluxos de dados com serviços de nuvem que têm limites de taxa por cliente, aumentar a contagem de instâncias pode ajudar você a permanecer dentro dos limites de taxa.

A escala também pode melhorar a resiliência dos fluxos de dados, fornecendo redundância em caso de falhas.

Para dimensionar manualmente o perfil de fluxo de dados, especifique o número de instâncias que deseja executar. Por exemplo, para definir a contagem de instâncias como 3:

No portal do Azure, navegue até a instância de Operações de IoT.
No painel esquerdo em Componentes, selecione Perfis de fluxo de dados.
Selecione o perfil de fluxo de dados que você deseja configurar.
Use o controle deslizante para definir a contagem de instâncias.

Use o comando az iot operations dataflow update para atualizar a contagem de instâncias de um perfil de fluxo de dados:

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

Este é um comando de exemplo para definir a contagem de instâncias como três para o perfil myDataFlowProfilede fluxo de dados:

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

properties: {
  instanceCount: 3
}

spec:
  instanceCount: 3

Configurações de diagnóstico

Você pode definir outras configurações de diagnóstico para um perfil de fluxo de dados, como o nível de log.

Na maioria dos casos, as configurações padrão são suficientes. No entanto, você pode substituir o nível de log ou outras configurações para depuração.

Para saber como definir essas configurações de diagnóstico, consulte ProfileDiagnostics.

No portal do Azure, navegue até a instância de Operações de IoT.
Em Componentes, selecione Perfis de fluxo de dados.
Selecione o perfil de fluxo de dados que você deseja configurar.

Use o comando az iot operations dataflow update para atualizar as configurações de diagnóstico de um perfil de fluxo de dados:

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

Aqui está um comando de exemplo para definir o nível de log como debug para o perfil de fluxo de dados 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

Próximas etapas

Para saber mais sobre fluxos de dados, consulte Criar um fluxo de dados.