# Bölgesel sinyali kontrol etme: UptimeScout hizmet durumu ile geçmişi nasıl karşılaştırılır

https://jsonscraper.com/tr/blog/bolgesel-sinyali-kontrol-etme-uptimescout-hizmet-durumu

Author: Michael Johnson

Published: 2026-11-21T11:40:55+00:00

Updated: 2026-11-21T11:40:55+00:00

Bölgesel gözlem ve geçmiş verilerini isteyin, zamanı ve güncelliği kontrol edin, ardından uygulama günlükleriyle karşılaştırın.

Bir kesinti şüphesinin belirli bir bölgedeki gözlemlerle örtüşüp örtüşmediğini kontrol etmek için hizmet durumunu ve seçilen zaman aralığının geçmişini isteyin. Bölgeyi ve zaman damgalarını uygulama günlükleriyle karşılaştırın. Sonuç, kayıtlı verilerde bölgesel bir sinyalin bulunup bulunmadığına ve ilgili kaydın ne kadar güncel olduğuna dair somut bir soruyu yanıtlar.

 

[UptimeScout belirtimi](https://uptimescout.com/openapi.json), durum ve geçmiş için ayrı yöntemler tanımlar. Durum yanıtındaki üst düzey `status` alanı API isteğinin sonucunu bildirir; hizmet sinyali `service.status` alanında bulunur. Geçmiş verileri, toplulaştırılmış zaman aralıklarını, çözünürlüğü ve örnek sayısını içerir. Bunlar ilk tanılama ve olay raporuna eklenecek belgeler için yararlı verilerdir.

 

## 1. Hizmeti, bölgeyi ve lisansı hazırlayın

 

Aşağıdaki örnekte `github` hizmet kimliği ve `US` bölgesi kullanılıyor. Kendi kontrolünüz için UptimeScout kataloğundan geçerli bir kimlik ve sorunun gözlemlendiği bölgenin kodunu kullanın. Kullanılabilir bölgeler hizmete göre değişebilir; yorumlamadan önce yanıttaki `available_regions` alanını kontrol edin.



![Bölgesel sinyali kontrol etme: UptimeScout hizmet durumu ile geçmişi nasıl karşılaştırılır
Özet: UptimeScout bölgesel sinyali için adım adım tanılama: Python SDK üzerinden istek gönderin, `service.status`, `observed_at` ve `stale` alanlarını kontrol edin, ardından geçmiş verileri ve çözünürlüğünü karşılaştırın.
Görselin rolü: kapak — ana fikir
Bölüm: 1. Hizmeti, bölgeyi ve lisansı hazırlayın
Görsel konusu: Olay müdahale çalışma sayfasının yakından göründüğü editoryal fotoğraf illüstrasyonu: iki n yanında bir ABD bölge haritası](https://jsonscraper.com/assets/uploads/journal/2026/11/392a4a61d4ab1c47ecbb56def0285127.png.hero.webp)

Haritadaki bölge, zaman damgaları ve gözlem geçmişindeki boşluklarla karşılaştırılıyor.© jsonscraper · yapay zekâyla oluşturuldu

 

Python 3.10+ sürümünü ve SDK’yı proje talimatlarına göre yükleyin. Anahtarı `UPTIMESCOUT_LICENSE_KEY` ortam değişkenine ekleyin; koda veya günlüklere koymayın. Örnek, belgelenmiş istemci üzerinden iki istek gönderir, özgün JSON yanıtlarını bellekte tutar ve inceleme için yazdırır. Bu, burada gerçekleştirilmiş bir testin raporu değil, entegrasyon örneğidir.

 

```
import json
import os
from uptimescout import Client, UptimeScoutError

client = Client(os.environ["UPTIMESCOUT_LICENSE_KEY"], timeout=30)

try:
    status_data = client.status("github", region="US", lang="ru")
    history_data = client.history("github", region="US", hours=24, lang="ru")
except UptimeScoutError as error:
    raise SystemExit(f"API request failed: HTTP {error.status}")

print(json.dumps(
    {"status": status_data, "history": history_data},
    ensure_ascii=False,
    indent=2,
))
```

 

Resmî [UptimeScout Python SDK](https://github.com/jsonscraper/uptimescout-api-python); istemciyi, `status` ve `history` yöntemlerini ve arka planda kullanılan Bearer kimlik doğrulamasını belgeliyor. Kurulum ve sürümler için depodaki güncel talimatları izleyin; gösterilen kod parçası SDK’nın zaten yüklü olduğunu varsayar.

 

## 2. İstek durumunu değil, sinyali okuduğunuzdan emin olun

 

Yanıttaki `service.status`, `service.observed_at`, `service.stale` alanlarını ve yanıtın bölgesini kontrol edin. Üst düzey `status`, API isteğinin başarılı olup olmadığını belirtir; hizmetin kullanılabilirliğini değil. Sonucun hangi kayda ait olduğunun anlaşılması için istek zamanını, hizmet kimliğini ve bölge parametrelerini de kaydedin.

 

Gözlem güncel olarak işaretlenmişse ve `service.status` bozulma veya kesinti gösteriyorsa bunu bölgesel bir sinyal olarak kaydedin; kendi günlüklerinizle, bağlantı hatalarıyla ve uygulama kontrolleriyle karşılaştırın. `stale` alanı, kaydedilmiş gözlemin belirlenen güncellik süresini aşıp aşmadığını gösterir. Değeri `true` ise veya gerekli alan yoksa bu yanıta dayanarak mevcut kullanılabilirliği bilinmiyor olarak belirtin; eski ya da eksik bir kaydı şu anki duruma ilişkin bir sonuca dönüştürmeyin.

 

UptimeScout, verileri kayıtlı bölgesel sinyaller olarak tanımlar: bunlar tanılama için bir göstergedir; doğrudan çalışma süresi ölçümü veya küresel bir kesintinin kanıtı değildir. Bu nedenle sonucu kesin ifade edin: “Belirtilen bölge için, belirtilen zamanda kaydedilmiş şu türde bir sinyal bulundu.” Kendi kontrollerinizle karşılaştırma, bu dış sinyalin uygulamanızın kullanıcı deneyimiyle örtüşüp örtüşmediğini gösterir.

 

## 3. Geçmişi ve aralık çözünürlüğünü karşılaştırın

 

Geçmiş yöntemi, zaman içinde toplanmış verileri döndürür. Yanıttaki `resolution_seconds`, `samples`, `counts` ve `effective_start` alanlarını kontrol edin; gerçek aralıkların zaman sınırlarını da kaydedin. Belgelerde UTC’ye göre hizalama açıklanır: bir saate kadar olan pencereler için üç dakikalık, üç saate kadar olanlar için beş dakikalık, 24 saate kadar olanlar için saatlik, daha uzun pencereler içinse günlük aralıklar. Eski toplulaştırılmış verilerde bildirilen çözünürlük daha kaba olabilir.



![Bölgesel sinyali kontrol etme: UptimeScout hizmet durumu ile geçmişi nasıl karşılaştırılır
Özet: UptimeScout bölgesel sinyali için adım adım tanılama: Python SDK üzerinden istek gönderin, `service.status`, `observed_at` ve `stale` alanlarını kontrol edin, ardından geçmiş verileri ve çözünürlüğünü karşılaştırın.
Görselin rolü: destekleyici illüstrasyon 2 — farklı ve belirli bir yön
Bölüm: 3. Geçmişi ve aralık çözünürlüğünü karşılaştırın
Görsel konusu: Açık renkli arka plan üzerinde temiz bir editoryal infografik; dört ardışık panel gösteriyor](https://jsonscraper.com/assets/uploads/journal/2026/11/fc10679b2a9f2c60c9aa8ec3f7f897a6.png.hero.webp)

Yanıt alanları ve bölgesel sinyalle geçmiş verilerini kontrol etme sırası.© jsonscraper · yapay zekâ tarafından oluşturulmuş illüstrasyon

 

Bu nedenle pencereyi sorunuza göre seçin. Kısa süreli bir olay için uygun kısa bir aralık kullanın ve sonucu sunarken çözünürlüğü de belirtin. Uzun dönemler için geçmiş verilerinin günlere göre toplulaştırılmış olabileceğini açıklayın: günlük bir veri noktası, dakika dakika gelişimi yeniden oluşturmayı sağlamaz.

 

Eksik aralıklar, normal çalışmanın kanıtı değil, bilinmeyen verilerdir. Örnek sayısını ve aralık sınırlarını toplulaştırılmış değerlerle birlikte saklayın. Bu, geçmiş verilerinin incelenen dönemi ne ölçüde kapsadığını ve sonucun hangi verilere dayandığını anlamaya yardımcı olur.

 

## 4. İncelenebilir bir olay kaydı hazırlayın

 

Rapor için özgün yanıtları ve standartlaştırılmış alanları saklamanız yeterlidir: hizmet, bölge, istek zamanı, `service.status`, `observed_at`, `stale`, seçilen geçmiş aralığı, `resolution_seconds`, örnek sayısı ve `effective_start`. Eksik değerleri eksik olarak bırakın: sıfır ile veri yokluğu aynı anlama gelmez.

 

Ardından bu bilgileri aynı döneme ait kurum içi kontrollerle karşılaştırın: yanıt kodları, bağlantı hataları, barındırma bölgesi ve zaman damgaları. Veriler uyuşmuyorsa her iki tarafı da saklayın. UptimeScout’un bölgesel gözlemi ile belirli bir endpoint’in kontrolü farklı gözlem noktalarını anlatır; bu nedenle uyuşmazlık, uygun görünen yanıtı seçmeyi değil, daha fazla incelemeyi gerektirir.

 

API hatası durumunda HTTP koduna bakın: belirtim; geçersiz parametreleri, lisansın bulunmamasını, lisansın geçersiz olmasını, kota aşımını ve geçici kullanılamama durumunu listeler. İlgili nedeni giderin. İstek hatası, kontrol edilen hizmetin durumu değildir.

 

## Nöbetçi ekibe ne iletilmeli?

 

Kısa sonuçta hizmeti, bölgeyi, gözlem zamanını, kaydın güncelliğini ve geçmiş verilerinin çözünürlüğünü belirtin. Veri bulunmayan aralıkları ayrıca bilinmiyor olarak işaretleyin ve aynı döneme ait kurum içi günlükleri ekleyin. Böylece ekip; API isteğinin durumunu, UptimeScout gözlemlerini ve uygulamanın kendi ölçümlerini birbirine karıştırmadan, doğrulanabilir bir bölgesel sinyal elde eder.
