Zum Hauptinhalt springen

Remote Logging

Remote Logging ermöglicht es ArmorLink Modules, Diagnoseinformationen über das Gateway an die ArmorLink App weiterzuleiten.

Es wurde entwickelt, um Entwicklung, Fehlersuche und Diagnosen im laufenden Betrieb zu vereinfachen, ohne dass ein USB-Kabel oder Serial Monitor erforderlich ist.

Warum Remote Logging?​

In einem modularen ArmorLink-System befinden sich viele ESP32-Modules oft innerhalb von Rüstungsteilen, Props oder Wearables.

Remote Logging ermöglicht es, das Laufzeitverhalten direkt in der ArmorLink App zu überwachen.

Beispiele:

  • Debuggen von Button-Eingaben
  • Überwachung von Sensoraktivitäten
  • Analyse von Kommunikationsproblemen
  • Erkennen von Konfigurationsfehlern
  • Erfassen von Laufzeitfehlern

Logging-Ablauf​

Remote Logs werden immer über das Gateway weitergeleitet.

Module
   |
   v
Gateway
   |
   v
ArmorLink App

Das Gateway fungiert als Transportebene und leitet Log-Nachrichten an verbundene App-Clients weiter.

Log-Level​

ArmorLink stellt vier Log-Level bereit.

LevelZweck
DebugDetaillierte Entwicklerinformationen
InfoAllgemeine Laufzeitinformationen
WarnMögliche Probleme
ErrorKritische Fehler

Remote Logging aktivieren​

Remote Logging ist deaktiviert, bis es von der ArmorLink App angefordert wird.

Sobald es aktiviert wird, beginnt ArmorLink damit, Log-Nachrichten weiterzuleiten, die dem aktuell ausgewählten Log-Level entsprechen.

Dies verhindert unnötigen ESP-NOW-Verkehr während des normalen Betriebs.

Log-Level-Filterung​

Die ArmorLink App kann steuern, welche Log-Level weitergeleitet werden sollen.

Dadurch kann der Log-Verkehr reduziert werden, ohne wichtige Informationen zu verlieren.

Warn- und Fehlermeldungen​

Warnungen und Fehler gelten als wichtige Diagnoseereignisse und werden nicht gedrosselt.

Auch wenn große Mengen an Debug- oder Info-Meldungen unterdrückt werden, bleiben Warnungen und Fehler stets priorisierte Diagnoseinformationen.

Remote Logging vs. Serial Logging​

Remote Logging und Serial Logging sind unabhängig voneinander.

Serial Logging​

Nachrichten werden im Serial Monitor ausgegeben.

Remote Logging​

Nachrichten werden über das ArmorLink-Netzwerk übertragen und in der ArmorLink App angezeigt.

Beide Systeme können gleichzeitig aktiviert sein.

Best Practices​

Debug für Entwicklung nutzen​

Für Entwicklung und Tests geeignet.

Info für Zustandsänderungen nutzen​

Für normale Statusänderungen und Betriebsinformationen geeignet.

Warn für behebbare Probleme nutzen​

Das Module arbeitet weiter, aber Aufmerksamkeit kann erforderlich sein.

Error für Fehler nutzen​

Verwende Error-Meldungen, wenn Funktionalität nicht verfügbar ist oder ein kritischer Fehler auftritt.

Zusammenfassung​

Remote Logging stellt drahtlose Diagnoseinformationen für ArmorLink-Systeme bereit.

Remote Logs:

  • Werden über das Gateway weitergeleitet
  • Werden in der ArmorLink App angezeigt
  • Unterstützen Debug, Info, Warn und Error
  • Können nach Log-Level gefiltert werden
  • Ermöglichen Diagnose ohne serielle Verbindung

Warnungen und Fehler sollten immer verwendet werden, wenn ungewöhnliche Zustände auftreten.