Gerenciar configurações de ativo remotamente

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

Depois de entrar, a interface do usuário da web 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:

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:

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:

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

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.

Execute o comando a seguir:

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} 

Para saber mais, consulte az iot ops asset endpoint.

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:

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 --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 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.

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

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 marcas usando o parâmetro --data 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 de marca 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

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.

Revisar suas alterações

Examine a marca de ativo e OPC UA e os detalhes do evento e faça os ajustes necessários:

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

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.

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.

Para listar seus ativos, use o comando a seguir:

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

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 data-point list --asset thermostat -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 data-point add --asset thermostat -g {your resource group} --data-source 'ns=3;s=FastUInt1002' --name 'humidity'

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

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

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:

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

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