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

# `pcluster get-image-log-events`
<a name="pcluster.get-image-log-events-v3"></a>

이미지 빌드와 연결된 로그 이벤트를 검색합니다.

```
pcluster get-image-log-events [-h] 
                 --image-id {{IMAGE_ID}}                               
                 --log-stream-name {{LOG_STREAM_NAME}}
                [--debug]
                [--end-time {{END_TIME}}]
                [--limit {{LIMIT}}]
                [--next-token {{NEXT_TOKEN}}]                              
                [--query {{QUERY}}]                               
                [--region {{REGION}}]                              
                [--start-from-head {{START_FROM_HEAD}}]
                [--start-time {{START_TIME}}]
```

## 이름 지정된 인수
<a name="pcluster-v3.get-image-log-events.namedargs"></a>

**-h, --help**  
`pcluster get-image-log-events`에 대한 도움말 텍스트를 표시합니다.

**--image-id, -i {{IMAGE\_ID}}**  
이미지의 ID를 지정합니다.

**--log-stream-name {{LOG\_STREAM\_NAME}}**  
로그 스트림의 이름을 지정합니다. `list-image-log-streams` 명령을 사용하여 이벤트 또는 이벤트와 관련된 로그 스트림을 검색할 수 있습니다.

**--debug**  
디버깅 로깅을 활성화합니다.

**--end-time {{END\_TIME}}**  
시간 범위의 끝을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`)으로 표현됩니다. 타임스탬프가 이 시간 이후인 이벤트는 포함되지 않습니다.

**--limit {{LIMIT}}**  
반환된 로그 이벤트의 최대 수를 지정합니다. 값이 지정되지 않는 경우 최대값은 1MB의 응답 크기에 들어갈 수 있는 로그 이벤트 수(최대 10,000개의 로그 이벤트)입니다.

**--next-token {{NEXT\_TOKEN}}**  
다음 결과 집합에 대한 토큰입니다.

**--query {{QUERY}}**  
출력에서 수행할 JMESPath 쿼리를 지정합니다.

**--region, -r {{REGION}}**  
사용할 AWS 리전 를 지정합니다. `AWS_DEFAULT_REGION` 환경 변수, `~/.aws/config` 파일 `[default]` 섹션의 `region` 설정 또는 `--region` 파라미터를 사용하여를 지정해야 AWS 리전 합니다.

**--start-from-head {{START\_FROM\_HEAD}}**  
값이 `true`인 경우 가장 이른 로그 이벤트가 먼저 반환됩니다. 값이 `false`인 경우 가장 최근의 로그 이벤트가 먼저 반환됩니다. (`false`로 디폴트됩니다.)

**--start-time {{START\_TIME}}**  
시간 범위의 시작을 지정합니다. ISO 8601 형식(`YYYY-MM-DDThh:mm:ssZ`, 예시로는 `2021-01-01T20:00:00Z`)으로 표현됩니다. 타임스탬프가 이 시간 이후인 이벤트가 포함됩니다.

** AWS ParallelCluster 버전 3.1.2 사용 예제:**

```
$ pcluster get-image-log-events --image-id {{custom-alinux2-image}} --region {{us-east-1}} --log-stream-name {{3.1.2/1}} --limit {{3}}
   {
  "nextToken": "f/36778317771100849897800729464621464113270312017760944178/s",
  "prevToken": "b/36778317766952911290874033560295820514557716777648586800/s",
  "events": [
    {
      "message": "ExecuteBash: FINISHED EXECUTION",
      "timestamp": "2022-04-05T22:13:26.633Z"
    },
    {
      "message": "Document arn:aws:imagebuilder:us-east-1:123456789012:component/parallelclusterimage-test-1234abcd-56ef-78gh-90ij-abcd1234efgh/3.1.2/1",
      "timestamp": "2022-04-05T22:13:26.741Z"
    },
    {
      "message": "TOE has completed execution successfully",
      "timestamp": "2022-04-05T22:13:26.819Z"
    }
  ]
}
```