Servis durumu

Yazar Haber Ajansı (YHA) servislerinin anlık durumunu herkese açık servis durumu sayfamızdan, yani YHA status sayfasından izleyebilirsiniz: yha.com.tr/servis-durumu. Sayfa; YHA Abone akışının, API ve anlık akışın, FTP ve SFTP çıkışının, RSS ve e-posta servisinin, Haber At Para Kazan gönderiminin ve giriş doğrulama kodunun (SMS) çalışıp çalışmadığını, kullanıcılara duyurulmuş kesintileri ve planlı bakımları gösterir. Aşağıda durum sayfasını nasıl okuyacağınızı ve bir kesinti anında sisteminizin nasıl davranması gerektiğini anlattık.

Canlı durum: Bu sayfadaki durum paneli dakikada bir kendiliğinden yenilenir; sayfayı yeniden yüklemenize gerek yoktur.

Durum sayfası neden var?

Bir haber ajansının abonesi için haberin geç gelmesi, hiç gelmemesi kadar can sıkıcıdır. Haber sitenizde son dakika akışı durduğunda, sorunun sizin sunucunuzda mı yoksa ajansın sisteminde mi olduğunu hızlıca anlamanız gerekir. YHA servis durum sayfası bu soruya tek bakışta cevap verir.

Durum sayfasını yayınlamamızın üç nedeni vardır:

1. Şeffaflık: Bir sorun yaşandığında bunu saklamak yerine açıkça duyurmak, Yazar Haber Ajansı'nın editoryal ve kurumsal ilkelerinin bir parçasıdır. Kullanım şartlarımızda da bakım ve arıza durumlarının bu sayfada duyurulacağı yazılıdır.
2. Zaman kazancı: Abonelerimiz duyurulmuş bir kesintiyi destek talebi açmadan öğrenir; teknik ekipleri boşuna kendi sistemlerinde hata aramaz.
3. Planlama: Planlı bakımlar bu sayfada duyurulduğu için aboneler yayın akışlarını buna göre ayarlayabilir.

Durum sayfasında hangi servisler izlenir?

Durum sayfası YHA'nın servislerini ayrı ayrı gösterir. Böylece yalnızca bir serviste yaşanan sorun diğerlerini etkilemiyorsa bunu net olarak görebilirsiniz.

Bütün kanalların teknik ayrıntılarını tek yerde görmek için YHA geliştirici belgeleri sayfasını ziyaret edebilirsiniz.

Durum seviyeleri ne anlama geliyor?

Her servis, o anki durumuna göre aşağıdaki seviyelerden biriyle gösterilir:

Sayfanın üst bölümünde genel durum, altında süren olaylar ve planlı bakımlar, servis listesi ve duyurular yer alır. Son güncelleme saati de sayfada gösterilir.

Uptime ve hizmet düzeyi

Uptime, bir hizmetin belirli bir dönemde erişilebilir olduğu sürenin toplam süreye oranıdır ve genellikle şöyle hesaplanır:

Uptime (%) = (Toplam süre − Kesinti süresi) ÷ Toplam süre × 100

YHA servis durumu sayfası bir uptime yüzdesi ya da geçmişe dönük uptime grafiği yayımlamaz; servislerin anlık durumunu, duyurulmuş kesintileri ve planlı bakımları gösterir. Sayfada herkese açık bir hizmet düzeyi taahhüdü (SLA) da yer almaz. Abone kurumlara verilen hizmet düzeyi, varsa, abonelik sözleşmesinde yazılıdır.

Bu nedenle durum sayfasını bir "karne" olarak değil, bir "pano" olarak düşünün: o anda bir sorun olup olmadığını ve sorunun ajans tarafında mı, sizin tarafınızda mı olduğunu anlamanızı sağlar.

Durumu nasıl takip edersiniz?

Durum sayfası dakikada bir kendiliğinden yenilendiği için açık bir sekmede bırakmanız yeterlidir. Planlı bakımlar ve olaylar aynı sayfada, duyurular bölümünde yayımlanır. Sayfa ayrı bir e-posta ya da RSS bildirim aboneliği sunmaz; bu nedenle kesintilerden haberdar olmak için kendi tarafınızda basit bir izleme kurmanızı öneririz (aşağıda anlattık).

Ekibinizde birden fazla kişinin durum sayfasını ve kendi izleme uyarılarınızı bilmesi önemlidir; tek bir kişiye bağlı uyarılar, o kişi izindeyken fark edilmeyebilir. Yalnızca kullandığınız servisleri takip etmeniz de işinizi kolaylaştırır: örneğin yalnızca RSS kullanıyorsanız FTP satırı sizin için önemli değildir.

Kesinti anında entegrasyonunuz ne yapmalı?

İyi kurulmuş bir entegrasyon, kısa süreli bir kesintiyi okurunuz hiç fark etmeden atlatır. YHA'yı kendi sistemine bağlayan geliştiricilere şu uygulamaları öneriyoruz:

1. Yeniden deneme (retry) ve artan bekleme (backoff)

Bir istek başarısız olduğunda hemen ve art arda tekrar denemek, hem sizin sisteminizi hem de toparlanmaya çalışan servisi yorar. Bunun yerine her başarısız denemeden sonra bekleme süresini artırın: örneğin 2 saniye, 4 saniye, 8 saniye, 16 saniye. Bekleme sürelerine küçük rastgele farklar (jitter) eklemek, çok sayıda istemcinin aynı anda tekrar denemesini önler. API 429 yanıtı verirse Retry-After başlığında yazan süre kadar bekleyin; 500 yanıtında kısa süre sonra yeniden deneyin, sorun sürerse yanıttaki X-YHA-Istek değeriyle bize bildirin.

2. Zaman aşımı sınırı belirleyin

İsteklerinize makul bir zaman aşımı (timeout) koyun. Cevap vermeyen bir bağlantıyı sonsuza kadar beklemek, sitenizin diğer işlerini de yavaşlatabilir.

3. Son başarılı durumu saklayın

API akışını imleçle çekiyorsanız son imleci saklayın. Hizmet geri geldiğinde kaldığınız yerden devam eder, yalnızca kaçırdığınız haberleri çekersiniz ve aynı haberi iki kez yayınlamaktan kaçınırsınız. Akış en çok 7 gün geriye gider; daha eskisi için arama ve liste uçlarını kullanın. Ayrıntılar YHA geliştirici belgeleri içindeki akış ve imleç sayfasındadır.

4. Yedek kanal tanımlayın

YHA aynı haber akışını birden fazla kanaldan sunabilir. Birincil kanalınızda uzun süreli bir sorun olursa, aboneliğinizin kapsadığı ikinci bir kanala geçebilirsiniz. Örneğin API'de sorun yaşanırken RSS beslemesi çalışıyorsa, geçici olarak beslemeden okumak akışınızı sürdürmenizi sağlar. Otomatik çıkışlar pakete sözleşmeyle eklenir; yedek kanal seçenekleri için YHA abonelik paketleri sayfasına bakabilirsiniz.

5. Webhook kaçırmalarına karşı kontrol

Webhook ile çalışıyorsanız sisteminizin geçici olarak bildirim alamadığı durumlar olabilir. YHA başarısız teslimleri artan aralıklarla yaklaşık 24 saat boyunca yeniden dener; art arda hatalarda çıkış "arızalı" görünür ve ilk başarılı teslimde biriken içerik sırayla gönderilir. Sıra garantisi olmadığı için eski düzeltmeleri sürüm numarasıyla ayıklayın. Belirli aralıklarla API üzerinden son haberleri kontrol eden bir "uzlaştırma" işi kurmak da kaçan bildirimleri telafi eder. Ayrıntılar webhook belgelerimizde yer alır.

6. Kendi tarafınızı da izleyin

Sorun her zaman ajans tarafında olmayabilir. Kendi sunucunuzun giden bağlantılarını, güvenlik duvarı kurallarını, FTP/SFTP parolanızı ve API anahtarınızın geçerliliğini düzenli kontrol edin. FTP çıkışında bağlantı ve kimlik hataları yeniden denenir; parolayı düzelttiğinizde bekleyen içerik sırayla gönderilir.

7. Kesintiyi okurunuza doğru yansıtın

Uzun süreli bir kesintide sitenizin boş görünmesi yerine son yayınlanan haberlerin yerinde kalmasını sağlayın. Otomatik haber akışı kullanılan bir sayfada "son güncelleme" bilgisini göstermek, okurun akışın neden durduğunu anlamasına yardımcı olur.

Kendi izlemenizi kurun

Durum sayfası YHA tarafını gösterir; ancak kendi entegrasyonunuzun sağlığını da izlemeniz önerilir. Basit bir izleme kurmak için:

• Son haber zamanını takip edin. Sitenize en son ne zaman YHA haberi düştüğünü kaydedin. Yoğun saatlerde uzun süre yeni haber gelmezse bir uyarı tetikleyin.
• Hata oranını ölçün. API veya besleme isteklerinizin ne kadarının başarısız olduğunu kaydedin. Ani bir artış, durum sayfasında henüz görünmeyen bir soruna ya da kendi tarafınızdaki bir değişikliğe işaret edebilir.
• Uyarıları doğru kişiye yönlendirin. Gece yarısı gelen bir uyarının, onu çözebilecek kişiye ulaştığından emin olun.

Bu izleme, durum sayfasıyla birlikte kullanıldığında bir sorunun kaynağını hızla ayırt etmenizi sağlar.

Planlı bakım duyuruları

Altyapıyı güncel ve güvenli tutmak için zaman zaman planlı bakım çalışmaları yaparız. Planlı bakımlar durum sayfasında duyurulur ve bakım süresince ilgili servis "planlı bakım" olarak gösterilir. Bakım duyurusunu gördüğünüzde etkilenen servisi kullanıp kullanmadığınızı kontrol edin ve gerekiyorsa yayın akışınızı buna göre planlayın.

Sorun durum sayfasında görünmüyorsa

Durum sayfasında tüm servisler "çalışıyor" görünürken siz sorun yaşıyorsanız, sorun sizin entegrasyonunuza veya hesabınıza özgü olabilir. Bu durumda YHA Abone programının içinden ("Destek" › "Yeni talep") talep açın ya da YHA iletişim sayfasındaki destek kanalından destek@yha.com.tr adresine şu bilgilerle yazın:

• Sorunun başladığı tarih ve saat,
• Kullandığınız kanal ve uç nokta,
• Aldığınız hata kodu veya mesajı,
• Kurum adınız (API anahtarınızın tamamını paylaşmadan).

Destek hafta içi 09.00–18.00 (Türkiye saati) arasında verilir.

Sıkça Sorulan Sorular

YHA status sayfasına nereden ulaşırım?

Durum sayfasına yha.com.tr/servis-durumu adresinden ulaşabilirsiniz; sitenin üst bölümündeki "Servis durumu" bağlantısı da bu sayfaya gelir. Sayfa herkese açıktır ve dakikada bir kendiliğinden yenilenir.

Haberler gelmiyor ama durum sayfası "çalışıyor" diyor, ne yapmalıyım?

Önce kendi sisteminizin kayıtlarına bakın, ardından hata bilgileriyle destek ekibimize yazın. Sorun yalnızca sizin hesabınızı ya da çıkışınızı etkiliyor olabilir.

Uptime geçmişini nereden görebilirim?

Servis durumu sayfası uptime yüzdesi ya da geçmiş uptime grafiği yayımlamaz; servislerin anlık durumunu, süren olayları ve planlı bakımları gösterir. Abone kurumlara verilen hizmet düzeyi, varsa, abonelik sözleşmesinde yazılıdır.

Bir kesinti yaşandığında abonelik ücretimden indirim yapılır mı?

Bu konu abonelik sözleşmenizdeki hizmet düzeyi hükümlerine bağlıdır. Sözleşmenizle ilgili sorularınız için satis@yha.com.tr adresine yazabilirsiniz.

Planlı bakım sırasında haberler kaybolur mu?

API akışını imleçle çeken entegrasyonlar, bakım sonrasında kaldıkları yerden devam ederek kaçırdıkları haberleri alabilir. FTP ve webhook çıkışlarında ise teslim edilemeyen içerik yeniden denenir ve bağlantı düzeldiğinde sırayla gönderilir.