Logs
Free & PremiumAuf der Seite Logs liest du alle Protokolle deines lokalen Setups an einem Ort: was WebDonkey selbst getan hat, was deine Dienste ausgeben, was die Webserver deiner Sites schreiben und, mit Premium, beliebige eigene Log-Dateien. Das ist der erste Blick, wenn ein Dienst nicht startet, eine Seite einen Fehler zeigt oder ein nächtliches Backup nicht gelaufen ist.
Was du hier machst
- Dienst- und Site-Logs lesen: live mitlesen, suchen, kopieren, exportieren.
- Das WebDonkey-Protokoll durchsehen: Backups, geplante Aufgaben und was dabei schiefging.
- Eigene Logs verfolgen: Log-Dateien deiner Projekte live ansehen, leeren und entfernen.
- Ein eigenes Log hinzufügen.
Aufbau der Seite
Oben links wählst du in einer Auswahlliste, welches Log du siehst. Daneben steht Eigenes Log anlegen. Die Liste ist in Gruppen geteilt:
| Gruppe | Inhalt |
|---|---|
| WebDonkey | Das Ereignisprotokoll der App. Es ist beim ersten Öffnen gewählt. |
| Eigene Logs | Deine eigenen Log-Dateien. Die Gruppe steht direkt unter WebDonkey, damit du sie ohne Scrollen findest. |
| Services | Ein Eintrag je Log-Datei deiner Dienste: das Protokoll jedes Dienstes („Service: …“) und weitere Dateien wie das Fehlerprotokoll von MySQL. |
| Sites | Je Site ihr Access- und ihr Error-Log („Site …: access“ und „Site …: error“). |
Der Untertitel der Seite sagt, was du gerade vor dir hast. Bei Dienst- und Site-Logs nennt er den Ordner <SANDBOX>/runtime/, aus dem sie stammen, und dass sich die Ansicht alle 1,5 Sekunden aktualisiert. Deine Auswahl bleibt erhalten, wenn du zwischendurch eine andere Seite öffnest.
Für die Logs deiner Server gibt es eine eigene Seite: Remote › Logs.
Free und Premium
| Teil | Free | Premium |
|---|---|---|
| WebDonkey-Protokoll | voll nutzbar | voll nutzbar |
| Dienst- und Site-Logs | Hinweis Eingebettete Log-Ansicht ist Premium und Datei öffnen, um die Datei in einem anderen Programm zu lesen | Live-Ansicht in der App |
| Eigene Logs | Die Gruppe ist sichtbar, Eigenes Log anlegen trägt das Premium-Zeichen und ist aus | Anlegen, live verfolgen, leeren, entfernen |
Hast du in Free unter Einstellungen › Navigation Premium-Funktionen ausblenden eingeschaltet, verschwinden die Gruppe Eigene Logs und ihr Knopf ganz.
Dienst- und Site-Logs Free & Premium
Die Gruppen Services und Sites der Auswahlliste zeigen die Log-Dateien, die deine Dienste und die Webserver deiner Sites schreiben. Du siehst die letzten 500 Zeilen live, gut lesbar aufbereitet: Zeitstempel abgesetzt, Fehler und Warnungen farbig, mehrzeilige Einträge wie Stacktraces zusammengefasst. So findest du schnell ein PHP-Fatal im FPM-Log, die Ursache eines 500ers im Error-Log der Site oder den Grund, warum ein Dienst nicht startet.
So findest du es
Seitenleiste Lokal › Logs, dann in der Auswahlliste oben links einen Eintrag aus Services oder Sites. Auf der Kommandozeile listet wd logs list alle Logs, wd logs tail <name> zeigt das Ende eines Logs, mit -f folgt es neuen Zeilen. Mehr dazu unter Aufgaben, Backups und Logs.
So gehst du vor
- Öffne Logs.
- Wähle in der Auswahlliste einen Eintrag aus Services oder Sites.
- Die letzten 500 Zeilen erscheinen, die neueste unten. Die Ansicht holt alle 1,5 Sekunden neue Zeilen und bleibt am Ende, solange du dort bist.
- Scrollst du nach oben, bleibt die Ansicht stehen. Kommen dann neue Zeilen dazu, bringt dich Neue Zeilen zurück ans Ende.
- Klick auf eine Zeile, um sie aufzuklappen. Dann siehst du den vollen Text, auch bei langen Zeilen.
Welche Logs es gibt
- Services: Jede Datei mit der Endung
.logunterruntime/in der Sandbox. Das Protokoll eines Dienstes heißt „Service: …“ mit Dienst und Version, andere Dateien stehen mit ihrem Pfad in der Liste, etwa das Fehlerprotokoll von MySQL oder das Log von OpenSearch. Neue Dateien erscheinen von selbst. - Sites: Je Site „Site …: access“ und „Site …: error“, sobald der Webserver die Datei angelegt hat. Statt des Site-Namens steht dort die interne Kennung der Site, eine lange Zeichenfolge.
Gängige Formate
Zeilen von Apache und nginx (Error- und Access-Log), PHP und PHP-FPM, Laravel und Monolog, syslog und alle Logs mit ISO-Zeitstempel erkennt die Ansicht:
- Der Zeitstempel steht abgesetzt vor der Meldung.
- Fehler sind rot und tragen ein Symbol, Warnungen gelb, Debug-Zeilen gedämpft.
- Zeilen ohne eigenen Zeitstempel, etwa ein Stacktrace, hängen eingeklappt am Eintrag davor. Ein Kennzeichen zeigt, wie viele es sind (n weitere Zeilen).
Zeilen in unbekannten Formaten bleiben normale Zeilen.
Felder und Knöpfe
| Element | Was es tut |
|---|---|
| Suchen… | Filtert die Zeilen. Groß- und Kleinschreibung zählt nicht. Darüber steht „x von y Zeilen“. Passt nichts, steht dort Keine Zeilen für diese Suche. |
| Kopieren | Legt genau die Zeilen, die gerade zur Suche passen, in die Zwischenablage. Danach steht kurz Kopiert da. |
| Als Text exportieren | Speichert dieselben Zeilen als .txt. Der vorgeschlagene Dateiname besteht aus dem Namen der Log-Datei und dem heutigen Datum. |
| Datei öffnen | Öffnet die Log-Datei selbst, so wie unter Einstellungen › Öffnen mit › Ordner und Dateien eingestellt: bei Automatisch im WebDonkey Editor, wenn er installiert ist, sonst mit dem Standardprogramm deines Macs. |
Gut zu wissen
- Hat ein Dienst noch nichts geschrieben, steht dort (noch keine Einträge).
- Schlägt ein Dienststart fehl, zeigt die Seite Services den passenden Auszug schon im Fehler-Hinweis.
- Die Ansicht liest nur Dateien in der Sandbox von WebDonkey. Für andere Dateien nimm Eigene Logs.
Free und Premium
Die Live-Ansicht ist Premium. In Free siehst du stattdessen den Hinweis Eingebettete Log-Ansicht ist Premium und den Knopf Datei öffnen, mit dem du das Log in einem anderen Programm liest.
Siehe auch
WebDonkey-Protokoll Free
Der Eintrag WebDonkey in der Auswahlliste der Seite Logs ist das Ereignisprotokoll der App selbst: was WebDonkey von sich aus getan hat, vor allem Backups und geplante Aufgaben, und was dabei schiefging. Hier findest du heraus, warum ein nächtliches Backup fehlt, welche Aufgabe mit welchem Exit-Code endete und ob ein Lauf ausgefallen ist, weil der Mac schlief. Das Protokoll ist in Free voll nutzbar.
So findest du es
Seitenleiste Lokal › Logs. WebDonkey ist der erste Eintrag der Auswahlliste und beim ersten Öffnen gewählt.
Was drinsteht
Jeder Lauf hinterlässt Ereignisse: Start, Ende und was dazwischen schiefging. Erfasst werden:
| Bereich | Was |
|---|---|
| Backups | Läufe deiner Backup-Sets |
| Geplante Aufgaben | Läufe deiner geplanten Aufgaben |
| Remote-Backups | Backups deiner Server |
| Remote-Cronjobs | Aufgaben, die WebDonkey auf deinen Servern auslöst |
| Sicherheitskopie der Datenbank | Die Kopie, die WebDonkey vor einem Update von seiner eigenen Datenbank anlegt |
Es zählt, was WebDonkey ausführt, egal ob in der App, im Hintergrunddienst ohne geöffnete App oder auf der Kommandozeile. Aufgaben, die ein Server über seine eigene crontab startet, stehen hier nicht. WebDonkey bewahrt die Ereignisse 90 Tage auf.
Filter
Beim Öffnen siehst du nur, was deine Aufmerksamkeit braucht: Fehler und Abbruch der Letzte 7 Tage. Ist in der Zeit nichts davon passiert, steht dort Nichts schiefgegangen mit Alle Ereignisse zeigen.
| Filter | Wirkung |
|---|---|
| Fehler, Abbruch, Warnung, Erfolg, Start | Schalter für die Schwere. Jeder Klick schaltet einen an oder aus. Mit allen fünf siehst du jedes Ereignis. |
| Alle Bereiche | Begrenzt auf einen Bereich aus der Tabelle oben. |
| Letzte 7 Tage oder Alles | Der Zeitraum. |
| Suchen… | Durchsucht Namen, Server, Sites, Gründe, Codes und Details. Groß- und Kleinschreibung zählt nicht. |
Darunter steht „x von y Ereignissen“. Angezeigt werden höchstens die neuesten 500, Kopieren und Export umfassen alle, die zum Filter passen. Gibt es noch gar keine Ereignisse, steht dort Noch keine Ereignisse. Die Filter bleiben erhalten, wenn du zwischendurch eine andere Seite öffnest. Die Liste aktualisiert sich alle 5 Sekunden.
Ein Ereignis lesen
Jede Zeile zeigt das Symbol der Schwere, die Zeit, den Bereich, den Namen (bei Remote mit dem Server), das Ereignis, die erste Zeile des Grundes und die Dauer. Mögliche Ereignisse:
| Ereignis | Bedeutung |
|---|---|
| Gestartet | Der Lauf hat begonnen. |
| Abgeschlossen | Der Lauf ist fertig. |
| Fehlgeschlagen | Der Lauf endete mit einem Fehler, zum Beispiel einem Exit-Code ungleich 0. |
| Abgebrochen | Du hast den Lauf abgebrochen. |
| Unterbrochen | Der Prozess wurde von außen beendet: App beendet, Mac aus oder im Ruhezustand. |
| Nicht zur geplanten Zeit gelaufen | Zur geplanten Zeit lief nichts, der Lauf kam später oder gar nicht. |
| Übersprungen | Der Lauf wurde gar nicht erst begonnen, etwa weil auf dem Server nicht genug Platz war. |
Ein Klick klappt die Details auf: den vollständigen Grund und je nach Lauf Auslöser (Geplant oder Von Hand), Geschrieben von (WebDonkey, WebDonkey Editor, wd (CLI) oder Hintergrunddienst), Server, Site, Exit-Code, Größe, Archiv, Code und Lauf.
Ein ausgefallenes Backup finden
- Lass Fehler und Abbruch an und schalte Warnung dazu.
- Wähle bei Alle Bereiche den Bereich Backups.
- Stell den Zeitraum auf Alles, wenn es länger her ist.
- Klapp das Ereignis auf.
„Nicht zur geplanten Zeit gelaufen“ mit dem Grund, der Mac sei aus oder im Ruhezustand gewesen oder WebDonkey geschlossen, heißt: Kein Hintergrunddienst hat übernommen. Richte dann Ohne geöffnete App ausführen ein. Eine Warnung mit „Teilweise gesichert: nur die Dateien“ heißt: Der Datenbankserver lief zur geplanten Zeit nicht, die Dateien sind gesichert, die Datenbanken nicht. Welche fehlen, steht in den Details.
Kopieren und exportieren
| Knopf | Was er tut |
|---|---|
| Kopieren | Legt alle Ereignisse, die zum Filter passen, als Text in die Zwischenablage. |
| Als Text exportieren | Speichert sie als .txt-Datei. |
| Als CSV exportieren | Speichert sie als .csv-Datei, etwa für eine Tabellenkalkulation. |
| Im Finder zeigen | Zeigt die Datei, in der WebDonkey das Protokoll führt. |
Siehe auch
Eigene Logs Premium
Mit Eigenen Logs verfolgst du beliebige Log-Dateien live in WebDonkey: das Log eines Frameworks, das Fehlerprotokoll eines Shops, das Log eines Workers, alles, was als Text lesbar ist. Die Datei darf überall auf deinem Mac liegen, auch außerhalb der Sandbox. Du brauchst dafür kein Terminal mit tail -f. Eigene Logs sind eine Premium-Funktion.
So findest du es
Seitenleiste Lokal › Logs, dann in der Auswahlliste die Gruppe Eigene Logs. Sie steht direkt unter WebDonkey. Über ⌘K springt der Eintrag Eigene Logs direkt in diese Gruppe. Auf der Kommandozeile gibt es wd logs custom. Mehr dazu unter Aufgaben, Backups und Logs.
So gehst du vor
- Öffne Logs.
- Wähle in der Gruppe Eigene Logs das Log. Gibt es noch keins, steht dort (keine eigenen Logs), und die Ansicht sagt, dass du mit Eigenes Log anlegen eins hinzufügst (siehe Eigenes Log hinzufügen).
- Die letzten 500 Zeilen erscheinen und aktualisieren sich alle 1,5 Sekunden.
Die Ansicht ist dieselbe wie bei Dienst-Logs: Formate erkennen, Zeilen aufklappen, Suchen…, Kopieren, Als Text exportieren und Datei öffnen. Alles dazu steht unter Dienst- und Site-Logs.
Leeren und entfernen
Bei einem geöffneten eigenen Log stehen rechts zwei weitere Knöpfe:
| Knopf | Was er tut |
|---|---|
| Leeren | Fragt Dieses Log leeren? und leert danach die Datei. Der Inhalt ist gelöscht und lässt sich nicht wiederherstellen. Die Datei selbst bleibt, die Anwendung schreibt weiter hinein. |
| Papierkorb (Entfernen) | Fragt Dieses eigene Log entfernen? und nimmt das Log danach aus der Liste. Die Log-Datei bleibt auf der Platte. |
Was im Hintergrund passiert
WebDonkey merkt sich für jedes eigene Log nur Name und Pfad, in seiner eigenen Datenbank. Gelesen wird die Datei erst, wenn du das Log öffnest, und nur, solange die Seite offen ist.
Free und Premium
Eigene Logs sind Premium. In Free siehst du die Gruppe in der Auswahlliste, Eigenes Log anlegen trägt das Premium-Zeichen und ist aus. Öffnest du ein eigenes Log, das noch aus Premium-Zeiten stammt, liegt über der Ansicht der Hinweis Eigene Logs sind Premium, mit Datei öffnen, um die Datei in einem anderen Programm zu lesen. Mit Premium-Funktionen ausblenden unter Einstellungen › Navigation verschwindet die Gruppe ganz.
Wenn es nicht klappt
| Was du siehst | Was du tust |
|---|---|
| (noch keine Einträge) | Die Datei ist leer. Lös in deiner Anwendung etwas aus, das ins Log schreibt. |
| Fehlermeldung statt Zeilen | Die Datei wurde verschoben, gelöscht oder ist nicht mehr lesbar. Entferne das Log und leg es mit dem neuen Pfad an. |
Siehe auch
Eigenes Log hinzufügen Premium
Mit Eigenes Log anlegen nimmst du eine Log-Datei in die Gruppe Eigene Logs der Seite Logs auf. Danach verfolgst du sie dort live wie jedes andere Log. Die Funktion ist Premium.
So findest du es
Seitenleiste Lokal › Logs, rechts neben der Auswahlliste Eigenes Log anlegen. Der Knopf steht dort, egal welches Log gerade offen ist. Auf der Kommandozeile fügt wd logs custom add ein Log hinzu. Mehr dazu unter Aufgaben, Backups und Logs.
So gehst du vor
- Klick Eigenes Log anlegen. Es öffnet sich Eigenes Log hinzufügen.
- Name: so heißt das Log in der Auswahlliste, zum Beispiel „Shop · Fehlerprotokoll“.
- Datei: Trag den vollständigen Pfad ein, oder klick Auswählen… und wähle die Datei. Ist der Name noch leer, übernimmt WebDonkey den Dateinamen.
- Klick Hinzufügen. Der Knopf ist erst aktiv, wenn Name und Datei ausgefüllt sind.
Das neue Log ist sofort gewählt und zeigt seine letzten Zeilen.
Schließt du den Dialog halb ausgefüllt, bleiben deine Eingaben erhalten, bis du die App beendest.
Wenn es nicht klappt
| Meldung | Warum | Was du tust |
|---|---|---|
| „Bitte einen Namen eingeben.“ | Das Feld Name ist leer. | Gib einen Namen ein. |
| „Der Pfad ist keine lesbare Datei.“ | Der Pfad zeigt auf einen Ordner oder auf nichts. | Prüf den Pfad oder nimm Auswählen…. |
| „Die Datei existiert, kann aber nicht gelesen werden (Rechte?).“ | Dir fehlen die Leserechte. | Prüf die Rechte der Datei, etwa mit ls -l. |