How to integrate self-managed Prometheus alerts into ARMS Alert Management - Application Real-Time Monitoring Service

Arka plan bilgileri

Açık kaynaklı Prometheus, uyarıları Alertmanager'a bildirir. Uyarıları ARMS Alert Management'a göndermek için Prometheus.yaml dosyasındaki <alertmanager_config> bölümünü yapılandırın. Yapılandırma referansı için bkz. [[alertmanager_config]](https://prometheus.io/docs/prometheus/latest/configuration/configuration/#alertmanager_config).

ARMS Alert Management, açık kaynaklı Prometheus için Alertmanager uyumlu bir uç nokta sağlar. Bir Prometheus entegrasyonu oluşturduğunuzda, ARMS Alert Management Prometheus örneğinizin uyarı göndermesi için kullanacağı bir entegrasyon adresi ve bearer belirteci oluşturur.

Ön koşullar

ARMS konsoluna erişim. Entegrasyonu oluşturduktan sonra kimlik doğrulama için gerekli olan bearer belirtecini entegrasyon ayarları sayfasından alırsınız.
Prometheus-Operator yöntemi için: Kubernetes kümenize erişimi yapılandırılmış ve yüklü kubectl aracına sahip olmanız gerekir.
Diğer kendi yönettiğiniz Prometheus örnekleri için: Prometheus ana bilgisayarınızdaki prometheus.yaml yapılandırma dosyasına yazma erişiminiz olması gerekir.

Adım 1: Entegrasyon oluşturun ve kendi yönettiğiniz bir Prometheus örneğini bağlayın

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

Alert Integration

sekmesinde

Prometheus

öğesini tıklayın.

New Prometheus Integration iletişim kutusunda Prometheus entegrasyonunun adını ve açıklamasını ile uyarı olaylarının otomatik kurtarma süresini girin ve ardından Save öğesini tıklayın.Prometheus instances managed by Prometheus-OperatorOther Self-managed Prometheus InstancesOK

Not
Zaman aşımı sonrası otomatik kurtarma süresi: Belirtilen süre içinde bir uyarı olayı tekrar tetiklenmezse uyarı olayı otomatik olarak temizlenir.
1. Prometheus dağıtımınıza göre bağlantı yöntemini seçin. Prometheus'unuz Prometheus-Operator aracılığıyla dağıtıldıysa
seçeneğini belirleyin. Aksi takdirde

seçeneğini belirleyin. Ardından

düğmesini tıklayın.

Prometheus instances managed by Prometheus-Operator

Yerel makinenizde arms-alertmanager-config.yaml dosyasını oluşturun ve aşağıdaki içeriği dosyaya yapıştırın.

- scheme: https
  bearer_token: ******
  static_configs:
    - targets: ['alerts.aliyuncs.com']

Not

Entegrasyon oluşturulduktan sonra bearer_token değerini ARMS konsolundan alın. ****** ifadesini gerçek belirteçle değiştirin.

arms-am-config adlı bir gizli dizi (secret) oluşturmak için arms-alertmanager-config.yaml dosyasını kullanın.

kubectl create secret generic arms-am-config --from-file=arms-alertmanager-config.yaml

Yerel makinenizde prometheus-patch.yaml dosyasını oluşturun ve aşağıdaki içeriği dosyaya yapıştırın.

spec:
  additionalAlertManagerConfigs:
    key: arms-alertmanager-config.yaml
    name: arms-am-config

Prometheus nesnesini almak için aşağıdaki komutu çalıştırın.

kubectl get prometheus

Örnek yanıt:

NAME                                                VERSION   REPLICAS   AGE
prometheus-operator-160879-prometheus               v2.18.2   1          4d1h

prometheus-patch.yaml dosyasını Prometheus nesnesine uygulamak için aşağıdaki komutu çalıştırın. prometheus-operator-160879-prometheus ifadesini önceki adımda döndürülen adla değiştirin.

kubectl patch prometheus prometheus-operator-160879-prometheus --patch "$(cat prometheus-patch.yaml)" --type=merge

Other Self-managed Prometheus Instances

prometheus.yaml yapılandırma dosyasını değiştirin. Aşağıdaki örnek Prometheus 2.x için geçerlidir. Diğer sürümlerin yapılandırma biçimleri için bkz.Prometheus documentation.

alerting:
  alertmanagers:
  - api_version: v1
    authorization:
      type: Bearer
      credentials: <bearer_token>
    scheme: https
    static_configs:
    - targets: ["alerts.aliyuncs.com"]

Not

Bearer belirtecini ARMS konsolundan alın. <bearer_token> ifadesini gerçek belirteç değeriyle değiştirin.

Tarayıcınızda Prometheus yapılandırma sayfasını açın ve alerting bölümünün hedefi alerts.aliyuncs.com olan Alertmanager yapılandırmasını içerdiğini doğrulayın.

ARMS Alert Management ile diğer Prometheus uyumlu gözlemlenebilirlik sistemlerini entegre etme

Thanos, Alertmanager yapılandırma dosyasını belirtmek için thanos rule komutunun --alertmanagers.config parametresini kullanır. Önceki adımlarda açıklanan entegrasyon adresini ve belirteci girin. Yapılandırma hakkında daha fazla bilgi için bkz. Thanos documentation.

VictoriaMetric, bildirim yapılandırma dosyasını belirtmek için ./bin/vmalert komutunun -notifier.config parametresini kullanır. Önceki adımlarda açıklanan entegrasyon adresini ve belirteci girin. Yapılandırma hakkında daha fazla bilgi için bkz. VictoriaMetric documentation.

(İsteğe bağlı) Entegrasyonu düzenleyin

ARMS Alert Management, kendi yönettiğiniz Prometheus uyarı kaynağı ile ARMS Alert Management arasındaki alan eşlemelerini önceden ayarlar. Gerektiğinde Edit Integration sayfasında alan eşlemelerini ekleyebilir veya değiştirebilirsiniz.

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

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

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

Not

Uploaded. No events are generated. Configure mappings based on the original data. mesajı görünüyorsa 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 durum, eşlemeleri yapılandırırken kaynak alanlarını seçmenize olanak tanır.
Uploaded. mesajı görünüyorsa uyarı içeriği Alert Event History sayfasına bildirilir. Daha fazla bilgi için bkz. View alert event history.

Send Test Data iletişim kutusunda Disable öğesini tıklayın.

Event Mapping bölümünün sol tarafında eşleme yapılandırmak istediğiniz veri kayıtlarını tıklayarak ayrıntıları görüntüleyin.

Bölümünün sağ tarafında uyarı kaynağı alanları ile ARMS uyarıları arasındaki eşlemeleri yapılandırın.

Event Mapping

İ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 halde 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 çok dizi düğümü varsa toplu işlem için bu dizi düğümlerinden yalnızca 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 simgesini 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ı sınırlayıcılar kullanarak tek bir alanda birleştirebilir ve ardından bu alanı ARMS'in belirtilen uyarı alanıyla eşleyebilirsiniz. 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 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ş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, 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 yinelenenlerini kaldırma özelliğini yapılandırın.

Sistem, yinelenen verileri azaltmak için ilgili alanları yinelenenleri kaldırmak için temel olarak kullanır. ARMS Alert Management, Event Mapping bölümünde görüntülenen geçmiş olay verilerinin yinelenenleri kaldırma gruplama sonuçlarını önizlemenize olanak tanır. Yinelenenleri kaldırılacak alanları değiştirebilirsiniz.

Not

Yinelenenleri kaldırma işlemini yalnızca temizlenmemiş olaylar için yapılandırabilirsiniz.

Integration Details sayfasındaki Event Deduplication bölümünde yinelenenleri kaldırmak 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.
Yinelenenleri kaldırma sonrası uyarı grubunu önizlemek için Deduplication Test öğesini tıklayın.

Not
Yinelenenleri kaldırma testi, yalnızca Event Mapping bölümünün sol tarafında yüklenen son 10 veri kaydı üzerinde etkili olur.

Ayarları yapılandırdıktan sonra Save öğesini tıklayın.

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

ARMS konsolunun sol gezinme bölmesinde Alert Management > Alert Event History 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ını tıklayın. Daha fazla bilgi için bkz. View alert event history.

Entegrasyon anahtarını güncelleyin

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ırı tıklayın. Integration Details sayfasında entegrasyon ayrıntılarını görüntüleyin.

Bir entegrasyonun anahtarını güncellemek için hedef entegrasyonun sağındaki Actions sütununda MoreUpdate Key seçeneğini belirleyin. Görüntülenen iletişim kutusunda Confirm öğesini tıklayın.

Önemli

Anahtarı güncelledikten sonra kendi yönettiğiniz Prometheus örneğini yeni anahtarla yeniden yapılandırın. Daha fazla bilgi için bkz. Configure Prometheus.

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

Bir entegrasyonu etkinleştirme veya devre dışı bırakma: Entegrasyonu bulun ve ardından Actions sütununda Disable veya Enable öğesini tıklayın.

Bir entegrasyonu silme: Entegrasyonu bulun ve ardından Actions sütununda Delete öğesini tıklayın. Görüntülenen mesajda OK öğesini tıklayın.

Bir entegrasyona olay işleme akışı ekleme: Entegrasyonu bulun ve Actions sütununda Add Event Processing Flow öğesini tıklayın. Daha fazla bilgi için bkz. Event processing flow.

Bildirim ilkesi oluşturma: Bildirim ilkesi oluşturmak istediğiniz entegrasyonu bulun ve Actions sütununda More öğesini tıklayın. Görüntülenen listede Create Notification Policy öğesini tıklayın. Daha fazla bilgi için bkz. Notification policies.

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. Notification policies. 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. View alert sending history.