Gerenciar configurações de ativo remotamente

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 do Azure IoT quando uma versão com disponibilidade geral estiver disponível. Você não poderá atualizar uma instalação de versão prévia.

Para 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, confira os Termos de Uso Complementares para Versões Prévias do Microsoft Azure.

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

Os servidores OPC UA são aplicativos de software que se comunicam com ativos. Os servidores OPC UA expõem marcas 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 no cluster do Kubernetes que conecta servidores OPC UA a módulos do conector para OPC UA. Essa conexão permite que um conector para 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 o conector para OPC UA e agente MQTT. 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 o conector para OPC UA.

Um site é uma coleção de instâncias de Operações de IoT do Azure. Os sites geralmente agrupam instâncias por local físico e facilitam para os usuários de OT localizar e gerenciar ativos. Seu administrador de TI cria sites e atribui instâncias do Operações de IoT do Azure a eles. Para saber mais, confira O que é o gerenciador de sites do Azure Arc (versão prévia)?.

Na interface do usuário da web da experiência de operações, 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 a interface do usuário da web da experiência de operações e a CLI do Azure para:

• Defina os pontos de extremidade de ativo que conectam ativos à instância de Operações do Azure IoT.
• Adicione ativos e defina suas marcas e eventos para habilitar o fluxo de dados de servidores OPC UA para o agente MQTT.

Esses ativos, marcas e eventos mapeiam dados de entrada de servidores OPC UA para nomes amigáveis que você pode usar nos fluxos de dados e do agente MQTT.

Pré-requisitos

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

Para entrar na interface do usuário da Web de experiência de operações, você precisa de uma conta do Microsoft Entra ID com pelo menos permissões de colaborador para o grupo de recursos que contém sua instância do Kubernetes — Azure Arc. Você não pode entrar com uma conta Microsoft (MSA). Para criar uma conta adequada do Microsoft Entra ID em seu locatário do Azure:

1. Entre no portal do Azure com o mesmo locatário e nome de usuário que você usou para implantar as Operações do Azure IoT.
2. No portal do Azure, vá para a seção Microsoft Entra ID e selecione Usuários > +Novo usuário > Criar novo usuário. Crie um novo usuário e anote a senha, já que você precisará dela para entrar mais tarde.
3. No portal do Azure, vá para o grupo de recursos que contém sua instância do Kubernetes — Azure Arc. Na página Controle de acesso (IAM), selecione +Adicionar > Adicionar atribuição de função.
4. Na página Adicionar atribuição de função, selecione Funções de administrador com privilégios. Selecione Colaborador e, a seguir, Avançar.
5. Na página Membros, adicione seu novo usuário à função.
6. Selecione Revisar e atribuir para concluir a configuração do novo usuário.

Agora você já pode usar a nova conta de usuário para entrar no portal de Operações do Azure IoT.

Entrar

Experiência de operações

Para entrar na experiência de operações, navegue até a experiência de operações em seu navegador e entre usando suas credenciais do Microsoft Entra ID.

Selecione seu site

Após conectar, a experiência de operações exibirá uma lista de sites. Cada site é uma coleção de instâncias das Operações do Azure IoT nas quais você pode configurar e gerenciar seus ativos. Um site normalmente representa um local físico em que você tem ativos físicos implantados. Os sites facilitam a localização e o gerenciamento de ativos. O administrador de TI é responsável por agrupar instâncias em sites. Quaisquer instâncias das Operações do Azure IoT que não estão atribuídas a um site aparecem no nó Instâncias não atribuídas. Selecione o site que você quer usar:

Dica

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 Active Directory. Você pode alterar o locatário no menu superior direito na experiência de operações. Se você ainda não vir nenhum site, isso significa que você ainda não foi adicionado a nenhum. Entre em contato com seu administrador de TI para solicitar acesso.

Selecione sua instância

Depois de você selecionar um site, a experiência de operações exibirá uma lista das instâncias de Operações do Azure IoT que fazem parte do site. Selecione a instância que você quer usar:

Dica

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

Depois de selecionar sua instância, a experiência de operações exibirá a página Visão Geral da instância. A página Visão geral mostra o status da instância e os recursos, como ativos, associados a ela:

CLI do Azure

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

az login

Criar um ponto de extremidade de ativo

Uma implantação de Operações do Azure IoT pode incluir um simulador interno do OPC PLC opcional. Para criar um ponto de extremidade de ativo que usa o simulador interno do OPC PLC:

Experiência de operações

1. Selecione Pontos de extremidade de ativo e, em seguida, Crie um ponto de extremidade de ativo:

   

   Dica

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

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

   Campo	Valor
   Nome	opc-ua-connector-0
   URL do conector para OPC UA	opc.tcp://opcplc-000000:50000
   Autenticação de usuário	Anonymous

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

CLI do Azure

Execute o comando a seguir:

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

Dica

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 recurso assetendpointprofile chamado opc-ua-connector-0 no cluster. Depois que você define um ativo, um pod do conector para 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 OPC UA e, depois, para o agente MQTT.

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

O exemplo anterior usa o modo de autenticação Anonymous. Esse modo não requer um nome de usuário ou senha.

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

Experiência de operações

1. Siga as etapas em Configurar a autenticação de usuário do OPC UA com nome de usuário e senha para adicionar segredos ao nome de usuário e senha no Azure Key Vault, e projetá-los no cluster do Kubernetes.
2. Na experiência de operações, selecione Senha e nome de usuário para o campo Autenticação de usuário para configurar o ponto de extremidade de ativo para usar esses segredos. Em seguida, insira os seguintes valores para os campos de referência de nome de usuário e referência de senha:

Campo	Valor
Referência de nome de usuário	aio-opc-ua-broker-user-authentication/username
Referência de senha	aio-opc-ua-broker-user-authentication/password

CLI do Azure

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

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

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

Adicionar um ativo, marcas e eventos

Experiência de operações

Para adicionar um ativo na experiência de operações:

1. Selecione a guia Ativos . Antes de criar ativos, você verá a tela a seguir:

   

   Dica

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

2. Selecione Criar ativo.

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

   • Ponto de extremidade do ativo. Selecione o ponto de extremidade do ativo na lista.
   • Nome do ativo
   • Descrição

4. 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 lista. As propriedades a seguir estão disponíveis por padrão:

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

   

5. Selecione Avançar para ir para a página Adicionar marcas.

Adicionar marcas individuais a um ativo

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

1. Selecione Adicionar marca ou CSV > Adicionar marca.

2. Insira os detalhes da marca:

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

   

   A tabela a seguir mostra alguns valores de marca de exemplo que você pode usar com o simulador interno do OPC PLC:

   ID do nó	Nome da marca	Modo de observabilidade
   ns=3;s=FastUInt10	Temperatura	Nenhum
   ns=3;s=FastUInt100	Umidade	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 marcas OPC UA que pertencem ao ativo. Você pode substituir essas configurações para cada marca que adicionar. 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 servidor OPC UA deve amostrar sua fonte subjacente para alterações de dados.
   • Intervalo de publicação (milissegundos): a taxa na qual o servidor OPC UA deve publicar dados.
   • Tamanho da fila: a profundidade da fila para manter os dados de amostragem antes de publicá-los.

Adicionar marcas em massa a um ativo

Você pode importar até 1000 marcas OPC UA por vez de um arquivo CSV:

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

   NodeID	TagName	QueueSize	ObservabilityMode	Milissegundos do intervalo de amostragem
   ns=3;s=FastUInt1000	Marca 1000	5	Nenhum	1000
   ns=3;s=FastUInt1001	Marca 1001	5	Nenhum	1000
   ns=3;s=FastUInt1002	Marca 1002	10	Nenhum	5.000

2. Selecione Adicionar marca ou CSV > Importar arquivo CSV (.csv). Selecione o arquivo CSV que você criou e selecione Abrir. As marcas definidas no arquivo CSV são importadas:

   

   Se você importar um arquivo CSV que contenha marcas duplicadas de marcas existentes, a experiência de operações exibirá a seguinte mensagem:

   

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

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

   

4. Na página Marcas, selecione Avançar para acessar a página Adicionar eventos.

Dica

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

CLI do Azure

Use os seguintes comandos para adicionar um ativo \"thermostat\" usando a CLI do Azure. Os comandos adicionam dois rótulos/pontos de dados ao ativo usando o comando point add:

# Create the asset
az iot ops asset create --name thermostat -g {your resource group name} --instance {your instance name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset'

# Add the datapoints
az iot ops asset dataset point add --asset thermostat -g {your resource group name} --dataset default --data-source 'ns=3;s=FastUInt10' --name temperature
az iot ops asset dataset point add --asset thermostat -g {your resource group name} --dataset default --data-source 'ns=3;s=FastUInt100' --name 'Tag 10'

# Show the datapoints
az iot ops asset dataset show --asset thermostat -n default -g {your resource group name}

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

• Vários pontos de dados/rótulos usando o comando point add várias vezes.
• Vários eventos usando o parâmetro --event várias vezes.
• Informações opcionais para o ativo, como:
  • Fabricante
  • URI do fabricante
  • Modelar
  • 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.
• Valores específicos do ponto de dados para intervalo de amostragem, intervalo de publicação e tamanho da fila.
• Valores específicos de evento para o intervalo de amostragem, publicação e tamanho da fila.
• O modo de observabilidade para cada marca e evento

Adicionar eventos individuais a um ativo

Experiência de operações

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

1. Selecione Adicionar evento ou CSV > Adicionar evento.

2. Insira os detalhes do evento:

   • Notificador de evento. Esse valor é o notificador de evento 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 evento será usado como o nome do evento.
   • Modo de observabilidade (opcional) com as seguintes opções:
     • Nenhum
     • Log
   • Tamanho da fila. Você pode substituir o valor padrão para essa marca.

   

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 de 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 servidor OPC UA deve publicar dados.
   • Tamanho da fila: a profundidade da fila para manter os dados de amostragem antes de publicá-los.

Adicionar eventos em massa a um ativo

Você pode importar até 1000 eventos OPC UA por vez 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 Próximo para acessar a página Revisão.

Dica

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

Revisar suas alterações

Examine a marca de ativo e OPC UA e os detalhes 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 parâmetro --event várias vezes:

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 que você definir, você pode especificar:

• Notificador de evento. Esse valor é o notificador de evento 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 evento será usado como o nome do evento.
• Modo de observabilidade.
• Tamanho da fila.

Você também pode usar os comandos az iot ops asset event para adicionar e remover eventos de um ativo.

Atualizar um ativo

Experiência de operações

Localize e selecione o ativo criado anteriormente. Use as guias Detalhes do ativo, Marcas e Eventos para fazer alterações:

Na guia Marcas, você pode adicionar marcas, atualizar marcas existentes ou remover marcas.

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

Para remover marcas, selecione uma ou mais marcas e selecione Remover marcas:

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

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

CLI do Azure

Para listar seus ativos, use o comando a seguir:

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

Dica

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

Para exibir os detalhes do ativo de termostato, use o comando a seguir:

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

Para atualizar um ativo, use o comando az iot ops asset update. 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 marcas do ativo de termostato, use o comando a seguir:

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

Para listar os eventos do ativo de termostato, use o comando a seguir:

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

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

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

Para excluir uma marca, use o comando az iot ops asset dataset point remove.

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

Excluir um ativo

Experiência de operações

Para excluir um ativo, selecione o ativo que você deseja excluir. Na página Detalhes do Ativo, selecione Excluir. Confirme suas 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}

Notificações

Sempre que você faz uma alteração no ativo na experiência de operações, você vê uma notificação que relata o status da operação:

Exibir logs de atividade

Na experiência de operações, você pode exibir logs de atividades para cada instância ou cada recurso em uma instância.

Para exibir os logs de atividades no nível da instância, selecione a guia Logs de atividades. Você pode usar os filtros Intervalo de tempo e Tipo de recurso para personalizar o modo de exibição.

Para exibir os logs de atividades como o nível de recurso, selecione o recurso que você deseja inspecionar. Esse recurso pode ser um ativo, ponto de extremidade de ativo ou pipeline de dados. Na visão geral do recurso, selecione Ver logs de atividade. Você pode usar o filtro Intervalo de tempo para personalizar a exibição.

Conteúdo relacionado

• Visão geral do conector para OPC UA
• az iot ops asset
• az iot ops asset endpoint