Tüm Ürünler
Search

Bu Ürün

    Application Real-Time Monitoring Service:Zabbix Entegrasyonu

    Belge Merkezi

    Application Real-Time Monitoring Service:Zabbix Entegrasyonu

    Son Güncelleme:Oct 05, 2026

    Bu konuda, Zabbix'in Application Real-Time Monitoring Service (ARMS) uyarı yönetimi özelliği ile nasıl entegre edileceği açıklanmaktadır.

    Önkoşullar

    Yalnızca Zabbix 5.x sürümü desteklenir.

    Adım 1: Zabbix entegrasyonu oluşturma

    1. ARMS konsolu üzerinde oturum açın. Sol gezinme bölmesinde Alert Management > Integrations seçeneğini belirleyin.

    2. Alert Integration sekmesinde Zabbix seçeneğine tıklayın.

    3. Create Zabbix Integration sihirbazında entegrasyon için bir ad ve açıklama girin, otomatik kurtarma süresini belirtin ve Save seçeneğine 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 oluşturduğunuz Zabbix entegrasyonunu arayın ve entegrasyon URL'sini kopyalayın.

    Adım 2: Zabbix'i yapılandırma

    1. Zabbix'in dağıtıldığı sunucuda oturum açın ve Zabbix komut dosyası yolunu bulmak için aşağıdaki komutu çalıştırın:

      cat /etc/zabbix/zabbix_server.conf | grep alert

      Örnek yanıt:

      [root@localhost ~]# cat /etc/zabbix/zabbix_server.conf | grep alert
#       Number of pre-forked instances of alerters.
#       Full path to location of custom alert scripts.
# AlertScriptsPath=${datadir}/zabbix/alertscripts
AlertScriptsPath=/usr/lib/zabbix/alertscripts
[root@localhost ~]#

    2. Zabbix komut dosyası yoluna geçmek için cd komutunu çalıştırın.

    3. ARMS uyarı yönetimi yükleme paketini indirmek için aşağıdaki komutu çalıştırın.

      wget http://arms-public.oss-cn-shanghai.aliyuncs.com/alerts/aliyunalertmanager.tgz

    4. Yükleme paketinin içeriğini çıkarmak için aşağıdaki komutu çalıştırın.

      tar -xzvf aliyunalertmanager.tgz

    5. Yükleme paketinin bin dizinine gidin.

      cd aliyunalertmanager/bin

    6. ARMS uyarı yönetimini yüklemek için aşağıdaki komutu çalıştırın.

      sh install.sh <integration_url>

      <integration_url> ifadesini Adım 1 bölümünde aldığınız entegrasyon URL'si ile değiştirin.

    7. Kurulum sırasında istendiğinde Zabbix yönetim URL'sini, yönetici kullanıcı adını ve parolasını girin.

    (İsteğe bağlı) Adım 3: Entegrasyonu düzenleme

    ARMS uyarı yönetimi, Zabbix uyarı kaynağından ARMS uyarılarına yönelik varsayılan alan eşlemelerini içerir. İhtiyaçlarınıza göre Edit Integration sayfasında bu eşlemeleri ekleyebilir veya değiştirebilirsiniz.

    Örnek uyarı kaynağı:

    {
    "startat":"2021.09.09 20:13:57",
    "eventId":"16874-9756",
    "eventType":"trigger",
    "message":"/: Used space in Zabbix server value is 81 GB, triggered an alarm disk usage trigger",
    "hostname":"Zabbix server",
    "ip":"127.0.0.1",
    "severity":"Warning",
    "value":"81 GB",
    "metric":"vfs.fs.size[/,used]",
    "itemName":"/: Used space",
    "alertname":"disk usage trigger",
    "eventUrl":"http://127.0.0.1/zabbix/tr_events.php?triggerid=16874&eventid=9756"
}

    1. Alert Integration sekmesinde yönetmek istediğiniz entegrasyonu bulun ve Actions sütunundaki Edit seçeneğine tıklayın.

    2. Event Mapping bölümünde Send Test Data seçeneğine tıklayın.

    3. Send Test Data iletişim kutusunda üçüncü taraf bir uyarı kaynağının uyarı içeriğini JSON biçiminde girin ve Send seçeneğine tıklayın.

      Not

      • Uploaded. No events are generated. Configure mappings based on the original data. iletisi görüntülenirse uyarı kaynağının alanları ARMS uyarı olaylarının alanlarıyla eşleştirilmemiştir. Gönderilen veriler sol taraftaki kutuda gösterilir. Bu sayede eşlemeleri yapılandırırken kaynak alanları seçebilirsiniz.

      • Uploaded. iletisi görüntülenirse 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.

    4. Send Test Data iletişim kutusunda Disable seçeneğine tıklayın.

    5. 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.

    6. Event Mapping bölümünün sağ bölmesinde kaynak alanları ARMS uyarı alanlarıyla eşleştirin.

      1. İ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 belirledikten sonra toplu işlenecek dizi düğümünü kök düğüm olarak seçin.

        Not

        Uyarı verilerinde birden fazla dizi düğümü varsa toplu işlem için yalnızca bir dizi düğümü seçebilirsiniz.

      2. Map Source Fields to Target Fields bölümünde uyarı kaynağının alanlarını ARMS uyarı alanlarıyla eşleştirin.

        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şleştirilir.

        • Seri: Birden fazla uyarı kaynağı alanını sınırlayıcılar kullanarak tek bir alanda birleştirebilir ve ardından bu alanı ARMS'in belirtilen uyarı alanıyla eşleştirebilirsiniz. Sınırlayıcı olarak yalnızca özel karakterler kullanılabilir.

        • Koşullu: Belirtilen uyarı kaynağı alanları, alan değerleri belirtilen koşulları karşıladığında ARMS uyarı alanlarıyla eşleştirilir.

        • Eşleme tablosu: Uyarı kaynağı önem düzeyi ARMS uyarı önem düzeyiyle eşleştirilir. Eşleme tablosu yalnızca önem düzeyi alanını içerir.

        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 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ğinin URL'si. URL, çizgi grafiğini eşlemek için kullanılır.


        check


        Uyarının denetim öğ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.

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

      Yinelenen verileri azaltmak amacıyla sistem ilgili alanları yinelenme temeli olarak kullanır. ARMS Uyarı Yönetimi, Event Mapping bölümünde görüntülenen geçmiş olay verilerinin yinelenme gruplama sonuçlarını önizlemenize olanak tanır. Yinelenen alanları değiştirebilirsiniz.

      Not

      Yinelenmeyi yalnızca temizlenmemiş olaylar için yapılandırabilirsiniz.

      1. Integration Details sayfasındaki Event Deduplication 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.

      2. Yinelenme sonrasında uyarı grubunu önizlemek için Deduplication Test seçeneğine tıklayın.

        Not

        Yinelenme testi, Event Mapping bölümünün sol kısmında yüklenen son 10 veri kaydı üzerinde etkili olur.

    8. Ayarları yaptıktan sonra Save seçeneğine tıklayın.

    Entegrasyonu doğrulama

    ARMS uyarı yönetimini Zabbix'e yükledikten sonra yükleyici otomatik olarak bir kullanıcı, kullanıcı grubu, medya türü ve eylem oluşturur. Bu sayede Zabbix'de oluşturulan yeni uyarı olayları otomatik olarak ARMS uyarı yönetimine bildirilir.

    Not

    Entegrasyon, kurulumdan önce Zabbix'de oluşturulan uyarı olaylarını bildirmez.

    ARMS uyarı yönetiminin başarıyla yüklendiğini doğrulamak için aşağıdaki adımları uygulayın.

    1. Zabbix konsolunda oturum açın.

    2. Üst menü çubuğunda Manage > Users seçeneğini belirleyin.

      Users sayfasında Aliyun Alert User kullanıcısının oluşturulduğunu, kullanıcı türünün Zabbix Super Admin, kullanıcı grubunun Aliyun Alert Group ve durumun Enabled olduğunu doğrulayın.

    3. Üst menü çubuğunda Manage > User groups seçeneğini belirleyin.

      User groups sayfasında Aliyun Alert Group adlı bir kullanıcı grubunun var olduğunu, üyesi olarak Aliyun Alert User kullanıcısını içerdiğini ve durumunun Enabled olduğunu doğrulayın.

    4. Üst menü çubuğunda Manage > Media types seçeneğini belirleyin.

      Media types sayfasında Aliyun Alert Media adlı bir medya türünün var olduğunu, türünün Script, durumunun Enabled ve komut dosyası adının aliyunalertmanager/bin/alert.sh olduğunu doğrulayın.

    5. Üst menü çubuğunda Configurations > Action seçeneğini belirleyin.

      Action sayfasında Aliyun Alert Action adlı bir eylemin oluşturulduğunu, durumunun Enabled ve işleminin tüm medyalar aracılığıyla Aliyun Alert User kullanıcısına mesaj gönderdiğini doğrulayın.

      Not

      İhtiyaçlarınıza göre Aliyun Alert Action eyleminde bildirilen uyarı içeriğini özelleştirebilirsiniz.

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

    1. ARMS konsolunun sol gezinme bölmesinde Alert Management > Alert Event History seçeneğini belirleyin.

    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.

    Entegrasyonları yönetme

    Sol gezinme bölmesinde Alert Management > Integrations seçeneğini belirleyin. Alert Integration sekmesinde oluşturduğunuz entegrasyonlarda aşağıdaki işlemleri gerçekleştirebilirsiniz:

    • Bir entegrasyonun ayrıntılarını görüntüleme: Entegrasyonu bulun ve ardından 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ı güncellemek için entegrasyonu bulun, Actions sütununda More > Update Key seçeneğini belirleyin ve ardından görüntülenen iletişim kutusunda Confirm seçeneğine tıklayın.

      Önemli

      Anahtarı güncelledikten sonra Adım 2 bölümündeki talimatları izleyerek ARMS uyarı yönetimini yeniden yüklemeniz gerekir.

    • Bir entegrasyonu değiştirme: Entegrasyonu bulun ve ardından Actions sütunundaki Edit seçeneğine tıklayın. Integration Details sayfasında entegrasyon bilgilerini değiştirin ve ardından Save seçeneğine tıklayın.

    • Bir entegrasyonu etkinleştirme veya devre dışı bırakma: Entegrasyonu bulun ve ardından Actions sütunundaki Disable veya Enable seçeneğine tıklayın.

    • Bir entegrasyonu silme: Entegrasyonu bulun ve ardından Actions sütunundaki Delete seçeneğine tıklayın. Görüntülenen mesajda OK seçeneğine tıklayın.

    • Bir entegrasyona olay işleme akışı ekleme: Entegrasyonu bulun ve Actions sütunundaki Add Event Processing Flow seçeneğine 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.