CloudWatch 측정 항목 - AWS IoT Greengrass

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

CloudWatch 측정 항목

Amazon CloudWatch 지표 구성 요소 (aws.greengrass.Cloudwatch) 는 Greengrass 코어 디바이스의 사용자 지정 지표를 Amazon에 게시합니다. CloudWatch 구성 요소를 통해 구성 요소는 CloudWatch 지표를 게시할 수 있으며, 이를 사용하여 Greengrass 코어 장치 환경을 모니터링하고 분석할 수 있습니다. 자세한 내용은 Amazon 사용 CloudWatch 설명서의 Amazon CloudWatch 측정치 사용을 참조하십시오.

이 구성 요소가 포함된 CloudWatch 지표를 게시하려면 이 구성 요소가 구독하는 주제에 메시지를 게시하십시오. 기본적으로 이 구성 요소는 cloudwatch/metric/put 로컬 게시/구독 주제를 구독합니다. 이 구성 요소를 배포할 때 AWS IoT Core MQTT 주제를 비롯한 다른 주제를 지정할 수 있습니다.

이 구성 요소는 동일한 네임스페이스에 있는 메트릭을 일괄 처리하여 정기적으로 게시합니다. CloudWatch

참고

이 구성 요소는 V1의 CloudWatch 메트릭 커넥터와 유사한 기능을 제공합니다. AWS IoT Greengrass 자세한 내용은 AWS IoT Greengrass V1 개발자 CloudWatch 안내서의 메트릭 커넥터를 참조하십시오.

버전

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

  • 3.1.x

  • 3.0.x

  • 2.1.x

  • 2.0.x

각 구성 요소 버전의 변경 사항에 대한 자세한 내용은 변경 로그를 참조하십시오.

유형

v3.x

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

v2.x

구성 요소는 Lambda 구성 요소 () 입니다. aws.greengrass.lambda Greengrass 핵은 Lambda 런처 구성 요소를 사용하여 이 구성 요소의 Lambda 함수를 실행합니다.

자세한 설명은 구성 요소 유형 섹션을 참조하세요.

운영 체제

v3.x

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

  • Linux

  • Windows

v2.x

이 구성 요소는 Linux 코어 장치에만 설치할 수 있습니다.

요구 사항

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

3.x
  • 코어 디바이스에 설치되고 PATH 환경 변수에 추가된 Python 버전 3.7입니다.

  • Greengrass 장치 역할은 다음 예시 IAM 정책에 나와 있는 것처럼 cloudwatch:PutMetricData 작업을 허용해야 합니다.

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] }

    자세한 내용은 Amazon 사용 CloudWatch 설명서의 Amazon CloudWatch 권한 참조를 참조하십시오.

2.x
  • 코어 디바이스는 Lambda 함수를 실행하기 위한 요구 사항을 충족해야 합니다. 코어 디바이스에서 컨테이너화된 Lambda 함수를 실행하려면 해당 디바이스가 해당 요구 사항을 충족해야 합니다. 자세한 설명은 Lambda 함수 요구 사항 섹션을 참조하세요.

  • 코어 디바이스에 설치되고 PATH 환경 변수에 추가된 Python 버전 3.7입니다.

  • Greengrass 장치 역할은 다음 예시 IAM 정책에 나와 있는 것처럼 cloudwatch:PutMetricData 작업을 허용해야 합니다.

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] }

    자세한 내용은 Amazon 사용 CloudWatch 설명서의 Amazon CloudWatch 권한 참조를 참조하십시오.

  • 이 구성 요소로부터 출력 데이터를 받으려면 이 구성 요소를 배포할 때 기존 구독 라우터 구성 요소 (aws.greengrass.LegacySubscriptionRouter) 에 대한 다음 구성 업데이트를 병합해야 합니다. 이 구성은 이 구성 요소가 응답을 게시하는 주제를 지정합니다.

    Legacy subscription router v2.1.xLegacy subscription router v2.0.x
    Legacy subscription router v2.1.x
    { "subscriptions": { "aws-greengrass-cloudwatch": { "id": "aws-greengrass-cloudwatch", "source": "component:aws.greengrass.Cloudwatch", "subject": "cloudwatch/metric/put/status", "target": "cloud" } } }
    Legacy subscription router v2.0.x
    { "subscriptions": { "aws-greengrass-cloudwatch": { "id": "aws-greengrass-cloudwatch", "source": "arn:aws:lambda:region:aws:function:aws-greengrass-cloudwatch:version", "subject": "cloudwatch/metric/put/status", "target": "cloud" } } }
    • 지역을 AWS 리전 사용하는 지역으로 바꾸십시오.

    • 버전을 이 구성 요소가 실행하는 Lambda 함수 버전으로 교체하십시오. Lambda 함수 버전을 찾으려면 배포하려는 이 구성 요소 버전의 레시피를 확인해야 합니다. AWS IoT Greengrass 콘솔에서 이 구성 요소의 세부 정보 페이지를 열고 Lambda 함수 키-값 쌍을 찾으십시오. 이 키-값 쌍에는 Lambda 함수의 이름과 버전이 들어 있습니다.

    중요

    이 구성 요소를 배포할 때마다 레거시 구독 라우터에서 Lambda 함수 버전을 업데이트해야 합니다. 이렇게 하면 배포하는 구성 요소 버전에 올바른 Lambda 함수 버전을 사용할 수 있습니다.

    자세한 설명은 배포 만들기 섹션을 참조하세요.

엔드포인트 및 포트

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

엔드포인트 포트 필수 설명

monitoring.region.amazonaws.com

443

지표 업로드. CloudWatch

의존성

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

3.0.0 - 3.1.0

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.0.0 <3.0.0 소프트
토큰 교환 서비스 >=0.0.0 하드
2.1.2 and 2.1.3

다음 표에는 이 구성 요소의 버전 2.1.2 및 2.1.3에 대한 종속성이 나와 있습니다.

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.0.0 <2.8.0 하드
람다 런처 ^2.0.0 하드
Lambda 런타임 ^2.0.0 소프트
토큰 교환 서비스 ^2.0.0 하드
2.1.1

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.0.0 <2.7.0 하드
람다 런처 ^2.0.0 하드
Lambda 런타임 ^2.0.0 소프트
토큰 교환 서비스 ^2.0.0 하드
2.0.8 - 2.1.0

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.0.0 <2.6.0 하드
람다 런처 ^2.0.0 하드
Lambda 런타임 ^2.0.0 소프트
토큰 교환 서비스 ^2.0.0 하드
2.0.7

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.0.0 <2.5.0 하드
람다 런처 ^2.0.0 하드
Lambda 런타임 ^2.0.0 소프트
토큰 교환 서비스 ^2.0.0 하드
2.0.6

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.0.0 <2.4.0 하드
람다 런처 ^2.0.0 하드
Lambda 런타임 ^2.0.0 소프트
토큰 교환 서비스 ^2.0.0 하드
2.0.5

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.0.0 <2.3.0 하드
람다 런처 ^2.0.0 하드
Lambda 런타임 ^2.0.0 소프트
토큰 교환 서비스 ^2.0.0 하드
2.0.4

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.0.0 <2.2.0 하드
람다 런처 ^2.0.0 하드
Lambda 런타임 ^2.0.0 소프트
토큰 교환 서비스 ^2.0.0 하드
2.0.3

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

종속성 호환되는 버전 종속성 유형
그린그래스 핵 >=2.0.3 <2.1.0 하드
람다 런처 >=1.0.0 하드
Lambda 런타임 >=1.0.0 소프트
토큰 교환 서비스 >=1.0.0 하드

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

구성

이 구성 요소는 구성 요소를 배포할 때 사용자 지정할 수 있는 다음과 같은 구성 매개 변수를 제공합니다.

v3.x
PublishInterval

(선택 사항) 구성 요소가 지정된 네임스페이스에 대해 일괄 처리된 메트릭을 게시할 때까지 기다려야 하는 최대 시간 (초). 메트릭을 수신할 때 (즉, 일괄 처리 없이) 게시하도록 구성 요소를 구성하려면 다음을 지정하십시오. 0

구성 요소는 동일한 네임스페이스에서 20개의 지표를 수신한 후 또는 지정한 간격 후에 게시합니다. CloudWatch

참고

구성 요소는 이벤트가 게시되는 순서를 지정하지 않습니다.

이 값은 최대 900초일 수 있습니다.

기본값: 10초

MaxMetricsToRetain

(선택 사항) 구성 요소가 새 메트릭으로 교체하기 전에 메모리에 저장할 모든 네임스페이스의 최대 메트릭 수입니다.

이 제한은 코어 기기가 인터넷에 연결되어 있지 않은 경우에 적용되므로 구성 요소가 나중에 게시하기 위해 메트릭을 버퍼링합니다. 버퍼가 가득 차면 구성 요소는 가장 오래된 메트릭을 최신 메트릭으로 바꿉니다. 지정된 네임스페이스의 메트릭은 동일한 네임스페이스의 메트릭만 대체합니다.

참고

구성 요소의 호스트 프로세스가 중단되는 경우 구성 요소는 메트릭을 저장하지 않습니다. 예를 들어 배포 중이나 코어 디바이스가 다시 시작될 때 이런 일이 발생할 수 있습니다.

이 값은 최소 2,000개 지표여야 합니다.

기본값: 5,000개 지표

InputTopic

(선택 사항) 구성 요소가 메시지를 수신하기 위해 구독하는 주제입니다. 를 지정하는 경우 이 true PubSubToIoTCore 항목에서 MQTT 와일드카드 (+ 및 #) 를 사용할 수 있습니다.

기본값: cloudwatch/metric/put

OutputTopic

(선택 사항) 구성 요소가 상태 응답을 게시하는 주제입니다.

기본값: cloudwatch/metric/put/status

PubSubToIoTCore

(선택 사항) AWS IoT Core MQTT 주제를 게시하고 구독할지 여부를 정의하는 문자열 값입니다. 지원되는 값은 truefalse입니다.

기본값: false

UseInstaller

(선택 사항) 이 구성 요소의 SDK 종속성을 설치하기 위해 이 구성 요소의 설치 프로그램 스크립트를 사용할지 여부를 정의하는 부울 값입니다.

사용자 지정 스크립트를 사용하여 종속성을 설치하거나 미리 빌드된 Linux 이미지에 런타임 종속성을 포함하려는 경우 이 값을 로 설정합니다. false 이 구성 요소를 사용하려면 종속성을 포함하여 다음 라이브러리를 설치하고 기본 Greengrass 시스템 사용자가 사용할 수 있도록 해야 합니다.

기본값: true

PublishRegion

(선택 사항) CloudWatch 메트릭을 게시할 대상. AWS 리전 이 값은 코어 장치의 기본 지역보다 우선합니다. 이 매개변수는 지역 간 지표에만 필요합니다.

accessControl

(선택 사항) 구성 요소가 지정된 주제를 게시하고 구독할 수 있도록 허용하는 권한 부여 정책이 포함된 객체입니다. InputTopicOutputTopic 에 대해 사용자 지정 값을 지정하는 경우 이 개체의 리소스 값을 업데이트해야 합니다.

기본값:

{ "aws.greengrass.ipc.pubsub": { "aws.greengrass.Cloudwatch:pubsub:1": { "policyDescription": "Allows access to subscribe to input topics.", "operations": [ "aws.greengrass#SubscribeToTopic" ], "resources": [ "cloudwatch/metric/put" ] }, "aws.greengrass.Cloudwatch:pubsub:2": { "policyDescription": "Allows access to publish to output topics.", "operations": [ "aws.greengrass#PublishToTopic" ], "resources": [ "cloudwatch/metric/put/status" ] } }, "aws.greengrass.ipc.mqttproxy": { "aws.greengrass.Cloudwatch:mqttproxy:1": { "policyDescription": "Allows access to subscribe to input topics.", "operations": [ "aws.greengrass#SubscribeToIoTCore" ], "resources": [ "cloudwatch/metric/put" ] }, "aws.greengrass.Cloudwatch:mqttproxy:2": { "policyDescription": "Allows access to publish to output topics.", "operations": [ "aws.greengrass#PublishToIoTCore" ], "resources": [ "cloudwatch/metric/put/status" ] } } }
예: 구성 병합 업데이트
{ "PublishInterval": 0, "PubSubToIoTCore": true }
v2.x
참고

이 구성 요소의 기본 구성에는 Lambda 함수 파라미터가 포함됩니다. 디바이스에서 이 구성 요소를 구성하려면 다음 파라미터만 편집하는 것이 좋습니다.

lambdaParams

이 구성 요소의 Lambda 함수에 대한 파라미터를 포함하는 객체입니다. 이 객체에는 다음 정보가 포함되어 있어야 합니다.

EnvironmentVariables

Lambda 함수의 파라미터를 포함하는 객체입니다. 이 객체에는 다음 정보가 포함되어 있어야 합니다.

PUBLISH_INTERVAL

(선택 사항) 구성 요소가 지정된 네임스페이스에 대한 일괄 측정치를 게시할 때까지 기다려야 하는 최대 시간 (초). 메트릭을 수신할 때 (즉, 일괄 처리 없이) 게시하도록 구성 요소를 구성하려면 다음을 지정하십시오. 0

구성 요소는 동일한 네임스페이스에서 20개의 지표를 수신한 후 또는 지정한 간격 후에 게시합니다. CloudWatch

참고

구성 요소는 이벤트가 게시되는 순서를 보장하지 않습니다.

이 값은 최대 900초일 수 있습니다.

기본값: 10초

MAX_METRICS_TO_RETAIN

(선택 사항) 구성 요소가 새 메트릭으로 교체하기 전에 메모리에 저장할 모든 네임스페이스의 최대 메트릭 수입니다.

이 제한은 코어 기기가 인터넷에 연결되어 있지 않은 경우에 적용되므로 구성 요소가 나중에 게시하기 위해 메트릭을 버퍼링합니다. 버퍼가 가득 차면 구성 요소는 가장 오래된 메트릭을 최신 메트릭으로 바꿉니다. 지정된 네임스페이스의 메트릭은 동일한 네임스페이스의 메트릭만 대체합니다.

참고

구성 요소의 호스트 프로세스가 중단되는 경우 구성 요소는 메트릭을 저장하지 않습니다. 예를 들어 배포 중이나 코어 디바이스가 다시 시작될 때 이런 일이 발생할 수 있습니다.

이 값은 최소 2,000개 지표여야 합니다.

기본값: 5,000개 지표

PUBLISH_REGION

(선택 사항) CloudWatch 지표를 AWS 리전 게시할 대상. 이 값은 코어 장치의 기본 지역보다 우선합니다. 이 매개변수는 지역 간 지표에만 필요합니다.

containerMode

(선택 사항) 이 구성요소의 컨테이너화 모드. 다음 옵션 중 하나를 선택합니다.

  • NoContainer— 구성 요소는 격리된 런타임 환경에서 실행되지 않습니다.

  • GreengrassContainer— 구성 요소는 AWS IoT Greengrass 컨테이너 내부의 격리된 런타임 환경에서 실행됩니다.

기본값: GreengrassContainer

containerParams

(선택 사항) 이 구성 요소의 컨테이너 매개 변수를 포함하는 개체입니다. 를 GreengrassContainer 지정하면 구성 요소에서 이러한 매개 변수를 사용합니다containerMode.

이 객체에는 다음 정보가 포함되어 있어야 합니다.

memorySize

(선택 사항) 구성 요소에 할당할 메모리 양 (KB).

기본값은 64MB (65,535KB) 입니다.

pubsubTopics

(선택 사항) 구성 요소가 메시지 수신을 위해 구독하는 주제를 포함하는 객체입니다. 각 주제를 지정하고 구성 요소가 MQTT 주제를 구독하는지 AWS IoT Core 아니면 로컬 게시/구독 주제의 MQTT 주제를 구독할지를 지정할 수 있습니다.

이 객체에는 다음 정보가 포함되어 있어야 합니다.

0— 문자열 형식의 배열 인덱스입니다.

다음 정보가 포함된 객체:

type

(선택 사항) 이 구성 요소가 메시지를 구독하는 데 사용하는 게시/구독 메시지의 유형입니다. 다음 옵션 중 하나를 선택합니다.

  • PUB_SUB – 로컬 게시/구독 메시지를 구독합니다. 이 옵션을 선택하면 주제에 MQTT 와일드카드가 포함될 수 없습니다. 이 옵션을 지정할 때 사용자 지정 구성 요소에서 메시지를 보내는 방법에 대한 자세한 내용은 을 참조하십시오. 로컬 메시지 게시/구독

  • IOT_CORE— AWS IoT Core MQTT 메시지를 구독하십시오. 이 옵션을 선택하면 주제에 MQTT 와일드카드가 포함될 수 있습니다. 이 옵션을 지정할 때 사용자 지정 구성 요소에서 메시지를 보내는 방법에 대한 자세한 내용은 을 참조하십시오. MQTT 메시지 게시/구독 AWS IoT Core

기본값: PUB_SUB

topic

(선택 사항) 구성 요소가 메시지 수신을 위해 구독하는 주제입니다. 를 지정하는 경우 이 IotCore type 항목에서 MQTT 와일드카드 (+#) 를 사용할 수 있습니다.

예: 구성 병합 업데이트 (컨테이너 모드)
{ "containerMode": "GreengrassContainer" }
예: 구성 병합 업데이트 (컨테이너 모드 없음)
{ "containerMode": "NoContainer" }

입력 데이터

이 구성 요소는 다음 주제에 대한 지표를 수락하고 CloudWatch 지표를 게시합니다. 기본적으로 이 구성 요소는 로컬 게시/구독 메시지를 구독합니다. 사용자 정의 구성 요소에서 이 구성 요소에 메시지를 게시하는 방법에 대한 자세한 내용은 을 참조하십시오. 로컬 메시지 게시/구독

구성 요소 버전 v3.0.0부터 구성 매개 변수를 로 설정하여 MQTT 주제를 구독하도록 이 구성 요소를 구성할 수도 있습니다. PubSubToIoTCore true 사용자 지정 구성 요소의 MQTT 주제에 메시지를 게시하는 방법에 대한 자세한 내용은 을 참조하십시오. MQTT 메시지 게시/구독 AWS IoT Core

기본 주제: cloudwatch/metric/put

메시지는 다음 속성을 허용합니다. 입력 메시지는 JSON 형식이어야 합니다.

request

이 메시지의 메트릭입니다.

요청 객체에는 CloudWatch에 게시할 지표 데이터가 포함되어 있습니다. 지표 값은 PutMetricData작업 사양을 충족해야 합니다.

다음 정보가 object 포함된 유형:

namespace

이 요청의 메트릭 데이터에 대한 사용자 정의 네임스페이스입니다. CloudWatch 네임스페이스를 지표 데이터 포인트의 컨테이너로 사용합니다.

참고

예약 문자어 AWS/로 시작하는 네임스페이스는 지정할 수 없습니다.

유형: string

유효한 패턴: [^:].*

metricData

지표에 대한 데이터.

다음 정보가 object 포함된 유형:

metricName

지표의 이름.

유형: string

value

지표에 대한 값.

참고

CloudWatch 너무 작거나 너무 큰 값은 거부합니다. 값은 ~ 1.174271e+108 (밑수 10) 또는 2e-360 ~ (기수 2) 8.515920e-109 사이여야 합니다. 2e360 CloudWatch NaN+Infinity, 및 같은 특수 값은 지원하지 않습니다-Infinity.

유형: double

dimensions

(선택 사항) 지표의 크기. 측정기준은 측정항목 및 해당 데이터에 대한 추가 정보를 제공합니다. 지표는 최대 10개 차원을 정의할 수 있습니다.

이 구성 요소에는 이름이 지정된 차원이 자동으로 포함되며coreName, 여기서 값은 코어 장치의 이름입니다.

유형: array 각각 다음 정보가 들어 있는 개체 유형:

name

(선택 사항) 차원 이름.

유형: string

value

(선택 사항) 차원 값입니다.

유형: string

timestamp

(선택 사항) 지표 데이터가 수신된 시간으로, Unix epoch 시간을 기준으로 초 단위로 표시됩니다.

구성 요소가 메시지를 수신하는 시간이 기본값입니다.

유형: double

참고

이 구성 요소를 버전 2.0.3에서 2.0.7 사이에서 사용하는 경우 단일 소스에서 여러 지표를 전송할 때 각 지표에 대해 개별적으로 타임스탬프를 검색하는 것이 좋습니다. 변수를 사용하여 타임스탬프를 저장하지 마세요.

unit

(선택 사항) 지표의 단위.

유형: string

유효한 값: SecondsMicroseconds, MillisecondsBytes,Kilobytes,Megabytes, GigabytesTerabytes,Bits,Kilobits, MegabitsGigabits,Terabits,Percent, CountBytes/Second,Kilobytes/Second,Megabytes/Second, Gigabytes/SecondTerabytes/Second,Bits/Second,Kilobits/Second, Megabits/SecondGigabits/Second,Terabits/Second,Count/Second, None

기본값은 None입니다.

참고

CloudWatch PutMetricDataAPI에 적용되는 모든 할당량은 이 구성 요소를 사용하여 게시한 지표에 적용됩니다. 다음과 같은 할당량이 특히 중요합니다.

  • API 페이로드의 40KB 제한

  • API 요청당 20개 지표

  • PutMetricData API에 대한 150개의 초당 트랜잭션(TPS)

자세한 내용은 사용 CloudWatch 설명서의 서비스 할당량을 참조하십시오. CloudWatch

예 입력 예
{ "request": { "namespace": "Greengrass", "metricData": { "metricName": "latency", "dimensions": [ { "name": "hostname", "value": "test_hostname" } ], "timestamp": 1539027324, "value": 123.0, "unit": "Seconds" } } }

출력 데이터

이 구성 요소는 기본적으로 응답을 다음 로컬 게시/구독 주제에 출력 데이터로 게시합니다. 사용자 지정 구성 요소에서 이 주제에 대한 메시지를 구독하는 방법에 대한 자세한 내용은 을 참조하십시오. 로컬 메시지 게시/구독

구성 매개 변수를 로 설정하여 MQTT 주제에 게시하도록 이 PubSubToIoTCore 구성 요소를 구성할 수도 있습니다. true 사용자 지정 구성 요소의 MQTT 주제에 대한 메시지 구독에 대한 자세한 내용은 을 참조하십시오. MQTT 메시지 게시/구독 AWS IoT Core

참고

구성 요소 버전 2.0.x는 기본적으로 응답을 MQTT 주제에 대한 출력 데이터로 게시합니다. 주제를 레거시 구독 라우터 구성 요소의 subject 구성에서와 같이 지정해야 합니다.

기본 주제: cloudwatch/metric/put/status

예 출력 예: 성공

응답에는 메트릭 데이터의 네임스페이스와 응답의 RequestId 필드가 포함됩니다. CloudWatch

{ "response": { "cloudwatch_rid": "70573243-d723-11e8-b095-75ff2EXAMPLE", "namespace": "Greengrass", "status": "success" } }
예 출력 예: 실패
{ "response" : { "namespace": "Greengrass", "error": "InvalidInputException", "error_message": "cw metric is invalid", "status": "fail" } }
참고

구성 요소가 연결 오류와 같이 재시도할 수 있는 오류를 감지하면 다음 배치에서 게시를 다시 시도합니다.

라이선스

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

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

로컬 로그 파일

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

Linux
/greengrass/v2/logs/aws.greengrass.Cloudwatch.log
Windows
C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.log
이 구성 요소의 로그를 보려면
  • 코어 기기에서 다음 명령을 실행하여 이 구성 요소의 로그 파일을 실시간으로 확인합니다. /greengrass/v2또는 C:\greengrass\v2 를 AWS IoT Greengrass 루트 폴더 경로로 바꿉니다.

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

Changelog

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

v3.x

버전

변경

3.1.0

버그 수정 및 개선

3.0.0

이 버전의 CloudWatch 메트릭 구성 요소에는 버전 2.x와 다른 구성 매개 변수가 필요합니다. 버전 2.x에 대해 기본이 아닌 구성을 사용하고 v2.x에서 v3.x로 업그레이드하려면 구성 요소의 구성을 업데이트해야 합니다. 자세한 내용은 메트릭 구성 요소 구성을 참조하십시오. CloudWatch

새로운 기능
  • Windows를 실행하는 핵심 장치에 대한 지원을 추가합니다.

  • 구성 요소 유형을 Lambda 구성 요소에서 일반 구성 요소로 변경합니다. 이제 이 구성 요소는 구독을 생성할 때 더 이상 기존 구독 라우터 구성 요소에 의존하지 않습니다.

  • InputTopic구성 요소가 메시지를 수신하기 위해 구독하는 주제를 지정하는 새 구성 매개 변수를 추가합니다.

  • OutputTopic구성 요소가 상태 응답을 게시하는 주제를 지정하는 새 구성 매개 변수를 추가합니다.

  • AWS IoT Core MQTT 주제를 게시하고 구독할지 여부를 지정하는 새 PubSubToIoTCore 구성 매개 변수를 추가합니다.

  • UseInstaller구성 요소 종속성을 설치하는 설치 스크립트를 선택적으로 비활성화할 수 있는 새 구성 매개 변수를 추가합니다.

버그 수정 및 개선

입력 데이터의 중복 타임스탬프에 대한 지원을 추가합니다.

v2.x

버전

변경

2.1.3

그린그래스 뉴클리어스 버전 2.11.0 릴리스를 위해 버전이 업데이트되었습니다.

2.1.2

Greengrass 뉴클리어스 버전 2.7.0 릴리스를 위해 버전이 업데이트되었습니다.

2.1.1

Greengrass 뉴클리어스 버전 2.6.0 릴리스를 위해 버전이 업데이트되었습니다.

2.1.0

새로운 기능

2.0.8

버그 수정 및 개선
  • 입력 데이터의 중복 타임스탬프에 대한 지원을 추가합니다.

  • Greengrass 뉴클리어스 버전 2.5.0 릴리스를 위해 버전이 업데이트되었습니다.

2.0.7

그린그래스 뉴클리어스 버전 2.4.0 릴리스를 위해 버전이 업데이트되었습니다.

2.0.6

그린그래스 뉴클리어스 버전 2.3.0 릴리스를 위해 버전이 업데이트되었습니다.

2.0.5

Greengrass 뉴클리어스 버전 2.2.0 릴리스를 위해 버전이 업데이트되었습니다.

2.0.4

그린그래스 뉴클리어스 버전 2.1.0 릴리스에 대한 버전이 업데이트되었습니다.

2.0.3

초기 버전

다음 사항도 참조하십시오.