# Erstellen einer Netzwerkanalysator-Konfiguration. Bevor Sie Ihre drahtlosen Gateways oder Geräte überwachen können, müssen Sie eine Netzwerkanalysator-Konfiguration erstellen. Beim Erstellen der Konfiguration müssen Sie nur einen Namen für die Konfiguration angeben. Sie können Ihre Konfigurationseinstellungen anpassen und die Ressourcen, die Sie überwachen möchten, zu Ihrer Konfiguration hinzufügen, auch nachdem sie erstellt wurde. Die Konfigurationseinstellungen bestimmen, welche Trace-Nachrichten-Informationen Sie für diese Ressourcen erhalten. Abhängig von den Ressourcen, die Sie überwachen möchten, und dem Umfang der Informationen, die Sie für sie erhalten möchten, möchten Sie möglicherweise mehrere Konfigurationen erstellen. Sie können beispielsweise eine Konfiguration erstellen, in der nur Fehlerinformationen für eine Reihe von Gateways in Ihrem AWS-Konto angezeigt werden. Sie können auch eine Konfiguration erstellen, in der alle Informationen zu einem WLAN-Gerät angezeigt werden, das Sie überwachen möchten. In den folgenden Abschnitten werden die verschiedenen Konfigurationseinstellungen und die Erstellung Ihrer Konfiguration beschrieben. ## Konfigurationseinstellungen Bei der Erstellung oder Aktualisierung Ihrer Netzwerkanalysator-Konfiguration können Sie auch die folgenden Parameter anpassen, um die Protokollstream-Informationen zu filtern. + **Informationen zum Frame** Diese Einstellung ist die Frame-Information für die Ressourcen Ihres WLAN-Geräts für Trace-Nachrichten. Die Frame-Informationen können verwendet werden, um die Kommunikation zwischen Ihrem Netzwerkserver und den Endgeräten zu debuggen. Sie ist standardmäßig aktiviert. + **Protokollstufen** Sie können Info- oder Fehlerprotokolle anzeigen oder die Protokollierung deaktivieren. + **Informationen** Protokolle mit der Protokollebene **Info** sind ausführlicher und enthalten sowohl Fehlerprotokollstreams als auch Informationsprotokollstreams. Die Informationsprotokolle können verwendet werden, um Änderungen am Status eines Geräts oder Gateways anzuzeigen. **Anmerkung** Das Sammeln ausführlicherer Protokollstreams kann zusätzliche Kosten verursachen. Weitere Informationen zu Preisen finden Sie unter [AWS IoT Core-Preise](https://aws.amazon.com/iot-core/pricing/). + **Fehler** Protokolle mit der Protokollebene **Fehler** sind weniger ausführlich und zeigen nur Fehlerinformationen an. Sie können diese Protokolle verwenden, wenn in einer Anwendung ein Fehler auftritt, z. B. ein Geräteverbindungsfehler. Mithilfe der Informationen aus dem Protokollstream können Sie Fehler bei Ressourcen in Ihrer Flotte identifizieren und beheben. ## Mithilfe der Konsole erstellen Sie eine Konfiguration wie folgt: Sie können eine Netzwerkanalysator-Konfiguration erstellen und die optionalen Parameter mithilfe der AWS IoT-Konsole oder der AWS IoT Wireless-API anpassen. Sie können auch mehrere Konfigurationen erstellen und später alle Konfigurationen löschen, die Sie nicht mehr verwenden. **Erstellen einer Netzwerkanalysator-Konfiguration.** 1. Öffnen Sie den [Netzwerkanalysator-Hub der AWS IoT Konsole](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) und wählen Sie **Konfiguration erstellen**. 1. Angeben der Konfigurationseinstellungen. + **Name, Beschreibung und Tags** Geben Sie einen eindeutigen **Konfigurationsnamen** an, der nur Buchstaben, Zahlen, Bindestriche oder Unterstriche enthält. Verwenden Sie das optionale Feld **Beschreibung**, um Informationen zur Konfiguration bereitzustellen, und das Feld **Tags**, um Schlüssel-Wert-Paare von Metadaten zur Konfiguration hinzuzufügen. Ausführlichere Informationen zur Benennung und Beschreibung von Ressourcen finden Sie unter [Beschreiben Ihrer AWS IoT Wireless-Ressourcen](iotwireless-describe-resources.md). + **Konfigurationseinstellungen** Wählen Sie aus, ob die Frame-Informationen deaktiviert werden sollen, und verwenden Sie **Protokollebenen wählen**, um die Protokollebenen zu definieren, die Sie für Ihre Trace-Nachrichtenprotokolle verwenden möchten. Wählen Sie **Next**. 1. Fügen Sie Ihrer Konfiguration Ressourcen hinzu. Sie können Ihre Ressourcen entweder jetzt hinzufügen oder **Erstellen** wählen, und Ihre Ressourcen später hinzufügen. Um Ressourcen später hinzuzufügen, wählen Sie **Erstellen**. Auf der **Netzwerkanalysator-Hub-Seite** sehen Sie die Konfiguration, die Sie erstellt haben, zusammen mit ihren Einstellungen. Um die Details der neuen Konfiguration anzuzeigen, wählen Sie den Namen der Konfiguration. **Konfiguration des Netzwerkanalysators löschen** Sie können mehrere Netzwerkanalysator-Konfigurationen erstellen, abhängig von den Ressourcen, die Sie überwachen möchten, und dem Level der Trace-Nachrichten-Information, die Sie empfangen möchten. **Um Konfigurationen von der Konsole zu entfernen** 1. Gehen Sie zum [Netzwerkanalysator-Hub der AWS IoT Konsole](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) und wählen Sie die Konfiguration aus, die Sie entfernen möchten. 1. Wählen Sie **Aktionen** und anschließend **Löschen** aus. ## Erstellen einer Konfiguration mit der API Um eine Netzwerkanalysator-Konfiguration mithilfe der API zu erstellen, verwenden Sie den API-Vorgang [CreateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateNetworkAnalyzerConfiguration.html) oder den CLI-Befehl [create-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-network-analyzer-configuration.html). Beim Erstellen der Konfiguration müssen Sie nur einen Namen für die Konfiguration angeben. Sie können diesen API-Vorgang auch verwenden, um die Konfigurationseinstellungen anzugeben und Ressourcen hinzuzufügen, wenn Sie die Konfiguration erstellen. Alternativ können Sie sie später mithilfe der API-Operation [UpdateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) oder der CLI [update-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-network-analyzer-configuration.html) angeben. + **Erstellen einer Konfiguration** Beim Erstellen einer Konfiguration müssen Sie einen Namen angeben. Beispielsweise erstellt der folgende Befehl eine Konfiguration, indem er nur einen Namen und eine optionale Beschreibung angibt. Standardmäßig sind die Frame-Informationen für die Konfiguration aktiviert und es wird eine Protokollebene von `INFO` verwendet. ``` aws iotwireless create-network-analyzer-configuration \ --configuration-name My_Network_Analyzer_Config \ --description "My first network analyzer configuration" ``` Wenn Sie diesen Befehl ausführen, werden der ARN und die ID Ihrer Netzwerkanalysator-Konfiguration angezeigt. ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" } ``` + **Konfiguration mit Ressourcen erstellen** Zum Anpassen der Konfiguration verwenden Sie den `trace-content`-Parameter. Um Ressourcen hinzuzufügen, verwenden Sie die Parameter `WirelessDevices` und `WirelessGateways`, um die Gateways, Geräte oder beides anzugeben, die Sie Ihrer Konfiguration hinzufügen möchten. Der folgende Befehl passt beispielsweise die Konfigurationseinstellungen an und fügt Ihrer Konfiguration die drahtlosen Ressourcen hinzu, die von ihrer `WirelessGatewayID` und `WirelessDeviceID` angegeben werden. ``` 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" ``` Das folgende Beispiel zeigt die Ausgabe des Befehls: ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" } ``` **Liste der Konfigurationen des Netzwerkanalysators.** Sie können mehrere Netzwerkanalysator-Konfigurationen erstellen, abhängig von den Ressourcen, die Sie überwachen möchten, und dem Level an Details der Trace-Nachrichten-Information, die Sie empfangen möchten. Nachdem Sie diese Konfigurationen erstellt haben, können Sie den API-Vorgang [ListNetworkAnalyzerConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListNetworkAnalyzerConfigurations.html) oder den CLI-Befehl [list-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-network-analyzer-configuration.html) verwenden, um eine Liste dieser Konfigurationen abzurufen. ``` aws iotwireless list-network-analyzer-configurations ``` Wenn Sie diesen Befehl ausführen, werden alle Konfigurationen des Netzwerkanalysators in Ihrem AWS-Konto angezeigt. Sie können den `max-results` Parameter auch verwenden, um anzugeben, wie viele Konfigurationen Sie anzeigen möchten. Das folgende Beispiel veranschaulicht die Ausgabe des Befehls. ``` { "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" } ] } ``` **Konfiguration des Netzwerkanalysators löschen** Sie können eine Konfiguration, die Sie nicht mehr verwenden, mit dem API-Vorgang [deleteNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteNetworkAnalyzerConfiguration.html) oder dem CLI-Befehl [delete-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-network-analyzer-configuration.html) löschen. ``` aws iotwireless delete-network-analyzer-configuration \ --configuration-name My_NetworkAnalyzer_Config ``` Dieser Befehl liefert keine Ausgabe. Um die verfügbaren Konfigurationen anzuzeigen, können Sie die `ListNetworkAnalyzerConfigurations`-API-Operation verwenden. ## Nächste Schritte Nachdem Sie nun eine Konfiguration für den Netzwerkanalysator erstellt haben, können Sie Ihrer Konfiguration Ressourcen hinzufügen oder Ihre Konfigurationseinstellungen aktualisieren. Weitere Informationen finden Sie unter [Hinzufügen von Ressourcen und Aktualisieren der Netzwerkanalysator-Konfiguration](network-analyzer-resources.md).