Verwenden von Projekten mit erweiterter Protokollierung

Die erweiterte Protokollierung für den Velocity Client ist eine einfache Möglichkeit für Administratoren, die Debugging-Protokollierung auf Andriod-Geräten zu aktivieren und Protokolldateien abzurufen. Verwenden Sie die erweiterte Protokollierung für das Velocity-Protokoll, das Netzwerkprotokoll oder für Dateien mit Bildschirmaufnahmen. Wenn Sie die Protokollebene mithilfe der erweiterten Protokollierung ändern, werden die in einem Profil festgelegten Protokollebenen vorübergehend außer Kraft gesetzt. Auf diese Weise können Sie die Debugging-Protokollierung starten und stoppen, ohne dazu vorhandene Hostprofile ändern oder Dateien an das Gerät senden zu müssen.

Erstellen Sie ein Projekt mit erweiterter Protokollierung, geben Sie die Protokolldateien oder die zu erfassenden Bildschirmaufnahmen an und scannen Sie anschließend den bereitgestellten QR-Code über den Client. Der Client aktiviert die Debugging-Protokollierung und/oder Bildschirmaufnahme, bis eine der folgenden Bedingungen erfüllt ist:

•Der Gerätebenutzer deaktiviert die erweiterte Protokollierung.

•Der Client wird über Menü > Beenden geschlossen.

•Das Gerät hat nicht mehr genügend Speicher für die Dateien.

Wenn die erweiterte Protokollierung stoppt, zeigt der Client dem Benutzer eine Meldung an, komprimiert die Dateien und sendet sie an die Console, wo der Administrator sie prüfen kann. Wenn die Console nicht verfügbar ist, wird die komprimierte Datei im Verzeichnis Downloads/com.wavelink.velocity auf dem Gerät gespeichert.

Die erweiterte Protokollierung kann ohne QR-Code vom Gerätebenutzer aktiviert werden, allerdings werden die Dateien dann stets lokal auf dem Gerät gespeichert und nicht an die Console gesendet. Informationen zum Aktivieren der erweiterten Protokollierung ohne QR-Code finden Sie unter Installieren des Velocity Clients. Wenn Sie die erweiterte Protokollierung ohne QR-Code aktivieren, beinhaltet diese keine Dateien mit Bildschirmaufnahmen.

Wenn Sie die Bildschirmaufnahme für ein Projekt mit erweiterter Protokollierung aktivieren, erstellt der Client für jede Sitzung, die während der Verwendung der erweiterten Protokollierung aktiv ist, eine separate Datei für die Bildschirmaufnahme (.wltsc).

Wenn auf dem Gerät Android 10 ausgeführt wird, hat der Client keinen Zugriff auf das Verzeichnis "Downloads/com.wavelink.velocity". Die Datei wird stattdessen im Verzeichnis "Android/data/com.wavelink.velocity/files" gespeichert. Android-Geräte nach Android 10 haben Zugriff auf das Downloads-Verzeichnis, Android 10 jedoch nicht.

Wie funktioniert der QR-Code?

Wenn Sie die erweiterte Protokollierung über einen QR-Code aktivieren, fungiert die Console als Server für den Empfang von Dateien über HTTPS, solange die Console den QR-Code anzeigt. Der Datenverkehr wird unter Verwendung eines im QR-Code enthaltenen Tokens gesichert. Zu Ihrer eigenen Sicherheit sollten Sie den QR-Code nur anzeigen, solange Sie die erweiterte Protokollierung aktiv verwenden. Falls Sie den QR-Code drucken möchten, empfehlen wir, den Zugang zu dem Ausdruck maximal einzuschränken. Der QR-Code gilt nur für die Console, die ihn generiert hat.

Damit die Console die komprimierte Datei vom Client empfangen kann, muss sie den QR-Code anzeigen, wenn das Gerät die Protokollierung stoppt. Empfangene Dateien werden im Ordner für Downloads gespeichert. Wenn der QR-Code nicht angezeigt wird, akzeptiert die Console keine Dateien (in dem Fall zeigt das Gerät eine Meldung an, die darauf hinweist, dass die Console nicht verfügbar ist und speichert die Dateien lokal). Wenn Sie jedoch das Projekt schließen und später wieder öffnen, kann das Gerät weiterhin die Dateien an die Console senden, solange der QR-Code angezeigt wird, wenn der Client die Protokollierung stoppt. Der QR-Code wird ungültig, wenn Sie die Console neu starten oder Hostadresse oder Port ändern.

Optionen für die erweiterte Protokollierung

Für ein Projekt mit erweiterter Protokollierung sind folgende Optionen verfügbar:

•Kunde. Der Name für das Unternehmen oder die Organisation, mit dem/der das Projekt verknüpft ist.

•Host. Die IP-Adresse oder der Hostname des lokalen Computers. Da die Hostadresse im QR-Code verwendet wird, ändert sich bei Änderung der Hostadresse auch der QR-Code und zuvor generierte QR-Codes verlieren ihre Gültigkeit.

•Port. Der Port, den die Console auf eingehende Dateien überwacht. Stellen Sie sicher, dass dieser Port für nichts anderes verwendet wird.

•Einschließen:

•Debugging-Protokollierung. Legt die Protokollebene für alle Sitzungen fest, für die Debugging in Frage kommt, und schließt das Velocity-Protokoll bei den Dateien ein, die an die Console gesendet werden.

•Netzwerkprotokollierung (nur TE). Legt die Protokollebene für die Netzwerkprotokollierung fest, die für Debugging in Frage kommt, und schließt das Netzwerkprotokoll bei den Dateien ein, die an die Console gesendet werden. Das Netzwerkprotokoll gilt nicht für Websitzungen.

•Bildschirmaufnahme (nur TE). Aktiviert die Bildschirmaufnahme und erstellt BiIdschirmaufnahmen für alle aktiven TE-Sitzungen. Jede Sitzung besitzt eine eigene Datei mit Bildschirmaufnahmen. Die Dateien mit den Bildschirmaufnahmen werden an die Console gesendet. Weitere Informationen zum Anpassen von Bildschirmen anhand von Bildschirmaufnahmen finden Sie unter Konfigurieren von Bildschirmen.

•Speicherort der Protokolldatei öffnen. Öffnet den lokalen Speicherort, an dem die Dateien, die von Geräten gesendet wurden, abgelegt werden.

1.Starten Sie die Velocity Console-Anwendung.

2.Klicken Sie auf die Schaltfläche Erstellen in der oberen rechten Ecke des Bildschirms und wählen Sie Erweiterte Protokollierung aus.

3.Geben Sie einen Namen für das Projekt ein. Sie können auch ein Unternehmen angeben und dieses zum Sortieren der Projekte verwenden.

4.Klicken Sie auf Erstellen.

Das Projekt wird geöffnet, und Sie können die Einstellungen konfigurieren.

Führen Sie die ersten zwei Schritte über die Velocity Console durch und die übrigen Schritte über den Velocity Client auf einem Android-Gerät. Sie können die erweiterte Protokollierung zwar ohne QR-Code starten, allerdings werden die Dateien dann vom Gerät nicht an die Console gesendet, wenn die Protokollierung abgeschlossen ist.

1.Öffnen Sie in der Velocity Console ein Projekt mit erweiterter Protokollierung.

2.Klicken Sie oben rechts auf Barcode anzeigen.

3.Navigieren Sie im Velocity Client auf einem Android-Gerät zur Profilliste und tippen Sie auf Menü > Erweiterte Protokollierung.

4.Geben Sie ggf. das Kennwort ein.

5.Scannen Sie den QR-Code mit dem Gerät.

6.Tippen Sie auf Erweiterte Protokollierung starten.

Der Client aktiviert den angeforderten Protokollierungstyp solange, bis eine der folgenden Bedingungen erfüllt ist: Der Gerätebenutzer deaktiviert die erweiterte Protokollierung, indem er auf Menü > Erweiterte Protokollierung > Erweiterte Protokollierung stoppen tippt, der Benutzer tippt auf Menü > Beenden oder das Gerät hat nicht mehr genügend Speicherplatz für die Dateien. Vergewissern Sie sich, dass der QR-Code für die erweiterte Protokollierung angezeigt wird, wenn das Gerät versucht, die Dateien zu senden, und dass die komprimierten Dateien, wenn sie von der Console empfangen werden, in der Liste der empfangenen Dateien angezeigt werden.

Wenn die Console nicht verfügbar ist, zeigt der Client eine Meldung an, die darauf hinweist, dass die Console nicht kontaktiert werden kann. Anschließend speichert der Client die Protokolldateien lokal.

•Wenn Sie die erweiterte Protokollierung unter Verwendung eines QR-Codes aktiviert haben und die Dateien an die Console übertragen wurden, wechseln Sie auf dem Windows-Gerät, auf dem die Console installiert ist, zum Verzeichnis Downloads\VelocityLogs. Innerhalb des Verzeichnisses VelocityLogs verfügt jedes Projekt mit erweiterter Protokollierung über ein eigenes Verzeichnis. Klicken Sie in einem geöffneten Projekt mit erweiterter Protokollierung auf Speicherort der Protokolldatei öffnen, um den Ordner zu öffnen, in dem sich das aktuelle Projekt mit erweiterter Protokollierung befindet. Dekomprimieren Sie die Datei und öffnen Sie dann entweder die Protokolldateien in einem Texteditor oder importieren Sie die .wltsc-Datei in ein Hostprofil.

-Oder-

•Wenn Sie die erweiterte Protokollierung über den Client gestartet haben oder wenn die Dateien nicht an die Console übertragen wurden, navigieren Sie auf dem Gerät zum Verzeichnis Downloads/com.wavelink.velocity (falls auf dem Gerät Android 10 ausgeführt wird, navigieren Sie zum Verzeichnis Android/data/com.wavelink.velocity/files). Dekomprimieren Sie die Datei und öffnen Sie dann entweder die Protokolldateien in einem Texteditor oder importieren Sie die .wltsc-Datei in ein Hostprofil.