# UptimeScout: Kullanıcının Bölgesinde Hizmet Kesintisi Olup Olmadığı Nasıl Kontrol Edilir?

https://jsonscraper.com/tr/blog/uptimescout-bolgesel-hizmet-erisebilirligi-kontrol-gecmisi

Author: Michael Johnson

Published: 2026-11-20T11:42:02+00:00

Updated: 2026-11-20T11:42:02+00:00

Uygulamalı bir örnek: Bölgeye ait gözlem geçmişini toplayın ve güncel sinyali bilinmeyen zaman aralıklarından ayırın

Kullanıcılar tek bir ülkede sorun bildirdiğinde, ekip ise hizmetin olağan çalıştığını gördüğünde, en faydalı adım onların bölgesine ait gözlemleri kontrol etmektir. UptimeScout API, seçilen hizmetin geçmişini bölge koduna göre sorgulamanıza ve gözlem aralıklarını ölçüm sayılarıyla birlikte almanıza olanak tanır. Sonuç, bir destek talebini incelemek için doğrulanabilir bir tablo sunar: aralığın zamanı, çözünürlük, sinyal dağılımı ve örnek sayısı.



![Makale: UptimeScout: Kullanıcının Bölgesinde Hizmet Kesintisi Olup Olmadığı Nasıl Kontrol Edilir?
Özet: Bölgesel erişilebilirlik kontrolü, kullanıcının yaşadığı olayın UptimeScout gözlemleriyle örtüşüp örtüşmediğini gösterebilir. Yeniden uygulanabilir bir yöntem sunuyoruz: hizmeti ve bölgeyi seçin, geçmişi sorgulayın, verilerin güncelliğini ve çözünürlüğünü kontrol edin, ardından sonucu ilk yanıtla birlikte saklayın.
Görsel rolü: kapak — ana fikir
Bölüm: 
Görsel konusu: Katlanmış bölgesel kesinti haritasının editoryal fotoğrafı](https://jsonscraper.com/assets/uploads/journal/2026/11/1cd4023e50fafa3c2411a7c5fc1a0f4b.png.hero.webp)

Bölge ve zaman aralığı, erişilebilirlik kontrolünün sınırlarını belirler.© jsonscraper · yapay zekâ ile oluşturuldu

 

Buradaki uygulamalı senaryo, olası bir bölgesel kesintiyi teşhis etmektir. Girdiler: UptimeScout kataloğundaki hizmet tanımlayıcısı, US veya GB gibi bir bölge kodu ve geçmiş için bir zaman aralığı. Sonuç, kullanıcının bildirim zamanını hizmet gözlemleriyle karşılaştırmaya yardımcı olur. API, verileri gözlemlenen erişilebilirlik sinyalleri olarak tanımlar; hizmet kontrolü, sorunu yerelleştirmeye yardımcı olur ancak uygulamanıza yönelik kendi kontrollerinizin yerini tutmaz.

 

## Önce hizmeti ve bölgeyi doğrulayın

 

Katalogdan başlayın: İstediğiniz hizmeti adıyla veya arama alanıyla bulun ve tam ID değerini kaydedin. [UptimeScout OpenAPI belirtimi](https://uptimescout.com/openapi.json), GET /v1/services üzerinden aramayı ve q, service, region, limit ve offset parametrelerini açıklar. Tanı raporu için yalnızca görünen adı değil ID değerini saklamak daha iyidir; böylece sonraki sorgu katalogdaki aynı öğeyi hedefler.

 

Bölge, iki harfli ayrı bir kodla belirtilir. Sonuçla birlikte bu kodu da saklamak önemlidir: US için alınan yanıt ile bölge filtresi olmadan alınan yanıt farklı soruları yanıtlar. Açıklama dilini Türkçe göstermek gerekiyorsa lang=tr parametresi açıklamanın yerelleştirilmesini sağlar; region parametresi ise gözlemleri seçer. Belgeler bu iki işlevi açıkça birbirinden ayırır.

 

## Tek bir durum yerine geçmişi sorgulayın

 

Olayı incelemek için zorunlu service parametresi ve seçilen region ile /v1/history uç noktasını kullanın. hours parametresi geçmiş zaman aralığını belirler; belirtim 1 ile 2160 saat arasındaki değerlere izin verir. İstekte lang parametresi de kullanılabilir. OpenAPI belirtimine göre yetkilendirme, Bearer şemasıyla lisans anahtarı üzerinden yapılır. Uygulamada anahtarı bir ortam değişkeninde tutun ve istek günlüklerine yazmayın.

 

```
import os
import requests

response = requests.get(
    "https://api.uptimescout.com/v1/history",
    headers={"Authorization": f"Bearer {os.environ['UPTIMESCOUT_LICENSE_KEY']}"},
    params={"service": "github", "region": "GB", "hours": 24, "lang": "ru"},
    timeout=30,
)
response.raise_for_status()
data = response.json()
print(data)
```

 

Bu, gerçek bir incelemenin yayımlanmış sonucu değil, asgari bir istek örneğidir. github tanımlayıcısı ve GB bölgesi örnek parametreler olarak verilmiştir; kullanmadan önce kendi senaryonuz için gereken hizmeti ve bölgeyi seçin. Yanıtı, alma zamanını ve istek açıklamasını denetim sisteminizde ayrı alanlara ekleyerek JSON biçiminde tümüyle saklamak faydalıdır. Böylece incelemeyi tekrarlayabilir ve hangi veri anlık görüntüsünün kullanıldığını görebilirsiniz.

 

## Çözünürlük ve eksik aralıklar da sonucun parçasıdır

 

history dizisinde observed_at, resolution_seconds, aggregated, samples ve counts alanları önemlidir. Çözünürlük, zaman aralığının süresini belirtir; samples toplulaştırmaya kaç gözlemin dahil olduğunu, counts ise sinyallerin dağılımını gösterir. Bunları birlikte değerlendirin: az sayıda sample içeren tek bir satırın analizdeki ağırlığı, çok sayıda gözlem içeren bir toplulaştırmadan farklıdır.



![Makale: UptimeScout: Kullanıcının Bölgesinde Hizmet Kesintisi Olup Olmadığı Nasıl Kontrol Edilir?
Özet: Bölgesel erişilebilirlik kontrolü, kullanıcının yaşadığı olayın UptimeScout gözlemleriyle örtüşüp örtüşmediğini gösterebilir. Yeniden uygulanabilir bir yöntem sunuyoruz: hizmeti ve bölgeyi seçin, geçmişi sorgulayın, verilerin güncelliğini ve çözünürlüğünü kontrol edin, ardından sonucu ilk yanıtla birlikte saklayın.
Görsel rolü: destekleyici illüstrasyon 2 — farklı bir özel konu
Bölüm: Çözünürlük ve eksik aralıklar da sonucun parçasıdır](https://jsonscraper.com/assets/uploads/journal/2026/11/a171063a93107bb525c54a0ee477e61a.png.hero.webp)

Geçmişi okuma sırası: bölge, zaman aralıkları, çözünürlük ve eksik veriler.© jsonscraper · yapay zekâ tarafından oluşturulmuş illüstrasyon

 

UptimeScout, geçmişi seçilen zaman aralığına göre adımı değişen zaman dilimleri olarak tanımlar: kısa dönemlerde dakikalık ve beş dakikalık aralıklar, bir günlük dönemlerde saatlik, uzun dönemlerde ise günlük aralıklar. Saklanan eski toplulaştırmaların çözünürlüğü daha düşük olabilir. Bu nedenle satır saatlik veya günlük bir toplulaştırmayı temsil ediyorsa “kesinti tam olarak şu dakikada başladı” sonucuna varmayın. Çıkarımın sınırlarını belirtmek için yanıttaki gerçek resolution_seconds değerini ve effective_start ile history_resolution alanlarını kullanın.

 

Eksik bir aralığı bilinmeyen olarak değerlendirin. Belirtim, eksiklerin bilinmeyen aralıklar olarak kontrol edilmesini açıkça ister: geçmişteki boşluk kendi başına ne normal çalışmayı ne de kesintiyi ifade eder. Bu basit kural, raporda boşlukların yanlışlıkla “yeşil” durumla veya sıfırlarla doldurulmasını önler.

 

## Geçmişi güncel sinyalle karşılaştırın

 

Bildirim anındaki durumu kontrol etmeniz gerekiyorsa aynı service ve region değerleriyle /v1/status uç noktasını sorgulayın. Hizmet nesnesinde status, observed_at ve stale alanlarını birlikte inceleyin; belgeler, durumu ve sinyalin güncelliğini anlamak için bu alanları gösterir. Üst düzey status, API isteğinin sonucunu ifade ederken service.status belirli bir hizmetin erişilebilirlik sinyalini tanımlar. Bu ayrım, otomatik raporlarda özellikle faydalıdır: başarılı bir HTTP yanıtı ile harici hizmetin durumu farklı şeylerdir.

 

Birden fazla bağımlılık için /v1/statuses uç noktasına geçebilir, ardından yalnızca anomali görülen hizmetler ve bölgeler için geçmişi kullanabilirsiniz. Belirtim ayrıca /v1/summary ve /v1/incidents uç noktalarını da sunar. Son uç noktayı tanılama amacıyla kullanırken işlevini doğru değerlendirin: uç nokta, sağlayıcının doğrulanmış olaylarını değil, yakın zamanda yükselmiş kesinti sinyallerini döndürür. Bu nedenle sonuç, neden hakkında kesin bir hüküm değil, doğrulama için bir işarettir.

 

## Çıkarımı varsayım eklemeden raporlayın

 

Rapor satırına service ID, region, sorgu dönemi, observed_at, resolution_seconds, samples, counts ve eksik aralıklarla ilgili bir not ekleyin. Destek talebinin veya kurum içi olay kaydının bağlantısını API alanlarından ayrı tutun. Ardından zaman aralığını uygulama günlükleri, bölgesel izleme verileri ve kullanıcı bildirimiyle karşılaştırın. Toplulaştırmanın zaman sınırları olaydan daha genişse sonucu buna uygun biçimde ifade edin: seçilen bölgedeki belirtilen zaman aralığına ait gözlemlerde şu sinyaller, şu çözünürlük ve şu sayıda örnek bulunuyor.

 

Bu inceleme, nöbetçi ekip üyesine yararlı bir sonraki adım sunar: harici hizmetin bölgesel tarafını kontrol etmek veya kullanıcının uygulama ve ağ bağlantısını teşhis etmeye devam etmek. İncelemenin tekrarlanabilirliği, istek parametrelerinin ve ilk JSON yanıtının saklanmasına; zamanla ilgili çıkarımların güvenilirliği ise çözünürlüğün, samples değerlerinin ve bilinmeyen aralıkların açıkça hesaba katılmasına bağlıdır. Erişilebilirlik senaryosunda pratik sonuç budur: yalnızca güncel durum etiketi değil, bir meslektaşın yeniden kontrol edebileceği, bölge ve zaman bakımından sınırları belirli bir kayıt.
