Gerencie configurações de ativos remotamente

Importante

Azure IoT Operations Preview – habilitado pelo Azure Arc está atualmente em visualização. Não deve utilizar este software de pré-visualização em ambientes de produção.

Veja Termos de Utilização Complementares da Pré-visualizações do Microsoft Azure para obter os termos legais que se aplicam às funcionalidades do Azure que estão na versão beta, na pré-visualização ou que ainda não foram lançadas para disponibilidade geral.

Um ativo no Azure IoT Operations Preview é uma entidade lógica que você cria para representar um ativo real. Um ativo de Operações IoT do Azure pode ter propriedades, marcas e eventos que descrevem seu comportamento e características.

Os servidores OPC UA são aplicações de software que comunicam com ativos. Os servidores OPC UA expõem tags OPC UA que representam pontos de dados. As tags OPC UA fornecem dados históricos ou em tempo real sobre o status, desempenho, qualidade ou condição dos ativos.

Um ponto de extremidade de ativo é um recurso personalizado em seu cluster Kubernetes que conecta servidores OPC UA a módulos de conector OPC UA. Essa conexão permite que um conector OPC UA acesse os pontos de dados de um ativo. Sem um ponto de extremidade de ativo, os dados não podem fluir de um servidor OPC UA para a instância do Azure IoT OPC UA Broker Preview e a instância do Azure IoT MQ Preview. Depois de configurar os recursos personalizados em seu cluster, uma conexão é estabelecida com o servidor OPC UA downstream e o servidor encaminha a telemetria para a instância do OPC UA Broker.

Um site é um conjunto de instâncias de Operações do Azure IoT. Os sites ajudam você a organizar suas instâncias e gerenciar o controle de acesso. O administrador de TI cria sites, atribui instâncias a eles e concede acesso a usuários de OT em sua organização.

No portal de Operações IoT do Azure (visualização), uma instância representa um cluster de Operações do Azure IoT. Uma instância pode ter um ou mais pontos de extremidade de ativos.

Este artigo descreve como usar o portal de Operações IoT do Azure (visualização) e a CLI do Azure para:

• Definir pontos de extremidade de ativos
• Adicionar ativos e definir tags e eventos

Esses ativos, tags e eventos mapeiam dados de entrada de servidores OPC UA para nomes amigáveis que você pode usar no agente MQ e nos pipelines do Azure IoT Data Processor Preview.

Pré-requisitos

Para configurar um ponto de extremidade de ativos, você precisa de uma instância em execução das Operações do Azure IoT.

Iniciar sessão

Portal de Operações IoT do Azure

Para entrar no portal de Operações do Azure IoT (visualização), navegue até o portal de Operações do Azure IoT (visualização) em seu navegador e entre usando suas credenciais de ID do Microsoft Entra.

Selecione o seu site

Depois de iniciar sessão, o portal apresenta uma lista de sites aos quais tem acesso. Cada site é um conjunto de instâncias do Azure IoT Operations onde você pode configurar seus ativos. O administrador de TI é responsável por organizar instâncias em sites e conceder acesso a usuários de OT em sua organização. As instâncias que não fazem parte de um site aparecem no nó Instâncias não atribuídas. Selecione o site que deseja usar:

Gorjeta

Você pode usar a caixa de filtro para pesquisar sites.

Se você não vir nenhum site, talvez não esteja no locatário correto do Azure Ative Directory. Você pode alterar o locatário no menu superior direito do portal. Se você ainda não vir nenhum site, isso significa que você ainda não foi adicionado a nenhum. Entre em contato com o administrador de TI para solicitar acesso.

Selecione sua instância

Depois de selecionar um site, o portal exibe uma lista das instâncias do Azure IoT Operations que fazem parte do site. Selecione a instância que você deseja usar:

Gorjeta

Você pode usar a caixa de filtro para pesquisar instâncias.

CLI do Azure

Antes de usar os az iot ops asset comandos, entre na assinatura que contém sua implantação do Azure IoT Operations:

az login

Criar um ponto de extremidade de ativo

Por padrão, uma implantação do Azure IoT Operations inclui um simulador de PLC OPC integrado. Para criar um ponto de extremidade de ativo que usa o simulador de PLC OPC integrado:

Portal de Operações IoT do Azure

1. Selecione Pontos de extremidade de ativos e, em seguida, Criar ponto de extremidade de ativos:

   

   Gorjeta

   Você pode usar a caixa de filtro para pesquisar pontos de extremidade de ativos.

2. Insira as seguintes informações do ponto final:

   Campo	Valor
   Nome	opc-ua-connector-0
   OPC UA Broker URL	opc.tcp://opcplc-000000:50000
   Autenticação do utilizador	Anonymous
   Autenticação de transporte	Do not use transport authentication certificate

3. Para salvar a definição, selecione Criar.

CLI do Azure

Execute o seguinte comando:

az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} 

Gorjeta

Use az connectedk8s list para listar os clusters aos quais você tem acesso.

Para saber mais, consulte az iot ops asset endpoint.

Essa configuração implanta um novo assetendpointprofile recurso chamado opc-ua-connector-0 para o cluster. Depois de definir um ativo, um pod de conector OPC UA o descobre. O pod usa o ponto de extremidade de ativo especificado na definição de ativo para se conectar a um servidor OPC UA.

Quando o simulador OPC PLC está em execução, os dados fluem do simulador para o conector, para o broker OPC UA e, finalmente, para o broker MQ.

Configurar um ponto de extremidade de ativo para usar um nome de usuário e senha

O exemplo anterior usa o modo de Anonymous autenticação. Este modo não requer um nome de utilizador ou palavra-passe.

Portal de Operações IoT do Azure

Para usar o UsernamePassword modo de autenticação, conclua as seguintes etapas:

1. Siga as etapas em Configurar autenticação de usuário OPC UA com nome de usuário e senha para adicionar segredos para nome de usuário e senha no Cofre de Chaves do Azure e projetá-los no cluster Kubernetes.
2. No portal Azure IoT Operations (visualização), selecione Nome de usuário e senha para o campo Autenticação de usuário para configurar o ponto de extremidade do ativo para usar esses segredos. Em seguida, insira os seguintes valores para os campos Referência de nome de usuário e Referência de senha:

Campo	Value
Referência de nome de utilizador	aio-opc-ua-broker-user-authentication/username
Referência de palavra-passe	aio-opc-ua-broker-user-authentication/password

CLI do Azure

Para usar o UsernamePassword modo de autenticação, conclua as seguintes etapas:

1. Siga as etapas em Configurar autenticação de usuário OPC UA com nome de usuário e senha para adicionar segredos para nome de usuário e senha no Cofre de Chaves do Azure e projetá-los no cluster Kubernetes.

2. Use um comando como o exemplo a seguir para criar seu ponto de extremidade de ativo:

   az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} --username-ref "aio-opc-ua-broker-user-authentication/username" --password-ref "aio-opc-ua-broker-user-authentication/password"
   

Configurar um ponto de extremidade de ativo para usar um certificado de autenticação de transporte

Para configurar o ponto de extremidade do ativo para usar um certificado de autenticação de transporte, conclua as seguintes etapas:

Portal de Operações IoT do Azure

1. Siga as etapas em configurar a confiança mútua para adicionar um certificado de transporte e uma chave privada ao Cofre de Chaves do Azure e projete-os no cluster do Kubernetes.
2. No portal Azure IoT Operations (visualização), selecione Usar certificado de autenticação de transporte para o campo Autenticação de transporte e insira a impressão digital do certificado.

CLI do Azure

1. Siga as etapas em configurar a confiança mútua para adicionar um certificado de transporte e uma chave privada ao Cofre de Chaves do Azure e projete-os no cluster do Kubernetes.

2. Use um comando como o exemplo a seguir para criar seu ponto de extremidade de ativo:

   az iot ops asset endpoint create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --cluster {your cluster name} --username-ref "aio-opc-ua-broker-user-authentication/username" --password-ref "aio-opc-ua-broker-user-authentication/password"
   

Para saber mais, consulte az iot ops asset.

Adicionar um ativo, tags e eventos

Portal de Operações IoT do Azure

Para adicionar um ativo no portal de Operações do Azure IoT (visualização):

1. Selecione a guia Ativos . Antes de criar qualquer ativo, você verá a seguinte tela:

   

   Gorjeta

   Você pode usar a caixa de filtro para pesquisar ativos.

   Selecione Criar ativo.

2. Na tela de detalhes do ativo, insira as seguintes informações do ativo:

   • Nome do ativo
   • Ponto final do ativo. Selecione seu ponto de extremidade de ativo na lista.
   • Description

   

3. Configure o conjunto de propriedades que você deseja associar ao ativo. Você pode aceitar a lista padrão de propriedades ou adicionar a sua própria. As seguintes propriedades estão disponíveis por padrão:

   • Fabricante
   • URI do fabricante
   • Modelo
   • Código do produto
   • Versão de hardware
   • Versão do software
   • Número de série
   • URI da documentação

4. Selecione Avançar para ir para a página Adicionar tags .

Adicionar tags individuais a um ativo

Agora você pode definir as tags associadas ao ativo. Para adicionar tags OPC UA:

1. Selecione Adicionar tag ou CSV > Add tag.

2. Introduza os detalhes da etiqueta:

   • ID do nó. Esse valor é o ID do nó do servidor OPC UA.
   • Nome da tag (opcional). Esse valor é o nome amigável que você deseja usar para a tag. Se você não especificar um nome de tag, o ID do nó será usado como o nome da tag.
   • Modo de observabilidade (opcional) com as seguintes opções:
     • Nenhuma
     • Medidor
     • Contador
     • Histograma
     • Registo
   • Intervalo de amostragem (milissegundos). Você pode substituir o valor padrão para essa tag.
   • Tamanho da fila. Você pode substituir o valor padrão para essa tag.

   

   A tabela a seguir mostra alguns exemplos de valores de tag que você pode usar com o simulador de PLC OPC integrado:

   ID do Nó	Nome da etiqueta	Modo de observabilidade
   ns=3; s=FastUInt10	temperatura	nenhum
   ns=3; s=FastUInt100	Etiqueta 10	nenhum

3. Selecione Gerenciar configurações padrão para definir as configurações de telemetria padrão para o ativo. Essas configurações se aplicam a todas as tags OPC UA que pertencem ao ativo. Você pode substituir essas configurações para cada tag adicionada. As configurações de telemetria padrão incluem:

   • Intervalo de amostragem (milissegundos): O intervalo de amostragem indica a taxa mais rápida na qual o OPC UA Server deve fazer uma amostra de sua fonte subjacente para alterações de dados.
   • Intervalo de publicação (milissegundos): a taxa na qual o OPC UA Server deve publicar dados.
   • Tamanho da fila: a profundidade da fila para armazenar os dados de amostragem antes de publicá-los.

Adicionar tags em massa a um ativo

Você pode importar até 1000 tags OPC UA de cada vez de um arquivo CSV:

1. Crie um arquivo CSV semelhante ao exemplo a seguir:

   NodeID	Nome da Etiqueta	Intervalo de amostragem milissegundos	Tamanho da fila	Modo de Observabilidade
   ns=3; s=FastUInt1000	Etiqueta 1000	1000	5	nenhum
   ns=3; s=FastUInt1001	Etiqueta 1001	1000	5	nenhum
   ns=3; s=FastUInt1002	Etiqueta 1002	5000	10	nenhum

2. Selecione Adicionar tag ou Arquivo CSV > de importação CSV (.csv). Selecione o arquivo CSV que você criou e selecione Abrir. As tags definidas no arquivo CSV são importadas:

   

   Se você importar um arquivo CSV que contenha marcas duplicadas de marcas existentes, o portal de Operações do Azure IoT (visualização) exibirá a seguinte mensagem:

   

   Você pode substituir as tags duplicadas e adicionar novas tags do arquivo de importação ou pode cancelar a importação.

3. Para exportar todas as tags de um ativo para um arquivo CSV, selecione Exportar tudo e escolha um local para o arquivo:

   

4. Na página Etiquetas, selecione Seguinte para ir para a página Adicionar eventos.

Gorjeta

Você pode usar a caixa de filtro para pesquisar tags.

CLI do Azure

Use o comando a seguir para adicionar um ativo "termostato" usando a CLI do Azure. O comando adiciona duas tags ao ativo usando o --data parâmetro:

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --data  data_source='ns=3;s=FastUInt10', name=temperature --data data_source='ns=3;s=FastUInt100', name='Tag 10'

Ao criar um ativo usando a CLI do Azure, você pode definir:

• Várias tags usando o --data parâmetro várias vezes.
• Vários eventos usando o --event parâmetro várias vezes.
• Informações opcionais para o ativo, tais como:
  • Fabricante
  • URI do fabricante
  • Modelo
  • Código do produto
  • Versão de hardware
  • Versão do software
  • Número de série
  • URI da documentação
• Valores padrão para intervalo de amostragem, intervalo de publicação e tamanho da fila.
• Marque valores específicos para intervalo de amostragem, intervalo de publicação e tamanho da fila.
• Valores específicos do evento para amostragem de intervalo de publicação e tamanho da fila.
• O modo de observabilidade para cada tag e evento

Adicionar eventos individuais a um ativo

Portal de Operações IoT do Azure

Agora você pode definir os eventos associados ao ativo. Para adicionar eventos OPC UA:

1. Selecione Adicionar evento ou CSV > Adicionar evento.

2. Introduza os detalhes do seu evento:

   • Notificador de eventos. Esse valor é o notificador de eventos do servidor OPC UA.
   • Nome do evento (opcional). Esse valor é o nome amigável que você deseja usar para o evento. Se você não especificar um nome de evento, o notificador de eventos será usado como o nome do evento.
   • Modo de observabilidade (opcional) com as seguintes opções:
     • Nenhuma
     • Medidor
     • Contador
     • Histograma
     • Registo
   • Tamanho da fila. Você pode substituir o valor padrão para essa tag.

   

3. Selecione Gerenciar configurações padrão para definir as configurações de evento padrão para o ativo. Essas configurações se aplicam a todos os eventos OPC UA que pertencem ao ativo. Você pode substituir essas configurações para cada evento adicionado. As configurações de evento padrão incluem:

   • Intervalo de publicação (milissegundos): a taxa na qual o OPC UA Server deve publicar dados.
   • Tamanho da fila: a profundidade da fila para armazenar os dados de amostragem antes de publicá-los.

Adicionar eventos em massa a um ativo

Você pode importar até 1000 eventos OPC UA de cada vez a partir de um arquivo CSV.

Para exportar todos os eventos de um ativo para um arquivo CSV, selecione Exportar tudo e escolha um local para o arquivo.

Na página Eventos, selecione Avançar para ir para a página Revisão.

Gorjeta

Você pode usar a caixa de filtro para pesquisar eventos.

Reveja as suas alterações

Revise seus detalhes de ativos e da tag OPC UA e do evento e faça os ajustes necessários:

CLI do Azure

Ao criar um ativo usando a CLI do Azure, você pode definir vários eventos usando o --event parâmetro várias vezes. A sintaxe do --event parâmetro é semelhante ao --data parâmetro:

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --event event_notifier='ns=3;s=FastUInt12', name=warning

Para cada evento definido, você pode especificar o:

• Notificador de eventos. Esse valor é o notificador de eventos do servidor OPC UA.
• Nome do evento. Esse valor é o nome amigável que você deseja usar para o evento. Se você não especificar um nome de evento, o notificador de eventos será usado como o nome do evento.
• Modo de observabilidade.
• Tamanho da fila.

Atualizar um ativo

Portal de Operações IoT do Azure

Localize e selecione o ativo que você criou anteriormente. Use as guias Detalhes do ativo, Tags e Eventos para fazer alterações:

No separador Etiquetas, pode adicionar etiquetas, atualizar etiquetas existentes ou remover etiquetas.

Para atualizar uma etiqueta, selecione uma etiqueta existente e atualize as informações da etiqueta. Em seguida, selecione Atualizar:

Para remover etiquetas, selecione uma ou mais etiquetas e, em seguida, selecione Remover etiquetas:

Você também pode adicionar, atualizar e excluir eventos e propriedades da mesma maneira.

Quando terminar de fazer alterações, selecione Salvar para salvar as alterações.

CLI do Azure

Para listar seus ativos, use o seguinte comando:

az iot ops asset query -g {your resource group name}

Gorjeta

Você pode refinar o comando de consulta para procurar ativos que correspondam a critérios específicos. Por exemplo, você pode pesquisar ativos por fabricante.

Para visualizar os detalhes do ativo de termostato, use o seguinte comando:

az iot ops asset show --name thermostat -g {your resource group}

Para atualizar um ativo, use o az iot ops asset update comando. Por exemplo, para atualizar a descrição do ativo, use um comando como o exemplo a seguir:

az iot ops asset update --name thermostat --description 'A simulated thermostat asset' -g {your resource group}

Para listar as tags do ativo do termostato, use o seguinte comando:

az iot ops asset data-point list --asset thermostat -g {your resource group}

Para listar os eventos do ativo do termostato, use o seguinte comando:

az iot ops asset event list --asset thermostat -g {your resource group}

Para adicionar uma nova tag ao ativo termostato, use um comando como o exemplo a seguir:

az iot ops asset data-point add --asset thermostat -g {your resource group} --data-source 'ns=3;s=FastUInt1002' --name 'humidity'

Para excluir uma tag, use o az iot ops asset data-point remove comando.

Você pode gerenciar os eventos de um ativo usando os az iot ops asset event comandos.

Excluir um ativo

Portal de Operações IoT do Azure

Para excluir um ativo, selecione o ativo que deseja excluir. Na página Detalhes do ativo, selecione Excluir. Confirme as alterações para excluir o ativo:

CLI do Azure

Para excluir um ativo, use um comando semelhante ao exemplo a seguir:

az iot ops asset delete --name thermostat -g {your resource group name}

Notifications

Sempre que você fizer uma alteração no ativo no portal de Operações do Azure IoT (visualização), verá uma notificação que relata o status da operação:

Conteúdos relacionados

• Visão geral do Azure OPC UA Broker
• Descrição geral do Azure IoT Akri
• az iot ops ativo
• Ponto de extremidade do ativo AZ IoT Ops