Application Real-Time Monitoring Service:Grafana uyarılarını entegre etme

1. Adım: Grafana entegrasyonu oluşturun

1. ARMS konsolu üzerinde oturum açın. Sol gezinme bölmesinde Alert Management > Integrations seçeneklerini seçin.

2. Alert Integration sekmesinde Grafana öğesine tıklayın.

3. New Grafana Integration iletişim kutusunda bir entegrasyon adı ve açıklaması girin, Grafana sürümünü seçin, uyarı olayları için otomatik çözümleme zaman aşımını ayarlayın ve Save butonuna tıklayın.

   Not

   Zaman aşımı sonrası otomatik kurtarma süresi: Belirtilen süre içinde bir uyarı olayı tekrar tetiklenmezse, uyarı olayı otomatik olarak temizlenir.

4. Alert Integration sekmesinde yeni Grafana entegrasyonunu bulun ve entegrasyon uç noktasını alın.

   Entegrasyon uç noktasının yanındaki Copy butonuna tıklayın.

2. Adım: Grafana uyarılarını yapılandırın

1. Grafana'nın sol gezinme bölmesinde > Notification Channels seçeneklerini seçin.

2. Notification Channels sekmesinde New channel butonuna tıklayın.

   Not

   İlk kez kanal oluşturuyorsanız Add channel butonuna tıklayın.

3. New Notification Channel sayfasında aşağıdaki adımları uygulayın.

   1. Name alanına özel bir Grafana uyarı adı girin.

   2. Type değerini webhook olarak ayarlayın.

   3. URL değerini 1. Adımda elde edilen entegrasyon uç noktasına ayarlayın.

   4. Notification settings bölümünde Default, Include image ve Send reminders seçeneklerini belirleyin. Send reminders seçeneğini belirlerseniz, aynı uyarı için bildirim sıklığını ayarlamanız gerekir. Bildirim sıklığı, 1. Adım bölümünde ayarladığınız otomatik çözümleme zaman aşımını aşamaz.

      Not

      Send reminders seçeneğini belirlemezseniz sistem her uyarı için yalnızca bir bildirim gönderir.

   5. ARMS Uyarı Yönetimi ile bağlantıyı doğrulamak için Test butonuna tıklayın.

   6. Test başarılı olduktan sonra Save butonuna tıklayın.

(İsteğe bağlı) 3. Adım: Entegrasyonu değiştirin

ARMS Uyarı Yönetimi, Grafana ve ARMS arasında varsayılan alan eşlemeleri sağlar. İhtiyaçlarınıza göre bu eşlemeleri Edit Integration sayfasında ekleyebilir veya değiştirebilirsiniz.

Aşağıdaki komut dosyası örnek bir uyarı kaynağı sağlar:

{
    "@timestamp":"2021-09-09T12:25:09.556Z",
    "orgId":0,
    "host":"10.1.11.14",
    "ruleName":"Test notification",
    "ruleUrl":"http://localhost:8001/grafana/",
    "state":"alerting",
    "title":"[Alerting] Test notification",
    "panelId":1,
    "imageUrl":"https://grafana.com/assets/img/blog/mixed_styles.png",
    "evalMatches":[
        {
            "metric":"High value",
            "value":100,
            "tags":null
        },
        {
            "metric":"Higher Value",
            "value":200,
            "tags":null
        }
    ],
    "ruleId":0,
    "tags":{
    },
    "dashboardId":1,
    "message":"Someone is testing the alert notification within grafana.",
    "@version":"1"
}

1. Alert Integration sekmesinde yönetmek istediğiniz entegrasyonu bulun ve Edit butonunu Actions sütununda tıklayın.

2. Event Mapping bölümünde Send Test Data butonuna tıklayın.

3. Send Test Data iletişim kutusunda uyarı kaynağınızdan gelen JSON içeriğini girin ve Send butonuna tıklayın.

   Not

   • Uploaded. 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ştir. Gönderilen veriler sol taraftaki kutuda görüntülenir. Bu sayede eşlemeleri yapılandırırken kaynak alanlarını 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 kutusunun metin alanında @timestamp, orgId, host, ruleName, ruleUrl, state, title ve panelId gibi alanları içeren JSON formatında örnek bildirim verileri bulunur. İlgili isteği almak için Copy as cURL command seçeneğine tıklayabilirsiniz.

4. Send Test Data iletişim kutusunda Disable butonuna tıklayın.

5. Event Mapping bölümünün sol kısmında, ayrıntıları görüntülemek için eşleme yapılandırmak istediğiniz veri kayıtlarına tıklayın.

6. Event Mapping bölümünün sağ bölmesinde kaynak uyarı alanları ile ARMS uyarı alanları arasındaki eşlemeleri yapılandırın.

   1. Optional: Select Root Node bölümünde toplu işlem kullanılıp kullanılmayacağını belirtin.

      Uyarı verileri bir dizi içeriyorsa, dizinin öğelerini toplu olarak işlemek üzere kök düğüm olarak belirtebilirsiniz.

      Use Batch Processing seçeneğini belirledikten sonra, kök düğüm olarak işlenecek dizi düğümünü seçin.

      Not

      Toplu işlem için yalnızca bir dizi seçebilirsiniz.

      Örneğin, örnek uyarıda evalMatches dizisi iki value alanı içerir. Kök düğüm olarak evalMatches seçerseniz ARMS, bunun altındaki iki value alanını belirtilen aynı ARMS uyarı alanıyla eşler.

      • Kök düğüm seçerseniz, dizideki tüm öğeler için $.evalMatches[*].value özelliğinin değerlerini yinelemeli olarak ARMS value alanına eşleyebilirsiniz.

      • Kök düğüm seçmezseniz, dizideki belirli bir öğenin özellik değerini (örneğin $.evalMatches[0].value veya $.evalMatches[1].value) ARMS value alanına eşleyebilirsiniz.

   2. Map Source Fields to Target Fields bölümünde kaynak alanları hedef ARMS uyarı alanlarıyla eşleyin.

      Eşleme yöntemini değiştirmek için eşleme simgesine tıklayın.

      • Doğrudan: Kaynak alan doğrudan ilgili ARMS uyarı alanıyla eşlenir.

      • Seri: Birden çok kaynak alanı belirtilen bir ayırıcı kullanarak tek bir alanda birleştirir ve bu alanı bir ARMS uyarı alanıyla eşler. Ayırıcı olarak yalnızca özel karakterler kullanabilirsiniz.

        Örneğin, $.host ve $.title alanlarını alt çizgi (_) kullanarak $.host_$.title şeklinde birleştirebilir ve ardından bunu ARMS alertname alanıyla eşleyebilirsiniz.

      • Koşul: Uyarı alan değeri belirtilen bir koşulu karşıladığında bir alan eşlenir.

      • Eşleme tablosu: Uyarı kaynağının önem dereceleri ile ARMS arasındaki eşlemeyi yapılandırır. Bu eşleme yöntemi yalnızca severity alanı için gereklidir.

      Aşağıdaki tabloda ARMS uyarı alanları açıklanmaktadır.

      Uyarı alanı	Açıklama
      alertname	Özel uyarının adı.
      severity	Uyarının önem derecesi. Bu alan için eşlemeler 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, Uygulama Çökmesi ve Dağıtım.
      source	Uyarının kaynağı.
      class	Uyarı olayını tetikleyen nesnenin türü, örneğin ana bilgisayar.
      service	Uyarının kaynak hizmeti. Örnek: Oturum Açma Hizmeti.
      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.

      Event Mapping sayfasında veri alımını doğrulamak için Send Test Data butonuna tıklayın. Latest 10 Data Entries bölümü alınan kaynak verilerini ve durumlarını gösterir. Bir veri girişini genişleterek @timestamp, orgId, host ve ruleName gibi alanları içeren JSON yapısını görüntüleyebilirsiniz. Sağ bölmede bu kaynak alanları ilgili ARMS uyarı alanlarıyla eşleyebilirsiniz.

7. Uyarı olayları için alan yinelenmesini yapılandırın.

   Yinelenen verileri azaltmak için sistem ilgili alanları yinelenme ölçütü olarak kullanır. ARMS Uyarı Yönetimi, Event Mapping alanında geçmiş olay verilerinin yinelenme gruplama sonuçlarını önizlemenize olanak tanır. Yinelenme alanlarını gerektiği gibi ayarlayabilirsiniz.

   Not

   Olay yinelenmesi yalnızca çözülmemiş olaylar için geçerlidir.

   1. Event Deduplication bölümünde Edit Integration sayfasında yinelenme için kullanılacak alanları seçin.

      Birden çok olay seçilen alanlar için aynı değerlere sahip olduğunda bunlar tek bir uyarıda birleştirilir.

      Örneğin, ARMS metric ve ruleName alanlarını yinelenme anahtarı olarak ayarlarsanız, aynı metriğe ve kural adına sahip Grafana kaynağından gelen olaylar tek bir olayda birleştirilir. Farklı değerlere sahip olaylar ayrı kalır.

   2. Deduplication Test butonuna tıklayarak yinelenmeden sonraki uyarı gruplamalarını önizleyin.

      Not

      Yinelenme testi, Event Mapping bölümünün sol bölmesine yüklenen son 10 test veri girişi üzerinde çalışır.

      Yinelenme alanları olarak metric ve ruleName seçeneklerini belirleyin ve Deduplication Test butonuna tıklayın. Sistem olayları seçilen alanlara göre gruplar. Aynı metriğe ve kural adına sahip olaylar birlikte gruplanır. Gruplama sonuçları alertname, value, severity, startat, endat ve message gibi sütunları içeren bir tabloda görüntülenir.

8. Yapılandırmayı tamamladıktan sonra Save butonuna tıklayın.

Bir uyarı olayının ayrıntılarını görüntüleyin

1. ARMS konsolunun sol gezinme bölmesinde Alert Management > Alert Event History seçeneklerini seçin.

2. 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önetin

Sol gezinme bölmesinde Alert Management > Integrations seçeneklerini seçin. Alert Integration sekmesinde oluşturduğunuz entegrasyonlar üzerinde aşağıdaki işlemleri gerçekleştirebilirsiniz:

• Bir entegrasyonun ayrıntılarını görüntüleyin: Entegrasyonu bulup satıra tıklayın. Integration Details sayfasında entegrasyon ayrıntılarını görüntüleyin.

• Anahtarı güncelleyin: Bir entegrasyonun anahtarını değiştirmek için entegrasyonu bulun, More > Update Key seçeneklerini Actions sütununda belirleyin ve ardından görüntülenen iletişim kutusunda Confirm butonuna tıklayın.

  Önemli

  Anahtarı güncelledikten sonra URL değerini de 2. Adım bölümünde yeni entegrasyon uç noktasıyla güncellemeniz gerekir.

• Bir entegrasyonu değiştirin: Entegrasyonu bulun ve Edit butonunu Actions sütununda tıklayın. Integration Details sayfasında entegrasyon bilgilerini değiştirin ve ardından Save butonuna tıklayın.

• Bir entegrasyonu etkinleştirin veya devre dışı bırakın: Entegrasyonu bulun ve Disable veya Enable butonunu Actions sütununda tıklayın.

• Bir entegrasyonu silin: Entegrasyonu bulun ve Delete butonunu Actions sütununda tıklayın. Görüntülenen mesajda OK butonuna tıklayın.

• Bir entegrasyona olay işleme akışı ekleyin: Entegrasyonu bulun ve Add Event Processing Flow butonunu Actions sütununda tıklayın. Daha fazla bilgi için bkz. Olay işleme akışı.

• Bildirim ilkesi oluşturun: 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 butonuna 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.