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

IoT SiteWise OPC UA 수집기

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

이 구성 요소를 사용하면 AWS IoT SiteWise 게이트웨이를 여러 OPC UA 서버에 연결할 수 있습니다. AWS IoT SiteWise 게이트웨이에 대한 자세한 내용은 AWS IoT SiteWise 사용 설명서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 nucleus는 구성 요소의 수명 주기 스크립트를 실행합니다.

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

운영 체제

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

Linux
Windows

요구 사항

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

Greengrass 코어 디바이스가 다음 플랫폼 중 하나에서 실행되어야 합니다.
- os: Ubuntu 18.04 이상
  
  아키텍처: x86_64(AMD64) 또는 ARMv8 (Aarch64)
- os: Red Hat Enterprise Linux(RHEL) 8
  
  아키텍처: x86_64(AMD64) 또는 ARMv8 (Aarch64)
- os: Amazon Linux 2
  
  아키텍처: x86_64(AMD64) 또는 ARMv8 (Aarch64)
- os: Debian 11
  
  아키텍처: x86_64(AMD64) 또는 ARMv8 (Aarch64)
- os: Windows Server 2019 이상
  
  아키텍처: x86_64(AMD64)
Greengrass 코어 디바이스는 OPC UA 서버에 대한 아웃바운드 네트워크 연결을 허용해야 합니다.

종속성

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

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

종속성	호환 버전	종속성 유형
Greengrass nucleus	>=2.3.0 <3.0.0	하드
스트림 관리자	>2.0.10<3.0.0	하드
보안 암호 관리자	>=2.0.8 <3.0.0	하드

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

구성

이 구성 요소에는 구성 파라미터가 없습니다.

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

입력 데이터

이 구성 요소는 다음 형식의 데이터만 허용하며, 다른 모든 데이터는 무시되고 삭제됩니다. 아래 표는 OPC UA 데이터 형식을 SiteWise 이에 상응하는에 매핑합니다.

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

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

출력 데이터

이 구성 요소는 AWS IoT Greengrass 스트림 관리자에게 BatchPutAssetPropertyValue 메시지를 작성합니다. 자세한 내용은 AWS IoT SiteWise API 참조의 BatchPutAssetPropertyValue 섹션을 참조하세요.

로컬 로그 파일

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

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

코어 디바이스에서 다음 명령을 실행하여 실시간으로 이 구성 요소의 로그 파일을 봅니다. /greengrass/v2 또는를 AWS IoT Greengrass 루트 폴더의 경로C:\greengrass\v2로 바꿉니다.
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 또는를 AWS IoT Greengrass 루트 폴더의 경로C:\greengrass\v2로 바꿉니다.

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

심각도 수준
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 코어 소프트웨어 라이선스 계약에 따라 릴리스됩니다.

Changelog

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

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

다음 사항도 참조하세요.

AWS IoT SiteWise 사용 설명서의 란 무엇입니까 AWS IoT SiteWise?

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

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

문서 규칙

토큰 교환 서비스

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