Bu konu, Simple Log Service uyarılarının Application Real-Time Monitoring Service (ARMS) içindeki Alert Management ile nasıl entegre edileceğini açıklar.
Arka Plan
Alert Management, webhooks kullanarak Simple Log Service ile entegre olur ve uyarıları merkezi olarak yönetmenizi sağlar.
Simple Log Service'i Alert Management ile iki yöntemden biriyle entegre edebilirsiniz:
Yöntem 1 (Eski): Simple Log Service'teki belirli bir projeden gelen tüm uyarıları Alert Management'a entegre edin. Daha fazla bilgi için bkz. Entegrasyon oluşturma ve Simple Log Service'e bağlanma.
Yöntem 2 (Önerilen): Simple Log Service'ten gelen belirli uyarıları Alert Management'a entegre edin. Daha fazla bilgi için bkz. Entegrasyon oluşturma ve Simple Log Service'e bağlanma ve Simple Log Service'ten belirli uyarı kurallarını entegre etme.
Simple Log Service entegrasyonu oluşturun
ARMS konsolu üzerinde oturum açın. Sol gezinme bölmesinde seçeneğini belirleyin.
Integrations sayfasında Alert Integration sekmesini tıklayın ve ardından Log Service öğesini seçin.
-
Açılan iletişim kutusunda entegrasyon için bir ad ve açıklama girin, ayrıca uyarı olayları için otomatik kurtarma zaman aşımını belirtin.
NotZaman aşımı sonrası otomatik kurtarma süresi: Belirtilen süre içinde bir uyarı olayı tekrar tetiklenmezse uyarı olayı otomatik olarak temizlenir.
-
Projects Enabling Alert Events bölümünde All Projects altında tüm Simple Log Service projeleriniz listelenir. Uyarılarını entegre etmek istediğiniz projeleri seçin,
simgesini tıklayın ve ardından Save düğmesine basın.NotBu özellik, seçilen projelerde yapılandırılmış tüm uyarı kurallarını otomatik olarak tarar ve uyarılar için istek URL'sini
https://alerts.aliyuncs.com/api/v1/events/{{token}}olarak ekler.{{token}}değişkeni, entegrasyon oluşturulduğunda otomatik olarak üretilen bir anahtardır.Yapılandırma tamamlandıktan sonra oluşturulan Simple Log Service entegrasyonunu Alert Integration sekmesinde görüntüleyebilirsiniz. Entegrasyon listesinde Simple Log Service Integration adlı bir kayıt görünür. Durumu Enabled, etkinliği ise Ready olarak gösterilir. Entegrasyon adresinin yanındaki Copy düğmesine basarak entegrasyon anahtar adresini kopyalayabilirsiniz. Actions sütununda Edit, Delete ve Disable gibi işlemler desteklenir.
Belirli Simple Log Service uyarı kurallarını entegre edin
Belirli uyarı kurallarını entegre etmek için mevcut bir Simple Log Service entegrasyonu gerekir.
Integrations sayfasında Alert Integration sekmesi altında hedef Simple Log Service entegrasyonunun entegrasyon URL'sini kopyalayın.
Simple Log Service konsolu üzerinde oturum açın.
Project alanında hedef projeyi tıklayın. Sol gezinme bölmesinde uyarı simgesini
seçin.Alert Center sayfasında yolunu izleyin. Webhook Integration sayfasında Create düğmesine tıklayın.
Açılan iletişim kutusunda adı ARMS Alert Management olarak ayarlayıp tür olarak General Webhook seçerek ve arayüzde istenen diğer parametreleri yapılandırarak ARMS Alert Management için genel webhook'u ekleyin.
-
Alert Center sayfasında yolunu takip edin. Hedef şablonun Actions sütununda Modify düğmesine tıklayın. Açılan iletişim kutusunda WebHook-Custom sekmesine gidin, mesaj içeriğini yapılandırın ve ardından Confirm düğmesine basın.
{ "uid": "{{ alert.aliuid }}", "project": "{{ alert.project }}(https://sls.console.alibabacloud.com/#/project/{{ alert.project }}/categoryList)", "trigger": "{{ alert.alert_name }}", "condition": "{{ alert.condition }}", "context": {{ alert.results[0].raw_results | to_json | quote }}, "message": " [Uid] {{ alert.aliuid }}\n\n> [Project] [{{ alert.project }}](https://sls.console.alibabacloud.com/#/project/{{alert.project }}/categoryList)\n\n> [Trigger] {{ alert.alert_name }}\n\n> [Condition] {{ alert.alert_name }}\n\n> [Message] Notification content\n\n> [Context] {{ alert.results[0].raw_results | to_json | quote | removeprefix('"') | removesuffix('"') }}\n\n> [View details]({{ alert.query_url }})" } Alert Center sayfasında Alert rules sekmesine gidin. Hedef kuralın Actions sütununda Edit düğmesine tıklayın. Açılan iletişim kutusunda Advanced Settings bölümünü genişletin. Output Target bölümünde SLS Notification seçeneğini belirleyin. Alert Policy bölümünde Simple Mode seçeneğini işaretleyin. Genel webhook için bildirim kanalını arayüzde istendiği gibi yapılandırın ve ardından OK düğmesine tıklayın.
Entegrasyonu düzenleyin
Alert Management, Simple Log Service uyarı kaynağı ile Alert Management arasında önceden tanımlanmış alan eşlemeleri sunar. İhtiyaçlarınıza göre Edit Integration sayfasında alan eşlemelerini ekleyebilir veya değiştirebilirsiniz.
Alert Integration sekmesinde yönetmek istediğiniz entegrasyonu bulun ve Actions sütunundaki Edit düğmesine tıklayın.
Event Mapping bölümünde Send Test Data düğmesine tıklayın.
-
Send Test Data iletişim kutusunda üçüncü taraf bir uyarı kaynağının JSON formatındaki uyarı içeriğini girin ve Send düğmesine basın.
NotUploaded. No events are generated. Configure mappings based on the original data. iletisi görünüyorsa uyarı kaynağının alanları ARMS uyarı olaylarının alanlarıyla eşlenmemiş demektir. Gönderilen veriler sol taraftaki kutuda görüntülenir. Bu sayede eşlemeleri yapılandırırken kaynak alanları seçebilirsiniz.
Uploaded. iletisi görünüyorsa uyarı içeriği Alert Event History sayfasına raporlanır. Daha fazla bilgi için bkz. Uyarı olayı geçmişini görüntüleme.
Send Test Data iletişim kutusunda Disable düğmesine tıklayın.
Event Mapping bölümünün sol kısmında eşleme yapılandırmak istediğiniz veri kayıtlarına tıklayarak ayrıntıları görüntüleyin.
-
Event Mapping bölümünün sağ kısmında uyarı kaynağı ile ARMS arasında alan eşlemelerini yapılandırın.
-
İsteğe bağlı: Select Root Node bölümünde toplu işlemeyi etkinleştirip etkinleştirmeyeceğinizi belirtin.
Uyarı verilerinde bir dizi düğümü varsa dizi düğümünü kök düğüm olarak belirtebilirsiniz. Kök düğüme ait veriler toplu olarak işlenir.
Use Batch Processing seçeneğini işaretledikten sonra toplu işlenecek dizi düğümünü kök düğüm olarak seçin.
NotUyarı verilerinde birden fazla dizi düğümü varsa bunlardan yalnızca birini toplu işlem için seçebilirsiniz.
-
İsteğe bağlı: Configure Alert Recovery Events seçeneğini işaretleyin ve uyarıları temizlemek için alan koşullarını yapılandırın.
ARMS olayları aldıktan sonra belirtilen alan değerlerini içeren uyarıları arar ve bu uyarıları temizler. Uyarıları temizlemek için belirttiğiniz alan, olayda uyarı önem düzeyine eşdeğer bir alan olmalıdır. Uyarıları temizlemek için
$.severityalanını kullanamazsınız. Örneğin, uyarıları temizlemek için belirttiğiniz alan{$.eventType ="resolved"}ise sistem entegrasyonda eventType değeri resolved olan tüm uyarıları otomatik olarak temizler. -
Map Source Fields to Target Fields bölümünde uyarı kaynağının alanlarını ARMS'in uyarı alanlarıyla eşleyin.
Alan eşleme yöntemini değiştirmek için eşleme simgesine tıklayın.
Doğrudan: Uyarı kaynağının belirtilen alanı doğrudan ARMS'in belirtilen uyarı alanıyla eşlenir.
Seri: Birden fazla uyarı kaynağı alanını ayırıcılarla tek bir alanda birleştirip bu alanı ARMS'in belirtilen uyarı alanıyla eşleyebilirsiniz. Ayırıcı olarak yalnızca özel karakterler kullanılabilir.
Koşullu: Belirtilen uyarı kaynağı alanları, alan değerleri belirtilen koşulları karşıladığında yalnızca ARMS uyarı alanlarıyla eşlenir.
Eşleme tablosu: Uyarı kaynağı önem düzeyi ARMS uyarı önem düzeyiyle eşlenir. Eşleme tablosu yalnızca önem düzeyi alanını içerir.
Aşağıdaki tabloda ARMS'in uyarı alanları açıklanmaktadır.
Uyarı alanı
Açıklama
alertname
Özel uyarının adı.
severity
Uyarının önem düzeyi. Bu alan için eşlemeleri yapılandırmanız gerekir. Eşleme yöntemi Doğrudan olarak ayarlanmalıdır.
message
Uyarının açıklaması. Açıklama, uyarı mesajının içeriği olarak kullanılır. Açıklama 15.000 karakteri aşamaz.
value
Bir ölçümün örnek değeri.
imageUrl
Grafana ölçümlerini içeren çizgi grafiğin URL'si. URL, çizgi grafiği eşlemek için kullanılır.
check
Uyarının kontrol öğesi. Örnekler: CPU, JVM, Application Crash ve Deployment.
source
Uyarının kaynağı.
class
Uyarı olayını tetikleyen nesnenin türü, örneğin host.
service
Uyarının kaynak hizmeti. Örnek: Login Service.
startat
Olayın başlangıç zamanını temsil eden zaman damgası.
endat
Olayın bitiş zamanını temsil eden zaman damgası.
generatorUrl
Olay ayrıntılarının URL'si.
-
-
Uyarı olayları için alan yinelenmesini yapılandırın.
Yinelenen verileri azaltmak amacıyla sistem ilgili alanları yinelenme temeli olarak kullanır. ARMS Alert Management, Event Mapping bölümünde görüntülenen geçmiş olay verilerinin yinelenme gruplama sonuçlarını önizlemenize olanak tanır. Yinelenmesi gereken alanları değiştirebilirsiniz.
NotYinelenmeyi yalnızca temizlenmemiş olaylar için yapılandırabilirsiniz.
-
Event Deduplication sayfasındaki Integration Details bölümünde yinelenme için kullanılan alanları seçin.
Birden fazla olay belirtilen bir alan için aynı değere sahipse olaylar tek bir uyarı bildiriminde birleştirilir.
-
Yinelenme sonrasında uyarı grubunu önizlemek için Deduplication Test düğmesine tıklayın.
NotYinelenme testi, yalnızca Event Mapping bölümünün sol kısmında yüklenen en son 10 veri kaydı üzerinde etkili olur.
-
Ayarları yapılandırdıktan sonra Save düğmesine tıklayın.
Uyarı olayının ayrıntılarını görüntüleyin
ARMS konsolunun sol gezinme bölmesinde yolunu izleyin.
Alert Event History sayfasında olay ayrıntılarını görüntülemek için uyarı olayının adına tıklayın. Daha fazla bilgi için bkz. Uyarı olayı geçmişini görüntüleme.
Entegrasyona projeler ekleyin
Yeni projelerden gelen uyarıları mevcut bir Simple Log Service entegrasyonuna eklemek için aşağıdaki adımları uygulayın:
Integrations sayfasında hedef Simple Log Service entegrasyonunu bulun ve Actions sütununda yolunu izleyin.
Açılan iletişim kutusunda uyarı almak istediğiniz projeleri seçin,
simgesine tıklayın ve ardından Save düğmesine basın.
Entegrasyonları yönetin
Sol gezinme bölmesinde yolunu izleyin. Alert Integration sekmesinde oluşturduğunuz entegrasyonlarda aşağıdaki işlemleri gerçekleştirebilirsiniz:
Entegrasyonun ayrıntılarını görüntüleme: Entegrasyonu bulun ve satıra tıklayın. Integration Details sayfasında entegrasyon ayrıntılarını görüntüleyin.
-
Anahtarı güncelleme: Bir entegrasyonun anahtarını değiştirmek için hedef entegrasyonun Actions sütununda seçeneğini belirleyin ve açılan iletişim kutusunda Confirm düğmesine tıklayın.
ÖnemliAnahtarı güncelledikten sonra Simple Log Service için proje uyarısını yeniden ekleyin. Daha fazla bilgi için bkz. Ürün ekleme.
Entegrasyonu değiştirme: Entegrasyonu bulun ve Actions sütunundaki Edit düğmesine tıklayın. Integration Details sayfasında entegrasyon bilgilerini değiştirin ve ardından Save düğmesine basın.
Entegrasyonu etkinleştirme veya devre dışı bırakma: Entegrasyonu bulun ve Actions sütunundaki Disable veya Enable düğmesine tıklayın.
Entegrasyonu silme: Entegrasyonu bulun ve Actions sütunundaki Delete düğmesine tıklayın. Görünen ileti de OK düğmesine basın.
Entegrasyona olay işleme akışı ekleme: Entegrasyonu bulun ve Actions sütunundaki Add Event Processing Flow düğmesine tıklayın. Daha fazla bilgi için bkz. Olay işleme akışı.
Bildirim ilkesi oluşturma: Bildirim ilkesi oluşturmak istediğiniz entegrasyonu bulun ve Actions sütununda More seçeneğine tıklayın. Görünen listede Create Notification Policy öğesine tıklayın. Daha fazla bilgi için bkz. Bildirim ilkeleri.
Sonraki adımlar
Bir bildirim ilkesi oluşturduktan sonra sistem, oluşturduğunuz bildirim ilkesine göre raporlanan uyarı olayları için uyarılar üretir ve uyarı bildirimleri gönderir. Daha fazla bilgi için bkz. Bildirim ilkeleri. Alert Sending History sayfasında yapılandırılan bildirim ilkesine göre üretilen uyarıları görüntüleyebilirsiniz. Daha fazla bilgi için bkz. Uyarı gönderme geçmişini görüntüleme.