Configurar o perfil do fluxo de dados

Artigo
11/04/2024

Importante

A Versão Prévia das Operações da Internet das Coisas do Azure – habilitadas pelo Azure Arc – está atualmente em versão prévia. Você não deve usar esse software em versão prévia em ambientes de produção.

Você precisará implantar uma nova instalação das Operações da Internet das Coisas do Azure quando uma versão em disponibilidade geral for disponibilizada. Você não poderá atualizar uma instalação de versão prévia.

Veja os Termos de Uso Complementares para Versões Prévias do Microsoft Azure para obter 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 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, que determina o número de instâncias que executam os fluxos de dados. 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 baixa taxa de transferência 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 configurações de diagnóstico diferentes para fins de depuração.

Perfil de fluxo de dados padrão

Por padrão, um perfil de fluxo de dados chamado "padrão" é criado quando as Operações do Azure IoT são implantadas. Esse perfil de fluxo de dados tem uma única contagem de instâncias. Você pode usar esse perfil de fluxo de dados para começar a usar as Operações do 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 menos que você precise de taxa de transferência ou redundância adicional, você pode usar o perfil padrão de fluxo de dados para seus fluxos de dados. Se você precisar ajustar a contagem de instâncias ou outras configurações, poderá 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.

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>

Scaling

Você pode dimensionar o perfil de fluxo de dados para ajustar o número de instâncias que executam os fluxos de dados. Aumentar a contagem de instâncias pode melhorar a taxa de transferência dos fluxos de dados ao criar 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 ajudá-lo a permanecer dentro dos limites de taxa.

O dimensionamento também pode melhorar a resiliência dos fluxos de dados ao fornecer redundância em caso de falhas.

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

Bicep
Kubernetes

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

spec:
  instanceCount: 3

Importante

Atualmente em visualização pública, ajustar a contagem de instâncias pode resultar em perda de mensagens. Neste momento, é recomendável não ajustar a contagem de instâncias para um perfil com fluxos de dados ativos.

Configurações de Diagnóstico

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

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.

Por exemplo, para definir o nível de log para depuração:

Bicep
Kubernetes

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

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

Próximas etapas

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

Compartilhar via