원격으로 자산 구성 관리

운영 환경에 로그인하려면 브라우저에서 운영 환경으로 이동하여 Microsoft Entra ID 자격 증명을 통해 로그인합니다.

사이트 선택

로그인하면 작업 환경에 사이트 목록이 표시됩니다. 각 사이트는 자산을 구성하고 관리할 수 있는 Azure IoT 작업 인스턴스의 컬렉션입니다. 사이트는 일반적으로 물리적 자산이 배포된 실제 위치를 나타냅니다. 사이트를 이용하면 자산을 더 쉽게 찾고 관리할 수 있습니다. IT 관리자는 인스턴스를 사이트로 그룹화하는 일을 담당합니다. 사이트에 할당되지 않은 모든 Azure IoT 작업 인스턴스는 할당되지 않은 인스턴스 노드에 ​​표시됩니다. 사용할 사이트를 선택합니다.

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

인스턴스 선택

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

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

az login

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

   

   팁

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

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

   필드	값
   속성	opc-ua-connector-0
   OPC UA용 커넥터 URL	opc.tcp://opcplc-000000:50000
   사용자 인증	Anonymous

3. 정의를 저장하려면 만들기를 선택합니다.

다음 명령을 실행합니다.

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} 

자세한 내용은 az iot ops 자산 엔드포인트를 참조하세요.

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

1. 사용자 이름 및 암호를 사용하여 OPC UA 사용자 인증 구성의 단계에 따라 Azure Key Vault에서 사용자 이름 및 암호에 대한 비밀을 추가하고 Kubernetes 클러스터에 프로젝션합니다.

2. 다음 예제와 같은 명령을 사용하여 자산 엔드포인트를 만듭니다.

   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"
   

운영 환경에 자산을 추가하려면 다음을 수행합니다.

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

   

   팁

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

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

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

   • 자산 엔드포인트입니다. 목록에서 자산 엔드포인트를 선택합니다.
   • 자산 이름
   • 설명
   • 자산이 게시하는 MQTT 항목입니다. 기본값은 <namespace>/data/<asset-name>입니다.

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

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

   

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

자산에 개별 태그 추가

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

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

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

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

   

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

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

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

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

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

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

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

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

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

   

   기존 태그와 중복되는 태그가 포함된 CSV 파일을 가져오면 운영 환경에 다음 메시지가 표시됩니다.

   

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

3. 자산에서 모든 태그를 CSV 파일로 내보내려면 모두 내보내기를 선택하고 파일의 위치를 선택합니다.

   

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

다음 명령을 사용하여 Azure CLI를 사용하여 "자동 온도 조절기" 자산을 추가합니다. 명령은 다음 명령을 사용하여 자산에 두 개의 태그/데이터포인트를 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}

Azure CLI를 사용하여 자산을 만들 때 다음을 정의할 수 있습니다.

• 명령을 여러 번 사용하여 여러 데이터 요소/태그를 point add 지정합니다.
• --event 매개 변수를 여러 번 사용하여 여러 이벤트.
• 다음과 같은 자산에 대한 선택적 정보:
  • 제조업체
  • 제조업체 URI
  • 모델
  • 제품 코드
  • 하드웨어 버전
  • 소프트웨어 버전
  • 일련 번호
  • 문서 URI
• 샘플링 간격, 게시 간격, 큐 크기에 대한 기본값.
• 샘플링 간격, 게시 간격 및 큐 크기에 대한 데이터 요소별 값입니다.
• 샘플링 게시 간격 및 큐 크기에 대한 이벤트별 값.
• 각 태그 및 이벤트에 대한 가시성 모드

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

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

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

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

   

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

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

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

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

자산에서 모든 이벤트를 CSV 파일로 내보내려면 모두 내보내기를 선택하고 파일의 위치를 선택합니다.

이벤트 페이지에서 다음을 선택하여 리뷰 페이지로 이동합니다.

변경 사항 검토

자산과 OPC UA 태그 및 이벤트 세부 정보를 검토하고 필요한 모든 조정을 수행합니다.

Azure CLI를 사용하여 자산을 만들 때 매개 변수를 여러 번 사용하여 여러 이벤트를 정의할 --event 수 있습니다.

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 서버의 이벤트 알림입니다.
• 이벤트 이름입니다. 이 값은 이벤트에 사용할 친숙한 이름입니다. 이벤트 이름을 지정하지 않으면 이벤트 알림이 이벤트 이름으로 사용됩니다.
• 가시성 모드.
• 큐 크기.

z iot ops 자산 이벤트 명령을 사용하여자산에서 이벤트를 추가하고 제거할 수도 있습니다.

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

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

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

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

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

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

자산을 나열하려면 다음 명령을 사용합니다.

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 dataset show --asset thermostat --name default -g {your resource group}

자동 온도 조절기 자산의 이벤트를 나열하려면 다음 명령을 사용합니다.

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

자동 온도 조절기 자산에 새 태그를 추가하려면 다음 예제와 같은 명령을 사용합니다.

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

태그를 삭제하려면 az iot ops asset dataset point remove 명령을 사용합니다.

az iot ops asset event 명령을 사용하여 자산의 이벤트를 관리할 수 있습니다.

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

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

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