Ongelman tutkiminen
Oireesta syyhyn — API:n paneeli, istunnon aikajana, virheen ketju ja ongelmien tilat.
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
- Avaa sovellus ja mene kohtaan Radar.
- Napsauta osiossa API:t ja skriptit API:n riviä — esimerkiksi
oportunidades. - 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. |
Kutsu, jonka henkilö hylkäsi ennen vastausta (vaihtoi suodatinta, poistui näytöltä tai sulki ikkunan), näkyy tilalla Peruttu, harmaana. Alusta keskeyttää lukemisen sillä hetkellä, jotta tietokanta ei jää varatuksi, eikä kutsua lasketa virheeksi.
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.
Palvelimella epäonnistuva kutsu (tila 500 tai suurempi) päätyy myös kohtaan Ongelmat API:n ja virheilmoituksen mukaan ryhmiteltynä, ja sillä on oma tilansa. Julkaistussa sovelluksessa uusi ongelma varoittaa sovelluksesta huolehtivia (katso Sähköpostihälytykset); studiossa tehdyt kutsut jäävät esikatseluksi eivätkä varoita ketään.
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." |
Vinkki
Trace on lanka, joka sitoo kaiken yhteen. Sama viite näkyy Havainnoinnin tapahtumissa ja virheen tiedoissa — kopioi se, ja sinulla on pyynnön koko matka, silloinkin kun se kulki monen palasen läpi.
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.
- Laajenna kohdassa Radar osio Istunnot.
- Napsauta käyntiä, joka sinua kiinnostaa —
23:11 · demo. - 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."
Huomio
Tyhjä istunto — "Ei vaiheita tässä istunnossa." — on yleensä käynti, joka avasi sovelluksen ja lähti ennen kuin mitään ehti tapahtua. Se ei ole virhe.
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. Se myös varoittaa uudelleen sovelluksesta huolehtivia. |
| Ohita | Ottaa sen pois tieltä ratkaisematta — "Ongelma ohitettu." Kohinalle, joka tunnetaan. Ohitettu ongelma ei laukaise hälytyksiä. |
| 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ä
- Yleiskatsaus — mikä sovellus palaa.
- Sovelluksen Radar — mikä API, skripti tai näyttö.
- Sen paneeli — mikä kutsu, millä datalla, minä hetkenä.
- Istunto — mitä henkilö teki ennen.
- Ongelma — koodirivi ja painike Avaa designerissa.
- 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.