Bu konu, Open-Falcon'ın Uyarı Yönetimi ile nasıl entegre edileceğini açıklar.
Adım 1: Open-Falcon entegrasyonu oluşturma
ARMS konsolu oturum açın. Sol gezinme bölmesinde seçeneğini belirleyin.
Alert Integration sekmesinde OpenFalcon öğesine tıklayın.
-
New OpenFalcon Integration sayfasında entegrasyon adını, açıklamasını ve otomatik kurtarma süresini girin, ardından Save düğmesine tıklayın.
NotZaman aşımı sonrası otomatik kurtarma süresi: Belirtilen süre içinde bir uyarı olayı tekrar tetiklenmezse uyarı olayı otomatik olarak temizlenir.
Alert Integration sekmesinde arama kutusunu kullanarak oluşturduğunuz Open-Falcon entegrasyonunu bulun ve entegrasyon adresini kopyalayın.
Adım 2: Open-Falcon uyarı şablonu yapılandırma
Open-Falcon'ı yükleyip açın. Eklentiyi Open-Falcon resmi web sitesinden indirip yükleyebilirsiniz.
Üst gezinme çubuğunda Templates öğesine tıklayın.
Templates sayfasının sağ üst köşesinde yeni uyarı şablonu için bir ad girin ve + simgesine tıklayın.
Şablon Yapılandırma sayfasında Policies in the Template bölümünde bir uyarı kuralı oluşturun. Daha fazla bilgi için Open-Falcon belgelerine bakın.
Şablon yapılandırma sayfasında callback address parametresini Adım 1 bölümünde elde ettiğiniz entegrasyon adresine ayarlayın ve ardından Save düğmesine tıklayın.
(İsteğe bağlı) Adım 3: Entegrasyonu değiştirme
Uyarı Yönetimi, Open-Falcon uyarı kaynağı ile ARMS arasında önceden tanımlanmış alan eşlemeleri sağlar. İhtiyaçlarınıza göre Edit Integration sayfasında alan eşlemelerini ekleyebilir veya değiştirebilirsiniz.
Örnek uyarı kaynağı:
{
"name":"cpu alert",
"endpoint":"test-host",
"metric":"cpu.user",
"status":"PROBLEM",
"step":"1",
"priority":2,
"time":"2021-09-08 09:25:00",
"tpl_id":1,
"exp_id":2,
"stra_id":1,
"tags":""
}
Alert Integration sekmesinde yönetmek istediğiniz entegrasyonu bulun ve Edit seçeneğini Actions sütununda tıklayın.
Event Mapping bölümünde Send Test Data seçeneğine tıklayın.
-
Send Test Data iletişim kutusunda üçüncü taraf uyarı kaynağının uyarı içeriğini JSON biçiminde girin ve Send düğmesine tıklayın.
NotUploaded. No events are generated. Configure mappings based on the original data. mesajı görünürse 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. mesajı görünürse uyarı içeriği Uyarı Olay Geçmişi sayfasına bildirilir. Daha fazla bilgi için bkz. Uyarı olay geçmişini görüntüleme.
Send Test Data iletişim kutusunda Disable seçeneğine 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ğı alanlarını ARMS uyarı alanlarıyla eşleyin.
-
İsteğe bağlı:Select Root Node bölümünde toplu işlemenin etkinleştirilip etkinleştirilmeyeceğini 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 parametresini seçtikten sonra toplu işlenecek dizi düğümünü kök düğüm olarak seçin.
NotUyarı verilerinde birden çok dizi düğümü varsa toplu işlem için yalnızca bu dizi düğümlerinden birini seçebilirsiniz.
-
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: Uyarı kaynağının birden çok alanını ayırıcılar kullanarak tek bir alanda birleştirebilir ve ardından 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 derecesi ARMS uyarı önem derecesiyle eşlenir. Eşleme tablosu yalnızca önem derecesi 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şleme 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ğini 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 yinelenen verileri kaldırma işlemini yapılandırın.
Sistem yinelenen verileri azaltmak için ilgili alanları yinelenen verileri kaldırma temeli olarak kullanır. ARMS Uyarı Yönetimi, Event Mapping bölümünde görüntülenen geçmiş olay verilerinin yinelenen verileri kaldırma gruplama sonuçlarını önizlemenize olanak tanır. Yinelenen verilerin kaldırılacağı alanları değiştirebilirsiniz.
NotYinelenen verileri kaldırmayı yalnızca temizlenmemiş olaylar için yapılandırabilirsiniz.
-
Event Deduplication bölümündeki Integration Details sayfasında yinelenen verilerin kaldırılması için kullanılan alanları seçin.
Birden çok olay belirtilen bir alan için aynı değere sahipse olaylar tek bir uyarı bildiriminde birleştirilir.
-
Deduplication Test seçeneğine tıklayarak yinelenen veriler kaldırıldıktan sonraki uyarı grubunu önizleyin.
NotYinelenen verileri kaldırma testi yalnızca Event Mapping bölümünün sol kısmında yüklenen son 10 veri kaydında etkili olur.
-
Ayarları yapılandırdıktan sonra Save seçeneğine tıklayın.
Uyarı olayının ayrıntılarını görüntüleme
ARMS konsolunun sol gezinme bölmesinde seçeneğini belirleyin.
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.
Entegrasyonu yönetme
Sol gezinme bölmesinde seçeneğini belirleyin. Alert Integration sekmesinde oluşturduğunuz entegrasyonlarda aşağıdaki işlemleri yapabilirsiniz:
Entegrasyonun ayrıntılarını görüntüleme: Entegrasyonu bulup satıra tıklayın. Integration Details sayfasında entegrasyon ayrıntılarını görüntüleyin.
-
Anahtarı güncelleme: Hedef entegrasyonu bulun ve seçeneğini Actions sütununda belirleyin. Onay iletişim kutusunda Confirm seçeneğine tıklayın.
ÖnemliAnahtarı güncelledikten sonra callback address parametresini Adım 2: Open-Falcon uyarı şablonu yapılandırma bölümünde açıklandığı gibi uyarı şablonunda da güncellemeniz gerekir.
Entegrasyonu değiştirme: Entegrasyonu bulun ve Edit seçeneğini Actions sütununda tıklayın. Integration Details sayfasında entegrasyon bilgilerini değiştirin ve ardından Save seçeneğine tıklayın.
Entegrasyonu etkinleştirme veya devre dışı bırakma: Entegrasyonu bulun ve Disable veya Enable seçeneğini Actions sütununda tıklayın.
Entegrasyonu silme: Entegrasyonu bulun ve Delete seçeneğini Actions sütununda tıklayın. Görüntülenen mesajda OK seçeneğine tıklayın.
Entegrasyona olay işleme akışı ekleme: Entegrasyonu bulun ve Add Event Processing Flow seçeneğini Actions sütununda 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üntülenen listede Create Notification Policy seçeneğine 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 bildirilen uyarı olayları için uyarılar oluşturur 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 oluşturulan uyarıları görüntüleyebilirsiniz. Daha fazla bilgi için bkz. Uyarı gönderme geçmişini görüntüleme.