De beheerconsole is het afgeschermde deel van de dienst. Zij toont het gedrag van BesluitBron en niet de gegevens van de bronplatformen, want die zijn voor iedereen zonder inlog te lezen.
Bereikbaar via /login op het adres van de installatie. Wat elk scherm toont, staat met een afbeelding erbij in Beheer; deze pagina beschrijft het gebruik. De console wordt niet geïndexeerd door zoekmachines.
Wat er te zien is
Naast "Dashboard" staat één andere knop, "Menu". Die opent elk scherm hieronder als tegel, gegroepeerd naar waarvoor het dient, met een sterretje om een tegel bovenaan in een eigen groep te zetten. Zie Menu voor die groepen.
- Het dashboard: de aanroepen terwijl zij binnenkomen, met hun duur en hun omvang, via een live verbinding;
- Het verzoeklogboek: wat er de afgelopen dagen is aangeroepen, te filteren per connector. Zie Logging en Verantwoording;
- De analyse: het gebruik per gereedschap over een langere periode. Daarmee wordt zichtbaar welke vragen daadwerkelijk worden gesteld;
- Een verkenner per connector: elk gereedschap is er met de hand aan te roepen, met de parameters ingevuld in een formulier. Dit is de manier om te controleren wat een gereedschap werkelijk teruggeeft, los van wat een assistent ervan maakt;
- De configuratiepagina: welke bronnen zijn aangeboden en of er een terugval is toegepast, zie Connectorregister;
- De antwoordcache: wat er per bronplatform is gebufferd, hoeveel het is, hoe oud het is en door welke uitgave van BesluitBron het is geschreven. Zie Buffering en Doorlooptijd;
- De foutenpagina: de meldingen met hun code;
- De tracepagina: elke gebeurtenis die de server schrijft, van het opstarten tot elke aanroep naar een bronplatform en elke fout met haar stapel. Te lezen op het scherm en te downloaden als bestand, zodat een storing aan een ander is over te dragen. Zie Logging en Verantwoording.
Waarvoor de verkenner bedoeld is
Voor het beantwoorden van de vraag "klopt dit antwoord". Wie een uitkomst van een assistent wil natrekken, roept hetzelfde gereedschap met dezelfde parameters aan in de verkenner. Het ruwe antwoord van het bronplatform verschijnt dan op het scherm, inclusief de precisievelden uit Zoekprecisie.
Wanneer de antwoordcache wordt geleegd
Zelden. Een gebufferd antwoord verloopt vanzelf, en een antwoord van een vorige uitgave wordt vanzelf weggegooid, zoals beschreven in Buffering en Doorlooptijd. Legen is bedoeld voor het geval dat daarbuiten valt. Dat doet zich in twee situaties voor: een bronhouder heeft gegevens gecorrigeerd en die correctie moet nu zichtbaar zijn, of er wordt onderzocht of een afwijkend antwoord uit de buffer komt of van het platform zelf.
Legen kan voor de hele buffer, voor één bronplatform, voor alles wat voor een bepaalde datum is opgeslagen, en voor wat toch al verlopen of van een andere uitgave was. De laatste twee zijn opruimen zonder gevolg. De eerste twee kosten tijd. Elk antwoord dat is weggegooid, wordt bij de volgende vraag opnieuw bij het bronplatform opgehaald. Dat telt mee in de verzoeklimieten uit Buffering en Doorlooptijd.
De cijfers op het scherm worden gemeten op het moment dat de pagina wordt getoond, en niet onthouden. Zij worden namelijk gelezen door iemand die op dat moment besluit iets te verwijderen.
Fouten opruimen
Het scherm "Fouten" toont wat er is misgegaan. Per melding staan erbij: het opgevraagde adres, het IP-adres waar het verzoek vandaan kwam, het browserkenmerk en, bij een aangemelde sessie, de gebruikersnaam. Die tabel wordt vanaf 1.3.0 opgeruimd met de knop "Nu verwijderen". Die knop verwijdert alles dat ouder is dan het aantal dagen ernaast; standaard staat er negentig.
Vanaf 1.3.10 ruimt de dienst die tabel ook zelf op, elke dag, na negentig dagen. De knop blijft daarnaast bestaan, voor wie een bepaalde periode eerder wil verwijderen. Tot 1.3.9 gebeurde dit alleen met de hand: een foutregel is het enige spoor van een storing waar nog niemand naar heeft gekeken, en een klok verwijdert die op het moment dat zij interessant wordt. Die afweging is met 1.3.10 omgedraaid, omdat een foutregel een adres, een browserkenmerk en soms een gebruikersnaam bevat, en een termijn die aan de bezoeker wordt beloofd door de machine moet worden nagekomen en niet door een gewoonte. Negentig dagen is genoeg om een terugkerende storing te herkennen.
Nul dagen wordt geweigerd, want dat zou alles verwijderen. Het aantal verwijderde regels verschijnt op het scherm en wordt vastgelegd in het tracebestand. Dat bestand is daarmee het enige bewijs dat het is gebeurd.
Meting en toestemmingsvraag
Vanaf 1.2.17 draagt de console dezelfde bezoekersmeting en dezelfde toestemmingsvraag als de publieke pagina's. Tot die uitgave droeg zij geen van beide. Wie de vraag beantwoordt op besluitbron.nl, krijgt haar in de console niet opnieuw. Wie meting weigert, wordt ook in de console niet gemeten.
Gemeten wordt welke schermen worden geopend. Tot 1.2.24 kon de installatie daarnaast sessieopnamen laten maken, waarbij de schermen van de beheerder werden vastgelegd zoals die van elke andere bezoeker. Die mogelijkheid is vervallen, samen met de instelling waarmee zij werd aangezet. Wat een installatie meet, wordt sindsdien alleen bepaald door wat er in de tagcontainer staat, en de toestemmingsvraag gaat daarover. De meting is uit te zetten door de sleutel onder BesluitBron:Analytics leeg te laten. Zonder die sleutel laadt de installatie geen meting en verschijnt er ook geen toestemmingsvraag.
Vanaf 1.3.74 meet de console, net als de publieke schermen, ook drie soorten gebeurtenissen: het uitvoeren van een query, een onverwachte fout in de JavaScript van de pagina, en of een bezoek dertig minuten duurt of zich over minstens tien dagen spreidt. Geen van de drie bevat de inhoud van een query of van een foutmelding. De volledige beschrijving staat op de pagina "Privacy en cookies", waarnaar de volgende alinea verwijst.
Wat wel en niet wordt vastgelegd, met wie het wordt gedeeld en hoe lang het blijft staan, staat vanaf 1.2.24 op de openbare pagina "Privacy en cookies". Die is bereikbaar via /nl/privacy en vanuit de voettekst van elk scherm, ook dat van de console.
Een testbericht versturen
Het scherm Instellingen is verder alleen om te lezen, maar draagt een knop: "Testbericht versturen". Die stuurt een bericht rechtstreeks naar de mailgateway, buiten de gewone wachtrij om, naar het adres dat de beheerder intypt. Het resultaat verschijnt meteen na het indrukken; er hoeft niet te worden ververst.
Drie afzonderlijke vaststellingen komen terug, in deze volgorde: of de server bereikbaar is, of de inloggegevens worden geaccepteerd, en of het bericht is aangenomen voor bezorging. Een mislukte test noemt daarnaast de melding van de gateway zelf, zodat duidelijk is welke van de instellingen fout staat. Of het bericht daarna ook echt in de inbox van de ontvanger belandt, en niet in een ongewenstmap, meldt het scherm niet: dat is een zaak tussen de gateway en de ontvanger.
Server, poort, gebruikersnaam, wachtwoord en het gebruik van STARTTLS staan bij het openen van het scherm vooringevuld met de ingestelde waarden, en elk daarvan is voor die ene test te wijzigen, bijvoorbeeld om een kandidaat-instelling te proberen voordat zij in het instellingenbestand wordt overgenomen. Het wachtwoordveld is de uitzondering: dat toont nooit het ingestelde wachtwoord, dus een leeg wachtwoordveld test met dat ingestelde wachtwoord en niet met een leeg wachtwoord.
Het testbericht draagt een bijlage met het tijdstip, de toepassing en haar versie, de machinenaam en de gebruikte mailgateway, zodat een ontvanger die de mailbox controleert iets concreets aantreft.
Beperkingen
- De console toont geen gesprekken met de assistent. Die inhoud bereikt de dienst niet, zie Openbaarheid en Persoonsgegevens;
- De taal van de console volgt de sessie en niet het adres. Na aanmelden dragen de adressen geen taalcode meer;
- De console volgt de lichte of donkere weergave van het besturingssysteem.