Remote › Logs
PremiumAuf der Seite Remote-Logs liest du Logdateien auf deinen Servern über die gespeicherte SSH-Verbindung mit, etwa das Fehlerlog von nginx oder das Log eines Shops. Übertragen wird nur, was neu dazugekommen ist. Die Zeilen siehst du in derselben Ansicht wie lokale Logs, mit Suche, Kopieren und Export. Remote-Logs sind eine Premium-Funktion.
Was du hier machst
- Remote-Log hinzufügen: eine Logdatei auf einem Server eintragen.
- Wann gelesen wird: beim Öffnen, live alle paar Sekunden oder nach Zeitplan.
- Zeilen durchsuchen, kopieren und als Text exportieren, siehe unten.
Aufbau der Seite
- Kopfzeile: Titel und Kurzbeschreibung. Rechts Hinzufügen, Aktualisieren (liest das gewählte Log sofort), Live mit der Auswahl des Intervalls (5 bis 10 s), Bearbeiten (Stift) und Entfernen (Papierkorb).
- Hinweis auf Risiken: der Streifen Vorsicht: Arbeit direkt auf dem Server wie auf allen Remote-Seiten.
- Infozeile zum gewählten Log: Server, Pfad, Zeitplan (etwa alle 1 Min., cron … oder bei Bedarf), Zeitplan pausiert, Größe der Datei und gelesen mit der Zeit des letzten Abrufs. Wurde die Datei rotiert oder geleert, steht dort eine Marke, dass neu begonnen wurde.
- Verbindungen (links): deine Server, unter jedem Server seine Logs mit Name und Pfad. Ein Klick auf ein Log zeigt es rechts und wählt seinen Server für alle Remote-Seiten. Ein Log, dessen letzter Abruf scheiterte, trägt ein rotes Warnsymbol.
- Die Ansicht (rechts): die Zeilen des gewählten Logs.
Gibt es noch kein Log, fordert dich die Ansicht auf, eine Logdatei hinzuzufügen.
Die Ansicht
- Suchen… filtert die Zeilen, daneben steht … von … Zeilen. Die Suche merkt sich WebDonkey für die Sitzung.
- Kopieren und Als Text exportieren nehmen genau die Zeilen, die die Suche zeigt.
- Zeilen gängiger Formate (Apache und nginx, PHP und PHP-FPM, Laravel und Monolog, syslog, die meisten Logs mit ISO-Zeitstempel) zeigen Zeit und Stufe abgesetzt: Fehler und Warnungen farbig mit Symbol, Debug gedämpft. Unbekannte Formate bleiben normale Zeilen.
- Zeilen ohne eigenen Zeitstempel, etwa ein Stacktrace, liegen eingeklappt unter dem Eintrag davor. Eine Marke nennt die Zahl der weiteren Zeilen. Ein Klick klappt den Eintrag auf.
- Die Liste zeigt die neuesten 2.000 Einträge. Ältere sind ausgeblendet, Suche, Kopieren und Export umfassen trotzdem alle.
- Die Liste folgt dem Ende. Bist du nach oben gescrollt, während neue Zeilen kommen, führt Neue Zeilen zurück ans Ende.
Ist der Server nicht erreichbar, steht der Fehler über der Ansicht. Die bisher gelesenen Zeilen bleiben stehen.
Free und Premium
Remote-Logs gehören zu Premium. Ohne Premium liegt eine Sperre über der Ansicht, und geplante Abrufe laufen nicht. Preise stehen auf webdonkey.io/pricing.
Über die Kommandozeile
wd remote logs listet die Remote-Logs, wd remote logs tail liest eines und gibt das Ende aus, mit -f fortlaufend. Mehr unter Server (Remote).
Remote-Log hinzufügen Premium
Ein Remote-Log ist ein Eintrag für eine Logdatei auf einem Server: welcher Server, welche Datei, wie es heißt und wann WebDonkey nach neuen Zeilen sieht. Die Datei selbst bleibt auf dem Server, WebDonkey liest sie nur.
So findest du es
Seitenleiste Remote › Logs, dann Hinzufügen oben rechts. Der Dialog heißt Remote-Log hinzufügen. Ein bestehendes Log wählst du links und öffnest es mit dem Stift (Remote-Log bearbeiten).
So gehst du vor
- Wähle links den Server und klicke auf Hinzufügen. Ohne SSH-Verbindung ist der Knopf gesperrt, lege dann zuerst eine unter Verbindungen an.
- Prüfe den Server.
- Trag unter Logdatei auf dem Server den Pfad ein, etwa
/var/www/shop/var/log/prod.log, oder wähle die Datei mit Durchsuchen… (Logdatei auswählen). - Gib einen Name ein, etwa „Shop · prod.log“. Wählst du die Datei mit Durchsuchen… und ist der Name noch leer, setzt WebDonkey den Dateinamen ein.
- Wähle bei Auf neue Zeilen prüfen, wie oft gelesen wird, siehe Wann gelesen wird.
- Klicke auf Speichern. Das Log erscheint links unter seinem Server und wird gleich gelesen.
Speichern wird frei, wenn Server, Name und Pfad da sind.
Felder und Optionen
| Feld | Bedeutung |
|---|---|
| Server | Die SSH-Verbindung. Vorgewählt ist der Server, der links gewählt ist. |
| Logdatei auf dem Server | Der Pfad der Datei. Er muss absolut sein oder mit ~/ beginnen. Durchsuchen… zeigt den Server, ein Klick auf eine Datei und Datei übernehmen (oder ein Doppelklick) setzt sie ein. |
| Name | Wie das Log in der Liste heißt. |
| Auf neue Zeilen prüfen | Nur beim Öffnen / live, alle 30 s, alle 1 Min. (Vorgabe), alle 5 Min., alle 15 Min., alle 1 Std. oder Cron-Ausdruck mit eigenem Ausdruck (Vorgabe */5 * * * *). |
| Zeitplan aktiv | Schaltet das Lesen nach Zeitplan ein oder aus. Vorgabe: an. |
Was im Hintergrund passiert
- Der erste Abruf holt die letzten 500 Zeilen. Jeder weitere fragt zuerst Größe und Kennung der Datei ab und holt dann nur, was seit dem letzten Abruf dazugekommen ist.
- Ist die Datei kürzer geworden oder eine andere (rotiert oder geleert), beginnt WebDonkey mit ihren letzten Zeilen neu und zeigt das in der Infozeile.
- Was gelesen wurde, hält WebDonkey im Speicher, bis zu 2 MB je Log. Gespeichert wird nur der Eintrag selbst, nicht der Inhalt. Nach einem Neustart liest WebDonkey das Log beim Öffnen neu.
Bearbeiten und entfernen
- Der Stift öffnet Remote-Log bearbeiten mit denselben Feldern.
- Der Papierkorb fragt Remote-Log entfernen?. Das Log verschwindet aus der Liste, die Datei auf dem Server bleibt unberührt.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Der Pfad muss absolut sein (oder mit ~/ beginnen). | Der Pfad ist relativ. | Vollen Pfad eintragen oder mit Durchsuchen… wählen. |
| Die Logdatei gibt es auf dem Server nicht (mehr). | Datei gelöscht oder Pfad falsch. | Pfad prüfen. |
| Der SSH-Benutzer darf diese Logdatei nicht lesen. | Fehlende Leserechte. | Rechte auf dem Server anpassen oder einen anderen Benutzer nehmen. |
| Das ist keine normale Datei … | Gewählt ist ein Ordner, ein Gerät oder eine Pipe. | Die Logdatei selbst wählen. |
| Das Intervall muss mindestens 5 Sekunden betragen. | Ein zu kurzes Intervall. | Längeres Intervall wählen. |
Siehe auch
Wann gelesen wird Premium
Ein Remote-Log liest WebDonkey auf drei Arten: wenn du es öffnest, live alle paar Sekunden, solange es angezeigt wird, und nach einem Zeitplan im Hintergrund. Jedes Mal wird nur übertragen, was neu ist.
So findest du es
Seitenleiste Remote › Logs. Aktualisieren und Live sitzen oben rechts, den Zeitplan stellst du im Dialog des Logs unter Auf neue Zeilen prüfen ein.
Beim Öffnen
Wählst du ein Log, zeigt WebDonkey, was es schon gelesen hat. Hat es noch nichts, liest es sofort. Aktualisieren liest jederzeit neu.
Live
- Wähle das Log.
- Stelle neben Live das Intervall ein: 5, 6, 7, 8, 9 oder 10 s (Vorgabe 5 s).
- Klicke auf Live. Das Symbol pulsiert grün, und das Log wird im eingestellten Abstand neu gelesen.
Live gilt nur für das eine Log, das du gerade siehst. Wechselst du das Log oder verlässt du die Seite, endet Live. Das Intervall merkt sich WebDonkey für die Sitzung.
Nach Zeitplan
Im Dialog stellst du unter Auf neue Zeilen prüfen ein Intervall (alle 30 s bis alle 1 Std.) oder einen Cron-Ausdruck ein. Zeitplan aktiv schaltet ihn ein und aus. Ist er aus, steht in der Infozeile Zeitplan pausiert. Mit Nur beim Öffnen / live wird nicht nach Zeitplan gelesen, die Infozeile zeigt dann bei Bedarf.
Gelesen wird, solange WebDonkey läuft. Ist WebDonkey geschlossen, ruht der Zeitplan. Die Infozeile zeigt bei gelesen, wann zuletzt abgerufen wurde.
Was im Hintergrund passiert
- Jeder Abruf läuft über die gespeicherte SSH-Verbindung des Servers.
- Live und Zeitplan können zusammentreffen. Es läuft trotzdem immer nur ein Abruf je Log zur Zeit.
- Kamen seit dem letzten Abruf sehr viele Daten dazu (mehr als 1 MB), springt WebDonkey zum neuesten Teil.
- Im WebDonkey Editor gibt es keinen Zeitplan im Hintergrund. Dort liest das gewählte Log im eigenen Intervall neu, solange es angezeigt wird. Logs mit Cron-Ausdruck werden dort nur bei Bedarf gelesen.
Free und Premium
Alle drei Arten gehören zu Premium. Ohne Premium läuft auch kein Zeitplan.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Roter Kasten mit Fehler über der Ansicht | Der Server war nicht erreichbar oder die Datei nicht lesbar. Bei Live und Zeitplan steht darunter, dass der nächste Durchgang es erneut versucht. Die bisher gelesenen Zeilen bleiben. | Verbindung prüfen, sonst einfach abwarten. |
| Live ist gesperrt | Es ist kein Log gewählt. | Wähle links ein Log. |
| Keine neuen Zeilen trotz Zeitplan | Zeitplan aktiv ist aus oder WebDonkey war geschlossen. | Zeitplan einschalten, Aktualisieren klicken. |