원격으로 자산 구성 관리

Important

Azure IoT 작업 미리 보기 - Azure Arc에서 지원되는 Azure IoT 작업은 현재 미리 보기로 제공됩니다. 프로덕션 환경에서는 이 미리 보기 소프트웨어를 사용하면 안 됩니다.

베타, 미리 보기로 제공되거나 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 약관은 Microsoft Azure 미리 보기에 대한 추가 사용 약관을 참조하세요.

Azure IoT Operations 미리 보기의 자산은 실제 자산을 나타내기 위해 만드는 논리적 엔터티입니다. Azure IoT Operations 자산에는 해당 동작 및 특성을 설명하는 속성, 태그, 이벤트가 있을 수 있습니다.

OPC UA 서버는 자산과 통신하는 소프트웨어 애플리케이션입니다. OPC UA 서버는 데이터 요소를 나타내는 OPC UA 태그를 노출합니다. OPC UA 태그는 자산의 상태, 성능, 품질, 조건에 대한 실시간 데이터 또는 기록 데이터를 제공합니다.

자산 엔드포인트는 OPC UA 서버를 OPC UA 커넥터 모듈에 연결하는 Kubernetes 클러스터의 사용자 지정 리소스입니다. 이 연결을 사용하면 OPC UA 커넥터가 자산의 데이터 요소에 액세스할 수 있습니다. 자산 엔드포인트가 없으면 데이터는 OPC UA 서버에서 Azure IoT OPC UA Broker 미리 보기 인스턴스 및 Azure IoT MQ 미리 보기 인스턴스로 흐를 수 없습니다. 클러스터에서 사용자 지정 리소스를 구성한 후 다운스트림 OPC UA 서버에 연결이 설정되고 서버는 원격 분석을 OPC UA Broker 인스턴스로 전달합니다.

사이트는 Azure IoT 작업 인스턴스의 컬렉션입니다. 사이트는 인스턴스를 구성하고 액세스 제어를 관리하는 데 도움이 됩니다. IT 관리자는 사이트를 만들고, 인스턴스를 사이트에 할당하고, 조직의 OT 사용자에게 액세스 권한을 부여합니다.

Azure IoT 작업(미리 보기) 포털에서 인스턴스는 Azure IoT 작업 클러스터를 나타냅니다. 인스턴스에는 하나 이상의 자산 엔드포인트가 있을 수 있습니다.

이 문서에서는 Azure IoT Operations(미리 보기) 포털 및 Azure CLI를 사용하여 다음을 수행하도록 하는 방법을 설명합니다.

• Azure IoT 작업 인스턴스에 자산을 연결하는 자산 엔드포인트를 정의합니다.
• 자산을 추가하고 해당 태그와 이벤트를 정의하여 OPC UA 서버에서 Azure IoT MQ 브로커로의 데이터 흐름을 사용하도록 설정합니다.

이러한 자산, 태그, 이벤트는 OPC UA 서버의 인바운드 데이터를 MQ Broker 및 Azure IoT 데이터 프로세서 미리 보기 파이프라인에서 사용할 수 있는 친숙한 이름으로 매핑합니다.

필수 조건

자산 엔드포인트를 구성하려면 Azure IoT Operations의 실행 중인 인스턴스가 필요합니다.

로그인

Azure IoT Operations 포털

Azure IoT 작업(미리 보기) 포털에 로그인하려면 브라우저에서 Azure IoT 작업(미리 보기) 포털로 이동하고 Microsoft Entra ID 자격 증명을 사용하여 로그인합니다.

사이트 선택

로그인하면 포털에 사용자의 액세스 권한이 있는 사이트 목록이 표시됩니다. 각 사이트는 자산을 구성할 수 있는 Azure IoT 작업 인스턴스의 컬렉션입니다. IT 관리자는 사이트에 인스턴스를 구성하고 조직의 OT 사용자에게 액세스 권한을 부여할 책임이 있습니다. 사이트에 속하지 않은 인스턴스는 할당되지 않은 인스턴스 노드에 표시됩니다. 사용할 사이트를 선택합니다.

팁

필터 상자를 사용하여 사이트를 검색할 수 있습니다.

사이트가 표시되지 않으면 올바른 Azure Active Directory 테넌트에 있지 않을 수 있습니다. 포털의 오른쪽 위 메뉴에서 테넌트 변경이 가능합니다. 계속 사이트가 보이지 않는다면 추가된 사이트가 없다는 뜻입니다. IT 관리자에게 문의하여 액세스를 요청하세요.

인스턴스 선택

사이트를 선택하면 포털에 사이트의 일부인 Azure IoT 작업 인스턴스 목록이 표시됩니다. 사용할 인스턴스를 선택합니다.

팁

필터 상자를 사용하여 인스턴스를 검색할 수 있습니다.

Azure CLI

az iot ops asset 명령을 사용하기 전에 Azure IoT Operations 배포가 포함된 구독에 로그인합니다.

az login

자산 엔드포인트 만들기

기본적으로 Azure IoT Operations 배포에는 기본 제공 OPC PLC 시뮬레이터가 포함됩니다. 기본 제공 OPC PLC 시뮬레이터를 사용하는 자산 엔드포인트를 만들려면 다음을 수행합니다.

Azure IoT Operations 포털

1. 자산 엔드포인트를 선택한 다음, 자산 엔드포인트 만들기를 선택합니다.

   

   팁

   필터 상자를 사용하여 자산 엔드포인트를 검색할 수 있습니다.

2. 다음 엔드포인트 정보를 입력합니다.

   필드	값
   속성	opc-ua-connector-0
   OPC UA Broker URL	opc.tcp://opcplc-000000:50000
   사용자 인증	Anonymous
   전송 인증	Do not use transport authentication certificate

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 자산 엔드포인트를 참조하세요.

이 구성은 opc-ua-connector-0라는 새 assetendpointprofile 리소스를 클러스터에 배포합니다. 자산을 정의한 후 OPC UA 커넥터 Pod에서 해당 자산을 검색합니다. Pod는 자산 정의에서 지정한 자산 엔드포인트를 사용하여 OPC UA 서버에 연결합니다.

OPC PLC 시뮬레이터가 실행 중일 때 데이터는 시뮬레이터에서 커넥터, OPC UA 브로커, 마지막으로 MQ broker로 흐릅니다.

사용자 이름 및 암호를 사용하도록 자산 엔드포인트 구성

이전 예제에서는 Anonymous 인증 모드를 사용합니다. 이 모드에는 사용자 이름이나 암호가 필요하지 않습니다.

Azure IoT Operations 포털

UsernamePassword 인증 모드를 사용하려면 다음 단계를 완료합니다.

1. 사용자 이름 및 암호를 사용하여 OPC UA 사용자 인증 구성의 단계에 따라 Azure Key Vault에서 사용자 이름 및 암호에 대한 비밀을 추가하고 Kubernetes 클러스터에 프로젝션합니다.
2. Azure IoT 작업(미리 보기) 포털에서 사용자 인증 필드에 대한 사용자 이름 및 암호를 선택하여 이러한 비밀을 사용하도록 자산 엔드포인트를 구성합니다. 그런 다음, 사용자 이름 참조 및 암호 참조 필드에 다음 값을 입력합니다.

필드	값
사용자 이름 참조	aio-opc-ua-broker-user-authentication/username
암호 참조	aio-opc-ua-broker-user-authentication/password

Azure CLI

UsernamePassword 인증 모드를 사용하려면 다음 단계를 완료합니다.

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"
   

전송 인증 인증서를 사용하도록 자산 엔드포인트 구성

전송 인증 인증서를 사용하도록 자산 엔드포인트를 구성하려면 다음 단계를 완료합니다.

Azure IoT Operations 포털

1. 상호 신뢰 구성의 단계에 따라 Azure Key Vault에 전송 인증서와 프라이빗 키를 추가하고 Kubernetes 클러스터에 프로젝션합니다.
2. Azure IoT 작업(미리 보기) 포털의 전송 인증 필드에서 전송 인증 인증서 사용을 선택하고 인증서 지문을 입력합니다.

Azure CLI

1. 상호 신뢰 구성의 단계에 따라 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"
   

자세한 내용은 az iot ops 자산을 참조하세요.

자산, 태그, 이벤트 추가

Azure IoT Operations 포털

Azure IoT 작업(미리 보기) 포털에서 자산을 추가하려면 다음을 수행합니다.

1. 자산 탭을 선택합니다. 자산을 만들기 전에 다음 화면이 표시됩니다.

   

   팁

   필터 상자를 사용하여 자산을 검색할 수 있습니다.

   자산 만들기를 선택합니다.

2. 자산 세부 정보 화면에서 다음 자산 정보를 입력합니다.

   • 자산 이름
   • 자산 엔드포인트입니다. 목록에서 자산 엔드포인트를 선택합니다.
   • 설명

   

3. 자산과 연결하려는 속성 집합을 구성합니다. 속성의 기본 목록을 수락하거나 직접 목록을 추가할 수 있습니다. 기본적으로 다음 속성을 사용할 수 있습니다.

   • 제조업체
   • 제조업체 URI
   • 모델
   • 제품 코드
   • 하드웨어 버전
   • 소프트웨어 버전
   • 일련 번호
   • 문서 URI

4. 다음을 선택하여 태그 추가 페이지로 이동합니다.

자산에 개별 태그 추가

이제 자산과 연결된 태그를 정의할 수 있습니다. OPC UA 태그를 추가합니다.

1. 태그 또는 CSV 추가 > 태그 추가를 선택합니다.

2. 태그 세부 정보를 입력합니다.

   • 노드 ID. 이 값은 OPC UA 서버의 노드 ID입니다.
   • 태그 이름(선택 사항). 이 값은 태그에 사용할 친숙한 이름입니다. 태그 이름을 지정하지 않으면 노드 ID가 태그 이름으로 사용됩니다.
   • 다음 선택 항목이 있는 가시성 모드(선택 사항):
     • 없음
     • 계기
     • 카운터
     • 히스토그램
     • 로그
   • 샘플링 간격(밀리초). 이 태그의 기본값을 재정의할 수 있습니다.
   • 큐 크기. 이 태그의 기본값을 재정의할 수 있습니다.

   

   다음 표에서는 기본 제공 OPC PLC 시뮬레이터와 함께 사용할 수 있는 태그 값의 몇 가지 예를 보여 줍니다.

   노드 ID	태그 이름	가시성 모드
   ns=3;s=FastUInt10	온도	없음
   ns=3;s=FastUInt100	태그 10	없음

3. 기본 설정 관리를 선택하여 자산에 대한 기본 원격 분석 설정을 구성합니다. 이러한 설정은 자산에 속하는 모든 OPC UA 태그에 적용됩니다. 추가하는 각 태그에 대해 이러한 설정을 재정의할 수 있습니다. 기본 원격 분석 설정은 다음과 같습니다.

   • 샘플링 간격(밀리초): 샘플링 간격은 OPC UA 서버가 데이터 변경을 위해 기본 원본을 샘플링해야 하는 가장 빠른 속도를 나타냅니다.
   • 게시 간격(밀리초): OPC UA 서버에서 데이터를 게시하는 속도입니다.
   • 큐 크기: 샘플링 데이터를 게시하기 전에 저장할 큐의 깊이입니다.

자산에 태그를 대량으로 추가

CSV 파일에서 한 번에 최대 1,000개의 OPC UA 태그를 가져올 수 있습니다.

1. 다음 예제와 같은 CSV 파일을 만듭니다.

   NodeID	TagName	샘플링 간격 밀리초	QueueSize	ObservabilityMode
   ns=3;s=FastUInt1000	태그 1000	1000	5	없음
   ns=3;s=FastUInt1001	태그 1001	1000	5	없음
   ns=3;s=FastUInt1002	태그 1002	5000	10	없음

2. 태그 또는 CSV 추가 > CSV(.csv) 파일 가져오기를 선택합니다. 만든 CSV 파일을 선택하고 열기를 선택합니다. CSV 파일에 정의된 태그를 가져옵니다.

   

   기존 태그와 중복되는 태그가 포함된 CSV 파일을 가져오면 Azure IoT 작업(미리 보기) 포털에 다음 메시지가 표시됩니다.

   

   중복 태그를 바꾸고 가져오기 파일에서 새 태그를 추가하거나 가져오기를 취소할 수 있습니다.

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
• 샘플링 간격, 게시 간격, 큐 크기에 대한 기본값.
• 샘플링 간격, 게시 간격, 큐 크기에 대한 특정 값 태그.
• 샘플링 게시 간격 및 큐 크기에 대한 이벤트별 값.
• 각 태그 및 이벤트에 대한 가시성 모드

자산에 개별 이벤트 추가

Azure IoT Operations 포털

이제 자산과 연결된 이벤트를 정의할 수 있습니다. OPC UA 이벤트를 추가하려면 다음을 수행합니다.

1. 이벤트 또는 CSV 추가 > 이벤트 추가를 선택합니다.

2. 이벤트 세부 정보를 입력합니다.

   • 이벤트 알림. 이 값은 OPC UA 서버의 이벤트 알림입니다.
   • 이벤트 이름(선택 사항). 이 값은 이벤트에 사용할 친숙한 이름입니다. 이벤트 이름을 지정하지 않으면 이벤트 알림이 이벤트 이름으로 사용됩니다.
   • 다음 선택 항목이 있는 가시성 모드(선택 사항):
     • 없음
     • 계기
     • 카운터
     • 히스토그램
     • 로그
   • 큐 크기. 이 태그의 기본값을 재정의할 수 있습니다.

   

3. 기본 설정 관리를 선택하여 자산에 대한 기본 이벤트 설정을 구성합니다. 이러한 설정은 자산에 속하는 모든 OPC UA 이벤트에 적용됩니다. 추가하는 각 이벤트에 대해 이러한 설정을 재정의할 수 있습니다. 기본 이벤트 설정은 다음과 같습니다.

   • 게시 간격(밀리초): OPC UA 서버에서 데이터를 게시하는 속도입니다.
   • 큐 크기: 샘플링 데이터를 게시하기 전에 저장할 큐의 깊이입니다.

자산에 이벤트를 대량으로 추가

CSV 파일에서 한 번에 최대 1,000개의 OPC UA 이벤트를 가져올 수 있습니다.

자산에서 모든 이벤트를 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 IoT Operations 포털

이전에 만든 자산을 찾아 선택합니다. 자산 세부 정보, 태그 및 이벤트 탭을 사용하여 변경합니다.

태그 탭에서 태그를 추가하거나, 기존 태그를 업데이트하거나, 태그를 제거할 수 있습니다.

태그를 업데이트하려면 기존 태그를 선택하고 태그 정보를 업데이트합니다. 그런 다음, 업데이트를 선택합니다.

태그를 제거하려면 하나 이상의 태그를 선택한 다음, 태그 제거를 선택합니다.

같은 방식으로 이벤트와 속성을 추가, 업데이트, 삭제할 수도 있습니다.

변경 작업을 마쳤으면 저장을 선택하여 변경 내용을 저장합니다.

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 IoT Operations 포털

자산을 삭제하려면 삭제할 자산을 선택합니다. 자산 세부 정보 페이지에서 삭제를 선택합니다. 변경 내용을 확인하여 자산을 삭제합니다.

Azure CLI

자산을 삭제하려면 다음 예제와 같은 명령을 사용합니다.

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

알림

Azure IoT 작업(미리 보기) 포털에서 자산을 변경할 때마다 작업 상태를 보고하는 알림이 표시됩니다.

관련 콘텐츠

• Azure OPC UA Broker 개요
• Azure IoT Akri 개요
• az iot ops 자산
• az iot ops 자산 엔드포인트