기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# IoT SiteWise OPC UA 수집기
<a name="iotsitewise-opcua-collector-component"></a>

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 에서 사용을](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) 참조하세요.

**Topics**
+ [버전](#iotsitewise-opcua-collector-component-versions)
+ [유형](#iotsitewise-opcua-collector-component-type)
+ [운영 체제](#iotsitewise-opcua-collector-component-os-support)
+ [요구 사항](#iotsitewise-opcua-collector-component-requirements)
+ [종속성](#iotsitewise-opcua-collector-component-dependencies)
+ [구성](#iotsitewise-opcua-collector-component-configuration)
+ [입력 데이터](#iotsitewise-opcua-collector-component-input-data)
+ [출력 데이터](#iotsitewise-opcua-collector-component-output-data)
+ [로컬 로그 파일](#iotsitewise-opcua-collector-component-log-file)
+ [라이선스](#iotsitewise-opcua-collector-component-licenses)
+ [Changelog](#iotsitewise-opcua-collector-component-changelog)
+ [다음 사항도 참조하세요.](#iotsitewise-opcua-collector-component-see-also)

## 버전
<a name="iotsitewise-opcua-collector-component-versions"></a>

이 구성 요소에는 다음과 같은 버전이 있습니다.
+ 3.1.x
+ 3.0.x
+ 2.6.x
+ 2.5.x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## 유형
<a name="iotsitewise-opcua-collector-component-type"></a>

<a name="public-component-type-generic"></a>이 <a name="public-component-type-generic-phrase"></a>구성 요소는 일반 구성 요소(`aws.greengrass.generic`)입니다. [Greengrass nucleus](greengrass-nucleus-component.md)는 구성 요소의 수명 주기 스크립트를 실행합니다.

<a name="public-component-type-more-information"></a>자세한 내용은 [구성 요소 유형](develop-greengrass-components.md#component-types) 단원을 참조하십시오.

## 운영 체제
<a name="iotsitewise-opcua-collector-component-os-support"></a>

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

## 요구 사항
<a name="iotsitewise-opcua-collector-component-requirements"></a>

이 구성 요소의 요구 사항은 다음과 같습니다.
+ Greengrass 코어 디바이스가 다음 플랫폼 중 하나에서 실행되어야 합니다.
  + OS: Ubuntu 20.04 이상

    아키텍처: x86\$164(AMD64) 또는 ARMv8(Aarch64)
  + 운영체제: Red Hat Enterprise Linux (RHEL) 8

    아키텍처: x86\$164(AMD64) 또는 ARMv8(Aarch64)
  + OS: Amazon Linux 2

    아키텍처: x86\$164(AMD64) 또는 ARMv8(Aarch64)
  + OS: Debian 11

    아키텍처: x86\$164(AMD64) 또는 ARMv8(Aarch64)
  + OS: Windows Server 2019 이상

    아키텍처: x86\$164(AMD64)
+ Greengrass 코어 디바이스에서 OPC UA 서버에 대한 아웃바운드 네트워크 연결을 허용해야 합니다.

## 종속성
<a name="iotsitewise-opcua-collector-component-dependencies"></a>

구성 요소를 배포할 때는 호환되는 버전의 종속성 AWS IoT Greengrass 도 배포합니다. 즉, 구성 요소를 성공적으로 배포하려면 구성 요소 및 모든 해당 종속성에 대한 요구 사항을 충족해야 합니다. 이 섹션에는 이 구성 요소의 [릴리스된 버전](#iotsitewise-opcua-collector-component-changelog)에 대한 종속성과 각 종속성에 대한 구성 요소 버전을 정의하는 의미 체계 버전 제약 조건이 나열되어 있습니다. [AWS IoT Greengrass 콘솔](https://console.aws.amazon.com//greengrass)에서도 각 구성 요소 버전에 대한 종속성을 볼 수 있습니다. 구성 요소 세부 정보 페이지에서 **종속성** 목록을 찾습니다.

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


| 종속성 | 호환 버전 | 종속성 유형 | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.3.0 <3.0.0 | 하드 | 
| [스트림 관리자](stream-manager-component.md) | >2.0.10<3.0.0 | 하드 | 
| [보안 암호 관리자](secret-manager-component.md) | >=2.0.8 <3.0.0 | 하드 | 

구성 요소 종속성에 대한 자세한 내용은 [구성 요소 레시피 참조](component-recipe-reference.md#recipe-reference-component-dependencies)를 참조하세요.

## 구성
<a name="iotsitewise-opcua-collector-component-configuration"></a>

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

 AWS IoT SiteWise 콘솔 또는 API를 사용하여 IoT SiteWise OPC UA 수집기 구성 요소를 구성할 수 있습니다. 자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [4단계: 데이터 소스 추가 - 선택 사항](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-gateway-ggv2.html#add-data-sources-console)을 참조하세요.

## 입력 데이터
<a name="iotsitewise-opcua-collector-component-input-data"></a>

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


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

\$1 OPC UA 데이터 유형 `UInt32` 및 `Int64`의 경우 해당하는 SiteWise 데이터 유형은 SiteWise가 값을 나타낼 수 있는 `INTEGER`이고, 그렇지 않으면 `DOUBLE`입니다.

## 출력 데이터
<a name="iotsitewise-opcua-collector-component-output-data"></a>



이 구성 요소는 AWS IoT Greengrass 스트림 관리자에 `BatchPutAssetPropertyValue` 메시지를 씁니다. 자세한 내용은 *AWS IoT SiteWise API 참조*의 [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)를 참조하세요.

## 로컬 로그 파일
<a name="iotsitewise-opcua-collector-component-log-file"></a>

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

------
#### [ Linux ]

```
/greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log
```

------

**이 구성 요소의 로그를 보려면**
+ 코어 디바이스에서 다음 명령을 실행하여 실시간으로 이 구성 요소의 로그 파일을 봅니다. `/greengrass/v2` 또는 *C:\$1greengrass\$1v2*를 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
  ```

------

## 라이선스
<a name="iotsitewise-opcua-collector-component-licenses"></a>

<a name="component-core-software-license"></a>이 구성 요소는 [Greengrass 코어 소프트웨어 라이선스 계약](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)에 따라 릴리스됩니다.

## Changelog
<a name="iotsitewise-opcua-collector-component-changelog"></a>

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


|  **버전**  |  **변경 사항**  | 
| --- | --- | 
| 3.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 3.0.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 3.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 3.0.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 3.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.6.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.5.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
| 2.5.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
|  2.4.2  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | 
|  2.4.1  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | 
|  2.4.0  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
|  2.3.0  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | 
|  2.2.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
|  2.1.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
|  2.1.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html)  | 
|  2.0.3  |  버그 수정 및 개선 사항  | 
|  2.0.2  |  엣지와의 자산 우선 순위 동기화에 대한 버그 수정 및 개선 사항  | 
|  2.0.1  |  초기 버전입니다.  | 

## 다음 사항도 참조하세요.
<a name="iotsitewise-opcua-collector-component-see-also"></a>
+ *AWS IoT SiteWise 사용 설명서*의 [란 무엇입니까 AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html)