Sentry

Sentry is een dienst die bijhoudt tegen welke fouten mensen aanlopen op je website of app: wat er misging, hoe vaak, en bij hoeveel mensen. De Sentry-koppeling van Taskstand laat die fouten (Sentry noemt ze issues) zien in het project waarin je het werk doet, naast de taken en commits, en maakt er met een klik een taak van. Voltooi je die taak, dan lost Taskstand het issue in Sentry voor je op.

Wat de koppeling doet#

• Laat je Sentry-issues zien in Taskstand, op de pagina Code van het project waar ze bij horen.
• Maakt een taak van een issue, of koppelt het aan een taak die al bestaat.
• Houdt Sentry bij. Je kunt een issue vanuit Taskstand oplossen, negeren of heropenen, en een voltooide taak lost de open issues op die eraan hangen.
• Zet werk weer open als een fout terugkomt. Komt een opgelost issue terug, dan gaan de voltooide taken ervan in Taskstand weer open.
• Laat zien wat nieuw is, met een rood getal op de knop Code, naast het project in de zijbalk (op de map zolang die dichtgeklapt is) en op het dashboard. Het getal telt de open issues waar je nog niets mee deed (zie De pagina Code hieronder), en klik je erop op het dashboard, dan kom je daar. Taken die je nog niet las krijgen ernaast een eigen blauw getal, zie Taken. Nieuwe issues laten ook de aandachtsmeter op het dashboard oplopen, iets minder dan een taak die te laat is.

Sentry laat Taskstand meteen weten wanneer een issue verschijnt of van status verandert. De aantallen (gebeurtenissen, gebruikers, laatst gezien) worden opnieuw gelezen als iemand de pagina Code opent en de vorige keer langer dan tien minuten geleden is, en daarnaast eens per dag voor elk gekoppeld project.

Wat je nodig hebt#

Wat	Nodig
Sentry	Een organisatie op sentry.io, de online dienst van Sentry. Een Sentry die je zelf host kun je niet koppelen.
Rechten in Sentry	Wie de koppeling installeert, moet in de Sentry-organisatie integraties mogen installeren. In Sentry is dat meestal de rol Owner of Manager.
Abonnement in Taskstand	Het abonnement van de eigenaar van het project moet Sentry bevatten: Plus, Pro of Business, en de gratis proefperiode. Zie Abonnementen en limieten.
Rol in Taskstand	Alleen de Eigenaar van een project installeert de koppeling en koppelt er Sentry-projecten aan.

Wie de issues in Taskstand ziet:

Rol in het project	Ziet Sentry-issues	Kan ze aanpassen
Eigenaar	Ja	Ja
Manager	Ja	Ja
Teamlid	Ja	Ja
Klant, Meelezer, Beperkt	Nee	Nee

De installatie hoort bij het Taskstand-account dat hem heeft geïnstalleerd. Alleen die persoon koppelt de projecten van die Sentry-organisatie, en alleen aan projecten waarvan die eigenaar is. Heeft een ander Taskstand-account dezelfde Sentry-organisatie al gekoppeld, vraag diegene dan het project te koppelen, of verwijder de app in Sentry en installeer hem opnieuw.

De koppeling installeren#

Begin de installatie altijd in Taskstand. Een installatie die in de lijst met integraties van Sentry zelf begint, kan Taskstand niet aan je account koppelen en wordt geweigerd.

1. Open het project en klik op het tandwiel (Projectinstellingen), en daarna op Code.
2. Klik in het blok Fouten uit Sentry op Koppel Sentry. Sentry gaat open.
3. Log zo nodig in bij Sentry, kies de organisatie, bekijk de rechten en keur de installatie goed.
4. Sentry stuurt je terug naar de instellingen onder Code van je project, waar Taskstand meldt: Sentry is gekoppeld. Kies het project om te koppelen.

Rond dit binnen een half uur af. Zie je Deze Sentry-koppeling is hier niet gestart, dan is de link verlopen, al gebruikt, of in Sentry zelf begonnen: begin opnieuw met Koppel Sentry. Staat de app in Sentry inmiddels als geïnstalleerd, verwijder hem daar dan eerst.

Wil je een tweede Sentry-organisatie koppelen, gebruik dan Koppel die achter Nog een Sentry-organisatie? in hetzelfde blok.

Een Sentry-project koppelen#

Een Sentry-project is de plek in Sentry waar de fouten van één website of app binnenkomen. Na de installatie kies je welk project bij dit Taskstand-project hoort.

1. Klik in Projectinstellingen, Code op Kies een Sentry-project.
2. Heb je meer dan één organisatie gekoppeld, kies die dan bij Sentry-organisatie.
3. Kies het project bij Welk Sentry-project? en klik op Koppelen.
4. Taskstand meldt De issues komen eraan. De open issues van de afgelopen 90 dagen staan er binnen enkele ogenblikken.

Goed om te weten:

• Aan een Taskstand-project kun je tot vijf Sentry-projecten koppelen. Met Nog een Sentry-project koppelen voeg je er een toe.
• Eén Sentry-project kan aan meerdere Taskstand-projecten hangen, bijvoorbeeld als één app voor meer dan één klantproject werkt.
• Bij elk gekoppeld Sentry-project zie je de naam, de organisatie en wanneer het voor het laatst is gelezen. Het ronde pijltje (Lees dit project opnieuw) leest het meteen opnieuw.
• Werkt een koppeling niet meer, dan staat dat in de instellingen met de reden erbij, en krijgt Code in de projectinstellingen een rode stip.

Sentry-issues gebruiken in Taskstand#

De pagina Code#

Zodra er een Sentry-project gekoppeld is, staat er in de projectbalk een knop Code. Die opent een pagina met de issues (Sentry-issues) en, als er ook een GitHub-repository gekoppeld is, de commits. Op een kleiner scherm wissel je met Commits en Sentry-issues tussen de twee.

Bij elk issue zie je de titel, de plek in de code, het Sentry-id (een link die het issue in Sentry opent), het aantal gebeurtenissen en gebruikers, wanneer het voor het laatst is gezien, en de taken waaraan het hangt. Een gekleurde stip geeft het niveau aan. Een open issue waar je nog niets mee deed, heeft het label Nieuw en telt mee in het rode getal op de knop Code, in de zijbalk en op het dashboard. Het blijft nieuw tot je er iets mee doet:

• Markeer als gezien in het menu naast het issue haalt het voor jou uit nieuw. Je collega's zien het nog wel als nieuw.
• Alles als gezien markeren boven de lijst doet dat in één keer voor alle open issues van het project.
• Een taak maken van het issue, of het aan een taak hangen, haalt het voor iedereen in het project uit nieuw, want dan staat het op iemands lijst.

Komt een issue terug nadat het was opgelost of genegeerd, dan is het weer nieuw, voor iedereen.

Beperk de lijst met:

• het zoekveld Zoek in de fout of het id
• de status: Open (standaard), Opgelost, Genegeerd of Alle issues
• het niveau: Alle niveaus, Fataal, Fout, Waarschuwing, Info of Debug
• het Sentry-project, als er meer dan één gekoppeld is

Het ronde pijltje naast Laatst gelezen (Lees de issues opnieuw) haalt de nieuwste aantallen uit Sentry terwijl je wacht.

Een taak maken van een issue#

1. Klik op de knop + bij het issue (Maak hier een taak van).
2. Het formulier Maak een taak van dit issue is ingevuld met de titel van de fout, en een beschrijving met een link naar het issue, de hele foutmelding, het bestand en de functie waarin het misging, en hoe vaak en bij hoeveel gebruikers het gebeurde.
3. Lees het en pas aan wat je wilt. Een foutmelding kan tekst bevatten die iemand op je site heeft ingetypt, dus er wordt pas een taak van als iemand het heeft gelezen.
4. Kies de Sectie, zet er eventueel Labels op (klik op een label van het project, of typ een nieuw label en druk op Enter) en klik op Maak taak. Een nieuw label wordt pas gemaakt als je opslaat.

De taak hangt meteen aan het issue.

Een issue aan een bestaande taak koppelen#

Open de taak en zoek Sentry-issues in de details van de taak. Klik op Koppel een Sentry-issue, zoek op de fout of het id, en klik erop. Met het kruisje (Ontkoppel dit issue) haal je het er weer af. Je moet de taak wel mogen bewerken.

Een issue oplossen, negeren of heropenen#

Klik op de knop ... bij een issue:

• Oplossen zet het issue in Sentry op opgelost.
• Negeren archiveert het issue in Sentry tot het erger wordt, net als de knop Archive in Sentry zelf. Treft de fout ineens veel meer mensen, dan zet Sentry het issue vanzelf weer open.
• Heropenen staat bij een opgelost of genegeerd issue en zet het weer open.

Taskstand vraagt het eerst aan Sentry en laat daarna zien wat Sentry antwoordt, zodat de lijst nooit iets zegt wat Sentry niet heeft overgenomen. Dit menu is er niet in een gearchiveerd project.

Taak voltooid, issue opgelost#

Voltooi je een taak waaraan open Sentry-issues hangen, dan lost Taskstand die issues in Sentry op. De taak zegt dat vooraf: Voltooi je deze taak, dan worden de open issues in Sentry opgelost. Komt de fout terug, dan gaat de taak weer open.

• Hangt een issue ook aan een andere taak die nog open is, dan blijft het open tot die taak ook voltooid is.
• Heropen je de taak later, dan blijft het issue in Sentry opgelost.

Als een fout terugkomt#

Gaat een opgelost of genegeerd issue in Sentry weer open (de fout komt terug, wordt erger, of iemand heropent het), dan zet Taskstand de voltooide taken die eraan hangen weer open. In de geschiedenis van de taak staat dat Sentry hem heropende en welk issue terugkwam. Gearchiveerde taken en taken in een gearchiveerd project blijven zoals ze zijn.

Een taak aan een AI-agent geven#

Kopieer je een taak voor een AI-agent die code schrijft, dan gaan de Sentry-issues mee, en vraagt de prompt de agent om zelf niets in Sentry op te lossen: dat doet Taskstand zodra de taak voltooid is. Zie Een taak aan een AI-agent geven.

Wat Taskstand in Sentry verandert#

Taskstand schrijft alleen dit naar Sentry:

Wanneer	Wat er in Sentry verandert
Iemand kiest in Taskstand Oplossen, Negeren of Heropenen	De status van dat issue, plus een notitie bij het issue, zoals "Opgelost in Taskstand door Anna de Vries."
Iemand voltooit een taak waaraan open issues hangen	Die issues worden opgelost, met een notitie met de naam van die persoon, de code van de taak, de titel en de link
Direct na de installatie	Taskstand bevestigt aan Sentry dat de installatie is aangekomen

In de geschiedenis van het issue toont Sentry de app van Taskstand als degene die de status veranderde. De notitie zegt welke persoon het deed, in de taal van die persoon. Taskstand maakt geen issues aan, bewerkt, voegt samen of verwijdert ze niet, en verandert niets aan je projecten, teams, meldingen of instellingen in Sentry.

Rechten en gegevens#

De koppeling vraagt Sentry om Issue & Event: Read & Write, en krijgt berichten van Sentry over issues en over het verwijderen van de koppeling.

Wat Taskstand uit Sentry leest:

• de naam en regio van je organisatie, en de lijst met projecten, voor de projectkiezer
• per issue: de titel, de plek in de code, het niveau, de status, het Sentry-id, het aantal gebeurtenissen en gebruikers, wanneer het voor het eerst en voor het laatst is gezien, en de link in Sentry

Wat Taskstand niet bewaart: stacktraces, de gebeurtenissen zelf, breadcrumbs, of gegevens van de mensen die tegen een fout aanliepen. Het aantal gebruikers is alleen een getal.

Hoe Taskstand met de tekst van een issue omgaat:

• De tekst van een issue komt uit de software die je klanten gebruiken, en kan alles bevatten wat een bezoeker heeft ingetypt. Taskstand toont hem als gewone tekst en nooit als link of opmaak, behalve de link naar het issue in Sentry zelf.
• Een issue wordt pas een taak als een lid daarvoor kiest, na het formulier te hebben gelezen.
• Alleen de Eigenaar, Managers en Teamleden van het project zien de issues.
• De notities die Taskstand in Sentry plaatst, kunnen de naam van een taak en een link ernaar bevatten. Iedereen in je Sentry-organisatie kan ze lezen.

Bevat het abonnement van de eigenaar Sentry niet meer, dan blijven de koppelingen bestaan maar wordt er niets nieuws gelezen, zijn de issues niet meer te zien en verandert een voltooide taak niets meer in Sentry. De eigenaar kan nog wel loskoppelen.

De koppeling verwijderen#

In Sentry#

1. Open in Sentry de Settings van je organisatie en ga naar Integrations.
2. Open de integratie van Taskstand.
3. Klik op Uninstall en bevestig.

Sentry stuurt dan geen issues meer naar Taskstand, en Taskstand kan niets meer lezen of veranderen. In Taskstand staat bij de gekoppelde Sentry-projecten Uitgezet in de projectinstellingen, en de pagina Code meldt dat het project niet meer wordt bijgewerkt. De issues die al binnen waren en hun koppeling met taken blijven staan, zodat je de geschiedenis houdt. Installeer je de app opnieuw voor dezelfde organisatie met Koppel Sentry, dan gaan de koppelingen weer aan.

In Taskstand#

• Loskoppelen (het kruisje naast een gekoppeld Sentry-project in Projectinstellingen, Code) haalt één Sentry-project van dit project af. De issues ervan verdwijnen uit het project, en hun koppeling met taken ook. De taken zelf blijven staan.
• Ontkoppel naast Gekoppelde organisatie haalt de hele Sentry-organisatie van je account. De Sentry-projecten ervan worden van al je projecten losgemaakt, en hun issues gaan mee. De app blijft in Sentry geïnstalleerd tot je hem daar ook verwijdert.

Wil je alles weghalen, ontkoppel dan de organisatie in Taskstand en verwijder de app in Sentry.

Hulp#

Een vraag over de koppeling, of werkt iets niet zoals hier beschreven? Mail naar support@taskstand.app. Noem de naam van je Sentry-organisatie en het project, en wat je verwachtte dat er zou gebeuren.