Gerenciar configurações de ativo remotamente

Um ativo nas Operações IoT do Azure é uma entidade lógica que você cria para representar um ativo real. Um ativo das Operações do Azure IoT 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 marcas 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, é estabelecida uma conexão com o servidor OPC UA a jusante, e o servidor encaminha mensagens, como dados de sensores, para o conector de OPC UA.

Um site é uma coleção de instâncias das Operações do Azure IoT. 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 do Azure IoT 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 das Operações do Azure IoT.
• Adicione ativos e defina 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 no agente MQTT.

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.

Para entrar na interface do usuário da web da experiência de operações, você precisa de uma conta do Microsoft Entra ID com, pelo menos, permissões de colaborador no 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 Examinar e atribuir para concluir a configuração do novo usuário.

Agora você pode usar a nova conta de usuário para acessar a interface web da experiência operacional.

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. As instâncias das Operações do Azure IoT que não estiverem atribuídas a um site aparecerão 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. Altere 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 das 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.

CLI do Azure

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

az login

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:

Criar um ponto de extremidade de ativo

Uma implantação das 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 ativos e, em seguida, Criar 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 create opcua --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 create opcua --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"
   

Importar e exportar pontos de extremidade de ativos

Use os botões Importar e Exportar para importar ou exportar um endpoint de ativo no ambiente de operações.

O arquivo JSON exportado contém a definição do ponto de extremidade do ativo. Você pode usar esse arquivo para importar o ponto de extremidade de ativo para outra instância das Operações de IoT do Azure ou modificá-lo para criar um novo ponto de extremidade de ativo na instância atual:

{
  "name": "<your asset endpoint name>",
  "type": "microsoft.deviceregistry/assetendpointprofiles",
  "location": "<your location>",
  "extendedLocation": {
    "type": "CustomLocation",
    "name": "/subscriptions/<your subscription id>/resourceGroups/<your resource group>/providers/Microsoft.ExtendedLocation/customLocations/<your custom location>"
  },
  "properties": {
    "targetAddress": "<your target address>",
    "endpointProfileType": "Microsoft.OpcUa",
    "additionalConfiguration": "{\"runAssetDiscovery\":true}",
    "authentication": {
      "method": "Anonymous"
    }
  },
  "apiVersion": "2024-11-01"
}

Dica

Exporte um ponto de extremidade de ativo existente para descobrir o valor extendedLocation Name.

Dica

Você também pode usar os comandos az iot ops asset endpoint show e az iot ops asset endpoint create para exibir e criar pontos de extremidade de ativo.

Gerenciar certificados e segredos

Na página Pontos de extremidade do ativo, você pode gerenciar os certificados e segredos que os pontos de extremidade de ativos usam:

• A guia Certificados mostra a lista de certificados confiáveis e a lista de certificados emissores para os servidores OPC UA aos quais você deseja se conectar.

  • Para saber mais sobre a infraestrutura de certificados OPC UA, consulte a infraestrutura de certificados OPC UA para o conector para OPC UA.
  • Para saber mais sobre como configurar as listas de emissores e certificados confiáveis, consulte Configurar a infraestrutura de certificados OPC UA para o conector para OPC UA.

• A guia Segredos mostra os segredos que contêm os nomes de usuário e senhas para os servidores OPC UA aos quais você deseja se conectar. Para saber mais sobre a autenticação de usuário do OPC UA, consulte Configurar opções de autenticação de usuário OPC UA para o conector para OPC UA.

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 seguinte tela:

   

   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
   • O tópico MQTT no qual o ativo faz a publicação. O padrão é <namespace>/data/<asset-name>.

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
   • Modelo
   • Código do produto
   • Versão do 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
     • Registro
   • 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 padrão para mensagens do 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 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 "termostato" 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
  • Modelo
  • Código do produto
  • Versão do 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
     • Registro
   • 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 Avançar para acessar a página Revisão.

Dica

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

Examinar as 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}

Importar e exportar ativos

Use os botões Importar e Exportar para importar ou exportar um ativo na experiência de operações:

O arquivo JSON exportado contém a definição de ativo. Você pode usar esse arquivo para importar o ativo para outra instância das Operações de IoT do Azure ou modificá-lo para criar um novo ativo na instância atual. O exemplo JSON a seguir mostra um arquivo de importação a ser usado para criar um ativo de termostato:

{
  "name": "thermostat",
  "type": "microsoft.deviceregistry/assets",
  "location": "<your location>",
  "extendedLocation": {
    "type": "CustomLocation",
    "name": "/subscriptions/<your subscription id>/resourceGroups/<your resource group>/providers/Microsoft.ExtendedLocation/customLocations/<your custom location>"
  },
  "properties": {
    "enabled": true,
    "displayName": "thermostat",
    "description": "A simulated thermostat asset",
    "assetEndpointProfileRef": "opc-ua-connector-1",
    "version": 1,
    "attributes": {
      "batch": "102",
      "customer": "Contoso",
      "equipment": "Boiler",
      "isSpare": "true",
      "location": "Seattle"
    },
    "defaultDatasetsConfiguration": "{\"publishingInterval\":1000,\"samplingInterval\":1000,\"queueSize\":1}",
    "defaultEventsConfiguration": "{\"publishingInterval\":1000,\"queueSize\":1}",
    "defaultTopic": {
      "path": "azure-iot-operations/data/thermostat",
      "retain": "Never"
    },
    "datasets": [
      {
        "name": "default",
        "dataPoints": [
          {
            "name": "temperature",
            "dataSource": "ns=3;s=SpikeData",
            "observabilityMode": "None",
            "dataPointConfiguration": "{}"
          }
        ]
      }
    ]
  },
  "apiVersion": "2024-11-01"
}

Dica

Exporte um ponto de extremidade de ativo existente para descobrir o valor extendedLocation Name.

Dica

Você também pode usar os comandos az iot ops asset show e az iot ops asset create para exibir e criar pontos de extremidade de ativo.

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 Timespan e Tipo de recurso para personalizar a 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 Timespan 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