Upptime Entegrasyonu - Çalışma Süresi İzleme Uyarıları

Upptime'ı Echobell ile entegre edin; siteniz çöktüğü anda push bildirimi veya telefon araması alın. GitHub Actions tabanlı kurulum kılavuzu.


Upptime'ın kesinti ve kurtarma olaylarını doğrudan Echobell'e iletebilirsiniz; böylece ekibiniz ayrı bir hat kurmadan zaman duyarlı push uyarıları veya telefon aramaları alır. Bu kılavuz kurulumun Echobell tarafına odaklanır ve Upptime'ın kendi bildirim değişkenlerini kullanır. Upptime'a özgü seçenekler için resmi bildirim dokümanlarına bakın.

Upptime uyarıları için neden Echobell?

  • Kritik kesintilerde telefon aramasıyla eskalasyon; rutin kontroller ise standart veya zaman duyarlı push olarak kalır
  • Şablonlar ve değişkenler sayesinde her uyarıda etkilenen site, durum, yanıt kodu ve GitHub issue bağlantısı görünür
  • Ek altyapı yok — her Echobell kanalı için yalnızca güvenli bir webhook URL'si

Ön Koşullar

  • GitHub Actions etkinleştirilmiş, mevcut bir Upptime deposu
  • GitHub deposuna secret ekleme yetkisi
  • Webhook URL'si olan bir Echobell kanalı (uygulamada kanalı açın → webhook URL'sini kopyalayın)

Bir Echobell kanalı hazırlayın

  1. Echobell'de bir kanal oluşturun veya açın ve tercih ettiğiniz bildirim türünü seçin (standart, zaman duyarlı veya arama).
  2. Kanalın webhook URL'sini kopyalayın; şuna benzer: https://hook.echobell.one/t/<channel-token>.
  3. (İsteğe bağlı) Uyarılarınızın düzenli kalması için {{site}}, {{status}}, {{code}}, {{url}} ve {{issue}} gibi değişkenleri kullanan bir şablon tanımlayın.

Echobell için Upptime secret'larını ekleyin

Upptime deponuzda Settings → Secrets and variables → Actions yolunu izleyin ve şunları ekleyin:

  • NOTIFICATION_CUSTOM_WEBHOOK=true
  • NOTIFICATION_CUSTOM_WEBHOOK_URL=https://hook.echobell.one/t/<channel-token>?site=$SITE_NAME&status=$STATUS&url=$SITE_URL&issue=$ISSUE_URL&code=$RESPONSE_CODE&emoji=$EMOJI
  • (İsteğe bağlı) NOTIFICATIONS_DOWN_MESSAGE=$EMOJI $SITE_NAME is $STATUS ($RESPONSE_CODE) – $ISSUE_URL
  • (İsteğe bağlı) NOTIFICATIONS_UP_MESSAGE=$EMOJI $SITE_NAME is back up – $SITE_URL

Notlar:

  • Sorgu parametreleri yapılandırılmış veriyi Echobell'e taşır. Upptime değişkenleri ekler, Echobell de bunları şablon değişkeni olarak saklar (site, status, url, issue, code, emoji).
  • İsteğin bozulmaması için URL'yi kodlanmış tutun (metni özelleştirirseniz boşlukları %20 ile değiştirin).
  • Diğer bildirim sağlayıcıları veya stratejileri Upptime tarafında yönetilmeye devam eder — yalnızca Echobell için gerekenleri ekleyin, geri kalanını GitHub secrets arayüzünde bırakın.

Echobell'de değişkenleri eşleyin

Uyarıların okunabilir kalması için kısa ve öz bir şablon kullanın:

Title: {{emoji}} Upptime: {{site}} is {{status}}
Body: Response {{code}} · {{url}}
External link: {{issue}}

Yüksek öncelikli siteler için kanalın bildirim türünü "Zaman Duyarlı" veya "Arama" olarak değiştirip diğerlerini standart push olarak bırakabilirsiniz.

Entegrasyonu test edin

  • İzlenen bir URL'yi geçici olarak var olmayan bir uç noktaya yönlendirin ya da bir servisi duraklatarak hata oluşturun.
  • Uyarının, şablon alanları dolu biçimde Echobell'e ulaştığını doğrulayın.
  • Servisi geri getirin ve kurtarma mesajını doğrulayın.

Sorun Giderme

  • NOTIFICATION_CUSTOM_WEBHOOK ve NOTIFICATION_CUSTOM_WEBHOOK_URL adlarının secret listesindekiyle birebir aynı yazıldığından emin olun.
  • Echobell kanal token'ını değiştirirseniz secret'ı da güncelleyin.
  • Upptime tarafındaki hatalar veya ek sağlayıcılar için resmi dokümanlara ve GitHub Actions günlüklerinize bakın.