View a markdown version of this page

建立網路分析器組態 - AWS IoT Wireless
組態設定使用主控台建立組態使用 API 建立組態後續步驟

建立網路分析器組態

您必須先建立網路分析器組態，才能監控無線閘道或無線裝置。建立組態時，您只需要指定組態名稱。您可以自訂您的組態設定，並將您想要監控的資源新增至組態，即使組態已建立之後也是如此。組態設定會決定您將針對這些資源接收到的追蹤訊息資訊。

您可能需要建立多個組態，具體取決於要監控的資源以及您希望接收的資訊層級。例如，您可以建立一個組態，僅顯示 AWS 帳戶 中一組閘道的錯誤資訊。您也可以建立一個組態，顯示要監控之無線裝置的所有資訊。

以下部分介紹各種組態設定以及如何建立組態。

組態設定

建立或更新網路分析器組態時，您也可以自訂下列參數，以篩選日誌串流資訊。

  • 框架資訊

    這個設定是要追蹤訊息之無線裝置資源的框架資訊。框架資訊可用來偵錯網路伺服器與終端裝置之間的通訊。依預設會啟用此功能。

  • 日誌層級

    您可以檢視 Info (資訊) 或 Error (錯誤) 日誌，也可以關閉記錄功能。

    • Info

      日誌層級為 Info (資訊) 的日誌更詳細，並且同時包含錯誤日誌串流和資訊日誌串流。資訊日誌可用來檢視裝置或閘道狀態的變更。

      注意

      收集更詳細的日誌串流會產生額外的成本。如需定價的詳細資訊，請參閱 AWS IoT Core 定價。

    • 錯誤

      日誌層級為 Error (錯誤) 的日誌不夠詳細且只會顯示錯誤資訊。當應用程式發生錯誤 (例如裝置連線錯誤) 時，您就可以使用這些日誌。藉由使用來自日誌串流的資訊，您可以識別並排解機群中資源的錯誤。

使用主控台建立組態

您可以建立網路分析器組態，並使用 AWS IoT 主控台或 AWS IoT Wireless API 自訂選用參數。您也可以建立多個組態，之後刪除不再使用的任何組態。

建立網路分析器組態

  1. 開啟 AWS IoT 主控台的網路分析器中樞並選擇 Create configuration (建立組態)。

  2. 指定組態設定

    • 名稱、描述和標籤

      指定一個唯一的組態名稱，只能含有字母、數字、連字號或底線。使用選用的 Description (描述) 欄位以提供有關組態的資訊，以及 Tags (標籤) 欄位加入有關組態之中繼資料的鍵值對。如需有關命名和描述資源的詳細資訊，請參閱 描述您的 AWS IoT Wireless 資源。

    • 組態設定

      選擇是否停用框架資訊並使用 Selelct log levels (選取日誌層級)，以此選擇要用於追蹤訊息的日誌層級。選擇 Next (下一步)。

  3. 新增資源到組態。您可以立即加入資源，也可以選擇 Create (建立)，然後之後加入您的資源。若要之後加入資源，請選擇 Create (建立)。

    在 Network Analyzer hub page (網路分析器中樞頁面)，您會看到您所建立的組態及其設定。若要檢視新組態的詳細資訊，請選擇組態名稱。

刪除您的網路分析器組態

您可以建立多個網路分析器組態，具體取決於要監控的資源，以及您希望接收的追蹤訊息資訊層級。

從主控台中移除組態

  1. 前往 AWS IoT 主控台的網路分析器中樞並選擇您要移除的組態。

  2. 選擇動作，然後選擇刪除。

使用 API 建立組態

若要使用 API 建立網路分析器組態，請使用 CreateNetworkAnalyzerConfiguration API 操作或 create-network-analyzer-configuration CLI 命令。

建立組態時，您只需要指定組態名稱。您也可以使用此 API 操作指定組態設定，並在建立組態時加入資源。或者，您可以稍後使用 UpdateNetworkAnalyzerConfiguration API 操作或 update-network-analyzer-configuration CLI 命令。

  • 建立組態

    建立組態時，您必須指定名稱。例如，下列命令只提供名稱和選用描述來建立組態。預設情況下，組態已啟用框架資訊，並使用 INFO 日誌層級。

    aws iotwireless create-network-analyzer-configuration \ 
    --configuration-name My_Network_Analyzer_Config \ 
    --description "My first network analyzer configuration"

    執行這個命令會顯示網路分析器組態的 ARN 和 ID。

    {
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
  • 使用資源建立組態

    若要自訂組態設定，請使用trace-content 參數。若要新增資源，請使用 WirelessDevices 和 WirelessGateways 參數指定您要新增至組態的閘道、裝置或者兩者。例如，以下命令可自訂組態設定，並將無線資源加入您的組態，這些資源由其 WirelessGatewayID 和 WirelessDeviceID 指定。

    aws iotwireless create-network-analyzer-configuration \ 
    --configuration-name My_NetworkAnalyzer_Config \ 
    --trace-content WirelessDeviceFrameInfo=DISABLED,LogLevel="ERROR" \ 
    --wireless-gateways "12345678-a1b2-3c45-67d8-e90fa1b2c34d" "90123456-de1f-2b3b-4c5c-bb1112223cd1"   
    --wireless-devices "1ffd32c8-8130-4194-96df-622f072a315f"

    以下範例顯示執行命令的輸出：

    {
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
列出網路分析器組態

您可以建立多個網路分析器組態，具體取決於要監控的資源，以及您希望接收的追蹤訊息資訊詳細程度。建立這些組態後，您可以使用 ListNetworkAnalyzerConfigurations API 操作或 list-network-analyzer-configuration CLI 命令取得這些組態的清單。

aws iotwireless list-network-analyzer-configurations

執行這個命令會顯示您 AWS 帳戶 中的所有網路分析器組態。您也可以使用 max-results 參數指定要顯示多少組態。以下顯示執行這個命令的輸出。

{
   "NetworkAnalyzerConfigurationList": [ 
      { 
         "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
         "Name": "My_Network_Analyzer_Config1"
      },
      { 
         "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/90123456-a1a2-9a87-65b4-c12bf3c2d09a",
         "Name": "My_Network_Analyzer_Config2"
      }
   ]
}
刪除您的網路分析器組態

您可以用 DeleteNetworkAnalyzerConfiguration API 操作或 delete-network-analyzer-configuration CLI 命令刪除不再使用的組態。

aws iotwireless delete-network-analyzer-configuration \ 
    --configuration-name My_NetworkAnalyzer_Config

執行這個命令不會產生任何輸出。若要檢視可用的組態，您可以使用 ListNetworkAnalyzerConfigurations API 操作。

後續步驟

現在您已建立網路分析器組態，可以在組態加入資源或更新組態設定。如需詳細資訊，請參閱新增資源並更新網路分析器組態。