AWS 自 2026 年 4 月 30 日起，物联网 FleetWise 将不再向新客户开放。现有的 AWS 物联网 FleetWise 客户可以继续使用该服务。[上的《互联移动指南》 AWS提供了有关如何为](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/)互联移动解决方案开发和部署模块化服务的指导，这些解决方案可用于实现与 AWS 物联网同等的功能 FleetWise。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# FleetWise 使用 Amazon CloudWatch 日志监控 AWS 物联网
<a name="monitoring-cloudwatch-logs"></a>

**重要**  
目前对某些 AWS 物联网 FleetWise 功能的访问受到限制。有关更多信息，请参阅 [AWS AWS 物联网中的区域和功能可用性 FleetWise](fleetwise-regions.md)。

Ama CloudWatch zon Logs 会监控您的资源中发生的事件，并在出现任何问题时提醒您。如果您收到警报，可以访问日志文件以获取有关具体事件的信息。有关更多信息，请参阅 [Amazon CloudWatch 日志用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/)。

## 在 CloudWatch 控制台中查看 AWS IoT FleetWise 日志
<a name="viewing-logs"></a>

**重要**  
在 CloudWatch 控制台中查看 AWS IoT FleetWise 日志组之前，请确保满足以下条件：  
您已启用 AWS 物联网登录功能 FleetWise。有关日志记录的更多信息，请参阅[配置 AWS 物联网 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 L CloudWatch ogs 用户指南*中的[筛选条件和模式语法](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 物联网接收的消息 FleetWise 包含无法根据车辆模型进行验证的信号。<br />属性：VehicleName、CampaignName（可选）、 signalCatalogName、signalID（可选）、signalValue（可选）、M signalValueRange in（可选）、 signalValueRange Max（可选）、（可选）、signalIds、 modelManifestName stateTemplateName | 
| ILLEGAL\_MESSAGE\_FROM\_EDGE | 从车辆发送并由 AWS 物联网接收的消息与要求的格式 FleetWise 不匹配。<br />属性：车辆名称、战役名称、 signalCatalogName | 
| DECODING\_ERROR | 从车辆发送并由 AWS 物联网接收的消息 FleetWise 包含无法根据车辆的解码器清单进行解码的信号。<br />属性：campaignName、 signalCatalogName、 decoderManifestName、（可选）signalName、（可选）s3uri | 
| MESSAGE\_TTLEDED | 从车辆发送到 AWS 物联网的消息 FleetWise 受到限制。这是因为在当前区域内的此账户中，您已超出服务限制。<br />属性：账户 ID、车辆名称、消息、事件类型、日志级别、时间戳 | 
| 已超出消息大小限制 | 从车辆发送并由 AWS 物联网接收的消息 FleetWise 超过了消息[服务限制](https://docs.aws.amazon.com/general/latest/gr/iotfleetwise.html)的最大大小。<br />属性：账户 ID、车辆名称 | 
| CHECKIN\_THROTTLED | 车辆向 AWS 物联网发送的办理登机手续 FleetWise 受到限制。这是因为您在当前地区已超出该账户的[服务限制](https://docs.aws.amazon.com/general/latest/gr/iotfleetwise.html)。<br />属性：车辆名称 | 
| 未找到车辆属性 |  FleetWise 无法使用指定的车辆属性来丰富从车辆发送并由 AWS 物联网接收的消息。<br />属性：CampaignName（可选）、 stateTemplateName （可选）、VehicleName、 vehicleAttributeNames | 


**车辆事件类型**  

| 事件类型 | 说明 | 
| --- | --- | 
| VEHICLE\_NOT\_FOUND |  AWS 物联网收到的消息 FleetWise，其中车辆未知。<br />属性：车辆名称、活动名称（可选）、 stateTemplateName （可选） | 


**部署事件类型**  

| 事件类型 | 说明 | 
| --- | --- | 
| 已超过有效载荷大小限制 | 从 AWS 物联网发送 FleetWise 到车辆的消息超过了最大大小服务限制。<br />属性：车辆名称、活动名称（可选）、 stateTemplateName （可选） | 


**活动事件类型**  

| 事件类型 | 说明 | 
| --- | --- | 
| CAMPAIGN\_NOT\_FOUND | 从车辆发送并由 AWS 物联网接收的消息 FleetWise，其中活动未知。<br />属性：vehicleName（可选）、campaignName | 
| CAMPAIGN\_INVALID | 从车辆发送并由 AWS 物联网接收的消息 FleetWise，其中活动无效。<br />属性：vehicleName（可选）、campaignName | 


**活动数据目标事件类型**  

| 事件类型 | 说明 | 
| --- | --- | 
| TIMESTREAM\_WRITE\_ERROR | AWS 物联网 FleetWise 无法将来自车辆的消息写入亚马逊 Timestream 表。<br />属性：车辆名称、战役名称、、 timestreamDatabaseName timestreamTableName | 
| S3\_WRITE\_ERROR | AWS 物联网 FleetWise 无法将消息从车辆写入亚马逊简单存储服务 (Amazon S3) 存储桶。<br />属性：campaignName、destinationName | 
| S3\_READ\_ERROR | AWS 物联网 FleetWise 无法从亚马逊简单存储服务 (Amazon S3) 存储桶中的车辆中读取对象密钥。<br />属性：campaignName、destinationName | 


**状态模板事件类型**  

| 事件类型 | 说明 | 
| --- | --- | 
| 未找到状态模板 | 从车辆发送并由 AWS 物联网接收的消息 FleetWise，其中状态模板未知。<br />属性：车辆名称（可选）， stateTemplateName | 


**客户管理的 AWS KMS 密钥事件类型**  

| 事件类型 | 说明 | 
| --- | --- | 
| KMS\_KEY\_ACCESS\_DENIED | AWS 由于 AWS KMS 密钥访问被拒绝错误，物联网 FleetWise 无法将消息从车辆写入 Timestream 表或 Amazon S3 存储桶。<br />属性： kmsKeyId （可选）、resourceArn（可选） | 

### 属性
<a name="cloudwatch-attributes"></a>

所有 CloudWatch 日志条目都包含以下属性：

**accountId**  
你的 AWS 账户 身份证。

**eventType**  
已为其生成日志的事件类型。事件类型的值取决于生成日志条目的事件。每个日志条目描述都包括该日志条目的 `eventType` 的值。

**logLevel**  
正在使用的日志级别。有关更多信息，请参阅《AWS IoT Core 开发人员指南》**中的[日志级别](https://docs.aws.amazon.com/iot/latest/developerguide/configure-logging.html#log-level)。

**message**  
包含有关日志的具体详情。

**timestamp**  
 AWS 物联网 FleetWise 处理日志时的纪元毫秒时间戳。

### 可选属性
<a name="cloudwatch-attributes-optional"></a>

CloudWatch 日志条目可以选择包含以下属性，具体取决于`eventType`：

**decoderManifestName**  
包含信号的解码器清单名称。

**destinationName**  
车辆数据目标的名称。例如 Amazon S3 存储桶名称。

**campaignName**  
活动的名称。

**signalCatalogName**  
包含信号的信号目录名称。

**signalId**  
错误信号的 ID。

**signalIds**  
错误信号列表 IDs。

**signalName**  
信号的名称。

**signalTimestampEpoch女士**  
错误信号的时间戳。

**signalValue**  
错误信号的值。

**signalValueRange马克斯**  
错误信号的最大范围。

**signalValueRange最小**  
错误信号的最小范围。

**s3URI**  
车辆消息中 Amazon Ion 文件的 Amazon S3 唯一标识符。

**timestreamDatabaseName**  
Timestream 数据库的名称。

**timestreamTableName**  
Timestream 表的名称。

**vehicleName**  
车辆的名称。

**vehicleAttributeNames**  
找不到的车辆属性名称列表。