IoT SiteWise 프로세서 - AWS IoT Greengrass
버전유형운영 체제요구 사항의존성구성로컬 로그 파일라이선스Changelog다음 사항도 참조하세요.

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

IoT SiteWise 프로세서

IoT SiteWise 프로세서 구성 요소 (aws.iot.SiteWiseEdgeProcessor) 를 사용하면 AWS IoT SiteWise 게이트웨이가 에지에서 데이터를 처리할 수 있습니다.

이 구성 요소를 통해 AWS IoT SiteWise 게이트웨이는 자산 모델 및 자산을 사용하여 게이트웨이 장치의 데이터를 처리할 수 있습니다. AWS IoT SiteWise 게이트웨이에 대한 자세한 내용은 사용 AWS IoT SiteWise 설명서의 Using AWS IoT SiteWise at the Edge를 참조하십시오.

버전

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

  • 3.2.x

  • 3.1.x

  • 3.0.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

유형

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

자세한 정보는 구성 요소 유형을 참조하세요.

운영 체제

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

  • Linux

  • Windows

요구 사항

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

  • Greengrass 코어 디바이스는 다음 플랫폼 중 하나에서 실행되어야 합니다.

    • 운영 체제: 우분투 20.04 또는 18.04

      아키텍처: x86_64 (AMD64)

    • 운영체제: Red Hat Enterprise Linux (RHEL) 8

      아키텍처: x86_64 (AMD64)

    • 운영체제: Amazon Linux 2

      아키텍처: x86_64 (AMD64)

    • 운영 체제: 윈도우 서버 2019 이상

      아키텍처: x86_64 (AMD64)

  • Greengrass 코어 디바이스는 포트 443에서 인바운드 트래픽을 허용해야 합니다.

  • Greengrass 코어 디바이스는 포트 443과 8883에서 아웃바운드 트래픽을 허용해야 합니다.

  • 다음 포트는 80, 443, 3001, 4569, 4572, 8000, 8081, 8082, 8084, 8085, 8086, 8445, 9000, 9500, 11080, 50010에서 사용할 수 있도록 예약되어 있습니다. AWS IoT SiteWise예약된 포트를 트래픽용으로 사용하면 연결이 종료될 수 있습니다.

    참고

    포트 8087은 이 구성 요소의 버전 2.0.15 이상에만 필요합니다.

  • Greengrass 장치 역할에는 장치의 AWS IoT SiteWise 게이트웨이를 사용할 수 있는 권한이 있어야 합니다. AWS IoT Greengrass V2 자세한 내용은 AWS IoT SiteWise 사용 설명서의 요구 사항을 참조하십시오.

엔드포인트 및 포트

이 구성 요소는 기본 작업에 필요한 엔드포인트 및 포트 외에도 다음 엔드포인트 및 포트에 대한 아웃바운드 요청을 수행할 수 있어야 합니다. 자세한 정보는 프록시 또는 방화벽을 통한 장치 트래픽 허용을 참조하세요.

엔드포인트 포트 필수 설명

model.iotsitewise.region.amazonaws.com

 443 예

AWS IoT SiteWise 자산 및 자산 모델에 대한 정보를 얻으십시오.

edge.iotsitewise.region.amazonaws.com

 443 예

코어 디바이스의 AWS IoT SiteWise 게이트웨이 구성에 대한 정보를 얻을 수 있습니다.

ecr.region.amazonaws.com

 443 예

Amazon Elastic 컨테이너 레지스트리에서 AWS IoT SiteWise 엣지 게이트웨이 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 항목도 배포됩니다. 즉, 구성 요소를 성공적으로 배포하려면 구성 요소 및 해당 종속성에 대한 요구 사항을 모두 충족해야 합니다. 이 섹션에는 이 구성 요소의 릴리스된 버전에 대한 종속성과 각 종속성에 대한 구성 요소 버전을 정의하는 시맨틱 버전 제약 조건이 나열되어 있습니다. 콘솔에서 구성 요소의 각 버전에 대한 종속성을 볼 수도 있습니다.AWS IoT Greengrass 구성 요소 세부 정보 페이지에서 종속성 목록을 찾아보십시오.

다음 표에는 이 구성 요소의 버전 2.0.x ~ 2.1.x에 대한 종속성이 나와 있습니다.

종속성 호환되는 버전 종속성 유형
토큰 교환 서비스 >=2.0.3 <3.0.0 하드
스트림 관리자 >=2.0.3 =2.0.10 <3.0.0 하드
그린그래스 CLI >=2.3.0 <3.0.0 하드

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

구성

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

로컬 로그 파일

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

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log
이 구성 요소의 로그를 보려면

  • 코어 기기에서 다음 명령을 실행하여 이 구성 요소의 로그 파일을 실시간으로 확인합니다. /greengrass/v2또는 C:\greengrass\v2 를 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

라이선스

이 구성 요소에는 다음과 같은 타사 소프트웨어/라이선스가 포함됩니다.

  • 아파치-2.0

  • 메사추세츠공과대학

  • BSD-2-조항

  • BSD-3-조항

  • CDDL-1.0

  • CDDL-1.1

  • 디스크

  • 즐리브

  • GPL-3.0-GCC-예외 적용

  • 퍼블릭 도메인

  • 파이썬-2.0

  • 유니코드-DFS-2015

  • BSD-1-조항

  • OpenSSL

  • EPL-1.0

  • EPL-2.0

  • GPL-2.0 (클래스 경로 예외 포함)

  • MPL-2.0

  • CC0-1.0

  • JSON

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

Changelog

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

버전

변경

3.2.1
버그 수정 및 개선

  • AWS IoT SiteWise API 호출이 Edge와 동시에 페이지 매김되지 않는 문제를 수정했습니다. SiteWise

  • 메트릭을 더 이상 게시하지 않는 문제를 수정했습니다MessageRemaining.SiteWise_Edge_Stream.

  • MQTT 브로커와의 연결을 모니터링하기 위해 다음 CloudWatch 메트릭을 추가했습니다.

    • IoTSiteWiseProcessor.IsConnectedToMqttBroker

    • IoTSiteWiseProcessor.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWiseProcessor.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWiseProcessor.MqttMessageReceivedSuccessCount

    • IoTSiteWiseProcessor.MqttReceivedSuccessBytes

    이러한 지표에 대한 자세한 내용은 AWS IoT Greengrass Version 2 게이트웨이 지표를 참조하십시오.

3.2.0
성능 개선

  • 메모리 사용량을 줄이고 설치에 필요한 디스크 공간을 줄이도록 API 서비스를 최적화합니다.

    • 이렇게 하면 초기 메모리 사용량이 2GB 줄어들고 (현재는 시작 시 7.5GB의 메모리를 사용하지만 여전히 16GB가 권장됨) 전체 구성 요소의 다운로드 크기는 500MB 감소 (현재는 1.4GB 다운로드 필요) 됩니다.

새로운 기능

  • GetAssetPropertyValueAggregatesAPI는 이제 엣지에서 15분 어그리게이션 윈도우를 지원합니다.

  • 포트 8081 및 8082를 더 이상 사용할 필요가 없어 이 구성 요소가 올바르게 실행될 수 있습니다.

    참고

    AWS IoT SiteWise 데이터 플레인 API (예:) 의 로컬 엔드포인트가 에서 로 get-asset-property-value 변경되었습니다. http://localhost:8081 http://localhost:11080/data AWS IoT SiteWise 컨트롤 플레인 API (예:) 의 로컬 엔드포인트가 에서 http://localhost:11080 로 list-asset-models 변경되고 있습니다. http://localhost:11080/control AWS 항상 SiteWise 에지 게이트웨이 HTTPS 엔드포인트를 사용할 것을 권장합니다. 이러한 엔드포인트는 변경되지 않았습니다.

버그 수정 및 개선

  • 이전 동기화가 중단된 경우 이제 에서 AWS IoT SiteWise 동기화하면 리소스가 유효한 상태로 전환됩니다. 이렇게 하면 강제 재시작 후 일부 리소스가 손상되는 문제가 해결됩니다.

  • 동기화 중에 리소스를 수정하면 엣지에서 리소스가 손상될 수 있는 드문 문제를 수정합니다. 이제 이 상태가 감지되면 동기화가 실패하고 다음 동기화 시 리소스가 재시도됩니다.

  • API용 HTTP 엔드포인트를 외부에서 호출할 수 있었던 문제를 수정합니다. 이제는 HTTPS만 사용하여 로컬 루프백 주소 외부의 API를 호출할 수 있습니다.

  • ListAssets이제 API는 엣지에 저장된 자산의 자산 계층 구조를 표시합니다.

  • Windows에서 데이터 처리 팩을 다시 시작, 업그레이드 또는 다운그레이드하지 못하던 문제를 수정합니다.

  • 고객이 자격 증명을 사용하여 MQTT 브로커에 연결할 수 없었던 Windows OS용 데이터 처리 팩의 버그를 수정합니다.

3.1.3
버그 수정 및 개선

  • 일부 리소스가 실제로 실패했을 때 데이터 처리 팩이 동기화 성공을 잘못 보고하던 문제를 수정했습니다.

  • 상위 항목이 동일하지 않는 한 여러 자산의 이름이 같도록 허용하십시오.

3.1.1
버그 수정 및 개선

  • 시간대 불일치로 인해 SigV4 요청이 실패하는 문제를 수정했습니다.

  • 변환 및 지표 속성이 다시 시작한 후 속성에 의존할 때 계산이 중지되는 문제를 수정했습니다.

  • 사용자 지정 Stream Manager 포트 구성 지원을 활성화합니다.

  • 엣지에 동기화된 속성의 업데이트가 중단될 수 있는 문제를 수정했습니다.

3.1.0
버그 수정 및 개선

  • ListAssetModelsAPI가 다음 토큰을 생성하지 못하는 문제를 수정했습니다.

3.0.0
새로운 기능

  • MQTT 브로커의 데이터 통합을 지원할 수 있습니다.

2.2.1
버그 수정 및 개선

  • 컨트롤 플레인 데이터 스토리지가 클라우드 운영 방식과 더 일관되도록 동기화 프로세스를 조정하세요. 이는 업그레이드에 약간의 영향을 미칩니다.

    참고

    버전 2.2.1 이상에서 동기화된 컨트롤 플레인 데이터는 이전 버전과 호환되지 않습니다. 이전 버전으로 다운그레이드하려면 새로 설치해야 합니다. 이는 업그레이드에는 영향을 미치지 않으며, 이전 버전에서 동기화된 데이터는 버전 2.2.1에서 작동합니다.

  • 자격 증명의 우선 순위를 AWS IoT Greengrass V2 지정하도록 AWS 자격 증명 체인을 추가로 수정했습니다.

2.1.37
버그 수정 및 개선

  • dependency-routing-service 프로세스를 더 이상 사용하지 않고 해당 기능을 프로세스로 이동하여 property-state-service 통신 프로세스의 리소스 사용량을 줄이십시오.

  • 에서 사용하는 한도와 일치하도록 get-asset-property-value-history API의 최대 결과 한도를 20,000으로 늘리십시오. AWS IoT SiteWise

  • 최대 결과 제한이 지정되지 않은 경우 get-asset-property-value-history API의 페이지 매김 결과에 다음 토큰이 제공되지 않던 문제를 수정했습니다.

2.1.35
버그 수정 및 개선

  • AWS 자격 증명 체인을 수정하여 자격 증명의 우선 순위를 지정합니다 AWS IoT Greengrass .

  • 사물 그룹의 일부로 배포할 때 발생하는 계정 감지 문제를 수정합니다. AWS IoT

2.1.34
버그 수정 및 개선

  • Linux에서 멀티스레딩을 사용하도록 메트릭/변환 계산을 조정합니다. Windows는 호환성을 위해 계속해서 단일 스레드 계산을 실행합니다.

  • 일부 계산 창에서 메트릭 계산이 누락되는 문제를 수정합니다.

2.1.33
버그 수정 및 개선

  • Greengrass 콘솔에 대한 오류 상태 보고 관련 문제를 수정합니다.

2.1.32
버그 수정 및 개선

  • 사용자 지정된 사용자 이름 및 그룹에 대한 지원을 추가합니다.

2.1.31
버그 수정 및 개선

  • 에서 모델링된 데이터에 대한 시간 가중 평균 및 시간 가중 표준 편차를 계산할 수 있는 지원을 추가합니다. AWS IoT SiteWise

2.1.29
버그 수정 및 개선

  • 에지 기능에 자산을 필터링하기 위한 지원을 추가합니다.

2.1.28
버그 수정 및 개선

  • 많은 자산을 에지에서 에지로 동기화할 수 있도록 리소스 동기화를 최적화합니다. AWS 클라우드

2.1.24
버그 수정 및 개선

  • 리소스를 두 번째로 동기화할 때 대시보드가 사라지던 문제를 수정합니다.

2.1.23
버그 수정 및 개선

  • 인터넷 연결이 느린 경우 설치가 실패하지 않도록 설치 프로세스 제한 시간을 추가했습니다. aws.iot.SiteWiseEdgeProcessor

  • 리소스 동기화를 최적화하여 클라우드와 엣지 간의 동기화 효율성을 개선했습니다.

2.1.21
주의

2.0.x에서 2.1.x로 업그레이드하면 로컬 데이터가 손실됩니다.

새로운 기능

  • 윈도우 서버 2019 이상에 대한 지원을 추가합니다.

  • 리눅스 기반 운영 체제의 docker를 제거합니다.

2.0.16

이 버전에는 버그 수정 및 개선 사항이 포함되어 있습니다.

2.0.15
버그 수정 및 개선

  • 이 구성 요소가 리소스 동기화 API 작업에 사용하는 포트를 8085에서 8087로 변경합니다. 따라서 이제 이 구성 요소를 사용하려면 포트 8087을 사용할 수 있어야 합니다. 이 구성 요소를 사용하려면 여전히 포트 8085가 필요합니다.

  • 사용자가 API 작업 호출을 시도하는 대신 로그인 중에 인증되지 않은 사용자를 거부하도록 AWS OpsHub 인증을 업데이트합니다.

2.0.14

이 버전에는 버그 수정 및 개선 사항이 포함되어 있습니다.

2.0.13
버그 수정 및 개선

  • 이 구성 요소가 Amazon CloudWatch 지표에 데이터를 보고할 때 이제 모델링되지 않은 데이터를 올바르게 표시하도록 문제를 수정합니다.

2.0.9
버그 수정 및 개선

  • 코어 AWS IoT SiteWise 디바이스에서 리소스를 생성하고 업데이트할 수 있는 안정성을 개선합니다.

  • 코어 장치에 설치된 구성 요소, 각 구성 요소의 버전 및 각 구성 요소의 상태를 모니터링하는 데 사용할 수 있는 추가 로컬 API 작업을 추가합니다. 코어 장치의 AWS IoT SiteWise 응용 AWS OpsHub 프로그램에 있는 설정 탭에서 이 정보를 볼 수 있습니다.

  • 이 구성 요소가 실행하는 Docker 컨테이너의 상태를 추가합니다. docker ps명령을 실행하여 컨테이너의 상태를 볼 수 있습니다.

2.0.7
버그 수정 및 개선

  • 코어 기기에서 AWS IoT SiteWise Monitor 포털을 볼 수 있는 지원이 수정되었습니다.

2.0.6
버그 수정 및 개선

  • 이 구성 요소가 코어 기기에서 계산하는 AWS IoT SiteWise statetime()earliest(), 및 latest() 함수를 수정합니다.

2.0.5
버그 수정 및 개선

  • 이 구성 요소가 코어 기기에서 계산하는 변환의 AWS IoT SiteWise pretrigger() 함수에 대한 지원을 추가합니다.

  • 이 구성 요소가 인증을 위한 LDAP (경량 디렉터리 액세스 프로토콜) 구성을 저장하는 경로를 변경합니다.

2.0.2

초기 버전

다음 사항도 참조하세요.