Wat de Radar meet

De Radar is de app van binnenuit gezien, terwijl zij wordt gebruikt. Het is geen rapport dat u aan het einde van de maand draait: het is wat de applicatie nu aan het doen is — welke API's zijn aangeroepen, hoe lang die duurden, welke schermen klapten, welke mensen binnenkwamen en wat zij deden tot aan het punt waar er iets misging.

Zij bestaat op twee plekken, en het verschil ertussen is alleen een kwestie van hoogte:

Waar	Wat die beantwoordt
De minitab Radar, binnen een app	"Wat gebeurt er in deze app?"
Het menu Observability, in de zijbalk	"Wat gebeurt er in alle apps, en op het platform?"

#De minitab Radar

Open een app in de zijbalk en klik op Radar, de vierde van de minitabs in de balk van de app (na UI, Code en Gegevens). De balk toont voortaan de boomstructuur van de Radar; de ruimte rechts toont het paneel van wat u kiest.

Boven aan de boom staan twee bedieningselementen die gelden voor alles wat eronder staat:

• De keuzelijst met de periode — Laatste uur, Laatste 24 uur, Laatste 7 dagen of Alles. Zij bepaalt wat de boom telt.
• De knop Vernieuwen, die opnieuw leest zonder de periode te wijzigen.

Daaronder beperkt het vak Filteren… de boom tot wat overeenkomt met wat u typt.

#De drie secties van de boom

#Schermen

De fouten die zijn ontstaan in de code die u zelf hebt geschreven in de gebeurtenissen van de schermen en de widgets. Het is de sectie waar er aan uw kant iets te verhelpen valt, en daarom komt zij als eerste.

Elke regel is een scherm; open het en u ziet de fouten ervan, gegroepeerd op oorzaak, met het aantal keren dat ze zijn opgetreden. Zonder enige fout zegt de sectie "Geen enkele fout in de code die u hebt geschreven."

De ⓘ naast de titel herhaalt het criterium: "Fouten die zijn ontstaan in de code die u in de gebeurtenissen van de widgets en de schermen hebt geschreven. Deze kunt u zelf verhelpen."

#API's en scripts

De aanroepen van de API's van de app en de uitvoeringen van de scripts, met de mislukkingen gegroepeerd op oorzaak. Elke regel bevat de naam en een samenvatting — hoeveel aanroepen, en de gemiddelde tijd. Een rood getal aan het einde van de regel zijn mislukkingen.

Klik op een regel om het paneel ervan te openen (dat is het onderwerp van de volgende pagina van dit hoofdstuk).

#Sessies

Elk bezoek aan de app: wie binnenkwam, wanneer, en wat er misging. De regels zijn de sessies, aangeduid met het tijdstip en met wie binnenkwam — 23:11 · demo —, of alleen met het tijdstip wanneer het bezoek anoniem was.

Het is de tijdas van de Radar: de andere secties vertellen wat, de sessies vertellen in welke volgorde.

#Van het platform

Er bestaat een vierde sectie, die alleen verschijnt wanneer er iets te tonen is: Van het platform. Dat zijn interne fouten van de runtime — "die komen niet uit uw code", zegt de hulp. Zij verschijnen ingeklapt, onderaan, omdat er aan uw kant niets te verhelpen valt; het is de moeite waard ze te melden met de Referentie die het paneel toont.

#De Observability: alle apps tegelijk

Klik op Observability in de linkerzijbalk, in de beheerzone. Het is dezelfde stof van bovenaf gezien, met een balk met secties onder de kop: Overzicht, Problemen, Gebeurtenissen, Status en Audit.

Bovenaan staat een keuzelijst met de periode die voor alle secties geldt — 1u, 6u, 24u, 7d, 30d en Alles — plus Exporteren (in CSV of JSON) en Vernieuwen.

Het Overzicht opent met vijf getallen:

Kaart	Wat die telt
Verzoeken	Hoeveel aanroepen er in de periode waren, en het tempo per minuut.
Foutpercentage	Het percentage mislukte aanroepen, en hoeveel mislukkingen dat waren.
Antwoordtijd (p95)	De tijd waaronder 95% van de aanroepen bleef, met de mediaan ernaast.
Open problemen	Gegroepeerde fouten die nog niemand heeft opgelost.
Scripts	Uitvoeringen van scripts, en hoeveel er mislukt zijn.

Daaronder de grafiek Operationele activiteit en de tabel Apps — één regel per app, met verkeer, verzoeken, fouten, mediaan, p95, onopgeloste problemen en scripts. Klik op de naam van een app om alleen de gebeurtenissen van die app te zien.

#De andere secties van de Observability

Sectie	Wat daar staat
Problemen	Runtimefouten gegroepeerd: één probleem, met al zijn voorvallen. Elk heeft een status — open, opgelost, genegeerd.
Gebeurtenissen	Eén regel per uitvoering — API's, scripts en systeem —, inclusief die welke goed gingen.
Status	De gezondheid van de installatie: wachtrij van de index, planner, meldingen, bewaartermijn, vrije schijfruimte en de verbindingen met de databases van elke app.
Audit	De wijzigingen in beheer en configuratie: wie wat heeft aangemaakt, gewijzigd, verwijderd of uitgevoerd.

#Hoe lang de registraties bewaard blijven

De registraties groeien niet eeuwig door: elke app heeft in haar instellingen een rotatie van registraties, die zegt hoeveel dagen er van elk soort bewaard blijven. De sectie Status toont of de rotatie aanstaat en in hoeveel apps.

#Waarom zie ik niet…?

• …niets in de boom van de Radar? De periode. Zet de keuzelijst op Alles — een weinig gebruikte app heeft geen verkeer in het laatste uur.
• …de minitab Radar? U bent buiten een app. De Radar is per app; de globale versie is het menu Observability.
• …getallen in het Overzicht, ook al wordt de app gebruikt? De index van Observability kan in de Instellingen van het platform uit staan — in dat geval waarschuwt de sectie Status dat "de schermen oude gegevens tonen".
• …het menu Observability? Dat is een beheermenu. Met een developerprofiel verschijnt het niet.