Het logboek lezen

Het logboek legt regel voor regel vast wat er bij een back-up, een controle of een herstel is gebeurd. Zo open en lees je het.

Er zijn twee soorten. Elke taak heeft haar eigen taaklogboek. Het algemene logboek bevat wat bij geen enkele taak hoort: de verbindingstests van de doelen, wijzigingen in de instellingen, het schema.

Stap 1: Het logboek openen

Waar	Wat er opent
Rode melding na een taak, gele melding na een back-up, een controle of een diagnose: Logboek	het logboek van die taak
Rode melding zonder taak en gele melding na een mislukte verbindingstest: Logboek tonen	het algemene logboek
Lijst van de back-ups op de pagina’s Overzicht, Back-up en Herstellen: Meer …, daarna Logboek	het logboek van die back-up
Statustegel van het Overzicht na een back-up met waarschuwingen of fout en bij een achterstallig plan: Logboek	het logboek van de back-up die de tegel noemt
Pagina Herstellen, weergave Uitgebreid, tegel Recente herstelacties: Logboek	het logboek van dat herstel
Pagina Instellingen, weergave Uitgebreid, tegel Logboek: Logboek tonen	het algemene logboek

De gele melding na een herstel heeft geen link. Het logboek van een herstel open je in de tegel Recente herstelacties.

1. De melding noemt aantal en soort van de waarschuwingen.
2. Logboek opent het logboek van deze back-up. Daar staan de namen van de items.
3. Het kruisje sluit de melding. Gele en rode meldingen blijven staan tot je ze sluit of een nieuwe actie begint.

Stap 2: De regels lezen

Het dialoogvenster heet altijd Logboek. De regels staan in de volgorde waarin ze zijn geschreven: de oudste bovenaan, de jongste helemaal onderaan.

1. Vooraan staat de tijd, in de tijdzone van de website.
2. Dan volgt het niveau, daarachter de melding.
3. De details bij de melding staan klein eronder.
4. Bij deze waarschuwing noemen de details het item dat niet kon worden geback-upt, en de reden.

Niveau	Betekenis
INFO	Een gewone stap van het proces.
WARNING, geel	Een waarschuwing: iets liep niet soepel.
ERROR, rood	Een fout: iets is mislukt.
DEBUG, grijs	Uitgebreide regels, alleen bij ingeschakelde foutopsporing.

Een lang logboek

Het dialoogvenster toont hoogstens de laatste 500 regels van een logboek. Heeft het logboek meer regels, dan staat boven de lijst Alleen de laatste … regels worden getoond.

1. De melding zegt dat het dialoogvenster alleen de laatste 500 regels van het logboek toont.
2. Een regel van het niveau DEBUG staat in het grijs. Zulke regels schrijft de plugin alleen bij ingeschakelde foutopsporing.

Na het openen staat de lijst aan haar begin: je ziet de oudste van de getoonde regels. De jongste regel vind je helemaal onderaan: scrol in de lijst tot aan het einde. Vanzelf springt het dialoogvenster daar niet naartoe. Oudere regels dan de getoonde staan in de download van alle logboeken.

De meldingen in het logboek zijn Engels. Wachtwoorden en sleutels staan daar nooit in leesbare tekst; op hun plaats staat ********.

Stap 3: De waarschuwingen vinden

Eindigt een back-up met waarschuwingen, dan noemt de melding alleen aantal en soort. Het logboek noemt elk item bij naam, in een regel van het niveau WARNING:

• Entry could not be backed up. Het item is niet geback-upt.
• File changed while it was being read; the backup holds what was read. Het bestand is tijdens het lezen gewijzigd. De back-up bevat wat is gelezen.

In de details staat achter entry het pad binnen de website, nooit een pad van de server, en achter reason de reden:

Reden	Betekenis
unreadable	niet leesbaar
vanished	verdwenen voordat de plugin het item kon lezen
unsupported	niet ondersteund: geen bestand, geen map en geen link
missing	om een andere reden niet geback-upt; de melding rekent deze items tot de verdwenen
changed	gewijzigd tijdens het lezen

Het logboek noemt hoogstens 50 items per reden. Verdere telt het, zonder ze te noemen: More entries of this kind follow; they are counted, not listed.

Het algemene logboek

1. Vooraan staan datum en tijd, in de tijdzone van de website. De datum staat erbij omdat dit logboek over dagen loopt.
2. Dan volgt het niveau, daarachter de melding.
3. Daaronder staan de details bij de melding.
4. Deze regel meldt een fout.

Logboeken bewaren en downloaden

Open de pagina Instellingen, schakel over naar Uitgebreid en klik op de titelregel van de tegel Logboek.

1. Logboeken bewaren gedurende neemt 7 tot 365 dagen, de standaard is 30. Oudere taaklogboeken verwijdert de plugin eenmaal per dag.
2. Foutopsporing gedurende 24 uur schakelt uitgebreide regels in.
3. Logboek schrijfbaar toont of de plugin zijn logboek kan schrijven. Zo niet, dan staat de reden erachter.
4. Opslaan slaat het aantal dagen op.
5. Alle logboeken downloaden slaat alle logboeken op als één bestand.
6. Logboek tonen opent het algemene logboek.

Het bestand heet cloneworx-backup-logs_<host>_<datum>_<tijd>.tar en is niet gecomprimeerd. In de map cloneworx-backup-logs staan het algemene logboek met zijn voorgangerbestand en per taak een bestand. Elke regel van een bestand noemt tijdstempel, niveau, bron, melding en details, gescheiden door verticale strepen. De plugin stuurt logboeken nooit uit zichzelf ergens naartoe.

De foutopsporing inschakelen

De schakelaar werkt meteen. Na 24 uur schakelt de foutopsporing zichzelf uit.

1. Foutopsporing gedurende 24 uur is ingeschakeld.
2. De regel eronder noemt het tijdstip: Foutopsporing staat aan tot ….

Schakel de foutopsporing in voordat je een mislukte handeling herhaalt. De uitgebreide regels staan dan in het logboek van de nieuwe handeling, tussen de andere regels. Een eigen bestand krijgen ze niet.

Als iets niet lukt

Melding	Betekenis
Er is geen logboek meer voor deze back-up. Logboeken worden … dagen bewaard.	Het bestand is verwijderd omdat de bewaartijd om is, of na een verhuizing van de website niet meer aanwezig.
Er is nog geen algemeen logboek.	Er is nog niets geschreven dat bij geen enkele taak hoort.
Het logboek kon niet worden geladen.	De reden staat erachter. Laad de pagina opnieuw en open het logboek nog een keer.

Goed om te weten

• Een taaklogboek neemt vanaf 5 MB alleen nog waarschuwingen en fouten aan, vanaf 10 MB niets meer. Het algemene logboek begint bij 5 MB een nieuw bestand; het bestaande blijft als voorgangerbestand.
• Logboeken staan op de webserver, nooit op een doel.

Zie ook

• Voortgang, meldingen en logboek
• Als een back-up mislukt of eindigt met waarschuwingen
• Hulp krijgen: supportrapport, foutopsporing en diagnose
• De pagina “Instellingen”
• Status, logboeken en support met WP-CLI

Op de opdrachtregel

WP-CLI nog niet ingesteld? Zo installeer je WP-CLI.

WP-CLI geeft de logbestanden weer, schrijft ze allemaal in een tar-bestand en schakelt de foutopsporing. Het bestand achter --to mag nog niet bestaan. De inhoud van een logboek toont logs niet; daarvoor open je de bestanden uit het archief.

# De logbestanden met grootte en datum tonen
wp cloneworx-backup logs

# Alle logboeken als één tar-bestand schrijven
wp cloneworx-backup logs --to=/tmp/cloneworx-logs.tar

# Foutopsporing gedurende 24 uur inschakelen
wp cloneworx-backup debug on

# Tonen of foutopsporing aanstaat, en tot wanneer
wp cloneworx-backup debug status

# Foutopsporing uitschakelen
wp cloneworx-backup debug off