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 globale logboek bevat alles wat cloneworx Backup en cloneworx Backup Pro schrijven: de verbindingstests van de doelen, wijzigingen in de instellingen, het schema, elke actie die de plugin heeft geweigerd en elke regel van elke taak.
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: Globaal logboek tonen | het globale 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 toont |
| Pagina Herstellen, weergave Uitgebreid, tegel Recente herstelacties: Logboek … | het logboek van dat herstel |
| Pagina Instellingen, weergave Uitgebreid, tegel Globaal logboek: Globaal logboek tonen | het globale logboek |
De gele melding na een herstel heeft geen link. Het logboek van een herstel open je in de tegel Recente herstelacties.
- De melding toont aantal en soort van de waarschuwingen.
- Logboek opent het logboek van deze back-up. Daar staan de namen van de items.
- 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 Logboek; bij het globale logboek heet het Globaal logboek. De regels staan in de volgorde waarin ze zijn geschreven: de oudste bovenaan, de nieuwste helemaal onderaan.
- Vooraan staat de tijd, in de tijdzone van de website.
- Dan volgt het niveau, daarachter de melding.
- De details bij de melding staan klein eronder.
- Bij deze waarschuwing tonen de details het item dat niet kon worden geback-upt, en de reden.
- Logboek kopiëren kopieert het logboek naar het klembord. Lukt dat niet, dan staat daar Kopiëren is mislukt. Selecteer de tekst en kopieer die met de hand.
| 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.
- De melding zegt dat het dialoogvenster alleen de laatste 500 regels van het logboek toont.
- Een regel van het niveau DEBUG staat in het grijs. De plugin schrijft zulke regels alleen bij ingeschakelde foutopsporing.
Na het openen staat de lijst aan haar begin: je ziet de oudste van de getoonde regels. De nieuwste regel vind je helemaal onderaan: scrol naar het einde van de lijst. Het dialoogvenster springt daar niet vanzelf 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; ze worden vervangen door ********.
Stap 3: De waarschuwingen vinden
Eindigt een back-up met waarschuwingen, dan toont de melding alleen aantal en soort. Het logboek vermeldt 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 vermeldt hoogstens 50 items per reden. De overige telt het alleen: More entries of this kind follow; they are counted, not listed.
Het globale logboek
- Vooraan staan datum en tijd, in de tijdzone van de website. De datum staat erbij omdat dit logboek over meerdere dagen loopt.
- Dan volgt het niveau, daarachter de melding.
- Daaronder staan de details bij de melding.
- Deze regel meldt een fout.
Toont het dialoogvenster niet alle regels, dan staat bovenaan: Alleen de laatste … regels worden getoond. De volledige globale logboeken krijg je met de knop „Alle logboeken downloaden”.
Weigert de plugin een actie, in de interface of op de opdrachtregel, dan staat daarover een waarschuwing in het globale logboek: Request rejected. bij een actie van de interface, Command rejected. bij een commando. De details vermelden de reden.
Logboeken bewaren en downloaden
Open de pagina Instellingen, schakel over naar Uitgebreid en klik op de titelregel van de tegel Globaal logboek.
- Logboeken bewaren gedurende accepteert 7 tot 365 dagen; de standaardwaarde is 30. Na die tijd verwijdert de plugin het globale logboek en de logboeken van de afzonderlijke taken, eenmaal per dag.
- Foutopsporing gedurende 24 uur schakelt uitgebreide regels in.
- Logboek schrijfbaar toont of de plugin zijn logboek kan schrijven. Zo niet, dan staat de reden erachter.
- Opslaan slaat het aantal dagen op.
- Alle logboeken downloaden slaat alle logboeken op als één bestand.
- Globaal logboek tonen opent het globale logboek.
Het bestand heet cloneworx-backup-logs_<host>_<datum>_<tijd>.tar en is niet gecomprimeerd. In de map cloneworx-backup-logs staan het globale logboek met één bestand per dag en per taak een bestand. Elke regel van een bestand bevat 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.
- Foutopsporing gedurende 24 uur is ingeschakeld.
- De regel eronder toont 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. Ze krijgen geen eigen bestand.
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 is verstreken, of het bestaat niet meer na een verhuizing van de website. |
| Er is nog geen globaal logboek. | De plugin heeft nog niets in het globale logboek geschreven. |
| 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 globale logboek heeft één bestand per dag. Schrijft de plugin er op één dag meer dan 5 MB in, dan neemt het voor de rest van die dag alleen nog waarschuwingen en fouten aan; bij 10 MB stopt het voor die dag.
- 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 in of uit. --to verwacht alleen een bestandsnaam; het bestand wordt aangemaakt in de map cloneworx-backup-exports-… in de uploadmap en mag nog niet bestaan. logs toont de inhoud van een logboek niet; open daarvoor 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=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