Kaufen

Logs

Free & Premium

Auf 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

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

  1. Öffne Logs.
  2. Wähle in der Auswahlliste einen Eintrag aus Services oder Sites.
  3. 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.
  4. Scrollst du nach oben, bleibt die Ansicht stehen. Kommen dann neue Zeilen dazu, bringt dich Neue Zeilen zurück ans Ende.
  5. 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 .log unter runtime/ 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

  1. Lass Fehler und Abbruch an und schalte Warnung dazu.
  2. Wähle bei Alle Bereiche den Bereich Backups.
  3. Stell den Zeitraum auf Alles, wenn es länger her ist.
  4. 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

  1. Öffne Logs.
  2. 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).
  3. 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

  1. Klick Eigenes Log anlegen. Es öffnet sich Eigenes Log hinzufügen.
  2. Name: so heißt das Log in der Auswahlliste, zum Beispiel „Shop · Fehlerprotokoll“.
  3. 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.
  4. 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.

Siehe auch

Cookie-Voreinstellungen

Diese Website verwendet Cookies, um eine bestmögliche Erfahrung bieten zu können. Deine Wahl gilt für webdonkey.io und den Shop unter shop.webdonkey.io. Mehr Informationen ...

Technisch erforderlich

Für die Funktion der Website erforderliche Cookies:

Immer an
WebDonkey
WebDonkey
Anbieter: BuI Hinsche GmbH, Neumarkt 7, 06712 Zeitz
Zweck: Deine Einwilligung, Farbschema und Sprache für Website und Shop, Preisschalter; mit wd_debug in der Adresse die Messereignisse in der Entwicklerkonsole zur Fehlersuche
Cookies und Speicher: Cookie wd_consent auf .webdonkey.io, gemeinsam mit shop.webdonkey.io (12 Monate); Cookies wd_theme und wd_lang auf .webdonkey.io, gemeinsam mit shop.webdonkey.io, nur wenn du Farbschema oder Sprache selbst umschaltest (365 Tage); localStorage wd:consent, wd:theme, wd:lang; sessionStorage wd:acc, wd:term, wd:debug (nur mit wd_debug in der Adresse; bis der Tab schließt)

Statistik

Zeigt uns, welche Seiten und Produkte auf webdonkey.io und im Shop angesehen werden, woher Besucher kommen und wie sie bis zum Kauf gelangen (mit Bestellnummer, Betrag und Produkten, ohne Name und E-Mail-Adresse). Anbieter: Google. Übermittlung in die USA möglich (EU-US Data Privacy Framework). Deine Wahl gilt für webdonkey.io und den Shop gemeinsam.

Google Tag Manager, Google Analytics 4
Google Tag Manager
Anbieter: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Irland
Zweck: Lädt die Dienste, denen du zugestimmt hast, hier und im Shop. Setzt selbst keine Cookies.
Cookies und Speicher: keine
Datenschutzerklärung
Google Analytics 4
Anbieter: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Irland
Zweck: Nutzungsstatistik: Seitenaufrufe, Klicks, Scrolltiefe, Quellen, Geräte, Ladezeiten; im Shop auch Warenkorb, Kasse, Käufe, Registrierung und Anmeldung
Cookies und Speicher: _ga, _ga_<ID> (2 Jahre)
Datenschutzerklärung

Marketing

Misst, ob unsere Anzeigen auf Facebook, Instagram und TikTok zu Besuchen und Downloads auf webdonkey.io sowie zu Registrierungen und Käufen im Shop führen, und bildet Zielgruppen für Anzeigen. Anbieter: Meta und TikTok, mit denen wir dafür gemeinsam verantwortlich sind. Mit dieser Zustimmung kann auch Google Werbe-Cookies (_gcl_…) setzen. Übermittlung in die USA und weitere Länder außerhalb der EU möglich. Deine Wahl gilt für webdonkey.io und den Shop gemeinsam.

Google Tag Manager, Meta Pixel (Facebook, Instagram), TikTok Pixel
Google Tag Manager
Anbieter: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Irland
Zweck: Lädt die Dienste, denen du zugestimmt hast, hier und im Shop. Setzt selbst keine Cookies.
Cookies und Speicher: keine
Datenschutzerklärung
Meta Pixel (Facebook, Instagram)
Anbieter: Meta Platforms Ireland Limited, Merrion Road, Dublin 4, D04 X2K5, Irland
Zweck: Anzeigenmessung und Zielgruppen auf Facebook und Instagram, auch im Shop (Warenkorb, Kasse, Käufe, Registrierung)
Cookies und Speicher: _fbp (3 Monate), _fbc (3 Monate, nur wenn du über eine Anzeige kommst), fr auf facebook.com (3 Monate)
Datenschutzerklärung
TikTok Pixel
Anbieter: TikTok Technology Limited, 10 Earlsfort Terrace, Dublin, D02 T380, Irland
Zweck: Anzeigenmessung und Zielgruppen auf TikTok, auch im Shop (Warenkorb, Kasse, Käufe, Registrierung)
Cookies und Speicher: _ttp, _tt_enable_cookie (13 Monate)
Datenschutzerklärung