Erstellen einer Netzwerkanalysator-Konfiguration. - AWS IoT Wireless
KonfigurationseinstellungenMithilfe der Konsole erstellen Sie eine Konfiguration wie folgt:Erstellen einer Konfiguration mit der APINächste Schritte

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.

    • 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 und wählen Sie Konfiguration erstellen.

  2. 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.

    • 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.

  3. 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 und wählen Sie die Konfiguration aus, die Sie entfernen möchten.

  2. 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 oder den CLI-Befehl create-network-analyzer-configuration.

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 oder der CLI update-network-analyzer-configuration 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 oder den CLI-Befehl list-network-analyzer-configuration 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 oder dem CLI-Befehl delete-network-analyzer-configuration 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.