

# Trace-Nachrichtenprotokolle des Netzwerkanalysators in Echtzeit anzeigen und überwachen
<a name="network-analyzer-logs"></a>

Wenn Sie Ihrer Netzwerkanalysator-Konfiguration Ressourcen hinzugefügt haben, können Sie Trace-Nachrichten aktivieren, um mit dem Empfang von Ablaufmeldungen für Ihre Ressourcen zu beginnen. Sie können entweder die AWS-Managementkonsole, die AWS IoT Wireless-API oder die AWS CLI verwenden.

## Voraussetzungen
<a name="network-analyzer-logs-prereq"></a>

Bevor Sie Trace-Nachrichten mithilfe des Netzwerkanalysators aktivieren können, müssen Sie über Folgendes verfügen:
+ Die Ressourcen, die Sie überwachen möchten, wurden zu Ihrer standardmäßigen Netzwerkanalysator-Konfiguration hinzugefügt. Weitere Informationen finden Sie unter [Hinzufügen von Ressourcen und Aktualisieren der Netzwerkanalysator-Konfiguration](network-analyzer-resources.md).
+ Mithilfe der Anfrage-URL wurde eine vorsignierte `StartNetworkAnalyzerStream` Anfrage generiert. Die Anfrage wird mit den Anmeldeinformationen für die AWS Identity and Access Management Rolle signiert, die diese Anfrage stellt. Weitere Informationen finden Sie unter [Eine vorsignierte URL erstellen](network-analyzer-generate-request.md#network-analyzer-presigned-url).

## Aktivieren Sie Trace-Nachrichten mithilfe der Konsole
<a name="network-analyzer-activate-console"></a>

Um Trace-Nachrichten zu aktivieren

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

1. Wählen Sie auf der Detailseite Ihrer Netzwerkanalysator-Konfiguration die Option **Trace-Nachrichten aktivieren** und dann **Aktivieren** aus.

   Sie erhalten ab sofort Trace-Nachrichten, bei denen die neueste Trace-Nachricht zuerst in der Konsole erscheint.
**Anmerkung**  
Nach dem Start der Nachrichten-Sitzung können für den Empfang von Ablaufverfolgungsnachrichten zusätzliche Kosten anfallen, bis Sie die Sitzung deaktivieren oder die Trace-Sitzung verlassen. Weitere Informationen zu Preisen finden Sie unter [AWS IoT Core Preise](https://aws.amazon.com/iot-core/pricing/).

## Ablaufverfolgungsnachrichten anzeigen und überwachen
<a name="network-analyzer-view-trace"></a>

Nachdem Sie Trace-Nachrichten aktiviert haben, wird die WebSocket-Verbindung hergestellt und die Trace-Nachrichten werden in Echtzeit angezeigt, die neuesten zuerst. Sie können die Einstellungen anpassen, um die Anzahl der Trace-Nachrichten festzulegen, die auf jeder Seite angezeigt werden sollen, und um nur die relevanten Felder für jede Nachricht anzuzeigen. Sie können das Trace-Nachrichtenprotokoll beispielsweise so anpassen, dass nur Protokolle für WLAN-Gateway-Ressourcen angezeigt werden, für die die **Protokollebene `ERROR`** aktiviert ist, sodass Sie Fehler bei Ihren Gateways schnell identifizieren und debuggen können. Die Trace-Nachrichten enthalten die folgenden Informationen: 
+ **Nachrichtennummer**: Eine eindeutige Nummer, die die zuletzt zuerst empfangene Nachricht anzeigt.
+ **Ressourcen-ID**: Die WLAN-Gateway- oder WLAN-Geräte-ID der Ressource.
+ **Zeitstempel**: Die Uhrzeit, zu der die Nachricht empfangen wurde.
+ **Nachrichten-ID**: Eine Kennung, die AWS IoT Core für LoRaWAN jeder empfangenen Nachricht zuweist.
+ **FPort**: Der Frequenzport für die Kommunikation mit dem Gerät über die WebSocket-Verbindung.
+ **DevEui**: Der erweiterte eindeutige Bezeichner (EUI) für Ihr WLAN-Gerät.
+ **Ressource**: Gibt an, ob es sich bei der überwachten Ressource um ein WLAN-Gerät oder ein WLAN-Gateway handelt.
+ **Ereignis**: Das Ereignis für eine Protokollnachricht für ein WLAN-Gerät. Dabei kann es sich um **Verbinden**, **Erneut verbinden**, **Uplink\$1Data**, **Downlink\$1Data** oder **Registrierung** handeln.
+ **Protokollebene**: Informationen über `INFO` oder `ERROR` Protokollstreams für Ihr Gerät.

## JSON-Protokollnachricht vom Netzwerkanalysator
<a name="connect-iot-network-analyzer-trace-logs"></a>

Sie können auch jeweils eine Trace-Nachricht auswählen, um die JSON-Nutzlast für diese Nachricht anzuzeigen. Abhängig von der Nachricht, die Sie in den Trace-Nachrichtenprotokollen auswählen, werden in der JSON-Nutzlast Informationen angezeigt, die darauf hinweisen, dass sie aus zwei Teilen bestehen: **CustomerLog** und **LoraFrame**.

**CustomerLog**  
Der **CustomerLog-Teil** der JSON-Datei zeigt den Typ und die Kennung der Ressource, die die Nachricht empfangen hat, die Protokollebene und den Nachrichteninhalt an. Das folgende Beispiel zeigt eine **CustomerLog**-Protokollmeldung. Sie können das `message` Feld in der JSON-Datei verwenden, um weitere Informationen über den Fehler zu erhalten und zu erfahren, wie er behoben werden kann.

**LoRaFrame**  
Der **LoRaFrame-Teil** des JSON hat eine **Nachrichten-ID** und enthält Informationen über die physische Nutzlast für das Gerät und die WLAN-Metadaten.

Das folgende Beispiel zeigt die Struktur der Trace-Nachricht.

```
export type TraceMessage = {
  ResourceId: string;
  Timestamp: string;
  LoRaFrame: 
  {
    MessageId: string;
    PhysicalPayload: any;
    WirelessMetadata: 
    {
      fPort: number;
      dataRate: number;
      devEui: string;
      frequency: number,
      timestamp: string;
    },
  }
  CustomerLog: 
  {
    resource: string;
    wirelessDeviceId: string;
    wirelessDeviceType: string;
    event: string;
    logLevel: string;
    messageId: string;
    message: string;
  },
};
```

## Rückblick und nächste Schritte
<a name="network-analyzer-review"></a>

In diesem Abschnitt haben Sie sich Trace-Nachrichten angesehen und erfahren, wie Sie diese Informationen zum Debuggen von Fehlern verwenden können. Nachdem Sie sich alle Nachrichten angesehen haben, können Sie:
+ 

**Trace-Nachrichten deaktivieren**  
Um zusätzliche Kosten zu vermeiden, können Sie Ihre Trace-Nachrichten-Sitzung deaktivieren. Wenn Sie die Sitzung deaktivieren, wird Ihre WebSocket-Verbindung getrennt, sodass Sie keine zusätzlichen Trace-Nachrichten erhalten. Sie können die vorhandenen Nachrichten weiterhin in der Konsole anzeigen.
+ 

**Bearbeiten Sie die Frame-Informationen für Ihre Konfiguration**  
Sie können die Netzwerkanalysator-Konfiguration bearbeiten und wählen, ob Sie die Frame-Informationen deaktivieren möchten, und die Protokollebenen für Ihre Nachrichten auswählen. Bevor Sie Ihre Konfiguration aktualisieren, sollten Sie erwägen, Ihre Trace-Nachrichten-Sitzung zu deaktivieren. Um diese Änderungen vorzunehmen, öffnen Sie die [Netzwerkanalysator-Detailseite in der AWS IoT Konsole](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer/details/NetworkAnalyzerConfig_Default) und wählen Sie **Bearbeiten.** Anschließend können Sie Ihre Konfiguration mit den neuen Konfigurationseinstellungen aktualisieren und Trace Messaging aktivieren, um die aktualisierten Nachrichten zu sehen.
+ 

**Fügen Sie Ihrer Konfiguration Ressourcen hinzu**  
Sie können Ihrer Netzwerkanalysator-Konfiguration auch weitere Ressourcen hinzufügen und diese in Echtzeit überwachen. Sie können insgesamt bis zu 250 Ressourcen für WLAN-Gateways und WLAN-Geräte hinzufügen. Um Ressourcen hinzuzufügen, wählen Sie auf der [Netzwerkanalysator-Detailseite der AWS IoT Konsole](https://console.aws.amazon.com/iot/home#/wireless/networkAnalyzer/details/NetworkAnalyzerConfig_Default) die Registerkarte **Ressourcen** und dann **Ressourcen hinzufügen**. Anschließend können Sie Ihre Konfiguration mit den neuen Ressourcen aktualisieren und Trace-Nachrichten aktivieren, um die aktualisierten Nachrichten für die zusätzlichen Ressourcen zu sehen.

Weitere Informationen zum Aktualisieren Ihrer Netzwerkanalysator-Konfiguration durch Bearbeiten der Konfigurationseinstellungen und Hinzufügen von Ressourcen finden Sie unter [Hinzufügen von Ressourcen und Aktualisieren der Netzwerkanalysator-Konfiguration](network-analyzer-resources.md).