Voiko UptimeScout incidents -vastauksen perusteella heti ilmoittaa, että palvelussa on häiriö? Ei: tämä päätepiste luettelee palvelut, joissa on viime aikoina havaittu tavallista enemmän häiriösignaaleja, ja määrittelyssä todetaan nimenomaisesti, etteivät ne ole palveluntarjoajan vahvistamia häiriöitä. Käytännössä tuloksena on lyhyt luettelo tarkistettavista signaaleista, ei valmis johtopäätös häiriön syystä.

Tämä ero on tärkeä päivystävälle insinöörille ja analyytikolle: automaattinen hälytys voi ilmoittaa ”tarkista palvelu X alueella Y” ja jättää tapahtuman vahvistamisen sekä syyn selvittämisen palveluntarjoajan virallisen tilannetiedotuksen tai oman diagnostiikan varaan. UptimeScoutin määrittely dokumentoi erilliset reitit signaaleille, nykyiselle tilalle ja havaintohistorialle.
Mitä signaaliluettelo palauttaa
/v1/incidents on GET-päätepiste sellaisten palvelujen luetteloon, joissa havaitaan tavallista enemmän häiriösignaaleja. Sen parametreilla voi suodattaa palvelun, alueen, luokan, hakusanan ja aikavälin mukaan. Vastauksen käyttö edellyttää lisenssiä; API kuvaa tunnistautumisen Bearer-tunnuksella. Aluekenttä hyväksyy kaksikirjaimisen koodin, ja hours määrittää 1–2160 tunnin aikavälin.
Polun sana ”incident” on helppo tulkita vahvistetuksi häiriöksi, mutta dokumentaatio määrittelee sen suppeammin: kyse on tuoreesta havaintosignaalista. Siksi ilmoitus kannattaa muotoilla vastauksen tietojen mukaisesti, esimerkiksi ”saatu signaali saatavuushäiriöstä”, eikä väittää palveluntarjoajan vahvistaneen häiriön.
Vähimmäistarkistukset ennen ilmoitusta
Tallenna ensin alkuperäinen vastaus sekä sen vastaanottoaika ja pyynnön parametrit. Tarkista sitten, mikä palvelu ja alue vastauksessa mainitaan, ja arvioi tietojen tuoreus palvelukenttien observed_at ja stale perusteella. Jos havainto on merkitty vanhentuneeksi, se on erotettava nykyisestä signaalista eikä sitä pidä esittää tämänhetkisenä tilana.
curl -sS 'https://api.uptimescout.com/v1/incidents?region=US&hours=24' \
-H "Authorization: Bearer $UPTIMESCOUT_LICENSE_KEY"
Tässä esimerkissä pyyntö koskee Yhdysvaltoja ja 24 tunnin aikaväliä; avain luetaan ympäristömuuttujasta eikä sitä tulosteta komentoriville. Tarkista vastauksen jälkeen HTTP-virheet ja JSON-rakenne ja käsittele sitten jokainen palautettu palvelu erikseen. Skeeman tilaarvoja ovat operational, degraded, outage ja unknown; jos kenttä tai arvo puuttuu, älä korvaa sitä omalla tulkinnalla.
Toimia vaativan signaalin kohdalla pyydä kyseisen palvelun nykyinen tila reitistä /v1/status ja historia reitistä /v1/history. Historiatietoihin kannattaa tallentaa aikasarjojen yhteyteen resolution_seconds, samples, counts ja effective_start: näin analyytikko näkee tietojen ajallisen tarkkuuden ja sen, miltä todelliselta aikaväliltä niitä on saatavilla. Määrittely varoittaa, että puuttuvien aikavälien sisältöä ei tunneta; tyhjää väliä ei voi automaattisesti tulkita sen paremmin saatavuudeksi kuin häiriöksikään.
Näin teet vastauksesta tarkistettavan raportin
Kirjaa jokaiselle tietueelle palvelun tunniste ja nimi, pyynnön alue, tila, havaintoaika, vanhentuneisuusmerkintä, vastauksen vastaanottoaika sekä linkki viralliseen tilannetiedotukseen, jos tiimi on tarkistanut sen. Viimeinen kenttä täytetään omassa integraatiossa tai operaattorin toimesta: UptimeScoutin määrittely ei lupaa, että signaali sisältäisi vahvistetun syyn tai palveluntarjoajan lausunnon.

Jaa työnkulku kolmeen tilaan. ”Signaali vastaanotettu” tarkoittaa, että tietue sisältyi reitin /v1/incidents tuloksiin. ”Tilaa tarkistetaan” tarkoittaa, että olet pyytänyt nykyisen tilan ja historian. ”Vahvistettu” tulee varata johtopäätökselle, jota tukee ulkopuolinen virallinen ilmoitus tai sisäinen tarkistus. Näin kojelauta ei esitä koottua signaalia varmana tosiasiana.
Jos tiimi laatii raportin useista alueista, tee erilliset pyynnöt tarvittavilla aluekoodeilla ja tallenna parametri tuloksen yhteyteen. lang-kenttä koskee palvelujen kuvausten kieltä; se ei muuta havaintojen aluetta. Tämä erottelu on tärkeä esimerkiksi vertailtaessa lokalisoitua luetteloa alueelliseen tilaan.
Mihin asti johtopäätöksiä voi tehdä
Tämän toimintatavan tarkistettava tulos on signaaliloki, jossa aika, alue ja tietojen tuoreus on merkitty selvästi ja jota täydentää erillinen tilan ja historian tarkistus. Sen avulla voi havaita, mikä vaatii huomiota ja mitä valittujen lähteiden perusteella onnistuttiin vahvistamaan. Itse /v1/incidents-vastaus kertoo tavallista voimakkaammasta havaintosignaalista; vahvistetun häiriön ilmoittaminen edellyttää sitä tukevaa näyttöä.