Xəbərdarlıqları e-poçt və webhook ilə göndərin

Bildiriş kanalı (notification channel) xəbərdarlıq qaydalarının (alert rule) bildirişlərini göndərdiyi e-poçt ünvanı və ya webhook URL-idir. Kanallar layihəyə (project) aiddir və layihənin hər qaydası onlardan istifadə edə bilər.

Başlamazdan əvvəlKeçidi kopyalayın

• Kanalları əlavə etmək, sınamaq, rotasiya etmək və ya silmək üçün layihədə və ya onun abunəliyində (subscription) Owner və ya Contributor rolu, yaxud Observability üzrə Manage girişi olan fərdi rol (custom role) lazımdır. Read girişi ilə, məsələn, Reader rolu ilə kanallara baxa bilərsiniz; bu zaman webhook URL-ləri sxem və host hissəsinə qədər qısaldılır.
• Konsolda xəbərdarlıqlarını (alert) göndərmək istədiyiniz layihəni seçin. Kanallar səhifəsi həmin layihənin kanallarını göstərir.

Kanallar səhifəsini açınKeçidi kopyalayın

Notification channels səhifəsi hər kanalı təyinat yeri və statusu ilə sadalayır.

E-poçt kanalı əlavə edinKeçidi kopyalayın

E-poçt ünvanını təsdiqləyinKeçidi kopyalayın

Təşkilatınızın aktiv istifadəçisinə aid ünvan əlavə edildiyi anda təsdiqlənmiş sayılır. Hər hansı digər ünvana təsdiq məktubu göndərilir və qəbuledən ünvanı təsdiq edənə qədər kanal heç bir xəbərdarlıq almır.

Kanalın statusu onun hansı mərhələdə olduğunu göstərir:

Yeni keçid göndərmək üçün kanalın Row actions menyusunu (⋯) açın və Resend confirmation əməliyyatını seçin. Yeni keçid əvvəlkini əvəz edir.

Təsdiqlənməmiş ünvana gedən bildirişlər növbədə saxlanılmır, sadəcə göndərilmir: ünvan təsdiqləndikdən sonra onları almır.

Webhook kanalı əlavə edinKeçidi kopyalayın

Webhook kanalı əlavə edildiyi anda təsdiqlənmiş sayılır. Onun URL-i bu qaydalara cavab verməlidir:

• https:// sxemindən istifadə edir və uzunluğu ən çox 2.048 simvoldur.
• İstifadəçi adı və ya parol ehtiva etmir.
• Onun hostu yalnız ictimai IP ünvanlarına çevrilir. Özəl, loopback, link-local və digər qeyri-ictimai diapazonlar rədd edilir. Platforma hostu hər göndərişdə yoxlayır və kanalı əlavə etdiyiniz zaman URL-də yazılmış qeyri-ictimai IP ünvanını rədd edir.

Platforma yönləndirmələri izləmir.

Webhook sorğularını yoxlayınKeçidi kopyalayın

Platforma hər bildirişi JSON gövdəsi və bu başlıqlarla HTTPS POST sorğusu kimi göndərir:

İmza başlığında <timestamp> Unix saniyələri ilə göndərilmə vaxtı, <signature> isə kanalın imzalama sirri açar kimi istifadə olunmaqla <timestamp>.<body> üzərində hesablanmış, onaltılıq kodlaşdırılmış HMAC-SHA256 dəyəridir. Sorğunu yoxlamaq üçün eyni HMAC dəyərini sorğunun alındığı kimi xam gövdəsi üzərində hesablayın və onu v1 ilə müqayisə edin. Təkrar göndərilmiş sorğuları rədd etmək üçün vaxt göstəricisi seçdiyiniz icazə verilən fərqdən köhnə olan sorğuları da rədd edin.

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 imzalama sirrinin whsec_ prefiksi də daxil olmaqla tam dəyəridir. header X-Publiccloud-Signature başlığının dəyəri, body isə sorğunun xam gövdəsidir.

Gövdədə bu sahələr var:

Bildirişlər necə çatdırılırKeçidi kopyalayın

10 saniyə ərzində 2xx status kodu ilə cavab verin. Platforma cəmi 15 saniyədən sonra sorğudan imtina edir.

Bildiriş təkrar cəhdi gözlədiyi müddətdə eyni qaydanın eyni kanala sonrakı bildirişləri onun arxasında gözləyir, buna görə onlar sıra ilə çatır. Poçt relesi uğursuz olduqda e-poçtlar da eyni təkrar cəhdlərlə göndərilir.

E-poçt bildirişləri. Standart olaraq mövzu kvadrat mötərizədəki yeni vəziyyətdən, [FIRING] və ya [RESOLVED], ardınca isə qaydanın adından və virtual maşından ibarət olur. Testdə [TEST] olur. Bu işarələr tərcümə olunmur, ona görə Daxilolanlar qovluğunuzu onlara görə süzgəcdən keçirə bilərsiniz. Məktubun mətni dəyişikliyi, dəyəri, virtual maşını, layihəni və vaxtı göstərir. Məktubun dili kanal əlavə edilərkən onu əlavə edən brauzerin dil seçiminə görə təyin olunur; ehtiyat dil ingilis dilidir.

Test bildirişi göndərinKeçidi kopyalayın

Platforma testi dərhal, təkrar cəhdlər olmadan göndərir:

• Test notification delivered. Təyinat yeri onu qəbul edib.
• Not sent: the address is not confirmed yet. Əvvəlcə ünvanı təsdiq edin.
• Uğursuzluq olduqda mesaj səbəbi göstərir. Nasazlığın həlli bölməsinə baxın.

Hər kanal üçün 60 saniyədə bir test göndərə bilərsiniz.

İmzalama sirrini rotasiya edinKeçidi kopyalayın

Köhnə sirr dərhal imzalamağı dayandırır, ona görə qəbuledicinizə yeni sirr verilənə qədər sorğular onun yoxlamasından keçmir. Büdcənin yaratdığı webhook kanalının sirrini almaq üçün onu büdcənin Edit dialoq pəncərəsində rotasiya edin. Büdcəni redaktə edin və ya silin bölməsinə baxın.

Kanalı silinKeçidi kopyalayın

Kanalı siyahısında saxlayan hər qayda ona bildiriş göndərməyi dayandırır və kanalın ünvanı və ya URL-i silinir. Silinmiş kanalı bərpa edə bilməzsiniz.

Managed by a budget nişanı ilə işarələnmiş kanal büdcənin xəbərdarlıq qəbuledənini izləyir və onu burada silə bilməzsiniz. Bunun əvəzinə büdcəni dəyişin. Büdcələr və hədd xəbərdarlıqları yaradın səhifəsinə baxın.

NəticəKeçidi kopyalayın

Kanal siyahıda görünür. Statusu Verified olduqdan sonra kanal onu siyahısında saxlayan hər qaydanın bildirişlərini alır. Kanalı qaydaya əlavə etmək üçün Xəbərdarlıq qaydaları yaradın səhifəsinə baxın.

LimitlərKeçidi kopyalayın

Nasazlığın həlliKeçidi kopyalayın

Test uğursuz olduqda mesaj bu səbəblərdən birini göstərir:

Əlaqəli məzmunKeçidi kopyalayın

• Xəbərdarlıq qaydaları yaradın
• Monitoring & Alerts nədir?
• Büdcələr və hədd xəbərdarlıqları yaradın
• Kanalları REST API vasitəsilə idarə etmək üçün POST/scopes/{scopeId}/observability/notification-channels səhifəsinə baxın.