AWS IoT Greengrass Version 1이(가) 2023년 6월 30일에 수명 연장 단계에 들어갔습니다. AWS IoT Greengrass V1 관리형 정책에 대한 자세한 정보는 섹션을 참조하세요. 이 날짜 이후에는 AWS IoT Greengrass V1에서 기능, 개선 사항, 버그 수정 또는 보안 패치를 제공하는 업데이트를 릴리스하지 않습니다. AWS IoT Greengrass V1에서 실행되는 장치는 중단되지 않으며 계속 작동하고 클라우드에 연결됩니다. 중대한 새 기능과 추가 플랫폼에 대한 지원이 추가되는 AWS IoT Greengrass Version 2(으)로 마이그레이션하는 것이 좋습니다.

AWS IoT Greengrass 코어 장치에서 시스템 상태 원격 측정 데이터 수집

시스템 상태 원격 측정 데이터는 Greengrass 코어 장치의 중요 작업 성능을 모니터링하는 데 도움이 되는 진단 데이터입니다. Greengrass 코어의 원격 측정 에이전트는 로컬 원격 측정 데이터를 수집하여 고객 상호 작용 없이 Amazon EventBridge에 게시합니다. 코어 장치는 최선의 노력으로 EventBridge에 원격 측정 데이터를 게시합니다. 예를 들어, 코어 장치는 오프라인 상태에서 원격 측정 데이터를 제공하지 못할 수 있습니다.

엣지 장치에서 원격 측정 데이터를 검색, 분석, 변환 및 보고하는 프로젝트와 애플리케이션을 만들 수 있습니다. 프로세스 엔지니어와 같은 도메인 전문가는 이러한 애플리케이션을 사용하여 플릿 상태에 대한 통찰력을 얻을 수 있습니다.

Greengrass 엣지 구성 요소가 제대로 작동하도록 하기 위해 AWS IoT Greengrass은(는) 개발 및 품질 개선 목적으로 데이터를 사용합니다. 또한 이 기능은 새롭고 향상된 엣지 기능을 알려주는 데도 도움이 됩니다. AWS IoT Greengrass은(는) 원격 측정 데이터를 최대 7일간 보존합니다.

이 기능은 AWS IoT Greengrass Core 소프트웨어 v1.11.0에서 사용할 수 있으며 기존 코어를 포함한 모든 Greengrass 코어에 기본적으로 활성화되어 있습니다. AWS IoT Greengrass Core 소프트웨어 v1.11.0 이상으로 업그레이드하는 즉시 자동으로 데이터를 받기 시작합니다.

게시된 원격 측정 데이터에 액세스하거나 관리하는 방법에 대한 자세한 내용은 원격 측정 데이터 수신 구독 단원을 참조하세요.

원격 측정 에이전트는 다음 시스템 지표를 수집하고 게시합니다.

원격 측정 설정 구성

Greengrass 원격 측정은 다음 설정을 사용합니다.

Greengrass 코어 장치에 대한 원격 측정 기능을 활성화하거나 비활성화할 수 있습니다. AWS IoT Greengrass은(는) 섀도우를 사용하여 원격 측정 구성을 관리합니다. 코어가 AWS IoT Core와(과) 연결되면 변경 내용이 즉시 적용됩니다.

원격 측정 에이전트는 서비스 품질(QoS) 수준이 0인 MQTT 프로토콜을 사용하여 데이터를 게시합니다. 즉, 전송을 확인하거나 게시 시도를 재시도하지 않습니다. 원격 측정 메시지는 AWS IoT Core 대상으로 하는 구독에 대한 다른 메시지와 MQTT 연결을 공유합니다.

데이터 링크 비용을 제외하고 코어에서 AWS IoT Core(으)로의 데이터 전송에는 요금이 부과되지 않습니다. 이는 에이전트가 AWS 예약된 주제에 게시하기 때문입니다. 하지만 사용 사례에 따라 데이터를 받거나 처리할 때 비용이 발생할 수 있습니다.

요구 사항

원격 측정 설정을 구성할 때는 다음 요구 사항이 적용됩니다.

설정 원격 측정 구성(콘솔)

다음은 AWS IoT Greengrass 콘솔에서 Greengrass 코어의 원격 측정 설정을 업데이트하는 방법을 보여줍니다.

변경 사항이 런타임에 적용됩니다. 그룹을 배포할 필요가 없습니다.

원격 측정 설정 구성(CLI)

AWS IoT Greengrass API에서 TelemetryConfiguration 객체는 Greengrass 코어의 원격 측정 설정을 나타냅니다. 이 개체는 코어와 연결된 RuntimeConfiguration 객체의 일부입니다. AWS IoT Greengrass API, AWS CLI 또는 AWS SDK를 사용하여 Greengrass 원격 측정을 관리할 수 있습니다. 이 단원의 예제에서는 AWS CLI를 사용합니다.

TelemetryConfiguration 객체

TelemetryConfiguration 객체에는 다음 속성이 있습니다.

원격 측정 데이터 수신 구독

Amazon EventBridge에서 Greengrass 코어 장치에서 게시된 원격 측정 데이터를 처리하는 방법을 정의하는 규칙을 생성할 수 있습니다. EventBridge는 데이터를 수신하면 규칙에 정의된 대상 작업을 간접적으로 호출합니다. 예를 들어 알림을 보내거나, 이벤트 정보를 저장하거나, 교정 작업을 수행하거나, 기타 이벤트를 간접적으로 호출하는 이벤트 규칙을 생성할 수 있습니다.

원격 측정 이벤트

원격 측정 데이터를 포함하는 배포 상태 변경에 대한 이벤트에서 사용하는 형식은 다음과 같습니다.

{
    "version": "0",
    "id": "f70f943b-9ae2-e7a5-fec4-4c22178a3e6a",
    "detail-type": "Greengrass Telemetry Data",
    "source": "aws.greengrass",
    "account": "123456789012",
    "time": "2020-07-28T20:45:53Z",
    "region": "us-west-1",
    "resources": [],
    "detail": {
        "ThingName": "CoolThing",
        "Schema": "2020-06-30",
        "ADP": [
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToKinesis",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToS3ExportTaskExecutor",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToHTTP",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToIoTAnalytics",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToIoTSiteWise",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "arn:aws:lambda:us-west-1:123456789012:function:my-function",
                "M": [
                    {
                        "N": "LambdaTimeout",
                        "Sum": 15,
                        "U": "Count"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "CloudSpooler",
                "M": [
                    {
                        "N": "DroppedMessageCount",
                        "Sum": 15,
                        "U": "Count"
                    }
                ]
            },
            {
                "TS": 1593727692,
                "NS": "SystemMetrics",
                "M": [
                    {
                        "N": "SystemMemUsage",
                        "Sum": 11.23,
                        "U": "Megabytes"
                    },
                    {
                        "N": "CpuUsage",
                        "Sum": 35.63,
                        "U": "Percent"
                    },
                    {
                        "N": "TotalNumberOfFDs",
                        "Sum": 416,
                        "U": "Count"
                    }
                ]
            },
            {
                "TS": 1593727692,
                "NS": "arn:aws:lambda:us-west-1:123456789012:function:my-function",
                "M": [
                    {
                        "N": "LambdaOutOfMemory",
                        "Sum": 12,
                        "U": "Count"
                    },
                    {
                        "N": "LambdaUngracefullyKilled",
                        "Sum": 100,
                        "U": "Count"
                    },
                    {
                        "N": "LambdaError",
                        "Sum": 7,
                        "U": "Count"
                    }
                ]
            }
        ]
    }
}

ADP 배열에는 다음과 같은 속성을 가진 집계된 데이터 포인트 목록이 포함됩니다.

EventBridge 규칙 생성을 위한 사전 조건

AWS IoT Greengrass에 대한 EventBridge 규칙을 생성하기 전에 다음을 수행해야 합니다.

자세한 내용은 Amazon EventBridge 사용 설명서의 Amazon EventBridge란? 및 Amazon EventBridge 시작하기 섹션을 참조하세요.

원격 측정 데이터를 가져오기 위한 이벤트 규칙 생성(콘솔)

다음 단계에 따라 AWS Management Console을(를) 사용하여 Greengrass 코어에서 게시한 원격 측정 데이터를 수신하는 EventBridge 규칙을 생성할 수 있습니다. 이렇게 하면 웹 서버, 이메일 주소 및 기타 주제 구독자가 이벤트에 대응할 수 있습니다. 자세한 내용은 Amazon EventBridge User Guide의 Creating an EventBridge Rule That Triggers on an Event from an AWS Resource를 참조하세요.

원격 측정 데이터(CLI) 를 가져오기 위한 이벤트 규칙 생성

다음 단계에 따라 AWS CLI을(를) 사용하여 Greengrass 코어에서 게시한 원격 측정 데이터를 수신하는 EventBridge 규칙을 생성할 수 있습니다. 이렇게 하면 웹 서버, 이메일 주소 및 기타 주제 구독자가 이벤트에 대응할 수 있습니다.

자세한 내용은 Amazon EventBridge 사용 설명서에서 EventBridge의 이벤트 및 이벤트 패턴 섹션을 참조하세요.

AWS IoT Greengrass 원격 측정 문제 해결

다음 정보를 사용하면 AWS IoT Greengrass 원격 측정 구성 문제 해결에 도움이 됩니다.

오류: get-thing-runtime-configuration 명령을 실행한 후 응답에 “ConfigurationStatus”: “OutOfSync”가 포함됨

솔루션: