기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # IoT SiteWise 프로세서 IoT SiteWise 프로세서 구성 요소(`aws.iot.SiteWiseEdgeProcessor`)를 사용하면 AWS IoT SiteWise Classic 스트림, V2 게이트웨이가 엣지에서 데이터를 처리할 수 있습니다. 이 구성 요소를 사용하면 AWS IoT SiteWise 게이트웨이가 자산 모델과 자산을 사용하여 게이트웨이 디바이스의 데이터를 처리할 수 있습니다. AWS IoT SiteWise 게이트웨이에 대한 자세한 내용은 *AWS IoT SiteWise 사용 설명서*[의 엣지 AWS IoT SiteWise 에서 사용을](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) 참조하세요. **참고** 데이터 처리 팩(DPP) 기능은 2025년 11월 7일부터 신규 고객에게 더 이상 공개되지 않습니다. DPP를 사용하려면 해당 날짜 이전에 가입하세요. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [데이터 처리 팩 가용성 변경](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html)을 참조하세요. **Topics** + [버전](#iotsitewise-processor-component-versions) + [Type](#iotsitewise-processor-component-type) + [운영 체제](#iotsitewise-processor-component-os-support) + [요구 사항](#iotsitewise-processor-component-requirements) + [종속성](#iotsitewise-processor-component-dependencies) + [구성](#iotsitewise-processor-component-configuration) + [로컬 로그 파일](#iotsitewise-processor-component-log-file) + [라이선스](#iotsitewise-processor-component-licenses) + [Changelog](#iotsitewise-processor-component-changelog) + [다음 사항도 참조하세요.](#iotsitewise-processor-component-see-also) ## 버전 이 구성 요소에는 다음과 같은 버전이 있습니다. + 3.5.x + 3.4.x + 3.3.x + 3.2.x + 3.1.x + 3.0.x + 2.2.x + 2.1.x + 2.0.x ## Type 이 구성 요소는 일반 구성 요소(`aws.greengrass.generic`)입니다. [Greengrass nucleus](greengrass-nucleus-component.md)는 구성 요소의 수명 주기 스크립트를 실행합니다. 자세한 내용은 [구성 요소 유형](develop-greengrass-components.md#component-types) 단원을 참조하십시오. ## 운영 체제 이 구성 요소는 다음 운영 체제를 실행하는 코어 디바이스에 설치할 수 있습니다. + Linux + Windows ## 요구 사항 이 구성 요소의 요구 사항은 다음과 같습니다. + Greengrass 코어 디바이스가 다음 플랫폼 중 하나에서 실행되어야 합니다. + OS: Ubuntu 20.04 이상 아키텍처: x86\$164(AMD64) + 운영체제: Red Hat Enterprise Linux (RHEL) 8 아키텍처: x86\$164(AMD64) + OS: Amazon Linux 2 아키텍처: x86\$164(AMD64) + OS: Windows Server 2019 이상 아키텍처: x86\$164(AMD64) + OS: Debian 11(Bullseye) 이상 아키텍처: x86\$164(AMD64) + Greengrass 코어 디바이스가 포트 443에서 인바운드 트래픽을 허용해야 합니다. + Greengrass 코어 디바이스가 포트 443과 8883에서 아웃바운드 트래픽을 허용해야 합니다. + 다음 포트는 AWS IoT SiteWise 80, 443, 3001, 4569, 4572, 8000, 8081, 8082, 8084, 8085, 8086, 8445, 9000, 9500, 11080 및 50010에서 사용하도록 예약되어 있습니다. 예약된 포트를 트래픽용으로 사용하면 연결이 종료될 수 있습니다. **참고** 포트 8087은 이 구성 요소의 버전 2.0.15 이상에만 필요합니다. + [Greengrass 디바이스 역할에](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html)는 AWS IoT Greengrass V2 디바이스에서 AWS IoT SiteWise 게이트웨이를 사용할 수 있는 권한이 있어야 합니다. 자세한 내용은 *AWS IoT SiteWise 사용 설명서*의 [요구 사항](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-gateway-ggv2.html#gateway-requirements)을 참조하세요. ### 엔드포인트 및 포트 이 구성 요소는 기본 작업에 필요한 엔드포인트 및 포트 외에 다음 엔드포인트 및 포트에 대한 아웃바운드 요청도 수행할 수 있어야 합니다. 자세한 내용은 [프록시 또는 방화벽을 통해 디바이스 트래픽 허용](allow-device-traffic.md) 단원을 참조하십시오. | 엔드포인트 | 포트 | 필수 | 설명 | | --- | --- | --- | --- | | `model.iotsitewise.region.amazonaws.com` | 443 | 예 | AWS IoT SiteWise 자산 및 자산 모델에 대한 정보를 가져옵니다. | | `edge.iotsitewise.region.amazonaws.com` | 443 | 예 | 코어 디바이스의 AWS IoT SiteWise 게이트웨이 구성에 대한 정보를 가져옵니다. | | `ecr.region.amazonaws.com` | 443 | 예 | Amazon AWS IoT SiteWise Elastic Container Registry에서 Edge 게이트웨이 Docker 이미지를 다운로드합니다. | | `iot.region.amazonaws.com` | 443 | 예 | AWS 계정에 대한 디바이스 엔드포인트를 가져옵니다. | | `sts.region.amazonaws.com` | 443 | 예 | 의 ID를 가져옵니다 AWS 계정. | | `monitor.iotsitewise.region.amazonaws.com` | 443 | 아니요 | 코어 디바이스의 AWS IoT SiteWise Monitor 포털에 액세스하는 경우 필요합니다. | ## 종속성 구성 요소를 배포할 때는 호환되는 버전의 종속성 AWS IoT Greengrass 도 배포합니다. 즉, 구성 요소를 성공적으로 배포하려면 구성 요소 및 모든 해당 종속성에 대한 요구 사항을 충족해야 합니다. 이 섹션에는 이 구성 요소의 [릴리스된 버전](#iotsitewise-processor-component-changelog)에 대한 종속성과 각 종속성에 대한 구성 요소 버전을 정의하는 의미 체계 버전 제약 조건이 나열되어 있습니다. [AWS IoT Greengrass 콘솔](https://console.aws.amazon.com//greengrass)에서도 각 구성 요소 버전에 대한 종속성을 볼 수 있습니다. 구성 요소 세부 정보 페이지에서 **종속성** 목록을 찾습니다. 다음 표에는 이 구성 요소의 버전 2.0.x\$12.1.x에 대한 종속성이 나열되어 있습니다. | 종속성 | 호환 버전 | 종속성 유형 | | --- | --- | --- | | [토큰 교환 서비스](token-exchange-service-component.md) | >=2.0.3 <3.0.0 | 하드 | | [스트림 관리자](stream-manager-component.md) | >=2.0.10 <3.0.0 | 하드 | | [Greengrass CLI](greengrass-cli-component.md) | >=2.3.0 <3.0.0 | 하드 | 구성 요소 종속성에 대한 자세한 내용은 [구성 요소 레시피 참조](component-recipe-reference.md#recipe-reference-component-dependencies)를 참조하세요. ## 구성 이 구성 요소에는 구성 파라미터가 없습니다. ## 로컬 로그 파일 이 구성 요소는 다음 로그 파일을 사용합니다. ------ #### [ Linux ] ``` /greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log ``` ------ **이 구성 요소의 로그를 보려면** + 코어 디바이스에서 다음 명령을 실행하여 실시간으로 이 구성 요소의 로그 파일을 봅니다. `/greengrass/v2` 또는 *C:\$1greengrass\$1v2*를 AWS IoT Greengrass 루트 폴더의 경로로 바꿉니다. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log -Tail 10 -Wait ``` ------ ## 라이선스 이 구성 요소에는 다음 타사 소프트웨어/라이선스가 포함되어 있습니다. ### 타사 라이선스 + Apache-2.0 + MIT + BSD-2-Clause + BSD-3-Clause + CDDL-1.0 + CDDL-1.1 + ISC + ZLIB + GPL-3.0-with-GCC-exception + 퍼블릭 도메인 + Python-2.0 + Unicode-DFS-2015 + BSD-1-Clause + OpenSSL + EPL-1.0 + EPL-2.0 + GPL-2.0-with-classpath-exception + MPL-2.0 + CC0-1.0 + JSON 이 구성 요소는 [Greengrass 코어 소프트웨어 라이선스 계약](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)에 따라 릴리스됩니다. ## Changelog 다음 표에는 각 구성 요소 버전의 변경 사항이 설명되어 있습니다. | **버전** | **변경 사항** | | --- | --- | | 3.5.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.1.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.37 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.35 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.34 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.33 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.32 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.31 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.29 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.28 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.24 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.23 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.21 | 2.0.x에서 2.1.x로 업그레이드하면 로컬 데이터가 손실됩니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.16 | 이 버전에는 버그 수정과 개선 사항이 포함되어 있습니다. | | 2.0.15 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.14 | 이 버전에는 버그 수정과 개선 사항이 포함되어 있습니다. | | 2.0.13 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.9 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.7 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.2 | 초기 버전입니다. | ## 다음 사항도 참조하세요. + *AWS IoT SiteWise 사용 설명서*의 [란 무엇입니까 AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html)