Удаленное управление конфигурациями ресурсов

Внимание

Предварительная версия операций Интернета вещей Azure, включенная Azure Arc в настоящее время в предварительной версии. Не следует использовать это программное обеспечение предварительной версии в рабочих средах.

Вам потребуется развернуть новую установку Операций Интернета вещей Azure, когда общедоступная версия станет доступной. Вы не сможете обновить предварительную установку.

Юридические условия, применимые к функциям Azure, которые находятся в состоянии бета-версии, предварительной версии или иным образом еще не выпущены в общедоступной версии, см. на странице Дополнительные условия использования предварительных версий в Microsoft Azure.

Ресурс в Azure IoT Operations Preview — это логическая сущность, созданная для представления реального ресурса. Ресурс Операций Интернета вещей Azure может иметь свойства, теги и события, описывающие его поведение и характеристики.

Серверы OPC UA — это программные приложения, взаимодействующие с ресурсами. Серверы OPC UA предоставляют теги OPC UA, представляющие точки данных. Теги OPC UA предоставляют данные в режиме реального времени или исторические данные о состоянии, производительности, качестве или состоянии активов.

Конечная точка ресурса — это настраиваемый ресурс в кластере Kubernetes, который подключает серверы OPC UA к соединителю для модулей OPC UA. Это подключение позволяет соединителю OPC UA получить доступ к точкам данных ресурса. Без конечной точки ресурса данные не могут передаваться с сервера OPC UA к соединителю для OPC UA и брокера MQTT. После настройки пользовательских ресурсов в кластере устанавливается подключение к нижнему серверу OPC UA, а сервер перенаправит данные телеметрии в соединитель для OPC UA.

Сайт — это семейство экземпляров Операций Интернета вещей Azure. Сайты обычно группировать экземпляры по физическому расположению и упрощают поиск и управление ресурсами пользователями OT. ИТ-администратор создает сайты и назначает им экземпляры операций Интернета вещей Azure. Дополнительные сведения см. в статье "Что такое диспетчер сайтов Azure Arc (предварительная версия)?".

В пользовательском веб-интерфейсе операций экземпляр представляет кластер операций Интернета вещей Azure. Экземпляр может иметь одну или несколько конечных точек ресурса.

В этой статье описывается, как использовать веб-интерфейс интерфейса операций и Azure CLI для:

• Определите конечные точки активов, которые подключают ресурсы к экземпляру Операций Интернета вещей Azure.
• Добавьте ресурсы и определите их теги и события, чтобы включить поток данных с серверов OPC UA в брокер MQTT.

Эти ресурсы, теги и события сопоставляют входящие данные с серверов OPC UA с понятными именами, которые можно использовать в брокере MQTT и потоках данных.

Необходимые компоненты

Чтобы настроить конечную точку ресурсов, требуется запущенный экземпляр операций Интернета вещей Azure.

Чтобы войти в веб-интерфейс взаимодействия с операциями, требуется учетная запись идентификатора Microsoft Entra с по крайней мере разрешениями участника для группы ресурсов, содержащей экземпляр Kubernetes — Экземпляр Azure Arc . Вы не можете войти с помощью учетной записи Майкрософт (MSA). Чтобы создать подходящую учетную запись идентификатора Microsoft Entra в клиенте Azure:

1. Войдите в портал Azure с тем же именем клиента и пользователя, который использовался для развертывания операций Интернета вещей Azure.
2. В портал Azure перейдите в раздел идентификатора Microsoft Entra, выберите "Пользователи > + Создать пользователя>". Создайте пользователя и запишите пароль, его необходимо выполнить позже.
3. В портал Azure перейдите в группу ресурсов, содержащую экземпляр Kubernetes — Azure Arc. На странице управления доступом (IAM) нажмите кнопку +Добавить > назначение ролей.
4. На странице "Добавление назначения ролей" выберите роли привилегированного администратора. Затем нажмите кнопку "Участник" и нажмите кнопку "Далее".
5. На странице "Участники" добавьте нового пользователя в роль.
6. Выберите "Рецензирование" и назначьте его, чтобы завершить настройку нового пользователя.

Теперь вы можете использовать новую учетную запись пользователя для входа на портал Операций Интернета вещей Azure.

Вход

Взаимодействие с операциями

Чтобы войти в интерфейс операций, перейдите к работе в браузере и войдите с помощью учетных данных идентификатора Microsoft Entra.

Выбор сайта

После входа в веб-интерфейс отображается список сайтов. Каждый сайт — это семейство экземпляров операций Интернета вещей Azure, где можно настроить ресурсы и управлять ими. Сайт обычно представляет физическое расположение, в котором развернуты физические ресурсы. Сайты упрощают поиск ресурсов и управление ими. ИТ-администратор отвечает за группировку экземпляров на сайты. Все экземпляры Операций Интернета вещей Azure, которые не назначены сайту, отображаются на узле неподписанных экземпляров . Выберите сайт, который вы хотите использовать:

Совет

Поле фильтра можно использовать для поиска сайтов.

Если вы не видите никаких сайтов, возможно, вы не будете в правильном клиенте Azure Active Directory. Вы можете изменить клиент в правом верхнем меню в интерфейсе операций. Если вы по-прежнему не видите ни одного сайта, что означает, что вы еще не добавлены. Обратитесь к ИТ-администратору, чтобы запросить доступ.

Выбор экземпляра

После выбора сайта в интерфейсе операций отображается список экземпляров операций Интернета вещей Azure, которые являются частью сайта. Выберите экземпляр, который вы хотите использовать:

Совет

Поле фильтра можно использовать для поиска экземпляров.

После выбора экземпляра в интерфейсе операций отображается страница обзора для экземпляра. На странице "Обзор" отображается состояние экземпляра и ресурсов, таких как ресурсы, связанные с ним:

Azure CLI

Перед использованием az iot ops asset команд войдите в подписку, содержащую развертывание Операций Интернета вещей Azure:

az login

Создание конечной точки ресурса

Развертывание Операций Интернета вещей Azure может включать дополнительный встроенный симулятор OPC PLC. Чтобы создать конечную точку ресурса, использующую встроенный симулятор OPC PLC:

Взаимодействие с операциями

1. Выберите конечные точки ресурса и создайте конечную точку ресурса:

   

   Совет

   Поле фильтра можно использовать для поиска конечных точек ресурсов.

2. Введите следующие сведения о конечной точке:

   Поле	Значение
   Имя.	opc-ua-connector-0
   Соединитель для URL-адреса OPC UA	opc.tcp://opcplc-000000:50000
   Проверка подлинности пользователя	Anonymous

3. Чтобы сохранить определение, нажмите кнопку "Создать".

Azure CLI

Выполните следующую команду:

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} 

Совет

Используйте az connectedk8s list для перечисления кластеров, к которых у вас есть доступ.

Дополнительные сведения см. в статье az iot ops asset endpoint.

Эта конфигурация развертывает новый assetendpointprofile ресурс, вызываемого opc-ua-connector-0 в кластере. После определения ресурса соединитель для pod OPC UA обнаруживает его. Модуль pod использует конечную точку ресурса, указанную в определении ресурса, для подключения к серверу OPC UA.

При запуске симулятора OPC PLC данные передаются из симулятора в соединитель для OPC UA, а затем к брокеру MQTT.

Настройка конечной точки ресурса для использования имени пользователя и пароля

В предыдущем примере используется Anonymous режим проверки подлинности. В этом режиме не требуется имя пользователя или пароль.

Чтобы использовать UsernamePassword режим проверки подлинности, выполните следующие действия.

Взаимодействие с операциями

1. Выполните действия, описанные в статье "Настройка проверки подлинности пользователя OPC UA с именем пользователя и паролем ", чтобы добавить секреты для имени пользователя и пароля в Azure Key Vault и проецировать их в кластер Kubernetes.
2. В ходе операций выберите пароль имени пользователя для поля проверки подлинности пользователя, чтобы настроить конечную точку ресурса для использования этих секретов. Затем введите следующие значения для полей ссылки на имя пользователя и ссылок на пароль:

Поле	значение
Справочник по имени пользователя	aio-opc-ua-broker-user-authentication/username
Справочник по паролям	aio-opc-ua-broker-user-authentication/password

Azure CLI

1. Выполните действия, описанные в статье "Настройка проверки подлинности пользователя OPC UA с именем пользователя и паролем ", чтобы добавить секреты для имени пользователя и пароля в Azure Key Vault и проецировать их в кластер Kubernetes.

2. Используйте следующую команду, чтобы создать конечную точку ресурса:

   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"
   

Добавление ресурса, тегов и событий

Взаимодействие с операциями

Чтобы добавить ресурс в интерфейс операций, выполните следующие действия.

1. Перейдите на вкладку "Активы ". Перед созданием ресурсов вы увидите следующий экран:

   

   Совет

   Поле фильтра можно использовать для поиска ресурсов.

2. Выберите " Создать ресурс".

3. На экране сведений о активе введите следующие сведения о ресурсах:

   • Конечная точка ресурса. Выберите конечную точку ресурса из списка.
   • Имя ресурса
   • Description

4. Настройте набор свойств, которые необходимо связать с ресурсом. Вы можете принять список свойств по умолчанию или добавить собственный. По умолчанию доступны следующие свойства:

   • Производитель
   • Универсальный код ресурса (URI) производителя
   • Модель
   • Код продукта
   • Версия оборудования
   • Версия ПО
   • Серийный номер
   • URI документации

   

5. Нажмите кнопку "Далее", чтобы перейти на страницу "Добавить теги".

Добавление отдельных тегов в ресурс

Теперь можно определить теги, связанные с ресурсом. Чтобы добавить теги OPC UA, выполните приведенные действия.

1. Выберите "Добавить тег" или "Добавить тег CSV>".

2. Введите сведения о теге:

   • Идентификатор узла. Это значение является идентификатором узла с сервера OPC UA.
   • Имя тега (необязательно). Это понятное имя, которое вы хотите использовать для тега. Если имя тега не указано, идентификатор узла используется в качестве имени тега.
   • Режим наблюдаемости (необязательно) со следующими вариантами:
     • нет
     • Показатели
     • Счетчик
     • Гистограмма
     • Журнал
   • Интервал выборки (миллисекунда). Можно переопределить значение по умолчанию для этого тега.
   • Размер очереди. Можно переопределить значение по умолчанию для этого тега.

   

   В следующей таблице показаны некоторые примеры значений тегов, которые можно использовать с встроенным симулятором OPC PLC:

   Идентификатор узла	Имя тега	Режим наблюдаемости
   ns=3; s=FastUInt10	Температура	нет
   ns=3; s=FastUInt100	Влажность	нет

3. Выберите " Управление параметрами по умолчанию", чтобы настроить параметры телеметрии по умолчанию для ресурса. Эти параметры применяются ко всем тегам OPC UA, принадлежащим ресурсу. Эти параметры можно переопределить для каждого добавляемого тега. Параметры телеметрии по умолчанию:

   • Интервал выборки (миллисекунда) — интервал выборки указывает самую быструю скорость, с которой сервер OPC UA должен образец своего базового источника для изменений данных.
   • Интервал публикации (миллисекунда) — скорость публикации данных сервера OPC UA.
   • Размер очереди: глубина очереди для хранения данных выборки перед публикацией.

Массовое добавление тегов в ресурс

Вы можете импортировать до 1000 тегов OPC UA за раз из CSV-файла:

1. Создайте CSV-файл, который выглядит следующим образом:

   NodeID	TagName	QueueSize	ObservabilityMode	Интервал выборки в миллисекундах
   ns=3; s=FastUInt1000	Тег 1000	5	нет	1000
   ns=3; s=FastUInt1001	Тег 1001	5	нет	1000
   ns=3; s=FastUInt1002	Тег 1002	10	нет	5000

2. Выберите "Добавить тег" или CSV-файл импорта CSV > (.csv). Выберите созданный CSV-файл и нажмите кнопку "Открыть". Теги, определенные в CSV-файле, импортируются:

   

   При импорте CSV-файла, содержащего теги, дублирующие существующие теги, операции отображают следующее сообщение:

   

   Вы можете заменить повторяющиеся теги и добавить новые теги из файла импорта или отменить импорт.

3. Чтобы экспортировать все теги из ресурса в CSV-файл, выберите "Экспортировать все " и выберите расположение для файла:

   

4. На странице "Теги" нажмите кнопку "Далее", чтобы перейти на страницу "Добавить события".

Совет

Поле фильтра можно использовать для поиска тегов.

Azure CLI

Используйте следующую команду, чтобы добавить ресурс термостата с помощью Azure CLI. Команда добавляет два тега в ресурс с помощью --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'

При создании ресурса с помощью Azure CLI можно определить следующее:

• Несколько тегов с помощью --data параметра несколько раз.
• Несколько событий с помощью --event параметра несколько раз.
• Необязательные сведения для ресурса, например:
  • Производитель
  • Универсальный код ресурса (URI) производителя
  • Модель
  • Код продукта
  • Версия оборудования
  • Версия ПО
  • Серийный номер
  • URI документации
• Значения по умолчанию для интервала выборки, интервала публикации и размера очереди.
• Пометьте определенные значения для интервала выборки, интервала публикации и размера очереди.
• Конкретные значения событий для интервала публикации выборки и размера очереди.
• Режим наблюдаемости для каждого тега и события

Добавление отдельных событий в ресурс

Взаимодействие с операциями

Теперь можно определить события, связанные с ресурсом. Чтобы добавить события OPC UA, выполните действия:

1. Выберите "Добавить событие" или "Добавить CSV>".

2. Введите сведения о событии:

   • Уведомление о событии. Это значение является уведомлением о событии с сервера OPC UA.
   • Имя события (необязательно). Это понятное имя, которое вы хотите использовать для события. Если имя события не указано, то в качестве имени события используется уведомление о событии.
   • Режим наблюдаемости (необязательно) со следующими вариантами:
     • нет
     • Журнал
   • Размер очереди. Можно переопределить значение по умолчанию для этого тега.

   

3. Выберите " Управление параметрами по умолчанию" , чтобы настроить параметры событий по умолчанию для ресурса. Эти параметры применяются ко всем событиям OPC UA, принадлежащим ресурсу. Эти параметры можно переопределить для каждого добавляемого события. Параметры событий по умолчанию:

   • Интервал публикации (миллисекунда) — скорость публикации данных сервера OPC UA.
   • Размер очереди: глубина очереди для хранения данных выборки перед публикацией.

Массовое добавление событий в ресурс

Вы можете импортировать до 1000 событий OPC UA за раз из CSV-файла.

Чтобы экспортировать все события из ресурса в CSV-файл, выберите "Экспорт всех " и выберите расположение для файла.

На странице "События" нажмите кнопку "Далее", чтобы перейти на страницу "Рецензирование".

Совет

Поле фильтра можно использовать для поиска событий.

Просмотр изменений

Просмотрите тег ресурса и тег OPC UA и сведения о событии и внесите необходимые изменения:

Azure CLI

При создании ресурса с помощью Azure CLI можно определить несколько событий с помощью --event параметра несколько раз. Синтаксис параметра --event аналогичен параметру --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

Для каждого определяемого события можно указать следующее:

• Уведомление о событии. Это значение является уведомлением о событии с сервера OPC UA.
• Имя события. Это понятное имя, которое вы хотите использовать для события. Если имя события не указано, то в качестве имени события используется уведомление о событии.
• Режим наблюдаемости.
• Размер очереди.

Обновление ресурса

Взаимодействие с операциями

Найдите и выберите созданный ранее ресурс. Используйте вкладки "Сведения о ресурсах", "Теги" и "События", чтобы внести изменения:

На вкладке "Теги" можно добавлять теги, обновлять существующие теги или удалять теги.

Чтобы обновить тег, выберите существующий тег и обновите сведения о теге. Затем нажмите кнопку "Обновить":

Чтобы удалить теги, выберите один или несколько тегов и нажмите кнопку "Удалить теги":

Вы также можете добавлять, обновлять и удалять события и свойства таким же образом.

Завершив внесение изменений, нажмите кнопку "Сохранить ", чтобы сохранить изменения.

Azure CLI

Чтобы вывести список ресурсов, используйте следующую команду:

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

Совет

Вы можете уточнить команду запроса, чтобы найти ресурсы, соответствующие определенным критериям. Например, можно искать ресурсы по изготовителю.

Чтобы просмотреть сведения о ресурсе термостата, используйте следующую команду:

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

Чтобы обновить ресурс, используйте az iot ops asset update команду. Например, чтобы обновить описание ресурса, используйте следующую команду:

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

Чтобы получить список тегов актива термостата, используйте следующую команду:

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

Чтобы перечислить события актива термостата, используйте следующую команду:

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

Чтобы добавить новый тег в ресурс термостата, используйте команду, как показано в следующем примере:

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

Чтобы удалить тег, используйте az iot ops asset data-point remove команду.

События ресурса можно управлять с помощью az iot ops asset event команд.

Удаление актива

Взаимодействие с операциями

Чтобы удалить ресурс, выберите ресурс, который требуется удалить. На странице сведений о ресурсе нажмите кнопку "Удалить". Подтвердите изменения, чтобы удалить ресурс:

Azure CLI

Чтобы удалить ресурс, используйте команду, которая выглядит следующим образом:

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

Notifications

Всякий раз, когда вы вносите изменения в ресурс в процессе работы, вы увидите уведомление, которое сообщает о состоянии операции:

Просмотр журналов действий

В интерфейсе операций можно просматривать журналы действий для каждого экземпляра или каждого ресурса в экземпляре.

Чтобы просмотреть журналы действий на уровне экземпляра, перейдите на вкладку "Журналы действий". Для настройки представления можно использовать фильтры таймпанов и типов ресурсов.

Чтобы просмотреть журналы действий в качестве уровня ресурса, выберите ресурс, который требуется проверить. Этот ресурс может быть ресурсом, конечной точкой ресурса или конвейером данных. В обзоре ресурса выберите "Просмотреть журналы действий". Для настройки представления можно использовать фильтр Timespan .

Связанный контент

• Обзор соединителя для OPC UA
• az iot ops asset
• az iot ops asset endpoint