CapordiaBeschrijf de impact voordat je een oorzaak aandraagt
Geef een waarneembare zin: sommige taken leveren geen uitvoer meer op, een geautoriseerde toegang wordt geweigerd of een export kan niet meer worden gelezen. Geef de getroffen scope aan en wat blijft werken. "De server ligt eruit" wordt al snel een te ruime conclusie wanneer alleen één uitvoerpad faalt. Tel de geaccepteerde, onvolledige en niet-gestarte resultaten met elkaar uitsluitende categorieën.
Wijs een coördinatieverantwoordelijke aan en iemand die bevoegd is om in te grijpen. De incidentmanagementgids van Google SRE maakt onderscheid tussen coördinatie, uitvoering en communicatie. In een klein team kan één persoon meerdere rollen vervullen, maar iedereen moet weten wie beslist. Leg het volgende interne informatiemoment vast; deze organisatie creëert geen gegarandeerde reactietijd van de leverancier.
Houd een chronologie bij die feiten onderscheidt
Noteer de laatste bekende correcte situatie, het eerste symptoom en de wijzigingen daartussen. Geef de tijdzone en de herkomst van elke tijd: logboek, directe observatie of te bevestigen herinnering. Een datum die in een screenshot is gekopieerd, heeft niet noodzakelijk hetzelfde referentiekader als het logboek van de applicatie. Als een grens ontbreekt, houd dan het onzekerheidsinterval aan in plaats van een precieze minuut te verzinnen.
Noteer bij elke actie de auteur, het bereik, het doel en het resultaat. 'Herstart uitgevoerd' is onvolledig zonder te weten welk proces het betrof en of het symptoom veranderd is. Houd observatie, hypothese en beslissing gescheiden. Die scheiding maakt het mogelijk te reconstrueren wat daadwerkelijk heeft geholpen en voorkomt dat meerdere mensen tegelijk incompatibele oplossingen proberen.
Fictief voorbeeld: een gedeeltelijke export, geen bewezen GPU-storing
In de fictieve cel 'Cartes du rivage' moeten twintig documenten worden geleverd. Veertien uitvoeritems zijn geopend en geaccepteerd, vier taken melden een schrijfweigering en twee moeten nog worden gestart. Zes resultaten zijn dus nog niet leverbaar, maar het zou onjuist zijn om te melden dat twintig resultaten verloren zijn. Er wordt geen enkel echt incident en geen enkele Capordia-server in dit voorbeeld beschreven.
De onderstaande tijdlijn leidt tot het vragen om een gericht onderzoek van het uitvoerpad. Ze toont de oorzaak nog niet aan: de wijziging kort daarvoor kan verband houden met het symptoom zonder het te verklaren. Het team behoudt de veertien geaccepteerde uitvoeritems en pauzeert alleen de betrokken nieuwe inzendingen. De tijden zijn fictief en behoren tot dezelfde tijdzone, gekozen om elke leesambiguïteit te vermijden.
| Tijd | Vastgelegd feit | Toegestane interpretatie |
|---|---|---|
| 9:40 | Laatste uitvoeritem dat met succes is geopend | Bekend werkingspunt |
| 9:42 | Uitvoerbestemming gewijzigd | Te onderzoeken wijziging |
| 9:43 | Eerste vastgelegde schrijfweigering | Waargenomen begin van het symptoom |
| 9:48 | Betrokken nieuwe inzendingen gepauzeerd | Maatregel om de impact te beperken |
| 10:05 | Dezelfde weigering met een klein fictief bestand | Kleinere reproductie, oorzaak nog te bevestigen |
De reproductie verkleinen zonder het defect te wissen
Zoek de kleinste invoer die het symptoom en hetzelfde relevante pad behoudt: bestandstype, bestemming, technische identiteit of instelling. Vervang de bedrijfsinhoud waar mogelijk door synthetische gegevens. Als de fout door de vervanging verdwijnt, documenteer dan deze beperking. Presenteer een vereenvoudigd commando dat niet meer door het verdachte deel loopt niet als een getrouwe reproductie.
Werk met verifieerbare hypothesen. Het hoofdstuk over foutopsporing van Google SRE adviseert tests waarmee oorzaken kunnen worden onderscheiden en herinnert eraan dat instrumentatie of proeven het systeem kunnen beïnvloeden. Noteer een negatief resultaat dus even zorgvuldig als een succes. Vermijd het in een lus herstarten van een verwerking die uitvoeritems publiceert of de opslag verergert; de verantwoordelijke bepaalt eerst het toegestane bereik van de test.
Leesbare en geanonimiseerde bewijzen voorbereiden
Het overdrachtsdossier bevat de nuttige versies, de minimale procedure, de tijden, de exacte foutmelding en een logfragment rond het symptoom. Voeg de taakidentificatie en de referentie van het betrokken dossier toe wanneer dat het koppelen vergemakkelijkt. Laat de rest van de logboeken weg als niemand die nodig heeft om de situatie te begrijpen. Bewaar de originelen binnen het toegestane bereik van het team.
OWASP herinnert eraan dat logboeken onder meer geen wachtwoorden, toegangstokens of sleutels mogen blootstellen. Controleer ook paden, bestandsnamen en argumenten die het project kunnen onthullen. Gebruik consistente vervangingen, zoals PROJET_A, terwijl je de structuur behoudt die nodig is voor de diagnose. Een geanonimiseerd bewijs moet melden wat is verwijderd; het mag de beslissende foutmelding niet wijzigen en geen belangrijke voorwaarde laten verdwijnen.
Een escalatieverzoek formuleren waarmee kan worden gehandeld
Open het verzoek met de impact en de precieze vraag: een toegangsweigering onderzoeken, een eigenschap van de allocatie bevestigen of helpen een reproduceerbare afwijking te lokaliseren. Voeg de tijdlijn en de geanonimiseerde reproductie toe. Geef aan welke acties al zijn geprobeerd, welke niets hebben veranderd en welke handelingen moeten worden vermeden. De ontvanger moet kunnen weten wat er wordt verwacht zonder een dossier met niet-toegelichte schermafbeeldingen te doorzoeken.
In het voorbeeld kan het verzoek luiden: 'Het nieuw gebruikte uitvoerpad weigert te schrijven onder de identiteit van de verwerking; gelieve de rechten op dit pad te onderzoeken. Veertien uitvoeritems blijven gevalideerd; vier taken meldden een schrijfweigering, en deze weigering is gereproduceerd met een fictieve invoer.' Deze tekst beschuldigt de GPU noch een operator. Hij zet uiteen wat bekend is en laat de oorzaak open tot het onderzoek.
De terugkoppeling controleren voordat je afsluit
Een fout die zich niet meer voordoet, is niet altijd voldoende. Controleer een volledig resultaat met dezelfde identiteit, dezelfde beslissende omstandigheden en een nagelopen bestemming. Controleer daarna de geraakte onderdelen: blijven de al geaccepteerde uitvoer behouden, zijn de gedeeltelijke uitvoer geïsoleerd en de resterende taken correct geïdentificeerd? De verantwoordelijke voor de resultaten moet de nuttige hervatting bevestigen, los van het slagen van een technische opdracht.
Een migratie is een georganiseerde wijziging vóór het verplaatsen van werk; het incident begint met een onverwachte afwijking. Als de oplossing vereist dat gegevens worden verplaatst of een onderbroken verwerking wordt hervat, gebruik dan het bestaande migratiedossier voor die operatie. De incidentchronologie bewaart de reden voor die beslissing; ze herschrijft niet de omschakelmethode of het batchregister.
Een bruikbare conclusie bewaren, ook als de oorzaak open blijft
Sluit af met de uiteindelijke impact, het verificatieresultaat, de aangetoonde of nog onbekende oorzaak en de genomen besluiten. Een omweg kan een resultaat herstellen zonder het onderliggende probleem op te lossen: zeg dat duidelijk en benoem de verantwoordelijke voor de opvolging. Een gebrek aan bewijs mag geen 'geen incident' worden; een gelijkenis met een oude zaak mag geen zekere oorzaak worden.
De eindcontrole moet een ander persoon in staat stellen te onderscheiden wat is waargenomen, wat is geprobeerd en wat nog moet worden geverifieerd. Ze dient om een procedure, een controle of een foutmelding te verbeteren, niet om een verhaal zonder onzekerheid te maken. Geen enkel aantal screenshots, logvolume of urgentieniveau vervangt deze kwaliteit van overdracht.
Vragen om te beslissen
Moet je wachten tot je de oorzaak kent om een incident te melden?
Nee. Meld een verifieerbare impact en het bekende bereik, en scheid de hypothesen duidelijk. Een chronologie en een gerichte reproductie helpen vaak al voordat de oorzaak is aangetoond. Vermeld ook de maatregelen die al zijn genomen om de impact te beperken.
Mag ik al mijn logs sturen om tijd te besparen?
Bereid eerst de nuttige fragmenten voor en loop ze na. Volledige logs kunnen geheimen en projectgegevens bevatten zonder de diagnose te helpen. Bewaar de originelen in een toegestane ruimte en leg de vervangingen in de verzonden versie uit.
Wanneer beschouw je het dossier als afgesloten?
Na een controle van het verwachte resultaat en een uitdrukkelijk besluit van de verantwoordelijke. Onderscheid bevestigde reparatie en tijdelijke omweg. De afsluiting kan een onbekende oorzaak behouden, op voorwaarde dat de beperkingen, de uitgevoerde controle en de nog openstaande acties worden benoemd.