View a markdown version of this page

使用 Amazon CloudWatch Logs 監控 AWS IoT FleetWise - AWS IoT FleetWise
在 CloudWatch 主控台中檢視 AWS IoT FleetWise 日誌

AWS IoT FleetWise 自 2026 年 4 月 30 日起將不再向新客戶開放。現有的 AWS IoT FleetWise 客戶可以繼續使用 服務。上的連線行動性指南 AWS提供如何為連線行動解決方案開發和部署模組化服務的指引，這些解決方案可用於實現與 AWS IoT FleetWise 同等的功能。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Amazon CloudWatch Logs 監控 AWS IoT FleetWise

重要

對特定 AWS IoT FleetWise 功能的存取目前受到鎖定。如需詳細資訊，請參閱AWS AWS IoT FleetWise 中的區域和功能可用性。

Amazon CloudWatch Logs 會監控資源中發生的事件，並在發生任何問題時提醒您。如果您收到提醒，您可以存取日誌檔案，以取得特定事件的相關資訊。如需詳細資訊，請參閱 Amazon CloudWatch Logs 使用者指南。

在 CloudWatch 主控台中檢視 AWS IoT FleetWise 日誌

重要

在 CloudWatch 主控台中看到 AWS IoT FleetWise 日誌群組之前，請確定下列項目為真：

在 CloudWatch 主控台中檢視您的 AWS IoT FleetWise 日誌

  1. 開啟 CloudWatch 主控台。

  2. 在導覽窗格中，選擇日誌、日誌群組。

  3. 選擇 日誌群組。

  4. 選擇 Search log group (搜尋日誌群組)。您將看到為您的帳戶產生的日誌事件的完整清單。

  5. 選擇展開圖示以查看個別串流，並尋找日誌層級為 的所有日誌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
}
訊號事件類型
事件類型 Description

MODELING_ERROR

從車輛傳送並由 AWS IoT FleetWise 接收的訊息包含無法驗證車輛模型的訊號。

屬性： vehicleName、campaignName （選用）、signalCatalogName、signalId （選用）、signalValue （選用）、signalValueRangeMin （選用）、signalValueRangeMax （選用）、modelManifestName （選用）、signalIdsstateTemplateName

ILLEGAL_MESSAGE_FROM_EDGE

從車輛傳送並由 AWS IoT FleetWise 接收的訊息不符合所需的格式。

屬性： vehicleName、campaignName、signalCatalogName

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

CHECKIN_THROTTLED

已調節從車輛傳送至 AWS IoT FleetWise 的簽入。這是因為您在目前區域中超過此帳戶的服務限制。

屬性： vehicleName

VEHICLE_ATTRIBUTE_NOT_FOUND

從車輛傳送並由 AWS IoT FleetWise 接收的訊息無法以指定的車輛屬性來充實。

屬性：campaignName （選用）stateTemplateName （選用）、 vehicleName、 vehicleAttributeNames
車輛事件類型
事件類型 Description

VEHICLE_NOT_FOUND

AWS IoT FleetWise 收到的訊息，其中車輛不明。

屬性： vehicleName、campaignName （選用）、stateTemplateName （選用）
部署事件類型
事件類型 Description

PAYLOAD_SIZE_LIMIT_EXCEEDED

從 AWS IoT FleetWise 傳送至車輛的訊息超過最大大小的服務限制。

屬性： vehicleName、campaignName （選用）、stateTemplateName （選用）
行銷活動事件類型
事件類型 Description

CAMPAIGN_NOT_FOUND

從車輛傳送並由 AWS IoT FleetWise 接收的訊息，其中行銷活動不明。

屬性： vehicleName （選用）、campaignName

CAMPAIGN_INVALID

從車輛傳送並由 AWS IoT FleetWise 接收的訊息，其中行銷活動無效。

屬性： vehicleName （選用）、campaignName
行銷活動資料目的地事件類型
事件類型 Description

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
狀態範本事件類型
事件類型 Description

STATE_TEMPLATE_NOT_FOUND

從車輛傳送並由 AWS IoT FleetWise 接收的訊息，其中狀態範本不明。

屬性： vehicleName （選用）stateTemplateName
客戶受管 AWS KMS 金鑰事件類型
事件類型 Description

KMS_KEY_ACCESS_DENIED

AWS IoT FleetWise 無法將訊息從車輛寫入 Timestream 資料表或 Amazon S3 儲存貯體，因為 AWS KMS 金鑰存取遭拒錯誤。

屬性： kmsKeyId （選用）、resourceArn （選用）

屬性

所有 CloudWatch Logs 項目都包含這些屬性：

accountId

您的 AWS 帳戶 ID。

eventType

產生日誌的事件類型。事件類型的值會根據產生該日誌項目的事件而定。每個日誌項目說明都包含該 eventType 日誌項目的值。

logLevel

正在使用的日誌層級。如需詳細資訊，請參閱《 AWS IoT Core 開發人員指南》中的日誌層級。

message

包含日誌的特定詳細資訊。

timestamp

當 AWS IoT FleetWise 處理日誌時的 epoch 毫秒時間戳記。

選擇性屬性

CloudWatch Logs 項目選擇性地包含這些屬性，視 而定eventType：

decoderManifestName

包含訊號的解碼器資訊清單名稱。

destinationName

車輛資料的目的地名稱。例如，Amazon S3 儲存貯體名稱。

campaignName

行銷活動的名稱。

signalCatalogName

包含訊號的訊號目錄名稱。

signalId

錯誤訊號的 ID。

signalIds

錯誤訊號 IDs的清單。

signalName

訊號的名稱。

signalTimestampEpochMs

錯誤訊號的時間戳記。

signalValue

錯誤訊號的值。

signalValueRangeMax

錯誤訊號的最大範圍。

signalValueRangeMin

錯誤訊號的最小範圍。

s3URI

車輛訊息中 Amazon Ion 檔案的 Amazon S3 唯一識別符。

timestreamDatabaseName

Timestream 資料庫的名稱。

timestreamTableName

Timestream 資料表的名稱。

vehicleName

車輛的名稱。

vehicleAttributeNames

找不到的車輛屬性名稱清單。