AWS IoT FleetWise는 2026년 4월 30일부터 신규 고객에게 더 이상 공개되지 않습니다. 기존 AWS IoT FleetWise 고객은 서비스를 계속 사용할 수 있습니다. [의 Connected Mobility 지침은 AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/) AWS IoT FleetWise와 동등한 기능을 달성하는 데 사용할 수 있는 커넥티드 모빌리티 솔루션을 위한 모듈식 서비스를 개발하고 배포하는 방법에 대한 지침을 제공합니다.

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

# Amazon CloudWatch Logs를 사용한 Monitor AWS IoT FleetWise Amazon CloudWatch
<a name="monitoring-cloudwatch-logs"></a>

**중요**  
특정 AWS IoT FleetWise 기능에 대한 액세스는 현재 게이트됩니다. 자세한 내용은 [AWS AWS IoT FleetWise의 리전 및 기능 가용성](fleetwise-regions.md) 단원을 참조하십시오.

Amazon CloudWatch Logs는 리소스에서 발생하는 이벤트를 모니터링하고 문제가 발생할 경우 사용자에게 알립니다. 알림을 받으면 로그 파일에 액세스하여 특정 이벤트에 대한 정보를 얻을 수 있습니다. 자세한 내용은 [Amazon CloudWatch Logs 사용자 안내서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/)를 참조하세요.

## CloudWatch 콘솔에서 AWS IoT FleetWise 로그 보기 CloudWatch
<a name="viewing-logs"></a>

**중요**  
CloudWatch 콘솔에서 AWS IoT FleetWise 로그 그룹을 보려면 먼저 다음이 true인지 확인합니다.  
 AWS IoT FleetWise에서 로깅을 활성화했습니다. 로깅에 대한 자세한 내용은 [AWS IoT FleetWise 로깅 구성](logging-cw.md) 섹션을 참조하세요.
 AWS IoT 작업에서 작성한 로그 항목이 이미 있습니다.

**CloudWatch 콘솔에서 AWS IoT FleetWise 로그를 보려면**

1. [CloudWatch 콘솔](https://console.aws.amazon.com/cloudwatch)을 엽니다.

1. 탐색 창에서 **로그**, **로그 그룹**을 선택합니다.

1. 로그 그룹을 선택합니다.

1. **로그 그룹 검색**을 선택합니다. 계정에 대해 생성된 로그 이벤트의 전체 목록이 표시됩니다.

1. 확장 아이콘을 선택하면 개별 스트림을 살펴보고 로그 수준이 `ERROR`와 같은 모든 로그를 찾을 수 있습니다.

   **이벤트 필터링** 검색 상자에 쿼리를 입력할 수도 있습니다. 예를 들면, 다음 쿼리를 수행할 수 있습니다.

   `{ $.logLevel = "ERROR" }` 

필터 표현식 생성에 대한 자세한 내용은 *Amazon CloudWatch Logs 사용 설명서*의 [필터 패턴 구문](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html)을 참조하세요.

**Example 로그 항목**  

```
{
  "accountId": "123456789012",
  "vehicleName": "test-vehicle",
  "message": "Unrecognized signal ID",
  "eventType": "MODELING_ERROR",
  "logLevel": "ERROR",
  "timestamp": 1685743214239,
  "campaignName": "test-campaign",
  "signalCatalogName": "test-catalog",
  "signalId": 10242
}
```


**신호 이벤트 유형**  

| 이벤트 유형 | 설명 | 
| --- | --- | 
| MODELING\_ERROR | 차량에서 전송되고 AWS IoT FleetWise에서 수신한 메시지에는 차량 모델에 대해 검증하지 못하는 신호가 포함되어 있습니다.<br />속성: vehicleName, campaignName(선택 사항), signalCatalogName, signalId(선택 사항), signalValue(선택 사항), signalValueRangeMin(선택 사항), signalValueRangeMax(선택 사항), modelManifestName(선택 사항), signalIds, stateTemplateName | 
| ILLEGAL\_MESSAGE\_FROM\_EDGE | 차량에서 전송되어 AWS IoT FleetWise에서 수신한 메시지가 필요한 형식과 일치하지 않습니다.<br />속성: 차량 이름, 캠페인 이름, 신호 카탈로그 이름 | 
| DECODING\_ERROR | 차량에서 전송되고 AWS IoT FleetWise에서 수신한 메시지에는 차량의 디코더 매니페스트에 대해 디코더에 실패하는 신호가 포함되어 있습니다.<br />속성: campaignName, signalCatalogName, decoderManifestName, (선택 사항) signalName, (선택 사항) s3URI | 
| MESSAGE\_THROTTLED | 차량에서 AWS IoT FleetWise로 전송된 메시지가 제한되었습니다. 이는 현재 지역에서 이 계정의 서비스 한도를 초과했기 때문입니다.<br />속성: accountId, vehicleName, 메시지, eventType, logLevel, 타임스탬프 | 
| MESSAGE\_SIZE\_LIMIT\_EXCEEDED | 차량에서 전송되고 AWS IoT FleetWise에서 수신한 메시지가 메시지 [서비스 제한](https://docs.aws.amazon.com/general/latest/gr/iotfleetwise.html)의 최대 크기를 초과합니다.<br />속성: accountId, vehicleName | 
| CHECKIN\_THROTTLED | 차량에서 AWS IoT FleetWise로 전송된 체크인이 제한되었습니다. 이는 현재 리전에서이 계정에 대한 [서비스 제한을](https://docs.aws.amazon.com/general/latest/gr/iotfleetwise.html) 초과했기 때문입니다.<br />속성: vehicleName | 
| VEHICLE\_ATTRIBUTE\_NOT\_FOUND | 차량에서 전송되고 AWS IoT FleetWise에서 수신한 메시지는 지정된 차량 속성으로 보강할 수 없습니다.<br />속성: campaignName(선택 사항), stateTemplateName(선택 사항), vehicleName, vehicleAttributeNames | 


**차량 이벤트 유형**  

| 이벤트 유형 | 설명 | 
| --- | --- | 
| VEHICLE\_NOT\_FOUND | 차량을 알 수 없는 AWS IoT FleetWise에서 수신한 메시지입니다.<br />속성: vehicleName, campaignName(선택 사항), stateTemplateName(선택 사항) | 


**배포 이벤트 유형**  

| 이벤트 유형 | 설명 | 
| --- | --- | 
| PAYLOAD\_SIZE\_LIMIT\_EXCEEDED |  AWS IoT FleetWise에서 차량으로 전송된 메시지가 최대 크기 서비스 제한을 초과했습니다.<br />속성: vehicleName, campaignName(선택 사항), stateTemplateName(선택 사항) | 


**캠페인 이벤트 유형**  

| 이벤트 유형 | 설명 | 
| --- | --- | 
| CAMPAIGN\_NOT\_FOUND | 차량에서 전송되고 AWS IoT FleetWise에서 수신한 메시지로, 캠페인을 알 수 없습니다.<br />속성: vehicleName(선택 사항), campaignName | 
| CAMPAIGN\_INVALID | 차량에서 전송되고 AWS IoT FleetWise에서 수신한 메시지로, 캠페인이 유효하지 않습니다.<br />속성: vehicleName(선택 사항), campaignName | 


**캠페인 데이터 대상 이벤트 유형**  

| 이벤트 유형 | 설명 | 
| --- | --- | 
| TIMESTREAM\_WRITE\_ERROR | AWS IoT FleetWise가 차량의 메시지를 Amazon Timestream 테이블에 쓸 수 없습니다.<br />속성: vehicleName, campaignName, timestreamDatabaseName, timestreamTableName | 
| S3\_WRITE\_ERROR | AWS IoT FleetWise가 차량의 메시지를 Amazon Simple Storage Service(Amazon S3) 버킷에 쓸 수 없습니다.<br />속성: campaignName, destinationName | 
| S3\_READ\_ERROR | AWS IoT FleetWise가 Amazon Simple Storage Service(Amazon S3) 버킷의 차량에서 객체 키를 읽을 수 없습니다.<br />속성: campaignName, destinationName | 


**상태 템플릿 이벤트 유형**  

| 이벤트 유형 | 설명 | 
| --- | --- | 
| STATE\_TEMPLATE\_NOT\_FOUND | 차량에서 전송되고 AWS IoT FleetWise에서 수신한 메시지로, 상태 템플릿을 알 수 없습니다.<br />속성: vehicleName(선택 사항), stateTemplateName | 


**고객 관리형 AWS KMS 키 이벤트 유형**  

| 이벤트 유형 | 설명 | 
| --- | --- | 
| KMS\_KEY\_ACCESS\_DENIED |  AWS KMS 키 액세스 거부 오류로 인해AWS IoT FleetWise가 차량의 메시지를 Timestream 테이블 또는 Amazon S3 버킷에 쓸 수 없습니다.<br />속성: kmsKeyId(선택 사항), resourceArn(선택 사항) | 

### 속성
<a name="cloudwatch-attributes"></a>

모든 CloudWatch Logs 로그 항목에는 다음 속성이 포함됩니다.

**accountId**  
 AWS 계정 ID.

**eventType**  
로그가 작성된 이벤트 유형입니다. 이벤트 유형의 값은 로그 항목을 생성한 이벤트에 따라 다릅니다. 각 로그 항목 설명에는 해당 로그 항목의 `eventType` 값이 포함됩니다.

**logLevel**  
사용 중인 로그 수준. 자세한 내용은 *AWS IoT Core 개발자 가이드*의 [로그 레벨](https://docs.aws.amazon.com/iot/latest/developerguide/configure-logging.html#log-level) 섹션을 참조하세요.

**message**  
로그에 대한 특정 세부 정보가 들어 있습니다.

**timestamp**  
 AWS IoT FleetWise가 로그를 처리한 시간의 에포크 밀리초 타임스탬프입니다.

### 선택적 속성
<a name="cloudwatch-attributes-optional"></a>

CloudWatch Logs 항목에는 `eventType`에 따라 다음 속성이 선택적으로 포함됩니다.

**decoderManifestName**  
신호가 포함된 디코더 매니페스트의 이름입니다.

**destinationName**  
차량 데이터의 대상의 이름입니다. Amazon S3 버킷 이름입니다.

**campaignName**  
캠페인의 이름입니다.

**signalCatalogName**  
신호가 포함된 신호 카탈로그의 이름입니다.

**signalId**  
오류 신호의 ID입니다.

**signalIds**  
오류 신호 ID 목록.

**signalName**  
신호의 이름입니다.

**signalTimestampEpochMs**  
오류 신호의 타임스탬프.

**signalValue**  
오류 신호의 값입니다.

**signalValueRangeMax**  
오류 신호의 최대 범위입니다.

**signalValueRangeMin**  
오류 신호의 최소 범위.

**s3URI**  
차량 메시지에 있는 Amazon Ion 파일의 Amazon S3 고유 식별자입니다.

**timestreamDatabaseName**  
Timestream 데이터베이스의 이름입니다.

**timestreamTableName**  
Timestream 테이블의 이름입니다.

**vehicleName**  
차량 모델의 이름입니다.

**vehicleAttributeNames**  
찾을 수 없는 차량 속성 이름의 목록입니다.