建立網路分析器組態
您必須先建立網路分析器組態,才能監控無線閘道或無線裝置。建立組態時,您只需要指定組態名稱。您可以自訂您的組態設定,並將您想要監控的資源新增至組態,即使組態已建立之後也是如此。組態設定會決定您將針對這些資源接收到的追蹤訊息資訊。
您可能需要建立多個組態,具體取決於要監控的資源以及您希望接收的資訊層級。例如,您可以建立一個組態,僅顯示 AWS 帳戶 中一組閘道的錯誤資訊。您也可以建立一個組態,顯示要監控之無線裝置的所有資訊。
以下部分介紹各種組態設定以及如何建立組態。
組態設定
建立或更新網路分析器組態時,您也可以自訂下列參數,以篩選日誌串流資訊。
-
框架資訊
這個設定是要追蹤訊息之無線裝置資源的框架資訊。框架資訊可用來偵錯網路伺服器與終端裝置之間的通訊。依預設會啟用此功能。
-
日誌層級
您可以檢視 Info (資訊) 或 Error (錯誤) 日誌,也可以關閉記錄功能。
-
Info
日誌層級為 Info (資訊) 的日誌更詳細,並且同時包含錯誤日誌串流和資訊日誌串流。資訊日誌可用來檢視裝置或閘道狀態的變更。
注意
收集更詳細的日誌串流會產生額外的成本。如需定價的詳細資訊,請參閱 AWS IoT Core 定價
。 -
錯誤
日誌層級為 Error (錯誤) 的日誌不夠詳細且只會顯示錯誤資訊。當應用程式發生錯誤 (例如裝置連線錯誤) 時,您就可以使用這些日誌。藉由使用來自日誌串流的資訊,您可以識別並排解機群中資源的錯誤。
-
使用主控台建立組態
您可以建立網路分析器組態,並使用 AWS IoT 主控台或 AWS IoT Wireless API 自訂選用參數。您也可以建立多個組態,之後刪除不再使用的任何組態。
建立網路分析器組態
-
開啟 AWS IoT 主控台的網路分析器中樞
並選擇 Create configuration (建立組態)。 -
指定組態設定
-
名稱、描述和標籤
指定一個唯一的組態名稱,只能含有字母、數字、連字號或底線。使用選用的 Description (描述) 欄位以提供有關組態的資訊,以及 Tags (標籤) 欄位加入有關組態之中繼資料的鍵值對。如需有關命名和描述資源的詳細資訊,請參閱 描述您的 AWS IoT Wireless 資源。
-
組態設定
選擇是否停用框架資訊並使用 Selelct log levels (選取日誌層級),以此選擇要用於追蹤訊息的日誌層級。選擇 Next (下一步)。
-
-
新增資源到組態。您可以立即加入資源,也可以選擇 Create (建立),然後之後加入您的資源。若要之後加入資源,請選擇 Create (建立)。
在 Network Analyzer hub page (網路分析器中樞頁面),您會看到您所建立的組態及其設定。若要檢視新組態的詳細資訊,請選擇組態名稱。
刪除您的網路分析器組態
您可以建立多個網路分析器組態,具體取決於要監控的資源,以及您希望接收的追蹤訊息資訊層級。
從主控台中移除組態
-
前往 AWS IoT 主控台的網路分析器中樞
並選擇您要移除的組態。 -
選擇動作,然後選擇刪除。
使用 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 操作。
後續步驟
現在您已建立網路分析器組態,可以在組態加入資源或更新組態設定。如需詳細資訊,請參閱新增資源並更新網路分析器組態。