Kan du ut fra et svar fra UptimeScout incidents umiddelbart slå fast at en tjeneste har et avbrudd? Nei: Dette endepunktet lister tjenester med nylig forhøyede signaler om forstyrrelser, og spesifikasjonen understreker uttrykkelig at dette ikke er bekreftede hendelser fra tjenesteleverandøren. Det praktiske resultatet er en kort liste med signaler som må undersøkes, ikke en ferdig konklusjon om årsaken til avbruddet.

Dette skillet er nyttig for vaktingeniører og analytikere: Et automatisk varsel kan si «kontroller tjeneste X i region Y», mens bekreftelse av hendelsen og forklaring av årsaken fortsatt må komme fra tjenesteleverandørens offisielle statusside eller egen diagnostikk. UptimeScouts spesifikasjon dokumenterer separate endepunkter for signaler, nåværende status og observasjonshistorikk.
Hva listen over signaler faktisk returnerer
/v1/incidents er et GET-endepunkt for katalogen over tjenester med forhøyede signaler om forstyrrelser. Parametrene omfatter filtre for tjeneste, region, kategori, søkestreng og tidsvindu. Svaret krever lisens; API-et beskriver autentisering med et Bearer-token. Regionfeltet godtar en kode med to bokstaver, og hours angir et tidsvindu fra 1 til 2160 timer.
Det er lett å tolke ordet «incident» i endepunktet som en «bekreftet driftsfeil», men dokumentasjonen gir det en snevrere betydning: et ferskt observasjonssignal. Formuler derfor varselet ut fra dataene i svaret, for eksempel «det er mottatt et signal om redusert tilgjengelighet», og ikke tilskriv tjenesteleverandøren en bekreftelse av hendelsen.
En enkel kontroll før varsling
Lagre først det opprinnelige svaret sammen med tidspunktet det ble mottatt og forespørselsparametrene. Kontroller deretter hvilken tjeneste og region som ble returnert, og vurder hvor ferske dataene er ut fra tjenestefeltene observed_at og stale. Hvis observasjonen er merket som foreldet, bør den skilles fra et aktuelt signal i stedet for å vises som status «akkurat nå».
curl -sS 'https://api.uptimescout.com/v1/incidents?region=US&hours=24' \
-H "Authorization: Bearer $UPTIMESCOUT_LICENSE_KEY"
Dette er et eksempel på en forespørsel for USA med et tidsvindu på 24 timer; nøkkelen hentes fra en miljøvariabel og vises ikke på kommandolinjen. Når svaret er mottatt, kontroller HTTP-feil og JSON-strukturen, og behandle deretter hver returnerte tjeneste separat. Statusverdiene i skjemaet omfatter operational, degraded, outage og unknown; hvis et felt eller en verdi mangler, må du ikke sette inn din egen tolkning.
For et signal som krever handling, kan du hente nåværende status for den aktuelle tjenesten via /v1/status og historikken via /v1/history. I historikken er det nyttig å lagre resolution_seconds, samples, counts og effective_start sammen med tidsseriene. Da ser analytikeren hvilken tidsoppløsning dataene er samlet inn med, og hvilket faktisk tidsrom de dekker. Spesifikasjonen advarer om at manglende intervaller er ukjente; et tomrom kan ikke automatisk regnes som verken tilgjengelighet eller et avbrudd.
Slik gjør du svaret om til en etterprøvbar rapport
Opprett disse feltene for hver oppføring: tjeneste-ID og -navn, forespurt region, status, observasjonstidspunkt, foreldelsesindikator, tidspunktet svaret ble mottatt og en lenke til den offisielle statussiden dersom teamet har kontrollert den. Integrasjonen eller operatøren fyller ut det siste feltet: UptimeScouts spesifikasjon lover ikke at signalet inneholder en bekreftet årsak eller en uttalelse fra tjenesteleverandøren.

Del arbeidsflyten inn i tre tilstander. «Signal mottatt» betyr at en oppføring kom med i resultatet fra /v1/incidents. «Status kontrolleres» betyr at du har hentet nåværende status og historikk. Bruk «bekreftet» bare om konklusjoner som støttes av en offisiell ekstern melding eller en intern kontroll. Dette enkle skillet hindrer dashbordet i å presentere et aggregert signal som et fastslått faktum.
Hvis teamet lager rapporter for flere regioner, sender du separate forespørsler med de aktuelle regionkodene og lagrer parameteren sammen med resultatet. Feltet lang gjelder språket i tjenestebeskrivelsene; det endrer ikke observasjonsregionen. Dette skillet er viktig når man for eksempel sammenligner en lokalisert katalog med regional status.
Hvor konklusjonene stopper
Et etterprøvbart resultat av denne fremgangsmåten er en logg over signaler med tydelige tidsstempler, region og ferskhetsmarkering, supplert med en separat kontroll av status og historikk. Den gjør det enklere å finne ut hva som krever oppmerksomhet, og hva som kunne bekreftes gjennom de valgte kildene. Selve svaret fra /v1/incidents rapporterer et forhøyet observasjonssignal; en bekreftet driftsfeil krever underbyggende data.