Trace-Nachrichtenprotokolle des Netzwerkanalysators in Echtzeit anzeigen und überwachen - AWS IoT Wireless
VoraussetzungenAktivieren Sie Trace-Nachrichten mithilfe der KonsoleAblaufverfolgungsnachrichten anzeigen und überwachenJSON-Protokollnachricht vom NetzwerkanalysatorRückblick und nächste Schritte

Trace-Nachrichtenprotokolle des Netzwerkanalysators in Echtzeit anzeigen und überwachen

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 Management Console, die AWS IoT Wireless-API oder die AWS CLI verwenden.

Voraussetzungen

Bevor Sie Trace-Nachrichten mithilfe des Netzwerkanalysators aktivieren können, müssen Sie über Folgendes verfügen:

Aktivieren Sie Trace-Nachrichten mithilfe der Konsole

Um Trace-Nachrichten zu aktivieren

  1. Öffnen Sie den Netzwerkanalysator-Hub der AWS IoT Konsole und wählen Sie Ihre Netzwerkanalysator-Konfiguration, NetworkAnalyzerConfig_Default.

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

Ablaufverfolgungsnachrichten anzeigen und überwachen

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 for 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_Data, Downlink_Data oder Registrierung handeln.

  • Protokollebene: Informationen über INFO oder ERROR Protokollstreams für Ihr Gerät.

JSON-Protokollnachricht vom Netzwerkanalysator

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

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