버전 유형 운영 체제 요구 사항 의존성 구성 입력 데이터 출력 데이터 로컬 로그 파일 문제 해결 및 디버깅 라이선스 Changelog 다음 사항도 참조하세요.

IoT SiteWise OPC - UA 컬렉터

IoT SiteWise OPC -UA 수집기 구성 요소 (aws.iot.SiteWiseEdgeCollectorOpcua) 를 사용하면 AWS IoT SiteWise 게이트웨이가 로컬 OPC -UA 서버에서 데이터를 수집할 수 있습니다.

이 구성 요소를 사용하면 AWS IoT SiteWise 게이트웨이를 여러 -UA 서버에 연결할 수 있습니다. OPC AWS IoT SiteWise 게이트웨이에 대한 자세한 내용은 사용 설명서의 AWS IoT SiteWise Edge에서의 사용을 참조하십시오.AWS IoT SiteWise

버전

이 구성 요소의 버전은 다음과 같습니다.

2.5.x
2.4.x
2.3.x
2.2.x
2.1.x
2.0.x

유형

이 구성 요소는 일반 구성 요소 () aws.greengrass.generic 입니다. Greengrass 핵은 구성 요소의 라이프사이클 스크립트를 실행합니다.

자세한 내용은 구성 요소 유형 단원을 참조하십시오.

운영 체제

이 구성 요소는 다음 운영 체제를 실행하는 코어 디바이스에 설치할 수 있습니다.

Linux
Windows

요구 사항

이 구성 요소의 요구 사항은 다음과 같습니다.

Greengrass 코어 디바이스는 다음 플랫폼 중 하나에서 실행되어야 합니다.
- 운영체제: Ubuntu 18.04 이상
  
  아키텍처: x86_64 (AMD64) 또는 (Aarch64) ARMv8
- OS: 레드햇 엔터프라이즈 리눅스 (8) RHEL
  
  아키텍처: x86_64 (AMD64) 또는 ARMv8 (Arch64)
- 운영체제: Amazon Linux 2
  
  아키텍처: x86_64 () 또는 (아치64) AMD64 ARMv8
- 운영체제: Debian 11
  
  아키텍처: x86_64 () 또는 (아치64) AMD64 ARMv8
- 운영 체제: 윈도우 서버 2019 이상
  
  아키텍처: x86_64 () AMD64
Greengrass 코어 디바이스는 -UA 서버에 대한 아웃바운드 네트워크 연결을 허용해야 합니다. OPC

의존성

구성 요소를 배포할 때 호환되는 버전의 AWS IoT Greengrass 종속 항목도 배포합니다. 즉, 구성 요소를 성공적으로 배포하려면 구성 요소 및 해당 종속성에 대한 요구 사항을 모두 충족해야 합니다. 이 섹션에는 이 구성 요소의 릴리스된 버전에 대한 종속성과 각 종속성에 대한 구성 요소 버전을 정의하는 시맨틱 버전 제약 조건이 나열되어 있습니다. 콘솔에서 구성 요소의 각 버전에 대한 종속성을 볼 수도 있습니다.AWS IoT Greengrass 구성 요소 세부 정보 페이지에서 종속성 목록을 찾아보십시오.

다음 표에는 이 구성 요소의 모든 버전에 대한 종속성이 나열되어 있습니다.

종속성	호환되는 버전	종속성 유형
그린그래스 핵	>=2.3.0 <3.0.0	하드
스트림 관리자	>=2.3.0 2.0.10<3.0.0	하드
시크릿 매니저	>2.0.10 =2.0.8 <3.0.0	하드

구성 요소 종속성에 대한 자세한 내용은 구성 요소 레시피 참조를 참조하십시오.

구성

이 구성 요소에는 구성 매개변수가 없습니다.

AWS IoT SiteWise 콘솔을 사용하거나 IoT SiteWise OPC -UA 컬렉터 구성 요소를 구성할 수 있습니다. API 자세한 내용은 AWS IoT SiteWise 사용 설명서의 4단계: 데이터 소스 추가 - 선택 사항을 참조하십시오.

입력 데이터

이 구성 요소는 다음 형식의 데이터만 받아들이고 다른 모든 형식은 무시되고 삭제됩니다. 아래 표는 OPC UA 데이터 유형을 해당 데이터 유형과 매핑합니다 SiteWise .

SiteWise 데이터 유형	OPCUA 데이터 유형	설명
`STRING`	`String` `Guid` `XmlElement`	최대 길이가 1024바이트인 문자열입니다.
`INTEGER`	`SByte` `Byte` `Int16` `UInt16` `Int32` `UInt32`* `Int64`*	범위가 1인 부호있는 32비트 정수. `-2,147,483,648 to 2,147,483,647`
`DOUBLE`	`UInt32`* `Int64`* `Float` `Double`	범위가 0이고 배정밀도가 두 배인 부동 소수점 숫자입니다`–10^100 to 10^100`. `IEEE 754`
`BOOLEAN`	`Boolean`	`true` 또는 `false`

* OPC UA SiteWise 데이터 유형 UInt32 및 Int64 의 경우 해당 값을 나타낼 수 INTEGER 있으면 해당 데이터 유형이 SiteWise 되고 그렇지 않으면 해당 데이터 유형이 됩니다DOUBLE.

출력 데이터

이 구성 요소는 AWS IoT Greengrass 스트림 관리자에 BatchPutAssetPropertyValue 메시지를 기록합니다. 자세한 내용은 BatchPutAssetPropertyValue AWS IoT SiteWiseAPI참조를 참조하십시오.

로컬 로그 파일

이 구성 요소는 다음 로그 파일을 사용합니다.

이 구성 요소의 로그를 보려면

코어 기기에서 다음 명령을 실행하여 이 구성 요소의 로그 파일을 실시간으로 확인합니다. 교체 /greengrass/v2 또는 C:\greengrass\v2 AWS IoT Greengrass 루트 폴더 경로와 함께
Linux
```
sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log -Tail 10 -Wait
```

문제 해결 및 디버깅

이 구성 요소에는 고객이 문제를 식별하고 해결하는 데 도움이 되는 새 이벤트 로그가 포함되어 있습니다. 로그 파일은 로컬 로그 파일과는 별개이며 다음 위치에서 찾을 수 있습니다. 바꾸기 /greengrass/v2 또는 C:\greengrass\v2 AWS IoT Greengrass 루트 폴더 경로와 함께

이 로그에는 자세한 정보와 문제 해결 지침이 포함되어 있습니다. 문제 해결 정보는 문제 해결 방법에 대한 설명과 함께 진단과 함께 제공되며 경우에 따라 추가 정보로 연결되는 링크와 함께 제공됩니다. 진단 정보에는 다음이 포함됩니다.

심각도 수준
Timestamp
추가 이벤트별 정보

예 로그 예


dataSourceConnectionSuccess:
  Summary: Successfully connected to OpcUa server
  Level: INFO
  Timestamp: '2023-06-15T21:04:16.303Z'
  Description: Successfully connected to the data source.
  AssociatedMetrics:
  - Name: FetchedDataStreams
    Description: The number of fetched data streams for this data source
    Value: 1.0
    Namespace: IoTSiteWise
    Dimensions:
    - Name: SourceName
      Value: SourceName{value=OPC-UA Server}
    - Name: ThingName
      Value: test-core
  AssociatedData:
  - Name: DataSourceTrace
    Description: Name of the data source
    Data:
    - OPC-UA Server
  - Name: EndpointUri
    Description: The endpoint to which the connection was attempted.
    Data:
    - '"opc.tcp://10.0.0.1:1234"'

라이선스

이 구성 요소는 Greengrass Core 소프트웨어 라이센스 계약에 따라 릴리스됩니다.

Changelog

다음 표에는 각 구성 요소 버전의 변경 사항이 설명되어 있습니다.

버전	변경
2.5.0	새로운 기능 간단한 배열과 DateTime 값을 문자열로 변환하는 데이터 소스 옵션을 추가합니다. OPC-UA 서버에서 데이터를 수집할 때 소스 또는 서버 타임스탬프를 선택하는 속성 그룹 옵션을 추가합니다. 버그 수정 및 개선 소스 타임스탬프를 사용하도록 기본 폴링 구성을 재설정합니다.
2.4.2	버그 수정 및 개선 OPCUA 서버 검색 중에 노드가 여러 번 발견될 수 있는 문제를 수정합니다. 각 스냅샷 데이터 포인트의 타임스탬프가 새로워지도록 스냅샷 기능을 수정합니다.
2.4.1	버그 수정 및 개선 프록시 지원 관련 문제를 수정합니다. 스레드 정리가 실패하여 데이터가 차단되는 문제를 수정했습니다.
2.4.0	새로운 기능 문제를 쉽게 식별하고 해결할 수 있도록 이벤트 로그를 추가합니다. 버그 수정 및 개선 -UA 사양 버전 1.05를 사용하는 OPC -UA 서버에 연결할 때 인증서 오류가 발생했던 OPC -UA 클라이언트 관련 문제를 수정합니다OPC.
2.3.0	새로운 기능 Linux에서 Greengrass 뉴클리우스 HTTP프록시 구성에 대한 지원을 추가합니다. 버그 수정 및 개선 보안 문제를 수정합니다 (CVE-2019-19135).
2.2.0	새로운 기능 Linux 아키텍처에 데이터 수집 팩을 설치하기 위한 지원을 추가합니다. ARMv8 Linux의 최소 요구 사항ARMv8: 메모리: 4GB CPU: ARM 코텍스-A72 또는 이에 상응하는 사양 버그 수정 및 개선 노드 검색 프로세스의 메트릭 로깅을 개선합니다. 지원되지 않는 데이터 유형의 처리를 개선합니다. 데이터 스트림 오류 로깅을 개선합니다.
2.1.3	새로운 기능 윈도우 서버 2019 이상에 대한 지원을 추가합니다. 버그 수정 및 개선 지원되지 않는 장치에 이 구성 요소를 배포할 때 나타나는 오류 메시지를 개선합니다.
2.1.1	새로운 기능 다음과 같은 구독 속성을 구성하기 위한 지원을 추가합니다. DataChangeTrigger‐ 데이터 변경 알림을 시작하는 조건을 정의할 수 있습니다. QueueSize‐ 모니터링 항목에 대한 알림이 대기열에 있는 특정 지표에 대한 OPC ‐UA 서버의 대기열 깊이. PublishingIntervalMilliseconds‐ 구독이 생성될 때 지정된 게시 주기 간격 (밀리초) SnapshotFrequencyMilliseconds ‐ AWS IoT SiteWise Edge가 꾸준한 데이터 스트림을 수집하도록 스냅샷 빈도 제한 시간 설정을 구성할 수 있습니다. 이 버전은 품질 데이터 수집을 지원하고 다음 데이터 `BAD` 품질을 기반으로 데이터를 필터링합니다. `UNCERTAIN`품질 데이터 `BAD`품질 데이터 버그 수정 및 개선 고객 지표 개선. 암호화가 활성화된 상태로 서버에 연결할 때 가끔 문제가 발생했던 보안 인코딩을 수정합니다. 속성 그룹이 업데이트되지 않던 문제를 수정합니다.
2.0.3	버그 수정 및 개선
2.0.2	Edge와의 자산 우선 순위 동기화에 대한 버그 수정 및 개선
2.0.1	초기 버전

다음 사항도 참조하세요.

이게 AWS IoT SiteWise뭐야? AWS IoT SiteWise 사용 설명서에서.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

토큰 교환 서비스

IoT SiteWise OPC-UA 데이터 소스 시뮬레이터