Ongelman tutkiminen

Tutkiminen on kulkemista oireesta syyhyn arvaamatta matkalla. Radar on suunniteltu sitä reittiä varten: valitaan mikä epäonnistui, katsotaan jokainen suoritus yksi kerrallaan, ja seurataan taaksepäin siihen vaiheeseen asti, joka sen aiheutti.

Tämä sivu kulkee tuon matkan neljässä etapissa — API, istunto, ongelma, ja auditointimerkintä, joka selittää miksi juuri nyt.

#API, joka epäonnistuu

1. Avaa sovellus ja mene kohtaan Radar.
2. Napsauta osiossa API:t ja skriptit API:n riviä — esimerkiksi oportunidades.
3. Avautuu välilehti sen nimellä, ja ylälaidassa kolme merkkiä: sisäinen nimi, 116 kutsua ja keskiarvo 4 ms. Kun virheitä on, näkyy myös "N virhettä (X %)".

Taulukossa on yksi rivi per kutsu — ei koskaan ryhmiteltynä — ja viisi saraketta:

Sarake	Mitä se näyttää
Milloin	Kutsun hetki.
Tila	Palautettu HTTP-tila.
Operaatio	Pyydetty operaatio, kun kutsu kertoo sen.
Tulos	ei virhettä, tai räjähtäneen virheen tyyppi.
Aika	Kauanko kesti.

Palkki Suodata… taulukon yläpuolella supistaa listaa millä tahansa näistä kentistä: vain virheet, vain yli 500 ms kestäneet, vain tämän päivän. Sivutus alhaalla kertoo missä olet — 1–50 / 116.

#Yhden kutsun tiedot

Napsauta riviä, ja alle avautuu tietopaneeli kolmella välilehdellä:

Välilehti	Mitä se tuo
Yleistä	Milloin, Aika, Tila, Alkuperä, Kuka teki kutsun ja sen tunnistava Trace.
Lähetetty	Mitä kutsu vei mukanaan. Kun tyypeistä on epäilyksiä, se näyttää kenttä kentältä Lähetetyn ja Odotetun tyypin, epäilty punaisella.
Vastaus	Mitä palasi. Kutsu, joka ei palauttanut mitään, sanoo "Mitään ei palautunut."; kutsu, joka ei vienyt mitään, sanoo "Tämä kutsu ei vienyt mitään."

Skripteillä on kaksoispaneeli: yksi rivi per suoritus, Paluukoodin, laukaisun Alkuperän ja Konsolin — skriptin kirjoittaman tulosteen — kanssa. Skripti ilman suorituksia jaksolla sanoo "Ei kirjattuja suorituksia."

#Istunnon aikajana

Yksittäinen kutsu selittää virheen harvoin. Seuraava kysymys on aina "mitä henkilö oli tekemässä?" — ja juuri sitä varten istunnot ovat.

1. Laajenna kohdassa Radar osio Istunnot.
2. Napsauta käyntiä, joka sinua kiinnostaa — 23:11 · demo.
3. Paneeli avautuu tiedoilla kuka tuli, milloin, ja yhteenvedolla: 15 vaihetta 5 sivulla.

Taulukko on käynnin aikajana, yksi vaihe per rivi:

Sarake	Mitä se näyttää
Nimi	Vaihe: sivu, näyttö, tapahtuma, API-kutsu, datan luku.
Tila	Menikö hyvin vai huonosti.
Alkuperä	Mistä vaihe tuli — Sivut, Näytöt, Toiminnot, Data.
Aika	Kauanko kesti.
Vesiputous	Palkki, joka näyttää milloin se tapahtui istunnon sisällä ja paljonko se vei.

Vesiputous tekee lukemisesta välitöntä: palkit asettuvat aikaan, ja kauan kestänyt vaihe näkyy lukematta yhtäkään numeroa. Napsauta riviä nähdäksesi tiedot — Sivu, Milloin, Aika ja Istunnon alusta (+0.0s, +2.4s, …). Vaihe, joka ei kutsunut palvelinta, sanoo sen: "Tämä vaihe ei kutsunut palvelinta."

#Koodivirhe

Virheet, jotka syntyivät tapahtumien koodissa, näkyvät osiossa Näytöt, ryhmiteltyinä syyn mukaan: yksi ongelma per erillinen virhe, esiintymien määrä vieressä.

Napsauta yhtä avataksesi ongelman paneelin, joka kokoaa kaiken siitä tiedetyn:

Alue	Mihin se vastaa
Koodi	Ote sinun koodistasi, syyllinen rivi korostettuna, ja tarkka Sijainti.
Polku tänne	Mitä henkilö teki ennen räjähdystä — sivu, näyttö, datan luvut, viimeinen napsautus.
Virheen jälki	Tekninen jälki, kun se tallennettiin.
Kulku	Virheen matka sovelluksen palasten läpi.
Avaa designerissa	Vie sinut suoraan tapahtumaan, jossa virhe syntyi.

Painike Avaa designerissa on tutkimuksen luonteva loppu: löysit rivin, nyt menet korjaamaan sen.

Virhe, jonka alusta luokitteli tulevaksi Alustalta, näyttää muuta: "Tämä virhe syntyi Keplinin ajoympäristössä, ei sovelluksesi koodissa. Sinun puolellasi ei ole mitään korjattavaa — kannattaa ilmoittaa siitä." — kopioitavan Viitteen kanssa.

#Ongelmat, kaikissa sovelluksissa

Valikko Havainnointi → Ongelmat on sama aines, koottuna ja tiloineen. Jokainen rivi on ryhmitelty ongelma, jolla on Esiintymät, Kärsineet käyttäjät, Ensimmäinen havainto ja Viimeisin havainto.

Terveellä asennuksella tämä sivu on tyhjä — "Mikään ongelma ei vastaa suodattimia", ja Tyhjennä suodattimet laajentaa hakua. Ennen kuin päättelet, ettei ongelmia ole, tarkista ylälaidan ajanjakso: valinnalla 1 h eilinen virhe ei näy.

Jokaisella ongelmalla on kolme tilaa, ja niitä vaihdetaan itse paneelissa:

Toiminto	Mitä se tekee
Ratkaise	Merkitsee sen hoidetuksi — "Ongelma merkitty ratkaistuksi." Jos se tapahtuu uudelleen, se avautuu itsestään.
Ohita	Ottaa sen pois tieltä ratkaisematta — "Ongelma ohitettu." Kohinalle, joka tunnetaan.
Avaa uudelleen	Palauttaa sen avoimeksi — "Ongelma avattu uudelleen."

Ongelman sisällä Ongelmaketju piirtää matkan: kontekstin selaimessa, korreloidut suoritukset, virheen ja havaitun vaikutuksen. Kun palasia ei voi sitoa yhteen, se sanoo sen keksimisen sijaan — "Katkoviivat esittävät vain vahvistettua kontekstia, eivät pääteltyä syy-yhteyttä."

#Tapahtumat, yksi kerrallaan

Havainnointi → Tapahtumat on raaka lista: yksi rivi per API:n, skriptin tai järjestelmän suoritus, myös ne jotka menivät hyvin.

Sarakkeet: Milloin, Tyyppi, Sovellus, Mitä, Kesto ja Tulos. Ylälaidan suodattimet leikkaavat Sovelluksen, Tyypin, Tilan, Vakavuuden ja jakson mukaan; Tyhjennä suodattimet palauttaa kaiken.

Napsauta riviä, ja tiedot avautuvat viereen, Yhteenvedon ja Datan kanssa — ja Avaa koko sivu, kun tarvitset enemmän tilaa. Virheviestit näkyvät palvelimen alkuperäisellä kielellä, tarkoituksella: niiden kääntäminen veisi ne kauas tekstistä, jota dokumentaatiosta haetaan.

#Ja miksi juuri nyt? Auditointi

Tänään alkaneen virheen takana on lähes aina muutos. Havainnointi → Auditointi tallettaa hallinnolliset ja konfiguraatiomuutokset — luominen, muuttaminen, poistaminen, suorittaminen, tuonti, vienti, peruminen, salasanan nollaus, roolin muutos — sen kanssa kuka ne teki, missä sovelluksessa ja milloin.

Napsauta riviä, ja tiedot näyttävät muutoksen Ennen ja Jälkeen. Se on suora vastaus kysymykseen, joka päättää suurimman osan tutkimuksista: "mikä muuttui eilen iltapäivällä?"

#Matka, tiivistettynä

1. Yleiskatsaus — mikä sovellus palaa.
2. Sovelluksen Radar — mikä API, skripti tai näyttö.
3. Sen paneeli — mikä kutsu, millä datalla, minä hetkenä.
4. Istunto — mitä henkilö teki ennen.
5. Ongelma — koodirivi ja painike Avaa designerissa.
6. Auditointi — mikä muuttui, jotta tämä alkoi.

#Miksi en näe…?

• …kutsun tietoja? Yhtään riviä ei ole valittuna. Taulukko sanoo "Valitse rivi nähdäksesi tiedot."
• …vanhan ongelman esiintymiä? Merkintöjen kierrätys on voinut viedä ne — paneeli varoittaa, kun niin käy.
• …Polkua tänne täytettynä? Kaikki esiintymät eivät tuo matkaa mukanaan; kun eivät tuo, paneeli sanoo "Tälle esiintymälle ei ole kirjattua polkua." keksittyjen vaiheiden näyttämisen sijaan.
• …painiketta Avaa designerissa? Se näkyy vain virheissä, joiden alkuperä on sovelluksen koodissa. Alustan virheillä ei ole mitään avattavaa.