Zdalne zarządzanie konfiguracjami zasobów

Ważne

Usługa Azure IoT Operations Preview — włączona przez usługę Azure Arc jest obecnie dostępna w wersji zapoznawczej. Nie należy używać tego oprogramowania w wersji zapoznawczej w środowiskach produkcyjnych.

Zobacz Dodatkowe warunki użytkowania wersji zapoznawczych platformy Microsoft Azure, aby zapoznać się z postanowieniami prawnymi dotyczącymi funkcji platformy Azure, które są w wersji beta lub wersji zapoznawczej albo w inny sposób nie zostały jeszcze wydane jako ogólnie dostępne.

Zasób w usłudze Azure IoT Operations Preview to jednostka logiczna tworzona do reprezentowania rzeczywistego zasobu. Zasób operacji usługi Azure IoT może mieć właściwości, tagi i zdarzenia, które opisują jego zachowanie i cechy.

Serwery OPC UA to aplikacje oprogramowania komunikujące się z elementami zawartości. Serwery OPC UA uwidaczniają tagi OPC UA reprezentujące punkty danych. Tagi OPC UA zapewniają dane historyczne dotyczące stanu, wydajności, jakości lub stanu zasobów w czasie rzeczywistym.

Punkt końcowy zasobu to zasób niestandardowy w klastrze Kubernetes, który łączy serwery OPC UA z modułami łącznika OPC UA. To połączenie umożliwia łącznikowi OPC UA uzyskiwanie dostępu do punktów danych zasobu. Bez punktu końcowego zasobu dane nie mogą przepływać z serwera OPC UA do wystąpienia usługi Azure IoT OPC UA Broker w wersji zapoznawczej i wystąpienia usługi Azure IoT MQ w wersji zapoznawczej. Po skonfigurowaniu zasobów niestandardowych w klastrze zostanie nawiązane połączenie z podrzędnym serwerem OPC UA, a serwer przekazuje dane telemetryczne do wystąpienia brokera OPC UA.

Witryna to zbiór wystąpień operacji usługi Azure IoT. Witryny ułatwiają organizowanie wystąpień i zarządzanie kontrolą dostępu. Administrator IT tworzy lokacje, przypisuje do nich wystąpienia i udziela dostępu użytkownikom OT w organizacji.

W portalu Azure IoT Operations (wersja zapoznawcza) wystąpienie reprezentuje klaster operacji usługi Azure IoT. Wystąpienie może mieć co najmniej jeden punkt końcowy zasobu.

W tym artykule opisano sposób używania portalu Operacje usługi Azure IoT (wersja zapoznawcza) i interfejsu wiersza polecenia platformy Azure do:

• Definiowanie punktów końcowych zasobów
• Dodawanie zasobów i definiowanie tagów i zdarzeń

Te zasoby, tagi i zdarzenia mapują dane przychodzące z serwerów OPC UA na przyjazne nazwy, których można używać w potokach brokera MQ i przetwarzania danych usługi Azure IoT w wersji zapoznawczej.

Wymagania wstępne

Aby skonfigurować punkt końcowy zasobów, potrzebne jest uruchomione wystąpienie operacji usługi Azure IoT.

Zaloguj

Portal operacji usługi Azure IoT

Aby zalogować się do portalu Operacje usługi Azure IoT (wersja zapoznawcza), przejdź do portalu Operacje usługi Azure IoT (wersja zapoznawcza) w przeglądarce i zaloguj się przy użyciu poświadczeń identyfikatora Entra firmy Microsoft.

Wybierz witrynę

Po zalogowaniu w portalu zostanie wyświetlona lista witryn, do których masz dostęp. Każda witryna to zbiór wystąpień operacji usługi Azure IoT, w których można skonfigurować zasoby. Administrator IT jest odpowiedzialny za organizowanie wystąpień w witrynach i udzielanie dostępu użytkownikom OT w organizacji. Wystąpienia, które nie są częścią witryny, są wyświetlane w węźle Nieprzypisane wystąpienia. Wybierz witrynę, której chcesz użyć:

Napiwek

Możesz użyć pola filtru, aby wyszukać witryny.

Jeśli nie widzisz żadnych witryn, być może nie jesteś w odpowiedniej dzierżawie usługi Azure Active Directory. Dzierżawę można zmienić z menu w prawym górnym rogu w portalu. Jeśli nadal nie widzisz żadnych witryn, oznacza to, że nie jesteś jeszcze dodany do żadnej z tych witryn. Skontaktuj się z administratorem IT, aby zażądać dostępu.

Wybierz wystąpienie

Po wybraniu witryny w portalu zostanie wyświetlona lista wystąpień operacji usługi Azure IoT, które są częścią witryny. Wybierz wystąpienie, którego chcesz użyć:

Napiwek

Możesz użyć pola filtru, aby wyszukać wystąpienia.

Interfejs wiersza polecenia platformy Azure

Przed użyciem az iot ops asset poleceń zaloguj się do subskrypcji zawierającej wdrożenie operacji usługi Azure IoT:

az login

Tworzenie punktu końcowego zasobu

Domyślnie wdrożenie operacji usługi Azure IoT obejmuje wbudowany symulator OPC PLC. Aby utworzyć punkt końcowy zasobu korzystający z wbudowanego symulatora OPC PLC:

Portal operacji usługi Azure IoT

1. Wybierz pozycję Punkty końcowe zasobu, a następnie pozycję Utwórz punkt końcowy zasobu:

   

   Napiwek

   Możesz użyć pola filtru, aby wyszukać punkty końcowe elementu zawartości.

2. Wprowadź następujące informacje o punkcie końcowym:

   Pole	Wartość
   Nazwisko	opc-ua-connector-0
   Adres URL brokera OPC UA	opc.tcp://opcplc-000000:50000
   Uwierzytelnianie użytkownika	Anonymous
   Uwierzytelnianie transportu	Do not use transport authentication certificate

3. Aby zapisać definicję, wybierz pozycję Utwórz.

Interfejs wiersza polecenia platformy Azure

Uruchom następujące polecenie:

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} 

Napiwek

Użyj az connectedk8s list polecenia , aby wyświetlić listę klastrów, do których masz dostęp.

Aby dowiedzieć się więcej, zobacz az iot ops asset endpoint (Punkt końcowy zasobu az iot ops).

Ta konfiguracja wdraża nowy assetendpointprofile zasób wywoływany opc-ua-connector-0 w klastrze. Po zdefiniowaniu zasobu zasobnik łącznika OPC UA odnajduje go. Zasobnik używa punktu końcowego zasobu określonego w definicji zasobu w celu nawiązania połączenia z serwerem OPC UA.

Gdy symulator OPC PLC jest uruchomiony, dane przepływa z symulatora, do łącznika, do brokera OPC UA, a na koniec do brokera MQ.

Konfigurowanie punktu końcowego zasobu do używania nazwy użytkownika i hasła

W poprzednim przykładzie używany jest Anonymous tryb uwierzytelniania. Ten tryb nie wymaga nazwy użytkownika ani hasła.

Portal operacji usługi Azure IoT

Aby użyć UsernamePassword trybu uwierzytelniania, wykonaj następujące kroki:

1. Wykonaj kroki opisane w temacie Konfigurowanie uwierzytelniania użytkownika OPC UA przy użyciu nazwy użytkownika i hasła , aby dodać wpisy tajne dla nazwy użytkownika i hasła w usłudze Azure Key Vault, a następnie projektuj je w klastrze Kubernetes.
2. W portalu Operacje usługi Azure IoT (wersja zapoznawcza) wybierz pozycję Nazwa użytkownika i hasło dla pola Uwierzytelnianie użytkownika, aby skonfigurować punkt końcowy zasobu do używania tych wpisów tajnych. Następnie wprowadź następujące wartości w polach Odwołania do nazwy użytkownika i Hasło :

Pole	Wartość
Dokumentacja nazwy użytkownika	aio-opc-ua-broker-user-authentication/username
Odwołanie do hasła	aio-opc-ua-broker-user-authentication/password

Interfejs wiersza polecenia platformy Azure

Aby użyć UsernamePassword trybu uwierzytelniania, wykonaj następujące kroki:

1. Wykonaj kroki opisane w temacie Konfigurowanie uwierzytelniania użytkownika OPC UA przy użyciu nazwy użytkownika i hasła , aby dodać wpisy tajne dla nazwy użytkownika i hasła w usłudze Azure Key Vault, a następnie projektuj je w klastrze Kubernetes.

2. Użyj polecenia podobnego do poniższego przykładu, aby utworzyć punkt końcowy zasobu:

   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"
   

Konfigurowanie punktu końcowego zasobu do używania certyfikatu uwierzytelniania transportu

Aby skonfigurować punkt końcowy zasobu do używania certyfikatu uwierzytelniania transportu, wykonaj następujące kroki:

Portal operacji usługi Azure IoT

1. Wykonaj kroki opisane w temacie Konfigurowanie wzajemnego zaufania , aby dodać certyfikat transportu i klucz prywatny do usługi Azure Key Vault, a następnie przeprojektuj je do klastra Kubernetes.
2. W portalu Operacje usługi Azure IoT (wersja zapoznawcza) wybierz pozycję Użyj certyfikatu uwierzytelniania transportu dla pola Uwierzytelnianie transportu i wprowadź odcisk palca certyfikatu.

Interfejs wiersza polecenia platformy Azure

1. Wykonaj kroki opisane w temacie Konfigurowanie wzajemnego zaufania , aby dodać certyfikat transportu i klucz prywatny do usługi Azure Key Vault, a następnie przeprojektuj je do klastra Kubernetes.

2. Użyj polecenia podobnego do poniższego przykładu, aby utworzyć punkt końcowy zasobu:

   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"
   

Aby dowiedzieć się więcej, zobacz az iot ops asset.

Dodawanie elementu zawartości, tagów i zdarzeń

Portal operacji usługi Azure IoT

Aby dodać zasób w portalu operacje usługi Azure IoT (wersja zapoznawcza):

1. Wybierz kartę Zasoby . Przed utworzeniem jakichkolwiek zasobów zostanie wyświetlony następujący ekran:

   

   Napiwek

   Możesz użyć pola filtru, aby wyszukać zasoby.

   Wybierz pozycję Utwórz zasób.

2. Na ekranie szczegółów zasobu wprowadź następujące informacje o zasobie:

   • Nazwa zasobu
   • Punkt końcowy zasobu. Wybierz punkt końcowy zasobu z listy.
   • opis

   

3. Skonfiguruj zestaw właściwości, które chcesz skojarzyć z zasobem. Możesz zaakceptować domyślną listę właściwości lub dodać własne. Domyślnie dostępne są następujące właściwości:

   • Producent
   • Identyfikator URI producenta
   • Model
   • Kod produktu
   • Wersja sprzętu
   • Wersja oprogramowania
   • Numer seryjny
   • Identyfikator URI dokumentacji

4. Wybierz przycisk Dalej , aby przejść do strony Dodawanie tagów .

Dodawanie poszczególnych tagów do elementu zawartości

Teraz możesz zdefiniować tagi skojarzone z zasobem. Aby dodać tagi OPC UA:

1. Wybierz pozycję Dodaj tag lub dodaj tag CSV>.

2. Wprowadź szczegóły tagu:

   • Identyfikator węzła. Ta wartość to identyfikator węzła z serwera OPC UA.
   • Nazwa tagu (opcjonalnie). Ta wartość to przyjazna nazwa, której chcesz użyć dla tagu. Jeśli nie określisz nazwy tagu, identyfikator węzła będzie używany jako nazwa tagu.
   • Tryb obserwacji (opcjonalnie) z następującymi opcjami:
     • Brak
     • Miernik
     • Licznik
     • Histogram
     • Dziennik
   • Interwał próbkowania (milisekundy). Możesz zastąpić wartość domyślną tego tagu.
   • Rozmiar kolejki. Możesz zastąpić wartość domyślną tego tagu.

   

   W poniższej tabeli przedstawiono przykładowe wartości tagów, których można użyć z wbudowanym symulatorem OPC PLC:

   Identyfikator węzła	Nazwa tagu	Tryb obserwacji
   ns=3; s=FastUInt10	temperature	Brak
   ns=3; s=FastUInt100	Tag 10	Brak

3. Wybierz pozycję Zarządzaj ustawieniami domyślnymi, aby skonfigurować domyślne ustawienia telemetrii dla zasobu. Te ustawienia dotyczą wszystkich tagów OPC UA należących do zasobu. Możesz zastąpić te ustawienia dla każdego dodanego tagu. Domyślne ustawienia telemetrii obejmują:

   • Interwał próbkowania (milisekund): interwał próbkowania wskazuje najszybszą szybkość, z jaką serwer OPC UA powinien próbkować jego bazowe źródło zmian danych.
   • Interwał publikowania (milisekund): szybkość publikowania danych przez serwer OPC UA.
   • Rozmiar kolejki: głębokość kolejki do przechowywania danych próbkowania przed ich opublikowaniem.

Zbiorcze dodawanie tagów do zasobu

Jednocześnie można zaimportować do 1000 tagów OPC UA z pliku CSV:

1. Utwórz plik CSV, który wygląda podobnie do następującego przykładu:

   NodeId (identyfikator węzła)	Tagname	Interwał próbkowania milisekund	QueueSize	ObservabilityMode
   ns=3; s=FastUInt1000	Tag 1000	1000	5	Brak
   ns=3; s=FastUInt1001	Tag 1001	1000	5	Brak
   ns=3; s=FastUInt1002	Tag 1002	5000	10	Brak

2. Wybierz pozycję Dodaj tag lub plik CSV Importuj plik CSV > (.csv). Wybierz utworzony plik CSV i wybierz pozycję Otwórz. Tagi zdefiniowane w pliku CSV są importowane:

   

   Jeśli zaimportujesz plik CSV zawierający tagi, które są duplikatami istniejących tagów, w portalu Azure IoT Operations (wersja zapoznawcza) zostanie wyświetlony następujący komunikat:

   

   Możesz zastąpić zduplikowane tagi i dodać nowe tagi z pliku importu lub anulować importowanie.

3. Aby wyeksportować wszystkie tagi z elementu zawartości do pliku CSV, wybierz pozycję Eksportuj wszystko i wybierz lokalizację pliku:

   

4. Na stronie Tagi wybierz pozycję Dalej, aby przejść do strony Dodawanie zdarzeń.

Napiwek

Możesz użyć pola filtru, aby wyszukać tagi.

Interfejs wiersza polecenia platformy Azure

Użyj następującego polecenia, aby dodać zasób "termostat" przy użyciu interfejsu wiersza polecenia platformy Azure. Polecenie dodaje dwa tagi do zasobu przy użyciu parametru --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'

Podczas tworzenia zasobu przy użyciu interfejsu wiersza polecenia platformy Azure można zdefiniować następujące elementy:

• Wiele tagów przy użyciu parametru --data wiele razy.
• Wiele zdarzeń przy użyciu parametru --event wiele razy.
• Opcjonalne informacje dotyczące zasobu, takie jak:
  • Producent
  • Identyfikator URI producenta
  • Model
  • Kod produktu
  • Wersja sprzętu
  • Wersja oprogramowania
  • Numer seryjny
  • Identyfikator URI dokumentacji
• Wartości domyślne interwału próbkowania, interwału publikowania i rozmiaru kolejki.
• Oznacz wartości specyficzne dla interwału próbkowania, interwału publikowania i rozmiaru kolejki.
• Wartości specyficzne dla zdarzenia dla interwału publikowania próbkowania i rozmiaru kolejki.
• Tryb obserwacji dla każdego tagu i zdarzenia

Dodawanie poszczególnych zdarzeń do zasobu

Portal operacji usługi Azure IoT

Teraz możesz zdefiniować zdarzenia skojarzone z zasobem. Aby dodać zdarzenia OPC UA:

1. Wybierz pozycję Dodaj zdarzenie lub dodaj zdarzenie CSV>.

2. Wprowadź szczegóły zdarzenia:

   • Powiadomienie o zdarzeniach. Ta wartość jest powiadomieniem o zdarzeniach z serwera OPC UA.
   • Nazwa zdarzenia (opcjonalnie). Ta wartość to przyjazna nazwa, której chcesz użyć dla zdarzenia. Jeśli nie określisz nazwy zdarzenia, powiadomienie o zdarzeniu będzie używane jako nazwa zdarzenia.
   • Tryb obserwacji (opcjonalnie) z następującymi opcjami:
     • Brak
     • Miernik
     • Licznik
     • Histogram
     • Dziennik
   • Rozmiar kolejki. Możesz zastąpić wartość domyślną tego tagu.

   

3. Wybierz pozycję Zarządzaj ustawieniami domyślnymi, aby skonfigurować domyślne ustawienia zdarzeń dla zasobu. Te ustawienia dotyczą wszystkich zdarzeń OPC UA należących do zasobu. Możesz zastąpić te ustawienia dla każdego dodanego zdarzenia. Domyślne ustawienia zdarzeń obejmują:

   • Interwał publikowania (milisekund): szybkość publikowania danych przez serwer OPC UA.
   • Rozmiar kolejki: głębokość kolejki do przechowywania danych próbkowania przed ich opublikowaniem.

Zbiorcze dodawanie zdarzeń do zasobu

Jednocześnie można zaimportować maksymalnie 1000 zdarzeń OPC UA z pliku CSV.

Aby wyeksportować wszystkie zdarzenia z zasobu do pliku CSV, wybierz pozycję Eksportuj wszystko i wybierz lokalizację pliku.

Na stronie Zdarzenia wybierz pozycję Dalej, aby przejść do strony Przegląd.

Napiwek

Możesz użyć pola filtru, aby wyszukać zdarzenia.

Przeglądanie zmian

Przejrzyj swój zasób i szczegóły zdarzenia OPC UA oraz wprowadź potrzebne korekty:

Interfejs wiersza polecenia platformy Azure

Podczas tworzenia zasobu przy użyciu interfejsu wiersza polecenia platformy Azure można zdefiniować wiele zdarzeń przy użyciu parametru --event wiele razy. Składnia parametru --event jest podobna do parametru --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

Dla każdego zdefiniowanego zdarzenia można określić następujące elementy:

• Powiadomienie o zdarzeniach. Ta wartość jest powiadomieniem o zdarzeniach z serwera OPC UA.
• Nazwa zdarzenia. Ta wartość to przyjazna nazwa, której chcesz użyć dla zdarzenia. Jeśli nie określisz nazwy zdarzenia, powiadomienie o zdarzeniu będzie używane jako nazwa zdarzenia.
• Tryb obserwacji.
• Rozmiar kolejki.

Aktualizowanie zasobu

Portal operacji usługi Azure IoT

Znajdź i wybierz utworzony wcześniej zasób. Użyj kart Szczegóły zasobu, Tagi i Zdarzenia, aby wprowadzić wszelkie zmiany:

Na karcie Tagi można dodawać tagi, aktualizować istniejące tagi lub usuwać tagi.

Aby zaktualizować tag, wybierz istniejący tag i zaktualizuj informacje o tagu. Następnie wybierz pozycję Aktualizuj:

Aby usunąć tagi, wybierz co najmniej jeden tag, a następnie wybierz pozycję Usuń tagi:

Możesz również dodawać, aktualizować i usuwać zdarzenia i właściwości w taki sam sposób.

Po zakończeniu wprowadzania zmian wybierz pozycję Zapisz , aby zapisać zmiany.

Interfejs wiersza polecenia platformy Azure

Aby wyświetlić listę zasobów, użyj następującego polecenia:

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

Napiwek

Możesz uściślić polecenie zapytania, aby wyszukać zasoby zgodne z określonymi kryteriami. Możesz na przykład wyszukać zasoby według producenta.

Aby wyświetlić szczegóły zasobu termostatu, użyj następującego polecenia:

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

Aby zaktualizować zasób, użyj az iot ops asset update polecenia . Aby na przykład zaktualizować opis zasobu, użyj polecenia podobnego do następującego przykładu:

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

Aby wyświetlić listę tagów aktywów termostatu, użyj następującego polecenia:

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

Aby wyświetlić listę zdarzeń aktywów termostatu, użyj następującego polecenia:

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

Aby dodać nowy tag do zasobu termostatu, użyj polecenia podobnego do następującego przykładu:

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

Aby usunąć tag, użyj az iot ops asset data-point remove polecenia .

Zdarzenia zasobu można zarządzać przy użyciu az iot ops asset event poleceń .

Usuwanie elementu zawartości

Portal operacji usługi Azure IoT

Aby usunąć zasób, wybierz zasób, który chcesz usunąć. Na stronie Szczegóły zasobu wybierz pozycję Usuń. Potwierdź zmiany w celu usunięcia elementu zawartości:

Interfejs wiersza polecenia platformy Azure

Aby usunąć zasób, użyj polecenia, które wygląda jak w poniższym przykładzie:

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

Notifications

Za każdym razem, gdy wprowadzisz zmianę elementu zawartości w portalu Operacje usługi Azure IoT (wersja zapoznawcza), zostanie wyświetlone powiadomienie z raportem o stanie operacji:

Powiązana zawartość

• Omówienie brokera usługi Azure OPC UA
• Przegląd usługi Azure IoT
• az iot ops asset
• az iot ops asset endpoint