Undersøke et problem

Å undersøke er å gå fra symptomet til årsaken uten å gjette underveis. Radar er tegnet for den ruten: du velger det som feilet, ser hver kjøring én for én, og følger bakover til trinnet som utløste den.

Denne siden går den veien i fire etapper — API-en, økten, problemet, og revisjonsoppføringen som forklarer hvorfor nå.

#En API som feiler

1. Åpne appen og gå til Radar.
2. I seksjonen API-er og skript, klikk på linjen til API-en — for eksempel oportunidades.
3. En fane med navnet dens åpnes, og øverst tre merker: det interne navnet, 116 kall og gjennomsnitt 4 ms. Når det finnes feil, vises også «N feil (X %)».

Tabellen har én linje per kall — aldri gruppert — med fem kolonner:

Kolonne	Hva den viser
Når	Øyeblikket for kallet.
Status	HTTP-statusen som ble returnert.
Operasjon	Operasjonen det ble bedt om, når kallet identifiserer den.
Resultat	ingen feil, eller feiltypen som røk.
Tid	Hvor lang tid det tok.

Linjen Filtrer… over tabellen reduserer listen etter hvilket som helst av disse feltene: bare feilene, bare dem over 500 ms, bare dagens. Sideinndelingen nederst sier hvor du er — 1–50 av 116.

#Detaljene til et kall

Klikk på en linje, og detaljpanelet åpnes nedenfor, med tre faner:

Fane	Hva den har
Generelt	Når, Tid, Status, Opphav, hvem som gjorde kallet og Trace-en som identifiserer det.
Sendt	Det kallet tok med seg. Ved tvil om typer viser den, felt for felt, det som ble Sendt og den Forventede typen, med den mistenkte i rødt.
Svar	Det som kom tilbake. Et kall som ikke returnerte noe, sier «Ingenting kom tilbake.»; ett som ikke tok med seg noe, sier «Dette kallet tok ikke med seg noe.»

Skriptene har et tvillingpanel: én linje per kjøring, med Avslutningskoden, Opphavet til utløsningen og Konsollen — utdataene skriptet skrev. Et skript uten kjøringer i perioden sier «Ingen registrerte kjøringer.»

#Tidslinjen til en økt

Et enkeltstående kall forklarer sjelden en feil. Det neste spørsmålet er alltid «hva holdt personen på med?» — og det er det øktene er til.

1. I Radar, utvid seksjonen Økter.
2. Klikk på besøket du er interessert i — 23:11 · demo.
3. Panelet åpner med hvem som kom inn, når, og et sammendrag: 15 trinn på 5 sider.

Tabellen er tidslinjen til besøket, ett trinn per linje:

Kolonne	Hva den viser
Navn	Trinnet: en side, en skjerm, en hendelse, et kall til en API, en lesing av data.
Status	Om det gikk bra eller dårlig.
Opphav	Hvor trinnet kom fra — Sider, Skjermer, Handlinger, Data.
Tid	Hvor lang tid det tok.
Fossefall	Stolpen som viser når det skjedde i økten og hvor mye det tok.

Fossefallet er det som gjør lesingen umiddelbar: stolpene stiller seg opp i tid, og et trinn som tok lang tid, ses uten å lese et eneste tall. Klikk på en linje for detaljene — med Side, Når, Tid og Siden økten startet (+0.0s, +2.4s, …). Et trinn som ikke kalte serveren, sier det: «Dette trinnet kalte ikke serveren.»

#En kodefeil

Feilene som oppsto i koden til hendelsene, vises i seksjonen Skjermer, gruppert etter årsak: ett problem per distinkt feil, med antallet forekomster ved siden av.

Klikk på ett for å åpne panelet til problemet, som samler alt man vet om det:

Sone	Hva den svarer på
Kode	Utdraget av koden din, med den skyldige linjen framhevet, og den nøyaktige Posisjonen.
Veien hit	Hva personen gjorde før det røk — side, skjerm, lesinger av data, det siste klikket.
Sporet etter feilen	Det tekniske sporet, når det ble lagret.
Flyt	Ruten feilen tok gjennom delene av appen.
Åpne i designeren	Tar deg rett til hendelsen der feilen oppsto.

Knappen Åpne i designeren er den naturlige slutten på undersøkelsen: du fant linjen, nå skal du rette den.

En feil plattformen klassifiserte som Fra plattformen, viser noe annet: «Denne feilen oppsto i Keplin-runtime, ikke i koden til appen din. Det er ingenting å rette på din side — det er verdt å rapportere den.» — med en Referanse å kopiere.

#Problemene, i alle appene

Menyen Observerbarhet → Problemer er det samme stoffet, samlet og med status. Hver linje er et gruppert problem, med Forekomster, Berørte brukere, Først sett og Sist sett.

En frisk installasjon har denne siden tom — «Ingen problemer svarer til filtrene», med Tøm filtrene for å utvide søket. Før du konkluderer med at det ikke finnes problemer, sjekk perioden øverst: med 1h valgt vises ikke en feil fra i går.

Hvert problem har tre statuser, og de endres i selve panelet:

Handling	Hva den gjør
Løs	Merker det som håndtert — «Problemet er merket som løst.» Skjer det igjen, gjenåpner det seg selv.
Ignorer	Tar det ut av veien uten å løse det — «Problemet er ignorert.» For støyen man kjenner.
Gjenåpne	Setter det tilbake til åpent — «Problemet er gjenåpnet.»

Inne i et problem tegner Problemkjeden ruten: konteksten i nettleseren, de korrelerte kjøringene, feilen og den observerte virkningen. Når det ikke finnes noen måte å knytte delene sammen på, sier den det i stedet for å dikte — «De stiplede koblingene viser bare bekreftet kontekst, ikke en utledet årsakssammenheng.»

#Hendelsene, én og én

Observerbarhet → Hendelser er den rå listen: én linje per kjøring av API, skript eller system, inkludert dem som gikk bra.

Kolonner: Når, Type, App, Hva, Varighet og Utfall. Filtrene øverst kutter etter App, Type, Status, Alvorlighetsgrad og periode; Tøm filtrene setter alt tilbake.

Klikk på en linje, og detaljene åpner ved siden av, med Sammendrag og Data — og Åpne hele siden når du trenger mer plass. Feilmeldingene vises på originalspråket til serveren, med vilje: å oversette dem ville fjernet dem fra teksten man søker etter i dokumentasjonen.

#Og hvorfor nå? Revisjonen

En feil som begynte i dag, har nesten alltid en endring bak seg. Observerbarhet → Revisjon tar vare på de administrative endringene og konfigurasjonsendringene — opprette, endre, slette, utføre, importere, eksportere, tilbakekalle, tilbakestille passord, endre rolle — med hvem som gjorde dem, i hvilken app og når.

Klikk på en linje, og detaljene viser Før og Etter for endringen. Det er det direkte svaret på spørsmålet som lukker de fleste undersøkelser: «hva var det som ble endret i går ettermiddag?»

#Veien, oppsummert

1. Oversikt — hvilken app som brenner.
2. Radar i appen — hvilken API, hvilket skript eller hvilken skjerm.
3. Panelet til den — hvilket kall, med hvilke data, i hvilket øyeblikk.
4. Økten — hva personen gjorde før.
5. Problemet — kodelinjen og knappen Åpne i designeren.
6. Revisjonen — hva som ble endret for at dette skulle begynne.

#Hvorfor ser jeg ikke …?

• …detaljene til et kall? Ingen linje er valgt. Tabellen sier «Velg en rad for å se detaljene.»
• …forekomstene av et gammelt problem? De kan ha blitt tatt av rotasjonen av oppføringer — panelet sier fra når det skjer.
• …Veien hit utfylt? Ikke alle forekomster har med seg ruten; når de ikke har det, sier panelet «Ingen vei er registrert for denne forekomsten.» i stedet for å vise oppdiktede trinn.
• …knappen Åpne i designeren? Den vises bare på feil med opphav i koden til appen. Feilene fra plattformen har ingenting å åpne.