# 实时查看和监控网络分析器跟踪消息日志
<a name="network-analyzer-logs"></a>

如果已将资源添加到网络分析器配置中，可以激活跟踪消息开始接收资源的跟踪消息。您可以使用 AWS 管理控制台、AWS IoT Wireless API 或 AWS CLI。

## 先决条件
<a name="network-analyzer-logs-prereq"></a>

在使用网络分析器激活跟踪消息传送之前，您必须：
+ 将希望监控的资源添加到默认网络分析器配置中。有关更多信息，请参阅[添加资源并更新网络分析器配置](network-analyzer-resources.md)。
+ 通过使用 `StartNetworkAnalyzerStream`请求 URL 生成预签请求。将使用发出此请求的 AWS Identity and Access Management角色的凭据对请求进行签名。有关更多信息，请参阅[创建预签名 URL](network-analyzer-generate-request.md#network-analyzer-presigned-url)。

## 使用控制台激活跟踪消息
<a name="network-analyzer-activate-console"></a>

要激活跟踪消息

1. 打开 AWS IoT控制台[的网络分析器中心](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer)然后选择网络分析器配置，**Network Analyszerconfig\$1DEFAULT**。

1. 在网络分析仪配置的详细信息页面中，选择**Activate trace messaging**（激活跟踪消息），然后选择**Activate**（激活）。

   您将开始接收跟踪消息，其中最新的跟踪消息首先出现在控制台中。
**注意**  
消息传递会话开始后，在您停用会话或退出跟踪会话之前，接收跟踪消息可能会产生额外费用。有关定价的更多信息，请参阅 [AWS IoT Core 定价](https://aws.amazon.com/iot-core/pricing/)。

## 查看和监控跟踪消息
<a name="network-analyzer-view-trace"></a>

激活跟踪消息后，将建立 WebSocket 连接，并且跟踪消息开始实时出现，首先是最新消息。您可以自定义首选项以指定要在每个页面中显示的跟踪消息的数量，并仅显示每条消息的相关字段。例如，您可以自定义跟踪消息日志以仅显示具有**日志级别**设置为 `ERROR`，以便您可以快速识别和调试网关的错误。跟踪消息包含以下信息。
+ **消息编号**：显示首先收到的最后一条消息的唯一编号。
+ **资源 ID**：资源的无线网关或无线设备 ID。
+ **时间戳**：收到消息的时间。
+ **消息 ID**：适用于 LoRaWAN 的 AWS IoT Core 分配给每条收到的消息的标识符。
+ **FPort**：使用 WebSocket 连接与设备通信的频率端口。
+ **DevEui**：无线设备的扩展唯一标识符 (EUI)。
+ **资源**：受监控的资源是无线设备还是无线网关。
+ **事件**：无线设备的日志消息的事件，可以是 **Join**、**Rejoin**、**Uplink\$1Data**、**Downlink\$1Data** 或 **Registration**。
+ **日志级别**：有关设备的 `INFO` 或 `ERROR` 日志流的信息。

## 网络分析器 JSON 日志消息
<a name="connect-iot-network-analyzer-trace-logs"></a>

您还可以一次选择一条跟踪消息来查看该消息的 JSON 有效负载。根据在跟踪消息日志中选择的消息，您将在 JSON 负载中看到指示包含两部分的信息：**CustomerLog** 和 **LoRaFrame**。

**CustomerLog**  
JSON 的**客户日志**部分显示接收消息的资源的类型和标识符、日志级别和消息内容。以下示例显示了 **CustomerLog** 日志消息。您可以使用 JSON 中的 `message`字段来获取有关错误以及如何解决错误的更多信息。

**LoRaFrame**  
JSON 的 **lorRaFrame** 部分有**消息 ID** 并包含有关设备的物理负载和无线元数据的信息。

以下示例显示了追踪消息的结构。

```
export type TraceMessage = {
  ResourceId: string;
  Timestamp: string;
  LoRaFrame: 
  {
    MessageId: string;
    PhysicalPayload: any;
    WirelessMetadata: 
    {
      fPort: number;
      dataRate: number;
      devEui: string;
      frequency: number,
      timestamp: string;
    },
  }
  CustomerLog: 
  {
    resource: string;
    wirelessDeviceId: string;
    wirelessDeviceType: string;
    event: string;
    logLevel: string;
    messageId: string;
    message: string;
  },
};
```

## 回顾和后续步骤
<a name="network-analyzer-review"></a>

在本节中，您查看了跟踪消息，并了解了如何使用这些信息调试错误。查看所有消息后，您可以：
+ 

**停用跟踪消息**  
为避免产生任何额外费用，您可以停用跟踪消息传送会话。取消激活会话会断开 WebSocket 连接的连接，因此您将不会收到任何其他跟踪消息。您仍然可以继续在控制台中查看现有消息。
+ 

**编辑配置的帧信息**  
您可以编辑网络分析器配置，然后选择是否停用帧信息并选择消息的日志级别。在更新配置之前，请考虑停用跟踪消息传送会话。要进行这些编辑，请打开 AWS IoT控制台中的[网络分析器详细信息页面](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer/details/NetworkAnalyzerConfig_Default)，然后选择 **Edit**（编辑）。然后，您可以使用新的配置设置更新配置，并激活跟踪消息查看更新的消息。
+ 

**向配置添加资源**  
您还可以向网络分析器配置添加更多资源并实时监控。您最多可以合计 250 个无线网关和无线设备资源。要添加资源，请在 AWS IoT控制台的[网络分析器详细信息](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer/details/NetworkAnalyzerConfig_Default)页面上，选择 **Resources**（资源）选项卡，然后选择 **Add resources**（添加资源）。然后，您可以使用新资源更新配置并激活跟踪消息查看其他资源的更新消息。

有关通过编辑配置设置和添加资源来更新网络分析器配置的详细信息，请参阅 [添加资源并更新网络分析器配置](network-analyzer-resources.md)。