

# Hinzufügen von Ressourcen und Aktualisieren der Netzwerkanalysator-Konfiguration
<a name="network-analyzer-resources"></a>

Bevor Sie Trace-Nachrichten aktivieren können, müssen Sie Ressourcen zur Ihrer Konfiguration hinzufügen. Sie können nur eine einzige Standardkonfiguration des Netzwerkanalysators verwenden. AWS IoT Core für LoRaWAN weist dieser Konfiguration den Namen **NetworkAnalyzerConfig \$1Default** zu und dieses Feld kann nicht bearbeitet werden. Diese Konfiguration wird Ihrem AWS-Konto automatisch hinzugefügt, wenn Sie den Netzwerkanalysator von der Konsole aus verwenden.

Sie können die Ressourcen, die Sie überwachen möchten, zu dieser Standardkonfiguration hinzufügen. Die Ressourcen können LoRaWAN-Geräte, LoRaWAN-Gateways oder beides sein. Um der Konfiguration jede einzelne Ressource hinzuzufügen, verwenden Sie die Kennungen des drahtlosen Gateways bzw. Geräts.

## Konfigurationseinstellungen
<a name="resources-config-settings"></a>

Um Einstellungen zu konfigurieren, fügen Sie zunächst Ressourcen zu Ihrer Standardkonfiguration hinzu und aktivieren Sie Trace-Nachrichten. Nachdem Sie die Trace-Nachrichtenprotokolle erhalten haben, können Sie auch die folgenden Parameter anpassen, um Ihre Standardkonfiguration zu aktualisieren und den Protokollstream zu filtern.
+ 

**Informationen zum Frame**  
Diese Einstellung ist die Frame-Information Ihrer drahtlosen Geräteressourcen für Trace-Nachrichten. Die Frame-Informationen sind standardmäßig aktiviert und können verwendet werden, um die Kommunikation zwischen Ihrem Netzwerkserver und den Endgeräten zu debuggen.
+ 

**Protokollstufen**  
Sie können Info- oder Fehlerprotokolle anzeigen oder die Protokollierung deaktivieren.
  + 

**Informationen**  
Protokolle mit der Protokollebene **Info** sind ausführlicher und umfassen Fehlerprotokollstreams, die Informationen und Fehler enthalten. 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. 

## Voraussetzungen
<a name="resources-prereq"></a>

Bevor Sie Ressourcen hinzufügen können, müssen Sie die Gateways und Geräte, die Sie überwachen möchten, in AWS IoT Core für LoRaWAN eingebunden haben. Weitere Informationen finden Sie unter [Gateways und Geräte verbinden mit AWS IoT Core für LoRaWAN](lorawan-getting-started.md).

## Hinzufügen von Ressourcen und Aktualisieren der Netzwerkanalysator-Konfiguration anhand der Konsole
<a name="add-resources-console"></a>

Sie können Ressourcen hinzufügen und die optionalen Parameter mithilfe der AWS IoT-Konsole oder der AWS IoT Wireless-API anpassen. Neben Ressourcen können Sie auch Ihre Konfigurationseinstellungen bearbeiten und die aktualisierte Konfiguration speichern.

**So fügen Sie Ihrer Konfiguration Ressourcen hinzu (Konsole)**  


1. Öffnen Sie den [Netzwerkanalysator-Hub der AWS IoT-Konsole](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) und wählen Sie die Netzwerkanalysator-Konfiguration **NetworkAnalyzerConfig\$1Default**.

1. Wählen Sie **Ressourcen hinzufügen** aus.

1. Fügen Sie die Ressourcen hinzu, die Sie überwachen möchten, mithilfe des WLAN-Gateways und der WLAN-Geräte-ID. Sie können bis zu 250 drahtlose Gateways oder Geräte hinzufügen. So fügen Sie Ihre Ressource hinzu:

   1. Verwenden Sie die Registerkarte **Gateways anzeigen** oder **Geräte anzeigen**, um die Liste der Gateways bzw. Geräte anzuzeigen, die Sie Ihrem AWS-Konto hinzugefügt haben.

   1. Kopieren Sie die `WirelessDeviceID` oder `WirelessGatewayID` des Geräts oder Gateways, das Sie überwachen möchten, und geben Sie den Kennungswert für die entsprechende Ressource ein.

   1. Um mit dem Hinzufügen von Ressourcen fortzufahren, wählen Sie **Gateway hinzufügen** oder **Gerät hinzufügen** aus und fügen Sie Ihr drahtloses Gateway oder Gerät hinzu. Wenn Sie eine Ressource hinzugefügt haben, die Sie nicht mehr überwachen möchten, wählen Sie **Ressource entfernen** aus.

1. Nachdem Sie alle Ressourcen hinzugefügt haben, wählen Sie **Hinzufügen**.

   Die Anzahl der Gateways und Geräte, die Sie hinzugefügt haben, wird auf der **Netzwerkanalysator-Hub-Seite angezeigt**. Sie können weiterhin Gateways und Geräte hinzufügen, bis Sie die Trace-Nachrichten-Sitzung aktivieren. Nachdem die Sitzung aktiviert wurde, müssen Sie die Sitzung deaktivieren, um Ressourcen hinzuzufügen.

**So bearbeiten Sie die Konfiguration des Netzwerkanalysators (Konsole)**  
Sie können auch die Netzwerkanalysator-Konfiguration bearbeiten und wählen, ob Sie die Frame-Informationen und die Protokollebene für Ihre Trace-Nachrichtenprotokolle deaktivieren möchten. 

1. Öffnen Sie den [Netzwerkanalysator-Hub der AWS IoT-Konsole](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer) und wählen Sie die Netzwerkanalysator-Konfiguration **NetworkAnalyzerConfig\$1Default**.

1. Wählen Sie **Bearbeiten** aus.

1. 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 **Speichern**.

   Sie sehen die Konfigurationseinstellungen, die Sie auf der Detailseite Ihrer Netzwerkanalysator-Konfiguration angegeben haben.

## Hinzufügen von Ressourcen und Aktualisieren der Netzwerkanalysator-Konfiguration anhand der API
<a name="network-analyzer-add-resources-api"></a>

Sie können die [AWS IoT Wireless-API-Operationen](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/) oder die [AWS IoT Wireless-CLI-Befehle](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html) verwenden, um Ressourcen hinzuzufügen und die Konfigurationseinstellungen für Ihren Netzwerkanalysator zu aktualisieren.
+ Um Ressourcen hinzuzufügen und Ihre Netzwerkanalysator-Konfiguration zu aktualisieren, verwenden Sie die API [updateNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) oder die CLI [update-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-network-analyzer-configuration.html).
  + 

**Ressourcen hinzufügen**  
Verwenden Sie für die hinzuzufügenden drahtlosen Geräte `WirelessDevicesToAdd`, um die `WirelessDeviceID` für die Geräte als Array von Zeichenfolgen einzugeben. Verwenden Sie für die hinzuzufügenden drahtlosen Gateways `WirelessGatewaysToAdd`, um die `WirelessGatewayID` für die Gateways als Array von Zeichenfolgen einzugeben.
  + 

**Bearbeiten der Konfiguration**  
Um Ihre Netzwerkanalysator-Konfiguration zu bearbeiten, verwenden Sie den Parameter `TraceContent`, um anzugeben, ob `WirelessDeviceFrameInfo` `ENABLED` oder `DISABLED` sein soll und ob der Parameter `LogLevel` `INFO`, `ERROR` oder `DISABLED` sein soll. 

  ```
  {
     "TraceContent": { 
        "LogLevel": "string",
        "WirelessDeviceFrameInfo": "string"
     },
     "WirelessDevicesToAdd": [ "string" ],
     "WirelessDevicesToRemove": [ "string" ],
     "WirelessGatewaysToAdd": [ "string" ],
     "WirelessGatewaysToRemove": [ "string" ]
  }
  ```
+ Um Informationen über die Konfiguration und die hinzugefügten Ressourcen abzurufen, verwenden Sie die API-Operation [GetNetworkAnalyzerConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateNetworkAnalyzerConfiguration.html) oder den Befehl [get-network-analyzer-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-network-analyzer-configuration.html). Geben Sie den Namen der Netzwerkanalysator-Konfiguration, `NetworkAnalyzerConfig_Default`, ein.

## Nächste Schritte
<a name="network-analyzer-resources-next"></a>

Nachdem Sie Ressourcen hinzugefügt und alle optionalen Konfigurationseinstellungen für Ihre Konfiguration angegeben haben, können Sie das WebSocket-Protokoll verwenden, um eine Verbindung mit AWS IoT Core für LoRaWAN für die Verwendung des Netzwerkanalysators herzustellen. Sie können dann Trace-Nachrichten aktivieren und beginnen, Trace-Nachrichten für Ihre Ressourcen zu empfangen. Weitere Informationen finden Sie unter [Streamen Sie Trace-Nachrichten des Netzwerkanalysators mit WebSockets](network-analyzer-api.md).