Alarmları e-posta ve webhook ile gönderme

Bildirim kanalı, alarm kurallarının bildirimlerini gönderdiği bir e-posta adresi veya webhook URL’sidir. Kanallar bir projeye aittir ve projenin tüm kuralları bunları kullanabilir.

Başlamadan önceBağlantıyı kopyalayın

• Kanal eklemek, test etmek, yenilemek veya silmek için proje ya da projenin aboneliği üzerinde Sahip veya Katkıda bulunan rolüne ya da Observability için Yönet erişimi olan özel bir role ihtiyacınız vardır. Okuyucu rolünde olduğu gibi Oku erişimiyle kanalları görüntüleyebilirsiniz; webhook URL’leri şemaya ve ana bilgisayar adına kısaltılmış olarak gösterilir.
• Konsolda, alarmlarını göndermek istediğiniz projeyi seçin. Kanallar sayfası o projenin kanallarını gösterir.

Kanallar sayfasını açmaBağlantıyı kopyalayın

Bildirim kanalları sayfası her kanalı hedefi ve durumuyla listeler.

E-posta kanalı eklemeBağlantıyı kopyalayın

E-posta adresini doğrulamaBağlantıyı kopyalayın

Kuruluşunuzun etkin bir kullanıcısına ait bir adres, eklediğiniz anda doğrulanır. Diğer tüm adreslere bir onay e-postası gönderilir ve alıcı onaylayana kadar kanal alarm almaz.

Kanalın durumu, onayın hangi aşamada olduğunu gösterir:

Yeni bir bağlantı göndermek için kanalın Satır eylemleri menüsünü (⋯) açın ve Onayı yeniden gönder seçeneğini seçin. Yeni bağlantı öncekinin yerini alır.

Onaylanmamış bir adrese gidecek bildirimler bekletilmez, atlanır: adres onaylandıktan sonra bu bildirimleri almaz.

Webhook kanalı eklemeBağlantıyı kopyalayın

Webhook kanalı, eklediğiniz anda doğrulanır. URL’si şu kurallara uymalıdır:

• https:// kullanır ve en fazla 2.048 karakterdir.
• Kullanıcı adı veya parola içermez.
• Ana bilgisayar adı yalnızca genel IP adreslerine çözümlenir. Özel, geri döngü, bağlantı yerel ve genel olmayan diğer aralıklar reddedilir. Platform ana bilgisayar adını her gönderimde denetler; kanalı eklediğinizde de URL’ye yazılmış genel olmayan bir IP adresini reddeder.

Platform yönlendirmeleri izlemez.

Webhook isteklerini doğrulamaBağlantıyı kopyalayın

Platform her bildirimi, JSON gövdeli ve şu başlıkları içeren bir HTTPS POST isteği olarak gönderir:

İmza başlığında <timestamp>, Unix saniyesi cinsinden gönderim zamanıdır; <signature> ise <timestamp>.<body> değerinin, kanalın imza anahtarıyla hesaplanan onaltılık kodlanmış HMAC-SHA256 değeridir. Bir isteği doğrulamak için aynı HMAC değerini ham istek gövdesi üzerinden, alındığı şekliyle hesaplayın ve v1 ile karşılaştırın. Yeniden oynatılan istekleri reddetmek için zaman damgası seçtiğiniz bir tolerans süresinden eski olan istekleri de reddedin.

import hashlib
import hmac
import time

def verify(secret: str, header: str, body: bytes, tolerance: int = 300) -> bool:
    fields = dict(item.split("=", 1) for item in header.split(","))
    timestamp = int(fields["t"])
    expected = hmac.new(
        secret.encode(), f"{timestamp}.".encode() + body, hashlib.sha256
    ).hexdigest()
    fresh = abs(time.time() - timestamp) <= tolerance
    return fresh and hmac.compare_digest(expected, fields["v1"])

secret, whsec_ önekiyle birlikte imza anahtarının tamamıdır. header, X-Publiccloud-Signature başlığının değeridir; body ise ham istek gövdesidir.

Gövdede şu alanlar bulunur:

Bildirimler nasıl teslim edilirBağlantıyı kopyalayın

10 saniye içinde 2xx durum koduyla yanıt verin. Platform, toplam 15 saniyenin sonunda istekten vazgeçer.

Bir bildirim yeniden denenmeyi beklerken aynı kuralın aynı kanala giden sonraki bildirimleri onun arkasında bekler; böylece bildirimler sırayla ulaşır. E-posta aktarma sunucusu başarısız olduğunda e-postalar da aynı yeniden denemeleri izler.

E-posta bildirimleri. Varsayılan olarak konu satırı köşeli parantez içindeki yeni durumla ([FIRING] veya [RESOLVED]) başlar; ardından kural adı ve sanal makine gelir. Testte [TEST] bulunur. Bu etiketler çevrilmez; böylece gelen kutunuzu bunlara göre filtreleyebilirsiniz. Gövde; değişikliği, değeri, sanal makineyi, projeyi ve zamanı belirtir. E-postanın dili, kanal eklenirken kanalı ekleyen tarayıcının dil tercihine göre belirlenir; yedek dil İngilizcedir.

Test bildirimi göndermeBağlantıyı kopyalayın

Platform testi yeniden deneme olmadan hemen gönderir:

• Test bildirimi iletildi. Hedef testi kabul etti.
• Gönderilmedi: adres henüz onaylanmadı. Önce adresi onaylayın.
• Başarısız olursa mesaj nedeni belirtir. Bkz. Sorun giderme.

Kanal başına 60 saniyede bir test gönderebilirsiniz.

İmza anahtarını yenilemeBağlantıyı kopyalayın

Eski anahtar hemen imzalamayı bırakır; bu nedenle alıcınız yeni anahtarı alana kadar istekler alıcınızın denetiminden geçemez. Bir bütçenin oluşturduğu webhook kanalının anahtarını almak için anahtarı bütçenin Düzenle iletişim kutusunda yenileyin. Bkz. Bütçeyi düzenleme veya silme.

Kanalı silmeBağlantıyı kopyalayın

Kanalı listeleyen her kural bu kanala bildirim göndermeyi bırakır ve kanalın adresi veya URL’si silinir. Silinen bir kanalı geri yükleyemezsiniz.

Bir bütçe tarafından yönetiliyor olarak işaretlenmiş bir kanal bir bütçenin alarm alıcısını izler ve burada silinemez. Bunun yerine bütçeyi değiştirin. Bkz. Bütçeler ve eşik alarmları oluşturma.

SonuçBağlantıyı kopyalayın

Kanal listede görünür. Durumu Doğrulandı olduğunda kanal, onu listeleyen her kuralın bildirimlerini alır. Bir kurala kanal eklemek için bkz. Alarm kuralları oluşturma.

LimitlerBağlantıyı kopyalayın

Sorun gidermeBağlantıyı kopyalayın

Bir test başarısız olduğunda mesaj şu nedenlerden birini belirtir:

İlgili içerikBağlantıyı kopyalayın

• Alarm kuralları oluşturma
• Monitoring & Alerts nedir?
• Bütçeler ve eşik alarmları oluşturma
• Kanalları REST API üzerinden yönetmek için bkz. POST/scopes/{scopeId}/observability/notification-channels.