Achtergrondtaken volgen

Niet alles is meteen klaar. Een website aanmaken duurt seconden, een certificaat aanvragen een halve minuut, een back-up terugzetten soms een uur, en een verhuizing van een hele server een nacht. Al dat werk draait op de server, niet in je browser: je mag het tabblad sluiten, je laptop dichtklappen en morgen terugkomen.

Deze pagina gaat over waar je dat werk terugvindt, wat de toestanden betekenen, en waarom je bij sommige taken wel een teller ziet en bij andere niet.

1. Waar je het vindt

Op twee plekken, en ze beantwoorden een iets andere vraag.

Het klokje in de balk bovenaan, links van het belletje. Het cijfer erop is het aantal dingen dat nu draait; een rood stipje eronder betekent dat er kort geleden iets is misgegaan. Klik erop en je ziet wat er loopt, met daaronder de laatste tien die klaar zijn — elk met de looptijd en, waar dat kan, de teller. Op je telefoon schuift hetzelfde lijstje van onderen in beeld.

Dit is ook waar een taak "heen verhuist". Start je iets, dan zie je het meteen onder de knop die je indrukte; die melding verdwijnt zodra je verder klikt, maar het klokje houdt het vast. Je mag dus gerust wegnavigeren. Precies dát ging vroeger mis: je startte een terugzetting, ging naar je e-mail kijken, en het paneel was vergeten dat er iets liep. De server niet.

De pagina Taken (menu: Inzicht › Taken) is de volledige lijst, met filters, en de plek waar je iets van vorige week terugzoekt. Boven de tabel staan twee knoppen: Alles en Vraagt aandacht. Die tweede laat alleen zien wat mislukt is of waarvan de toestand onbekend werd — de twee dingen waar je iets mee moet. Daarnaast filter je op status, herkomst, server en periode, en het zoekveld zoekt op handeling, onderwerp en servernaam.

Taken of Meldingen? Twee vensters op dezelfde gebeurtenissen. Taken is de stand van zaken: wat draait er, hoe ver is het, en wat kwam eruit. Meldingen (het belletje) is de geschiedenis van wat je verteld is, met gelezen/ongelezen en een archief. Een taak die klaar is levert precies één melding op — niet twee.

2. Wat er in de lijst staat

Eén lijst voor alles wat op de achtergrond loopt, van drie soorten herkomst:

Elke regel vertelt hetzelfde verhaal: wanneer het begon, wat het is, waar het over gaat, op welke machine, wie het vroeg, hoe lang het duurt en hoe het staat.

Je ziet alleen je eigen werk. Precies dezelfde grens als bij het auditlog en de meldingen: als klant zie je wat jij hebt gevraagd, als reseller wat jij en je klanten hebben gevraagd, als beheerder alles. Dat is geen aparte regel voor deze lijst maar dezelfde regel, één keer opgeschreven — een taak kan hier dus nooit opduiken die je in het auditlog niet zou zien.

3. De toestanden

• In de wachtrij — aangenomen, maar de machine is nog met iets anders bezig. Een server voert zijn wijzigingen één voor één uit, zodat twee handelingen elkaar nooit in de weg zitten.
• Bezig — hij draait.
• Klaar — gelukt.
• Mislukt — niet gelukt, met de reden erbij. Zo'n regel krijg je ook als melding, dus je hoeft er niet op te zitten wachten.
• Afgebroken — de taak had een tijdslimiet en die was op, of de server werd eronder herstart. Dit is nadrukkelijk iets anders dan mislukt: er is niets kapot, het werk is alleen niet afgemaakt. Wat al klaar was blijft staan, en het logboek laat zien hoever hij kwam. Deze staat telt wél mee bij Vraagt aandacht.
• Gestopt — iemand heeft op stoppen gedrukt. Dat is een keuze en geen probleem, dus deze staat vraagt géén aandacht.
• Onbekend — dit is de eerlijke toestand. Het paneel heeft de server vijf minuten lang niet kunnen bereiken (of de server kent de taak niet meer), en weet dus níet of het werk gelukt is. Er staat dan bij sinds wanneer het stil is. Een herstart of een korte netwerkstoring duurt korter dan vijf minuten, en daar blijft de taak gewoon "bezig" doorheen.

4. Waarom niet alles een balk heeft

Bij sommige taken staat een teller — 3 van de 11 accounts — en bij de meeste niet. Dat is geen onafheid maar een keuze.

Een balk mag er alleen staan als er echt geteld is. Een handeling die vooraf een lijst heeft gemaakt, weet hoeveel er in zit en kan dus eerlijk zeggen hoe ver hij is. Vandaag zijn dat er drie:

• een back-up van álle accounts op een server: accounts;
• een verhuizing van een hele server: accounts;
• een bulkactie over je WordPress-sites: sites.

Alle andere handelingen tonen de toestand en de looptijd, en geen percentage. De reden is dat de alternatieven allemaal liegen: een balk op basis van verstreken tijd staat op 80% terwijl er nog een half uur te gaan is, en een balk op basis van het aantal logregels versnelt precies wanneer er iets misgaat en er veel geschreven wordt. Liever geen getal dan een verkeerd getal.

Een teller loopt bovendien nooit terug. Ook niet bij een verhuizing die tien accounts tegelijk doet en ze in willekeurige volgorde afmeldt.

5. De uitvoer teruglezen

Klik een regel — in de lijst of in het klokje — en er schuift een paneel open met het volledige logboek van die handeling, met waarschuwingen apart bovenaan gemarkeerd. Hetzelfde logboek dat je tijdens de handeling onder de knop ziet meelopen, maar dan achteraf en compleet.

Is de taak mislukt, dan staat de foutmelding bovenaan in het rood, in de woorden van de server zelf — niet "er ging iets mis", maar bijvoorbeeld "het adres in DNS wijst naar 203.0.113.9 en deze server luistert op 185.117.226.120". Onderaan staat één knop terug naar waar de taak over ging: het account, het domein, de uitrol of de verhuizing.

Zo'n geopend paneel heeft een eigen webadres (/tasks?task=…), dus je kunt de link doorsturen naar een collega of naar de helpdesk.

Twee bewaartermijnen, en het verschil is zichtbaar:

Een taak van twee maanden geleden staat er dus nog, maar zegt dan "het logboek is op de server verlopen" in plaats van een lege pagina te tonen. Dat is bewust: leeg zou eruitzien als een storing.

Bij een uitrol of een verhuizing staat er geen logboek maar een verwijzing naar de eigen pagina van dat werk, want dáár staat het volledige verhaal per server of per account.

6. Stoppen — en wat stoppen níet is

Open een taak die nog loopt en er staat een knop Stoppen. Die was er lang niet, en met reden: zolang de server zelf geen "annuleren" kende was een stopknop een knop die er alleen maar uitzag alsof hij iets deed. De server kent het nu wel, dus de knop is er — met precies dezelfde eerlijkheid.

Het paneel vertelt je vóór je bevestigt wat er gaat gebeuren, en er zijn drie mogelijke uitkomsten:

• Gestopt. De taak was nog niet begonnen. Er is niets op de server veranderd.
• Gevraagd te stoppen. De taak was al bezig. Hij stopt op het eerstvolgende punt waarop de server in een nette toestand staat — en hij kan dus nog gewoon klaar raken. Dat is geen slag om de arm maar de waarheid: een wijziging half afbreken zou de server in een toestand achterlaten die niemand heeft ontworpen.
• Te laat. Hij was al klaar. Er verandert niets.

Stoppen is geen terugdraaien. Wat al gedaan is blijft staan; het logboek onder de taak laat zien hoever hij kwam. Wil je iets ongedaan maken, dan doe je dat daarna met de gewone handelingen — de meeste zijn omkeerbaar, en de handelingen die dat niet zijn vragen vooraf om bevestiging.

Een uitrol en een migratie stop je op hun eigen pagina en niet hier. Twee stopknoppen voor hetzelfde werk zouden vroeg of laat iets anders doen.

6a. "De server is bezig" bij webmail of phpMyAdmin

Druk je op Webmail of phpMyAdmin terwijl de server net een andere wijziging doorvoert, dan krijg je binnen een seconde een gele melding: de server is bezig met een andere wijziging, dus aanmelden is niet gestart; er is niets veranderd. Probeer het even later opnieuw — meestal is het dan gewoon klaar.

Dat is bewust een snelle weigering en geen wachtscherm. Aanmelden is óók een wijziging op de server, dus het stond vroeger in dezelfde rij en je keek tot een minuut lang naar "Bezig met aanmelden…" voordat je hetzelfde antwoord kreeg. Hetzelfde antwoord, een minuut eerder, is het hele verschil.

7. Voor beheerders: vanaf de opdrachtregel

# Alles wat nu draait, over de hele vloot.
root@panel1:~# corecp-panel tasks list --active
STARTED              SOURCE  OPERATION        SUBJECT  NODE              STATE    PROGRESS       DURATION  ID
2026-08-17 09:41:02  node    backup.accounts  -        stck1.corecp.dev  running  3/11 accounts  1m48s     6f1e…

# Alleen de mislukte van vandaag.
root@panel1:~# corecp-panel tasks list --state failed --limit 10

# En wat er onderweg is afgebroken.
root@panel1:~# corecp-panel tasks list --state interrupted --limit 10

# Eén taak helemaal, inclusief de reden achter de toestand.
root@panel1:~# corecp-panel tasks show 6f1e2c40-0000-4000-8000-000000000001

# Het paneel bijwerken zonder op de lus te wachten (handig na een storing).
root@panel1:~# corecp-panel tasks reconcile
4 row(s) reconciled or projected

En via de API, met een API-sleutel die de familie tasks mag lezen:

$ curl -s -H "Authorization: Bearer $KEY" \
    'https://panel1.corecp.dev/api/v1/tasks?active=1&limit=5'
$ curl -s -H "Authorization: Bearer $KEY" \
    'https://panel1.corecp.dev/api/v1/tasks/6f1e2c40-…'

De technische kant staat in docs/tasks.md.