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

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

IoT SiteWise 게시자

IoT SiteWise 게시자 구성 요소(aws.iot.SiteWiseEdgePublisher)를 사용하면 AWS IoT SiteWise 게이트웨이가 엣지에서 로 데이터를 내보낼 수 있습니다 AWS 클라우드.

AWS IoT SiteWise 게이트웨이에 대한 자세한 내용은 AWS IoT SiteWise 사용 설명서의 엣지 AWS IoT SiteWise 에서 사용을 참조하세요.

버전

이 구성 요소에는 다음과 같은 버전이 있습니다.

  • 4.1.x

  • 4.0.x

  • 3.2.x

  • 3.1.x

  • 3.0.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)

    • 운영체제: 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 코어 디바이스를 인터넷에 연결해야 합니다.

  • Greengrass 코어 디바이스에 iotsitewise:BatchPutAssetPropertyValue 작업을 수행할 권한이 있어야 합니다. 자세한 내용은 코어 디바이스가 AWS 서비스와 상호 작용할 수 있도록 권한 부여를 참조하세요.

    예 권한 정책
    JSON
    {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iotsitewise:BatchPutAssetPropertyValue",
            "Resource": "*"
        }
    ]
}

엔드포인트 및 포트

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

엔드포인트 Port 필수 설명

data.iotsitewise.region.amazonaws.com

 443 예

데이터를에 게시합니다 AWS IoT SiteWise.

종속성

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

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

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

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

구성

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

AWS IoT SiteWise 콘솔 또는 API를 사용하여 IoT SiteWise 게시자 구성 요소를 구성할 수 있습니다. 자세한 내용은 AWS IoT SiteWise 사용 설명서의 3단계: 게시자 구성 - 선택 사항을 참조하세요.

입력 데이터

이 구성 요소는 AWS IoT Greengrass 스트림 관리자의 PutAssetPropertyValueEntry 메시지를 읽습니다. 자세한 내용은 AWS IoT SiteWise API 참조에서 PutAssetPropertyValueEntry를 참조하세요.

로컬 로그 파일

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

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

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

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log -Tail 10 -Wait

문제 해결 및 디버깅

이 구성 요소에는 고객이 문제를 식별하고 해결하는 데 도움이 되는 새로운 이벤트 로그가 포함되어 있습니다. 로그 파일은 로컬 로그 파일과 별개이며 다음 위치에 있습니다. /greengrass/v2 또는 C:\greengrass\v2를 AWS IoT Greengrass 루트 폴더의 경로로 바꿉니다.

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IotSiteWisePublisherEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgePublisher\logs\IotSiteWisePublisherEvents.log

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

  • 심각도 수준

  • 타임스탬프

  • 추가 이벤트별 정보

예 로그 예
accountBeingThrottled:
  Summary: Data upload speed slowed due to quota limits
  Level: WARN
  Timestamp: '2023-06-09T21:30:24.654Z'
  Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested"
    quota for a customers account. See the associated documentation and associated
    metric for the number of requests that were limited for more information. Note
    that this may be temporary and not require any change, although if the issue continues
    you may need to request an increase for the mentioned quota.
  FurtherInformation:
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams
  AssociatedMetrics:
  - Name: TotalErrorCount
    Description: The total number of errors of this type that occurred.
    Value: 327724.0
  AssociatedData:
  - Name: AggregatePropertyAliases
    Description: The aggregated property aliases of the throttled data.
    FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log

라이선스

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

Changelog

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

버전

변경 사항

4.1.3
버그 수정 및 개선 사항

  • 데이터 체크포인팅 과정에서 발생하던 메모리 누수 문제가 수정됩니다.

  • 보안 취약성을 수정합니다.

4.1.2
버그 수정 및 개선 사항

  • 대용량 구성 동기화 과정에서 발생하던 문제가 수정됩니다.

  • 에 대한 구독 지연은 더 이상 시작 프로세스에 영향을 주지 AWS IoT Core 않습니다.

  • 체크포인트 초기화 지연이 더 이상 시작 프로세스에 영향을 미치지 않습니다.

4.1.1
버그 수정 및 개선 사항

  • 게시자를 다시 시작한 후 Amazon S3 대상을 사용하여 AWS IoT SiteWise 버퍼링된를 통해 데이터를 전송할 때 Classic 스트림, V2 게이트웨이에서 CPU 및 메모리 사용량이 높은 문제를 해결합니다.

  • 또한 기본 구성 요소 로깅 동작을 재정의할 수 있도록 선택적 파일(/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/log4j2.xml)을 생성하는 기능이 추가됩니다.

4.1.0
새로운 기능

  • 기본 제공 EMQX MQTT 브로커 사용자를 관리할 수 있는 명령줄 도구가 추가됩니다. 이 인터페이스는 사용자 계정 관리를 활성화하고, MQTT 토픽 게시 및 구독 권한에 대한 액세스 제어 정책을 구성합니다.

버그 수정 및 개선 사항

  • 단일 버퍼링 수집 Parquet 파일에 포함될 수 있는 고유 별칭의 수를 결정하는 계산 방식이 수정됩니다.

4.0.3
버그 수정 및 개선 사항

  • 클라우드 한도 10,000과 일치하도록 AWS IoT SiteWise 버퍼링된 수집 파일당 고유 별칭의 최대값을 업데이트합니다.

  • 잘못된 서비스 상태를 잘못 보고하는 AWS IoT Greengrass 로깅 문제를 해결합니다.

  • Classic 스트림 및 V2 게이트웨이에서 Amazon S3 대상 구성 간 중복 스트림 이름을 방지하기 위한 검증이 추가됩니다.

  • 비표준 AWS 파티션에서 AWS IoT SiteWise 버퍼링된 수집과 관련된 호환성 문제를 해결합니다.

  • 중복 데이터 수집을 유발하던 문제가 수정됩니다.

4.0.2
버그 수정 및 개선 사항

  • 배치 대기 시간이 만료된 후 데이터 업로드가 되지 않던 문제가 수정됩니다.

  • MQTT 지원 V3 게이트웨이 구성에서 각 대상이 고유한지 확인하는 검증이 추가됩니다.

4.0.1
버그 수정 및 개선 사항

  • 최대 배치 대기 시간 구성을 비활성화 AWS IoT SiteWise 하면에 데이터가 업로드되지 않는 문제를 해결합니다.

  • IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker 지표가 MQTT 브로커에 구독된 고유 토픽 수를 잘못 보고하던 문제가 수정됩니다.

4.0.0
새로운 기능

Classic 스트림 및 V2 게이트웨이(이전 명칭: 자체 호스팅 SiteWise Edge 게이트웨이)에 더해, MQTT 지원 V3 게이트웨이를 지원하도록 기능이 추가됩니다.

버그 수정 및 개선 사항

  • PublishSuccessCount 지표가 음수 값을 보고하던 문제가 수정됩니다.

  • 게시자가 100초 내에 시작되지 않고 BROKEN 상태로 진입하던 문제가 수정됩니다.

  • 보안 취약성을 수정합니다.

3.2.0
새로운 기능

  • AWS IoT SiteWise에서 수집이 활성화된 경우 Null 및 NaN 값의 수집이 지원되도록 기능이 추가되었습니다. AWS IoT SiteWise에서 Null 및 NaN 구성을 확인하거나 수정하려면 DescribeStorageConfiguration 및 PutStorageConfiguration API를 참조하세요.

버그 수정 및 개선 사항

  • 체크포인트 데이터베이스 파일이 손상되는 문제가 수정됩니다.

  • 중복된 지표가 생성되는 문제가 수정됩니다.

3.1.4
주의

버전 3.1.4는 2025년 2월 20일에 중단되었습니다. 이 버전의 개선 사항은 이 구성 요소의 이후 버전에서 사용할 수 있습니다.

버그 수정 및 개선 사항

  • 오프라인 후 예상보다 긴 시작 시간을 유발할 수 있는 문제가 수정됩니다.

3.1.3
버그 수정 및 개선 사항

  • /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IoTSiteWisePublisherEvents.log에 있는 이벤트 로그 파일이 생성되었지만 이벤트가 기록되지 않던 문제가 수정됩니다.

  • MQTT 브로커와의 연결을 모니터링하기 위해 다음 CloudWatch 지표가 추가됩니다.

    • IoTSiteWisePublisher.IsConnectedToMqttBroker

    • IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWisePublisher.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWisePublisher.MqttMessageReceivedSuccessCount

    • IoTSiteWisePublisher.MqttReceivedSuccessBytes

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

  • parquet 파일을 S3에 업로드하는 데 실패할 때에도 BatchCreateJob API가 호출되던 문제가 수정됩니다.

3.1.2
버그 수정 및 개선 사항

  • 버전 3.1.1에서 발생한 높은 CPU 사용량 문제를 수정합니다.

3.1.1
주의

버전 3.1.1은 2024년 3월 12일에 중단되었습니다. 이 버전의 개선 사항은 이 구성 요소의 이후 버전에서 사용할 수 있습니다.

버그 수정 및 개선 사항

  • 오류가 발생할 때 영향을 받는 데이터 별칭을 식별하는 로깅이 추가됩니다.

  • 수집된 데이터의 수명에 대한 AWS IoT SiteWise API 제한의 로컬 적용을 추가합니다.

  • Amazon S3 대상이 여러 개 있는 경우 게시자가 StreamManager 스트림의 체크포인트를 혼합하는 문제가 해결됩니다.

  • 게시자가 StreamManager 스트림에서 읽는 방식과 관련된 성능 병목 현상이 해결됩니다.

3.1.0
새로운 기능

  • Amazon S3에 데이터를 parquet 파일로 게시할 수 있는 지원이 추가됩니다.

  • AWS IoT SiteWise 버퍼링된 수집에 대한 지원을 추가합니다.

3.0.0
버그 수정 및 개선 사항

  • 프록시 지원과 관련된 문제가 해결됩니다.

새로운 기능

  • MQTT 브로커에서 데이터 수집에 대한 지원이 활성화됩니다.

2.4.1
버그 수정 및 개선 사항

  • 구성 요소가 Java Corretto 11 버전 11.0.20.8.1 이상과 연동되도록 합니다. 구성 요소 버전 2.4.0 및 2.3.3에서는 Java Corretto 버전 11.0.20.8.1과 함께 사용할 경우 "Could not find or load main class" 오류 메시지가 표시됩니다.

2.4.0
새로운 기능

  • 문제를 더 쉽게 식별하고 해결할 수 있도록 새 이벤트 로그가 추가됩니다.

버그 수정 및 개선 사항

  • 게시자 체크포인트 복구가 개선됩니다.

2.3.3
버그 수정 및 개선 사항

  • 높은 처리량을 지원할 수 있는 기능이 개선됩니다.

2.3.2
버그 수정 및 개선 사항

  • 게시자 구성을 다운로드할 때 HTTP 프록시 지원이 수정됩니다.

2.3.1
새로운 기능

  • Linux ARMv8 아키텍처에 데이터 수집 팩 설치에 대한 지원을 추가합니다.

  • Linux ARMv8의 최소 요구 사항:

    • 메모리: 4GB

    • CPU: ARM Cortex-A72 또는 동등한 사양

2.2.3
버그 수정 및 개선 사항

  • 재시도 가능 예외 목록에 없는 일반 예외에 대한 재시도가 제거됩니다.

2.2.2
버그 수정 및 개선 사항

  • HTTP 프록시 서버를 AWS IoT SiteWise 통해에 데이터 업로드 지원을 다시 소개합니다.

2.2.1
참고

이 버전은 HTTP 프록시 구성을 지원하지 않습니다. 버전 2.2.2 이상에서 이 기능에 대한 지원이 다시 도입됩니다.

새로운 기능

  • AWS IoT SiteWise에 데이터를 업로드할 때 압축을 전환하도록 이 구성 요소에 대한 지원이 추가됩니다.

2.2.0
참고

이 버전은 HTTP 프록시 구성을 지원하지 않습니다. 버전 2.2.2 이상에서 이 기능에 대한 지원이 다시 도입됩니다.

새로운 기능

  • 데이터를 AWS IoT SiteWise 서비스에 전송하기 전에 압축하도록 이 구성 요소가 업데이트됩니다.

    • 대부분의 경우 이 변경으로 인해 대역폭 사용량이 이 구성 요소의 이전 버전에 비해 75% 줄어듭니다.

    • 대부분의 경우 이 변경으로 인해 CPU 사용량이 최대 5% 증가합니다. 대량의 데이터를 처리하는 게이트웨이에서 이 변경으로 인해 CPU 사용량이 최대 15% 증가할 수 있습니다.

    • 이 변경 사항은 AWS IoT SiteWise 서비스 요금 또는 서비스 할당량 사용량에 영향을 주지 않습니다.

    • Windows Server 2019 이상에 대한 지원을 추가합니다.

버그 수정 및 개선 사항

  • 체크포인트 파일이 손상되었을 때 이 구성 요소가 시작되지 않는 문제를 해결합니다.

2.1.4
버그 수정 및 개선 사항

  • Java 버전 8과의 호환성이 수정됩니다.

2.1.3
주의

이 버전은 미국 동부(오하이오), 캐나다(중부) 및 AWS GovCloud(미국 동부) 리전을 제외하고 더 이상 사용할 수 없습니다. 이 구성 요소 버전을 실행하려면 Java 버전 11 이상이 필요합니다. 이 버전의 개선 사항은 이 구성 요소의 이후 버전에서 사용할 수 있습니다.

버그 수정 및 개선 사항

  • 지원되지 않는 디바이스에 이 구성 요소를 배포할 때의 오류 메시지가 개선됩니다.

  • 데이터 업로드가 실패하면 로그 오류가 업데이트됩니다.

2.1.2
버그 수정 및 개선 사항

  • 데이터가 만료되는 즉시 만료된 데이터 내보내기 기능을 호출하도록 업데이트됩니다.

2.1.1

버그 수정 및 개선 사항

2.1.0
새로운 기능

  • 최신 데이터를 클라우드에 먼저 게시하도록 지원을 추가합니다.

  • 만료된 데이터를 클라우드에 게시하지 않도록 지원을 추가합니다.

  • 만료된 데이터를 로컬에 저장하기 위한 지원을 추가합니다.

버그 수정 및 개선 사항

  • 디스크 I/O 및 해당 지연 시간이 감소됩니다.

2.0.2

버그 수정 및 개선 사항

2.0.1

초기 버전입니다.

다음 사항도 참조하세요.