기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon CloudWatch Logs를 사용한 Monitor AWS IoT FleetWise Amazon CloudWatch
중요
특정 AWS IoT FleetWise 기능에 대한 액세스는 현재 게이트됩니다. 자세한 내용은 AWSAWS IoT FleetWise의 리전 및 기능 가용성 단원을 참조하십시오.
Amazon CloudWatch Logs는 리소스에서 발생하는 이벤트를 모니터링하고 문제가 발생할 경우 사용자에게 알립니다. 알림을 받으면 로그 파일에 액세스하여 특정 이벤트에 대한 정보를 얻을 수 있습니다. 자세한 내용은 Amazon CloudWatch Logs 사용 설명서를 참조하세요.
CloudWatch 콘솔에서 AWS IoT FleetWise 로그 보기 CloudWatch
중요
CloudWatch 콘솔에서 AWS IoT FleetWise 로그 그룹을 보려면 먼저 다음이 true인지 확인합니다.
-
AWS IoT FleetWise에서 로깅을 활성화했습니다. 로깅에 대한 자세한 내용은 AWS IoT FleetWise 로깅 구성 섹션을 참조하세요.
-
AWS IoT 작업에서 작성한 로그 항목이 이미 있습니다.
CloudWatch 콘솔에서 AWS IoT FleetWise 로그를 보려면
-
CloudWatch 콘솔
을 엽니다. -
탐색 창에서 로그, 로그 그룹을 선택합니다.
-
로그 그룹을 선택합니다.
-
로그 그룹 검색을 선택합니다. 계정에 대해 생성된 로그 이벤트의 전체 목록이 표시됩니다.
-
확장 아이콘을 선택하면 개별 스트림을 살펴보고 로그 수준이
ERROR
와 같은 모든 로그를 찾을 수 있습니다.이벤트 필터링 검색 상자에 쿼리를 입력할 수도 있습니다. 예를 들면, 다음 쿼리를 수행할 수 있습니다.
{ $.logLevel = "ERROR" }
필터 표현식 생성에 대한 자세한 내용은 Amazon CloudWatch Logs 사용 설명서의 필터 패턴 구문을 참조하세요.
예 로그 항목
{
"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에서 수신한 메시지에는 차량 모델에 대해 검증하지 못하는 신호가 포함되어 있습니다. 속성: vehicleName, campaignName(선택 사항), signalCatalogName, signalId(선택 사항), signalValue(선택 사항), signalValueRangeMin(선택 사항), signalValueRangeMax(선택 사항), modelManifestName(선택 사항), signalIds, stateTemplateName |
ILLEGAL_MESSAGE_FROM_EDGE |
차량에서 전송되고 AWS IoT FleetWise에서 수신한 메시지가 필요한 형식과 일치하지 않습니다. 속성: 차량 이름, 캠페인 이름, 신호 카탈로그 이름 |
DECODING_ERROR |
차량에서 전송되고 AWS IoT FleetWise에서 수신한 메시지에는 차량의 디코더 매니페스트에 대해 디코더에 실패하는 신호가 포함되어 있습니다. 속성: campaignName, signalCatalogName, decoderManifestName, (선택 사항) signalName, (선택 사항) s3URI |
MESSAGE_THROTTLED |
차량에서 AWS IoT FleetWise로 전송된 메시지가 제한되었습니다. 이는 현재 지역에서 이 계정의 서비스 한도를 초과했기 때문입니다. 속성: accountId, vehicleName, 메시지, eventType, logLevel, 타임스탬프 |
MESSAGE_SIZE_LIMIT_EXCEEDED |
차량에서 전송되고 AWS IoT FleetWise에서 수신한 메시지가 메시지 서비스 제한의 최대 크기를 초과합니다. 속성: accountId, vehicleName |
이벤트 유형 | 설명 |
---|---|
VEHICLE_NOT_FOUND |
차량을 알 수 없는 AWS IoT FleetWise에서 수신한 메시지입니다. 속성: vehicleName, campaignName(선택 사항), stateTemplateName(선택 사항) |
이벤트 유형 | 설명 |
---|---|
CAMPAIGN_NOT_FOUND |
차량에서 전송되고 AWS IoT FleetWise에서 수신한 메시지로, 캠페인을 알 수 없습니다. 속성: vehicleName(선택 사항), campaignName |
CAMPAIGN_INVALID |
차량에서 전송되어 AWS IoT FleetWise에서 수신한 메시지로, 캠페인이 유효하지 않습니다. 속성: vehicleName(선택 사항), campaignName |
이벤트 유형 | 설명 |
---|---|
TIMESTREAM_WRITE_ERROR |
AWS IoT FleetWise가 차량의 메시지를 Amazon Timestream 테이블에 쓸 수 없습니다. 속성: vehicleName, campaignName, timestreamDatabaseName, timestreamTableName |
S3_WRITE_ERROR |
AWS IoT FleetWise가 차량의 메시지를 Amazon Simple Storage Service(Amazon S3) 버킷에 쓸 수 없습니다. 속성: campaignName, destinationName |
S3_READ_ERROR |
AWS IoT FleetWise가 Amazon Simple Storage Service(Amazon S3) 버킷의 차량에서 객체 키를 읽을 수 없습니다. 속성: campaignName, destinationName |
이벤트 유형 | 설명 |
---|---|
STATE_TEMPLATE_NOT_FOUND |
차량에서 전송되고 AWS IoT FleetWise에서 수신한 메시지로, 상태 템플릿을 알 수 없습니다. 속성: vehicleName(선택 사항), stateTemplateName |
이벤트 유형 | 설명 |
---|---|
KMS_KEY_ACCESS_DENIED |
AWS KMS 키 액세스 거부 오류로 인해AWS IoT FleetWise가 차량의 메시지를 Timestream 테이블 또는 Amazon S3 버킷에 쓸 수 없습니다. |
속성
모든 CloudWatch Logs 로그 항목에는 다음 속성이 포함됩니다.
- accountId
-
AWS 계정 ID.
- eventType
-
로그가 작성된 이벤트 유형입니다. 이벤트 유형의 값은 로그 항목을 생성한 이벤트에 따라 다릅니다. 각 로그 항목 설명에는 해당 로그 항목의
eventType
값이 포함됩니다. - logLevel
-
사용 중인 로그 수준. 자세한 내용은 AWS IoT Core 개발자 가이드의 로그 레벨 섹션을 참조하세요.
- message
-
로그에 대한 특정 세부 정보가 들어 있습니다.
- 타임스탬프
-
AWS IoT FleetWise가 로그를 처리한 시간의 에폭 밀리초 타임스탬프입니다.
선택적 속성
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
-
차량 모델의 이름입니다.