Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
PromQL kullanarak Sorgu tabanlı ölçüm uyarı koşuluyla, Prometheus ölçümleri veya Azure İzleyici Çalışma Alanında depolanan özel (OTel) ölçümler üzerinde bir ölçüm uyarısı kuralı oluşturabilirsiniz.
Bu makalede, Azure İzleyici'deki sorgu tabanlı ölçüm uyarılarına genel bir bakış sağlanmaktadır ve Prometheus veya Bir Azure İzleyici Çalışma Alanında depolanan özel (OTel) ölçümlerinde uyarı kuralları oluşturmak için PromQL'in nasıl kullanılacağına odaklanmaktadır.
PromQL nedir?
PromQL, açık kaynak tabanlı ölçüm sorgu dilidir:
- Veri seçimi, toplama ve dönüştürme için bir dizi ölçüm işlevi ve işleç.
- Yerleşik çok boyutlu işleme, değerlendirme ve uyarı, boyut filtreleme, toplama ve yeniden etiketlemeyi kapsar.
- Koşul iç içe yerleştirme dahil bileşik koşullar.
- Birden çok ölçümü birleştirme ve karşılaştırma
- Topluluktan veya mevcut Prometheus tabanlı izleme sistemlerinden gelen PromQL uyarı ifadelerinin yeniden kullanılması.
Capabilities
-
Kaynak merkezli ve Çalışma alanı merkezli kural kapsamları.
- Kaynak merkezli kurallar, Azure Kubernetes Services (AKS) veya VM'ler gibi belirli Azure kaynaklarından ölçümlere sorgular uygular ve yalnızca izlenen kaynağa erişim gerektirerek RBAC ayrıntı düzeyine sahip olur.
- Çalışma alanı merkezli kurallar, yetkili kullanıcıların kaynaklar arası sorgular da dahil olmak üzere herhangi bir kaynak tarafından Çalışma Alanına yayılan ölçümleri sorgulamasına olanak sağlar.
- Yönetilen Kimlik tabanlı yetkilendirme. Azure Yönetilen Kimliği kullanarak Çalışma Alanlarına erişim yetkisi vekleyebilirsiniz. Yönetilen Kimlik, kaynaklara güvenli, Azure tarafından yönetilen erişim sağlayarak kullanıcı ve kural erişim haklarını ayırarak RBAC ayrıntı düzeyini artırır. Ölçüm uyarıları hem Kullanıcı tarafından atanan hem de Sistem tarafından atanan kimlikleri destekler.
-
Tetiklenmiş uyarı özelleştirmesi. Sorgu tabanlı ölçüm uyarılarını daha bağlamsal ve senaryoya özgü bilgiler içerecek şekilde özelleştirebilirsiniz.
- Özel e-posta konusu: Uyarı bildirimi e-posta konularını senaryoya özgü bilgilerle yapılandırın. Yükteki alanları tanımlamak için ortak uyarı şemasını kullanın.
- Özel özellikler: Uyarı yüküne senaryoya özgü metin, bağlantı veya meta veri ekleyin.
Uyarı
Hem özel e-posta konusu hem de özel özellikler, uyarı yükünden özelliklerin dinamik olarak eklenmesini destekler.
Prometheus kural gruplarıyla karşılaştırıldığında sorgu tabanlı ölçüm uyarıları
Sorgu tabanlı ölçüm uyarıları, Prometheus kural gruplarındaki uyarılara alternatiftir.
Sorgu tabanlı ölçüm uyarılarını kullanmanın avantajları:
- Uyarı kuralları tek tek Azure kaynakları olarak yapılandırılır ve yönetilir. Tek tek kuralların üzerinde kural grupları oluşturmanız ve yönetmeniz gerekmez.
- Kaynak odaklı sorgular ve RBAC desteği: Kullanıcılarınızın Çalışma Alanınıza erişim haklarına ihtiyacı yoktur.
- Azure Yönetilen Kimliği kullanarak kimlik doğrulaması ve yetkilendirme desteği.
- E-posta konusu özelleştirme desteği.
Sorgu tabanlı ölçüm uyarı kurallarını ve Prometheus kural gruplarını kullanma farklılıkları
-
Kapsam sınırlama. Prometheus kural gruplarında,
clusterNameözelliğini kullanarak kuralların kapsamını tek bir AKS veya ARC kümesiyle sınırlayabilirsiniz. Sorgu tabanlı ölçüm uyarı kurallarında, kapsamı tek bir kümeyle (veya başka bir kaynakla) sınırlamak, kuralıscopebelirli bir kaynağa ayarlayarak yapılır. -
Kural koşulu. Ölçüm uyarısı kuralı
queryözelliği, Prometheus kural gruplarıexpressionözelliğine tamamen eşdeğerdir ve aynı sonuçları oluşturur. Buforözelliği her iki hizmette de aynı şekilde çalışır. -
Ölçüm etiketlerini işleme. Sorgu tabanlı metrik uyarıları, PromQL standardına göre Prometheus ve OTel metriklerindeki etiketlerin yönetilmesini ve düzenlenmesini tamamen destekler. Ancak bir uyarı tetiklendiğinde, diğer Azure uyarılarında ve Azure İzleyici deneyimlerinde kullanılan terminolojiye göre kalan ölçüm etiketleri ve değerleri yükte olarak
dimensionsgörünür. - Özel meta veriler ve bilgiler. Prometheus kural grubu uyarı kurallarında uyarı yüküne dinamik meta veriler, bilgilendirme metni, runbook bağlantıları ve daha fazlasını eklemek için özel etiketler ve ek açıklamalar tanımlayabilirsiniz. Sorgu tabanlı ölçüm uyarılarında, benzer işlevler özel özellikler aracılığıyla sağlanır.
Sorgu tabanlı uyarılar için yönetilen kimlikler
Sorgu tabanlı ölçüm uyarı kuralları için Azure Yönetilen Kimlikleri kullanmanız gerekir.
Yönetilen kimliğin kapsamı belirlenmiş kaynakta veya AMW'de bir İzleme Okuyucusu rolüne (veya eşdeğer izinlere sahip özel bir role) sahip olması gerekir.
Hem User-Assigned hem de Sistem Tarafından Atanan MI türleri desteklenir.
Şema ve özellikler
Aşağıdaki tablo, sorgu tabanlı ölçüm uyarı kuralı için şema ve özelliklerin açıklamasını sağlar.
| İsim | Gerekli | Türü | Description | Notes |
|---|---|---|---|---|
| name | Doğru | String | Uyarı kuralı adı | |
| location | Doğru | String | Kaynak konumu | Önizlemede desteklenen bölgelerden |
| identity.type | Doğru | String | Yönetilen kimlik türü | KullanıcıAtanmış veya SistemAtanmış |
| identity.userAssignedIdentities | Doğru | String | Kullanıcı Tarafından Atanan Yönetilen Kimlik Kaynak Kimliği | Türün UserAssigned olması durumunda gereklidir |
| properties.enabled | Yanlış | Boolean | Kural etkinleştirme/devre dışı bırakma | Varsayılan = true |
| özellikler.açıklama | Yanlış | String | Uyarı kuralı açıklaması | |
| özellikler.şiddet | Yanlış | tamsayı | Uyarı önem derecesi | 0-4, varsayılan değer 3'tür (bilgilendirme) |
| Özellikler.hedefKaynakTürü | Yanlış | String | Uyarı hedef kaynak türü | |
| özellikler.kapsamlar | Doğru | string[] | Azure kaynak kimliği | AMW kaynak kimliği (çalışma alanı merkezli kural için) veya başka bir Azure kaynak kimliği / kaynak grubu kimliği / abonelik kimliği (kaynak merkezli kural için). Şu anda yalnızca bir kapsam öğesi desteklenmektedir. |
| özellikler.değerlendirmeSıklığı | Doğru | String | Kural değerlendirme aralığı | Prometheus Aralığına eşdeğerdir. |
| properties.criteria.allOf[].name | Doğru | String | Koşul adı | |
| properties.criteria.allOf[].query | Doğru | String | Uyarı kuralı sorgusu | Prometheus uyarı kuralı ifadesine eşdeğer PromQL sorgusu |
| properties.criteria.allOf[].criterionType | Yanlış | String | Koşul türü | Varsayılan değer StaticThresholdCriterion'dır (dinamik eşik önizlemede desteklenmez) |
| özellikler.kriterler.başarısızDönemler.için | Yanlış | String | Uyarı tetiklenmeden önce koşulun doğru kalma süresi | Prometheus uyarı kuralı 'for' ile eşdeğerdir. Değerler - 'PT1M', 'PT5M' vb. Varsayılan değer 0'dır (hemen ateşle) |
| özellikler.konfigürasyonlarıÇöz.otomatikÇözüldü | Yanlış | Boolean | Uyarı otomatik çözümlemesi etkin | Varsayılan = true |
| özellikler.çözümKonfigürasyonları.çözümSüresi | Yanlış | String | Uyarı otomatik çözümleme zaman aşımı | Varsayılan = "PT5M" |
| properties.actions[].actionGroupId | false | String | eylem grubu kimliği listesi | bir uyarı tetiklendiğinde veya çözümlendiğinde gerçekleştirilen eylem grupları dizisi |
| properties.actionProperties.E-postaKonusu | false | String | özel e-posta konusu şablonu | |
| properties.özelÖzellikler | false | String | uyarı özel özellikleri için anahtar/değer çiftleri |
Desteklenen bölgeler
- East US
- West Europe
- Doğu ABD 2
- Kuzey Avrupa
- Central US
- Batı ABD 2
- UK South
- Güneydoğu Asya
- Orta Hindistan
- West US
- Almanya Batı Merkez
- Japonya Doğu
- Canada Central
- ABD'nin Güney Merkez Bölgesi
- Doğu Asya
- Australia East
- Orta İsveç
- Switzerland North
- Orta Fransa
- Birleşik Arap Emirlikleri Kuzey
- Norway East
- Korea Central
- Güney Brezilya
- Batı ABD 3
- Australia Southeast
- Güney Afrika - Kuzey
Sonraki Adımlar
- Yönetilen Prometheus ile AKS kümesi oluşturma - Azure İzleyici Çalışma Alanı oluşturma da bu iş akışının bir parçasıdır.
- Sorgu tabanlı uyarı oluşturma