모니터 AWS IoT Greengrass 로그 - AWS IoT Greengrass
파일 시스템 로그에 액세스하십시오.액세스 로그 CloudWatch 시스템 서비스 로그에 액세스 CloudWatch 로그에 로깅을 활성화합니다.AWS IoT Greengrass의 로깅 구성AWS CloudTrail 로그

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

모니터 AWS IoT Greengrass 로그

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

기본적으로 AWS IoT Greengrass Core 소프트웨어는 로컬 파일 시스템에만 로그를 기록합니다. 파일 시스템 로그를 실시간으로 볼 수 있으므로 개발 및 배포한 Greengrass 구성 요소를 디버깅할 수 있습니다. 또한 로그에 로그를 기록하도록 코어 디바이스를 구성할 수 있으므로 로컬 파일 시스템에 액세스하지 않고도 코어 디바이스 문제를 해결할 수 있습니다. CloudWatch 자세한 설명은 CloudWatch 로그에 로깅을 활성화합니다. 섹션을 참조하세요.

파일 시스템 로그에 액세스하십시오.

AWS IoT GreengrassCore 소프트웨어는 코어 디바이스의 /greengrass/v2/logs 폴더에 로그를 저장합니다. 여기서 /greengrass/v2 는 AWS IoT Greengrass 루트 폴더의 경로입니다. 로그 폴더의 구조는 다음과 같습니다.

/greengrass/v2
└── logs
    ├── greengrass.log
    ├── greengrass_2021_09_14_15_0.log
    ├── ComponentName.log
    ├── ComponentName_2021_09_14_15_0.log
    └── main.log

플러그인, 제네릭 및 Lambda 구성 요소 간의 차이점에 대한 자세한 내용은 을 참조하십시오. 구성 요소 유형

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

  • 루트 사용자 권한

    파일 시스템에서 AWS IoT Greengrass 로그를 읽을 수 있는 루트 권한이 있어야 합니다.

  • 로그 파일 로테이션

    AWS IoT GreengrassCore 소프트웨어는 1시간마다 또는 파일 크기 제한을 초과할 때마다 로그 파일을 순환합니다. 순환된 로그 파일의 파일 이름에는 타임스탬프가 포함됩니다. 예를 들어 회전된 AWS IoT Greengrass Core 소프트웨어 로그 파일의 이름을 지정할 수 있습니다. greengrass_2021_09_14_15_0.log 기본 파일 크기 제한은 1,024KB (1MB) 입니다. Greengrass nucleus 컴포넌트에서 파일 크기 제한을 구성할 수 있습니다.

  • 로그 파일 삭제

    AWS IoT GreengrassCore 소프트웨어는 Core 소프트웨어 로그 파일 또는 Greengrass 구성 요소 로그 파일 (회전된 로그 파일 포함) 의 AWS IoT Greengrass 크기가 디스크 공간 제한을 초과하는 경우 이전 로그 파일을 정리합니다. AWS IoT GreengrassCore 소프트웨어 로그와 각 구성 요소 로그의 기본 디스크 공간 제한은 10,240KB (10MB) 입니다. Greengrass nucleus 구성 요소 또는 로그 관리자 구성 요소에서 AWS IoT Greengrass Core 소프트웨어 로그 디스크 공간 제한을 구성할 수 있습니다. 로그 관리자 구성 요소에서 각 구성 요소의 로그 디스크 공간 제한을 구성할 수 있습니다.

AWS IoT GreengrassCore 소프트웨어 로그 파일을 보려면

  • 다음 명령을 실행하여 로그 파일을 실시간으로 확인합니다. AWS IoT Greengrass루트 폴더 /greengrass/v2 경로로 바꿉니다.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\logs\com.example.HelloWorld.log

    이 type 명령은 파일 내용을 터미널에 기록합니다. 이 명령을 여러 번 실행하여 파일의 변경 사항을 관찰하십시오.

    PowerShell
    gc C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
구성 요소의 로그 파일을 보려면

  • 다음 명령을 실행하여 로그 파일을 실시간으로 확인합니다. /greengrass/v2또는 C:\greengrass\v2 를 AWS IoT Greengrass 루트 폴더 경로로 바꾸고 com.example을 대체합니다. HelloWorld구성 요소 이름과 함께.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
    PowerShell
    gc C:\greengrass\v2\logs\com.example.HelloWorld.log -Tail 10 -Wait

또한 Greengrass CLI의 logs 명령을 사용하여 코어 디바이스의 그린그래스 로그를 분석할 수 있습니다. logs명령을 사용하려면 JSON 형식 로그 파일을 출력하도록 Greengrass 핵을 구성해야 합니다. 자세한 내용은 그린그래스 커맨드 라인 인터페이스 및 로그 섹션을 참조하세요.

액세스 로그 CloudWatch

로그 관리자 구성 요소를 배포하여 CloudWatch 로그에 기록하도록 코어 장치를 구성할 수 있습니다. 자세한 설명은 CloudWatch 로그에 로깅을 활성화합니다. 섹션을 참조하세요. 그러면 Amazon CloudWatch 콘솔의 로그 페이지에서 또는 Logs API를 사용하여 CloudWatch 로그를 볼 수 있습니다.

로그 그룹 이름
/aws/greengrass/componentType/region/componentName

로그 그룹 이름은 다음 변수를 사용합니다.

  • componentType— 구성 요소의 유형으로, 다음 중 하나일 수 있습니다.

    • GreengrassSystemComponent— 이 로그 그룹에는 Greengrass 핵과 동일한 JVM에서 실행되는 핵 및 플러그인 구성 요소에 대한 로그가 포함됩니다. 구성 요소는 Greengrass 핵의 일부입니다.

    • UserComponent— 이 로그 그룹에는 일반 구성 요소, Lambda 구성 요소 및 디바이스의 기타 애플리케이션에 대한 로그가 포함됩니다. 구성 요소는 Greengrass 핵의 일부가 아닙니다.

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

  • region— 코어 디바이스가 사용하는 AWS 지역.

  • componentName— 구성 요소의 이름. 시스템 로그의 경우 이 값은 입니다System.

로그 스트림 이름
/date/thing/thingName

로그 스트림 이름은 다음 변수를 사용합니다.

  • date— 로그 날짜 (예:2020/12/15. 로그 관리자 구성 요소는 yyyy/MM/dd 형식을 사용합니다.

  • thingName— 코어 디바이스의 이름.

참고

사물 이름에 콜론 (:) 이 포함된 경우 로그 관리자는 콜론을 더하기 () 로 바꿉니다. +

로그 관리자 구성 요소를 사용하여 로그에 기록할 때는 다음 고려 사항이 적용됩니다. CloudWatch

  • 로그 지연

    참고

    순환 및 활성 로그 파일의 로그 지연을 줄이는 로그 관리자 버전 2.3.0으로 업그레이드하는 것이 좋습니다. 로그 관리자 2.3.0으로 업그레이드할 때는 Greengrass nucleus 2.9.1으로도 업그레이드하는 것이 좋습니다.

    로그 관리자 구성 요소 버전 2.2.8 (이하) 은 순환된 로그 파일의 로그만 처리하고 업로드합니다. 기본적으로 AWS IoT Greengrass Core 소프트웨어는 1시간마다 또는 1,024KB가 된 이후에 로그 파일을 교체합니다. 따라서 로그 관리자 구성 요소는 AWS IoT Greengrass Core 소프트웨어 또는 Greengrass 구성 요소가 1,024KB 이상의 로그를 기록한 후에만 로그를 업로드합니다. 로그 파일 크기를 낮게 제한하여 로그 파일이 더 자주 회전하도록 구성할 수 있습니다. 이로 인해 로그 관리자 구성 요소가 로그를 로그에 CloudWatch 더 자주 업로드합니다.

    로그 관리자 구성 요소 버전 2.3.0 (이상) 은 모든 로그를 처리하고 업로드합니다. 새 로그를 작성하면 로그 관리자 버전 2.3.0 (이상) 은 활성 로그 파일이 회전될 때까지 기다리지 않고 해당 활성 로그 파일을 처리하여 직접 업로드합니다. 즉, 5분 이내에 새 로그를 볼 수 있습니다.

    로그 관리자 구성 요소는 새 로그를 주기적으로 업로드합니다. 기본적으로 로그 관리자 구성 요소는 5분마다 새 로그를 업로드합니다. 업로드 간격을 낮게 구성하여 로그 관리자 구성 요소가 로그를 로그에 더 자주 업로드하도록 CloudWatch 구성할 수 있습니다. periodicUploadIntervalSec 이 주기적 간격을 구성하는 방법에 대한 자세한 내용은 구성을 참조하십시오.

    동일한 Greengrass 파일 시스템에서 거의 실시간으로 로그를 업로드할 수 있습니다. 로그를 실시간으로 관찰해야 하는 경우 파일 시스템 로그를 사용하는 것이 좋습니다.

    참고

    다른 파일 시스템을 사용하여 로그를 기록하는 경우 로그 관리자는 로그 관리자 구성 요소 버전 2.2.8 및 이전 버전의 동작으로 되돌아갑니다. 파일 시스템 로그에 액세스하는 방법에 대한 자세한 내용은 파일 시스템 로그 액세스를 참조하십시오.

  • 클럭 스큐

    로그 관리자 구성요소는 표준 서명 버전 4 서명 프로세스를 사용하여 CloudWatch 로그에 대한 API 요청을 생성합니다. 코어 디바이스의 시스템 시간이 15분 이상 동기화되지 않으면 CloudWatch Logs는 요청을 거부합니다. 자세한 정보는 AWS 일반 참조의 서명 버전 4 서명 프로세스를 참조하십시오.

시스템 서비스 로그에 액세스

AWS IoT GreengrassCore 소프트웨어를 시스템 서비스로 구성하면 시스템 서비스 로그를 보고 소프트웨어 시작 실패와 같은 문제를 해결할 수 있습니다.

시스템 서비스 로그 (CLI) 를 보려면

  1. 다음 명령을 실행하여 AWS IoT Greengrass 코어 소프트웨어 시스템 서비스 로그를 확인합니다.

    Linux or Unix (systemd)
    sudo journalctl -u greengrass.service
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\logs\greengrass.wrapper.log
    PowerShell
    gc C:\greengrass\v2\logs\greengrass.wrapper.log

  2. Windows 장치에서 AWS IoT Greengrass Core 소프트웨어는 시스템 서비스 오류에 대한 별도의 로그 파일을 생성합니다. 다음 명령을 실행하여 시스템 서비스 오류 로그를 확인합니다.

    Windows Command Prompt (CMD)
    type C:\greengrass\v2\logs\greengrass.err.log
    PowerShell
    gc C:\greengrass\v2\logs\greengrass.err.log

Windows 장치에서는 이벤트 뷰어 애플리케이션을 사용하여 시스템 서비스 로그를 볼 수도 있습니다.

Windows 서비스 로그를 보려면 (이벤트 뷰어)

  1. 이벤트 뷰어 애플리케이션을 엽니다.

  2. Windows 로그를 선택하여 확장합니다.

  3. 응용 프로그램 서비스 로그를 보려면 [응용 프로그램] 을 선택합니다.

  4. 소스가 있는 이벤트 로그를 찾아 엽니다 greengrass.

CloudWatch 로그에 로깅을 활성화합니다.

로그 관리자 구성 요소를 배포하여 로그에 로그를 기록하도록 코어 디바이스를 구성할 수 CloudWatch 있습니다. CloudWatch Logs for AWS IoT Greengrass Core 소프트웨어 로그를 활성화하고 특정 Greengrass 구성 요소에 대한 CloudWatch 로그를 활성화할 수 있습니다.

참고

Greengrass 코어 디바이스의 토큰 교환 역할은 다음 예시 IAM 정책에 나와 있는 것처럼 코어 디바이스가 CloudWatch 로그에 쓸 수 있도록 허용해야 합니다. 자동 리소스 프로비저닝으로 AWS IoT Greengrass Core 소프트웨어를 설치한 경우 코어 기기는 이러한 권한을 가집니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:DescribeLogStreams"
      ],
      "Effect": "Allow",
      "Resource": "arn:aws:logs:*:*:*"
    }
  ]
}

코어 소프트웨어 로그를 로그에 기록하도록 AWS IoT Greengrass 코어 디바이스를 구성하려면 CloudWatch 구성 aws.greengrass.LogManager 요소에 true 대해 로 설정하는 구성 업데이트를 지정하는 uploadToCloudWatch배포를 생성하십시오. AWS IoT Greengrass 핵심 소프트웨어 로그에는 Greengrass 핵 및 플러그인 구성 요소에 대한 로그가 포함됩니다.

{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true"
    }
  }
}

Greengrass 구성 요소의 로그를 Logs에 CloudWatch 기록하도록 코어 디바이스를 구성하려면 구성 요소 로깅 구성 목록에 구성 요소를 추가하는 구성 업데이트를 지정하는 배포를 생성하십시오. 이 목록에 구성 요소를 추가하면 로그 관리자 구성 요소가 로그를 로그에 CloudWatch 기록합니다. 구성 요소 로그에는 일반 구성 요소 및 Lambda 구성 요소에 대한 로그가 포함됩니다.

{
  "logsUploaderConfiguration": {
    "componentLogsConfigurationMap": {
      "com.example.HelloWorld": {
      
      }
    }
  }
}

로그 관리자 구성 요소를 배포할 때 디스크 공간 제한과 코어 디바이스가 로그 파일을 Logs에 기록한 후 삭제할지 여부도 구성할 수 있습니다. CloudWatch 자세한 설명은 AWS IoT Greengrass의 로깅 구성 섹션을 참조하세요.

AWS IoT Greengrass의 로깅 구성

다음 옵션을 구성하여 Greengrass 코어 장치에 대한 로깅을 사용자 지정할 수 있습니다. 이러한 옵션을 구성하려면 Greengrass nucleus 또는 log manager 구성 요소에 대한 구성 업데이트를 지정하는 배포를 생성하십시오.

  • 로그에 로그 쓰기 CloudWatch

    코어 디바이스의 문제를 원격으로 해결하려면 코어 소프트웨어와 구성 요소 로그를 로그에 기록하도록 AWS IoT Greengrass 코어 디바이스를 구성할 수 있습니다. CloudWatch 이렇게 하려면 로그 관리자 구성 요소를 배포하고 구성해야 합니다. 자세한 설명은 CloudWatch 로그에 로깅을 활성화합니다. 섹션을 참조하세요.

  • 업로드된 로그 파일 삭제

    디스크 공간 사용량을 줄이려면 로그 파일을 로그에 기록한 후 로그 파일을 삭제하도록 코어 디바이스를 구성할 수 있습니다. CloudWatch 자세한 내용은 AWS IoT GreengrassCore 소프트웨어 로그 및 구성 요소 로그에 지정할 수 있는 로그 관리자 구성 요소의 deleteLogFileAfterCloudUpload 매개 변수를 참조하십시오.

  • 로그 디스크 공간 제한

    디스크 공간 사용을 제한하려면 코어 장치에서 회전된 로그 파일을 포함하여 각 로그의 최대 디스크 공간을 구성할 수 있습니다. 예를 들어, 파일을 합친 최대 디스크 greengrass.log 공간과 greengrass.log 회전된 파일을 구성할 수 있습니다. 자세한 내용은 Greengrass nucleus 구성 요소의 logging.totalLogsSizeKB 매개 변수 및 AWS IoT GreengrassCore 소프트웨어 로그 및 구성 요소 로그에 대해 지정할 수 있는 로그 관리자 구성 요소의 diskSpaceLimit 매개 변수를 참조하십시오.

  • 로그 파일 크기 제한

    각 로그 파일의 최대 파일 크기를 구성할 수 있습니다. 로그 파일이 이 파일 크기 제한을 초과하면 AWS IoT Greengrass Core 소프트웨어에서 새 로그 파일을 생성합니다. 로그 관리자 구성 요소 버전 2.28 (이하) 은 회전된 로그 파일만 CloudWatch 로그에 기록하므로 더 낮은 파일 크기 제한을 지정하여 로그에 CloudWatch 로그를 더 자주 쓸 수 있습니다. 로그 관리자 구성 요소 버전 2.3.0 (이상) 은 순환될 때까지 기다리지 않고 모든 로그를 처리하고 업로드합니다. 자세한 내용은 Greengrass nucleus 구성 요소의 로그 파일 크기 제한 매개 변수 () 를 참조하십시오. logging.fileSizeKB

  • 최소 로그 수준

    Greengrass nucleus 구성 요소가 파일 시스템 로그에 기록하는 최소 로그 수준을 구성할 수 있습니다. 예를 들어 문제 해결에 도움이 되는 DEBUG 레벨 로그를 지정하거나 코어 디바이스에서 생성하는 로그의 양을 줄이기 위해 ERROR 레벨 로그를 지정할 수 있습니다. 자세한 내용은 Greengrass nucleus 컴포넌트의 로그 레벨 파라미터 () 를 참조하십시오. logging.level

    또한 로그 관리자 구성 요소가 로그에 기록하는 최소 로그 수준을 구성할 수 있습니다. CloudWatch 예를 들어, 더 높은 로그 수준을 지정하여 로깅 비용을 줄일 수 있습니다. 자세한 내용은 AWS IoT Greengrass코어 소프트웨어 로그 및 구성 요소 로그에 지정할 수 있는 로그 관리자 구성 요소의 minimumLogLevel 매개 변수를 참조하십시오.

  • 로그에 기록할 CloudWatch 로그를 확인하는 간격

    로그 관리자 구성 요소가 로그에 로그를 기록하는 빈도를 늘리거나 줄이려면 CloudWatch 기록할 새 로그 파일이 있는지 확인하는 간격을 구성할 수 있습니다. 예를 들어, 기본 5분 간격보다 빨리 로그에서 CloudWatch 로그를 볼 수 있는 간격을 더 짧게 지정할 수 있습니다. 로그 관리자 구성 요소가 로그 파일을 더 적은 수의 요청으로 일괄 처리하므로 비용을 줄이기 위해 간격을 더 높게 지정할 수 있습니다. 자세한 내용은 로그 관리자 구성 요소의 업로드 간격 매개 변수 (periodicUploadIntervalSec) 를 참조하십시오.

  • 로그 형식

    AWS IoT GreengrassCore 소프트웨어에서 로그를 텍스트 또는 JSON 형식으로 작성할지 선택할 수 있습니다. 로그를 읽는 경우 텍스트 형식을 선택하고, 애플리케이션을 사용하여 로그를 읽거나 분석하는 경우 JSON 형식을 선택합니다. 자세한 내용은 Greengrass nucleus 구성 요소의 로그 형식 매개 변수 () 를 참조하십시오. logging.format

  • 로컬 파일 시스템 로그 폴더

    로그 폴더를 코어 디바이스의 다른 폴더로 변경할 수 있습니다. /greengrass/v2/logs 자세한 내용은 Greengrass nucleus 컴포넌트의 출력 디렉토리 파라미터 () 를 참조하십시오. logging.outputDirectory

AWS CloudTrail 로그

AWS IoT Greengrass사용자AWS CloudTrail, 역할 또는 역할 내에서 수행한 작업에 대한 기록을 제공하는 서비스와 통합됩니다. AWS 서비스 AWS IoT Greengrass 자세한 내용은 로 AWS IoT Greengrass V2 API 통화 기록 AWS CloudTrail을(를) 참조하세요.