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 로그를 사용하여 모니터링

AWS IoT Greengrass은(는) 클라우드 서비스와 AWS IoT Greengrass 코어 소프트웨어로 구성됩니다. AWS IoT GreengrassCore 소프트웨어는 Amazon CloudWatch 및 코어 디바이스의 로컬 파일 시스템에 로그를 기록할 수 있습니다. 코어에서 실행되는 Lambda 함수 및 커넥터는 로그 및 로컬 파일 시스템에 로그를 CloudWatch 기록할 수도 있습니다. 로그를 사용하여 이벤트를 모니터링하고 문제를 해결할 수 있습니다. 모든 AWS IoT Greengrass 로그 항목에는 타임스탬프, 로그 수준 및 이벤트에 대한 정보가 포함됩니다. 로깅 설정에 대한 변경 사항은 그룹을 배포한 후에 적용됩니다.

로깅은 그룹 수준에서 구성됩니다. Greengrass 그룹에 대한 로깅을 구성하는 방법을 보여주는 단계는 AWS IoT Greengrass의 로깅 구성 단원을 참조하십시오.

로그 액세스 CloudWatch

CloudWatch 로깅을 구성하면 Amazon CloudWatch 콘솔의 로그 페이지에서 로그를 볼 수 있습니다. AWS IoT Greengrass 로그의 로그 그룹은 다음과 같은 이름 지정 규칙을 사용합니다.

/aws/greengrass/GreengrassSystem/greengrass-system-component-name
/aws/greengrass/Lambda/aws-region/account-id/lambda-function-name

각 로그 그룹에는 다음 명명 규칙을 사용하는 로그 스트림이 포함되어 있습니다.

date/account-id/greengrass-group-id/name-of-core-that-generated-log

CloudWatch 로그를 사용할 때는 다음 고려 사항이 적용됩니다.

파일 시스템 로그 액세스

파일 시스템 로깅을 구성하면 로그 파일이 코어 디바이스에 greengrass-root/ggc/var/log 아래 저장됩니다. 다음은 상위 디렉터리 구조입니다.

greengrass-root/ggc/var/log
    - crash.log
    - system
        - log files for each Greengrass system component
    - user
        - region
            - account-id
                - log files generated by each user-defined Lambda function
            - aws
                - log files generated by each connector

파일 시스템 로그 사용 시 다음 사항을 고려하십시오.

기본 로깅 구성

로깅 설정이 명시적으로 구성되어 있지 않으면 AWS IoT Greengrass은(는) 첫 번째 그룹 배포 후 다음과 같은 기본 로깅 구성을 사용합니다.

AWS IoT Greengrass의 로깅 구성

AWS IoT 또는 AWS IoT Greengrass API를 사용하여 AWS IoT Greengrass 로깅을 구성할 수 있습니다.

로깅 구성(콘솔)

그룹의 설정 페이지에서 로깅을 구성할 수 있습니다.

로깅 구성(API)

AWS IoT Greengrass 로거 API를 사용하여 프로그래밍 방식으로 로깅을 구성할 수 있습니다. 예를 들어, CreateLoggerDefinition 작업을 사용하여 다음 구문을 사용하는 LoggerDefinitionVersion 페이로드를 기반으로 로거 정의를 생성합니다.

{
  "Loggers": [
    {
      "Id": "string",
      "Type": "FileSystem|AWSCloudWatch",
      "Component": "GreengrassSystem|Lambda",
      "Level": "DEBUG|INFO|WARN|ERROR|FATAL",
      "Space": "integer"
    },
    {
      "Id": "string",
      ...
    }
  ]
}

LoggerDefinitionVersion은 다음 속성이 있는 하나 이상의 Logger 객체 배열입니다.

구성 예

다음 LoggerDefinitionVersion 예제는 다음과 같은 작업을 수행하는 로깅 구성을 지정합니다.

{
  "Name": "LoggingExample",
  "InitialVersion": {
    "Loggers": [
      {
        "Id": "1",
        "Component": "GreengrassSystem",
        "Level": "ERROR",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "2",
        "Component": "Lambda",
        "Level": "INFO",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "3",
        "Component": "Lambda",
        "Level": "INFO",
        "Type": "AWSCloudWatch"
      }
    ]
  }
}

로거 정의 버전을 생성한 후에는 그룹을 배포하기 전에 해당 버전 ARN을 사용하여 그룹 버전을 생성할 수 있습니다.

로깅 제한

AWS IoT Greengrass에는 다음과 같은 로깅 제한이 있습니다.

초당 트랜잭션 수

CloudWatch 로깅이 활성화되면 로깅 구성 요소가 이벤트를 전송하기 전에 로컬로 이벤트를 일괄 처리하므로 로그 스트림당 초당 5개 이상의 요청 속도로 로깅할 수 있습니다. CloudWatch

메모리

Lambda 함수가 로그를 전송하도록 구성되어 CloudWatch 있고 Lambda 함수가 초당 5MB를 초과하여 장기간 로깅하는 경우 AWS IoT Greengrass 내부 처리 파이프라인이 결국 꽉 차게 됩니다. 이론상 최악의 경우는 Lambda 함수 1개당 6MB입니다.

클록 스큐

CloudWatch 로깅이 활성화되면 로깅 구성 요소는 일반 서명 버전 4 서명 프로세스를 CloudWatch 사용하여 요청에 서명합니다. AWS IoT Greengrass 코어 디바이스에서 시스템 시간이 15분 이상 동기화되지 않을 경우, 해당 요청은 거부됩니다.

디스크 사용량

다음 공식을 사용하면 로깅 시 총 디스크 사용량의 최대값을 계산할 수 있습니다.

greengrass-system-component-space * 8    // 7 if automatic IP detection is disabled
  + 128KB                                // the internal log for the local logging component
  + lambda-space * lambda-count          // different versions of a Lambda function are treated as one

위치:

로그 손실

AWS IoT Greengrass코어 디바이스가 로그인만 하도록 CloudWatch 구성되어 있고 인터넷에 연결되어 있지 않으면 현재 메모리에 있는 로그를 검색할 방법이 없습니다.

Lambda 함수가 종료되면 (예: 배포 중) 몇 초 분량의 로그가 기록되지 않습니다. CloudWatch

CloudTrail 로그

AWS IoT Greengrass는 AWS IoT Greengrass에서 사용자, 역할, 또는 AWS 서비스가 수행한 작업에 대한 레코드를 제공하는 서비스인 AWS CloudTrail와 함께 실행됩니다. 자세한 내용은 AWS CloudTrail을 사용하여 AWS IoT Greengrass API 직접 호출 로깅을(를) 참조하세요.