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

# 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\_64(AMD64) 또는 ARMv8(Aarch64)
  + 운영체제: 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 서버에 대한 아웃바운드 네트워크 연결을 허용해야 합니다.

## 종속성
<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`<br />`Guid`<br />`XmlElement` | 최대 길이가 1,024바이트인 문자열입니다. | 
| `INTEGER` | `SByte`<br />`Byte`<br />`Int16`<br />`UInt16`<br />`Int32`<br />`UInt32`\*<br />`Int64`\* | 범위가 `-2,147,483,648 to 2,147,483,647`인 서명된 32비트 정수입니다. | 
| `DOUBLE` | `UInt32`\*<br />`Int64`\*<br />`Float`<br />`Double` | `–10^100 to 10^100`의 범위 및 `IEEE 754`의 배정밀도를 갖는 부동 소수점 숫자입니다. | 
| `BOOLEAN` | `Boolean` | `true` 또는 `false` | 

\* 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:\\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
  ```

------

## 라이선스
<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)