로그 - AWS IoT Greengrass
get목록 키워드list-log-files

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

로그

logs명령을 사용하여 코어 디바이스의 Greengrass 로그를 분석할 수 있습니다.

하위 명령

get

Greengrass 로그 파일을 수집, 필터링 및 시각화합니다. 이 명령은 JSON 형식의 로그 파일만 지원합니다. nucleus 구성에서 로깅 형식을 지정할 수 있습니다.

시놉시스
greengrass-cli logs get
    [--log-dir path/to/a/log/folder]
    [--log-file path/to/a/log/file]
    [--follow true | false ]
    [--filter <filter> ]
    [--time-window <start-time>,<end-time> ]
    [--verbose ]
    [--no-color ]
    [--before <value> ]
    [--after <value> ]
    [--syslog ]
    [--max-long-queue-size <value> ]
인수

  • --log-dir,-ld. 로그 파일을 확인할 디렉터리 경로 (예:/greengrass/v2/logs. 와 함께 사용하지 마십시오--syslog. 지정할 추가 디렉터리마다 별도의 인수를 사용하십시오. --log-dir또는 중 하나 이상을 사용해야 --log-file 합니다. 단일 명령에 두 인수를 모두 사용할 수도 있습니다.

  • --log-file,-lf. 사용하려는 로그 디렉터리의 경로 지정할 추가 디렉터리마다 별도의 인수를 사용합니다. --log-dir또는 중 하나 이상을 사용해야 --log-file 합니다. 단일 명령에 두 인수를 모두 사용할 수도 있습니다.

  • --follow,-fol. 로그 업데이트가 발생하는 대로 표시합니다. Greengrass CLI는 계속 실행되며 지정된 로그에서 읽습니다. 기간을 지정하는 경우 Greengrass CLI는 모든 기간이 종료된 후 로그 모니터링을 중지합니다.

  • --filter,. -f 필터로 사용할 키워드, 정규 표현식 또는 키-값 쌍. 이 값을 문자열, 정규 표현식 또는 키-값 쌍으로 제공하십시오. 지정할 각 추가 필터에 대해 별도의 인수를 사용하십시오.

    평가 시 단일 인수에 지정된 여러 필터는 OR 연산자로 구분되고 추가 인수에 지정된 필터는 AND 연산자와 결합됩니다. 예를 들어 명령에 이 포함된 --filter "installed" --filter "name=alpha,name=beta" 경우 Greengrass CLI는 키워드와 값이 또는 인 name 키를 모두 포함하는 로그 메시지를 installed 필터링하고 표시합니다. alpha beta

  • --time-window,. -t 로그 정보를 표시할 시간 창입니다. 정확한 타임스탬프와 상대 오프셋을 모두 사용할 수 있습니다. 이 정보는 다음 형식으로 제공해야 합니다. <begin-time>,<end-time> 시작 시간이나 종료 시간을 지정하지 않는 경우 해당 옵션의 기본값은 현재 시스템 날짜 및 시간입니다. 지정할 추가 시간 창마다 별도의 인수를 사용하십시오.

    Greengrass CLI는 다음과 같은 타임스탬프 형식을 지원합니다.

    • yyyy-MM-DD예를 들어,. 2020-06-30 이 형식을 사용하는 경우 기본 시간은 00:00:00 입니다.

      yyyyMMDD예를 들어,. 20200630 이 형식을 사용하는 경우 기본 시간은 00:00:00 입니다.

      HH:mm:ss예를 들어,. 15:30:45 이 형식을 사용할 경우 날짜는 현재 시스템 날짜로 기본 설정됩니다.

      HH:mm:ssSSS예를 들어,15:30:45. 이 형식을 사용할 경우 날짜는 현재 시스템 날짜로 기본 설정됩니다.

      YYYY-MM-DD'T'HH:mm:ss'Z'예를 들어,2020-06-30T15:30:45Z.

      YYYY-MM-DD'T'HH:mm:ss, 예를 들어,2020-06-30T15:30:45.

      yyyy-MM-dd'T'HH:mm:ss.SSS, 예를 들어,2020-06-30T15:30:45.250.

    상대 오프셋은 현재 시스템 시간으로부터의 기간 오프셋을 지정합니다. Greengrass CLI는 상대 오프셋에 대해 다음 형식을 지원합니다. +|-[<value>h|hr|hours][valuem|min|minutes][value]s|sec|seconds

    예를 들어, 현재 시간보다 1시간에서 2시간 15분 전 사이의 시간 창을 지정하는 다음 인수는 입니다. --time-window -2h15min,-1hr

  • --verbose. 로그 메시지의 모든 필드를 표시합니다. 와 함께 사용하지 마십시오--syslog.

  • --no-color,-nc. 색상 코딩을 제거합니다. 로그 메시지의 기본 색상 코딩은 굵은 빨간색 텍스트를 사용합니다. ANSI 이스케이프 시퀀스를 사용하므로 Unix 계열 터미널만 지원합니다.

  • --before,-b. 일치하는 로그 항목 앞에 표시할 줄 수입니다. 기본값은 0.

  • --after,-a. 일치하는 로그 항목 다음에 표시할 줄 수입니다. 기본값은 0.

  • --syslog. RFC3164 정의된 syslog 프로토콜을 사용하여 모든 로그 파일을 처리합니다. 및 와 함께 --log-dir 사용하지 마십시오. --verbose syslog 프로토콜은 다음 형식을 사용합니다. "<$Priority>$Timestamp $Host $Logger ($Class): $Message" 로그 파일을 지정하지 않으면 Greengrass CLI는, 또는 에서 로그 메시지를 읽습니다. /var/log/messages /var/log/syslog /var/log/system.log

    AWS IoT Greengrass현재 Windows 코어 디바이스에서는 이 기능을 지원하지 않습니다.

  • --max-log-queue-size,-m. 메모리에 할당할 최대 로그 항목 수입니다. 이 옵션을 사용하면 메모리 사용을 최적화할 수 있습니다. 기본값은 100입니다.

출력

다음 예제는 이 명령을 실행할 때 생성되는 출력을 보여줍니다.

$ sudo greengrass-cli logs get --verbose \
    --log-file /greengrass/v2/logs/greengrass.log \
    --filter deployment,serviceName=DeploymentService \
    --filter level=INFO \
    --time-window 2020-12-08T01:11:17,2020-12-08T01:11:22

2020-12-08T01:11:17.615Z [INFO] (pool-2-thread-14) com.aws.greengrass.deployment.DeploymentService: Current deployment finished. {DeploymentId=44d89f46-1a29-4044-ad89-5151213dfcbc, serviceName=DeploymentService, currentState=RUNNING}
2020-12-08T01:11:17.675Z [INFO] (pool-2-thread-14) com.aws.greengrass.deployment.IotJobsHelper: Updating status of persisted deployment. {Status=SUCCEEDED, StatusDetails={detailed-deployment-status=SUCCESSFUL}, ThingName=MyThing, JobId=22d89f46-1a29-4044-ad89-5151213dfcbc

목록 키워드

로그 파일을 필터링하는 데 사용할 수 있는 추천 키워드를 표시합니다.

시놉시스
greengrass-cli logs list-keywords [arguments]
인수

None

출력

다음 예제는 이 명령을 실행할 때 생성되는 출력을 보여줍니다.

$ sudo greengrass-cli logs list-keywords

Here is a list of suggested keywords for Greengrass log:
level=$str
thread=$str
loggerName=$str
eventType=$str
serviceName=$str
error=$str
$ sudo greengrass-cli logs list-keywords --syslog

Here is a list of suggested keywords for syslog:
priority=$int
host=$str
logger=$str
class=$str

list-log-files

지정된 디렉터리에 있는 로그 파일을 표시합니다.

시놉시스
greengrass-cli logs list-log-files [arguments]
인수

--log-dir,-ld. 로그 파일을 확인할 디렉터리 경로입니다.

출력

다음 예제는 이 명령을 실행할 때 생성되는 출력을 보여줍니다.

$ sudo greengrass-cli logs list-log-files -ld /greengrass/v2/logs/

/greengrass/v2/logs/aws.greengrass.Nucleus.log
/greengrass/v2/logs/main.log
/greengrass/v2/logs/greengrass.log
Total 3 files found.