Layanan terkelola Azure Monitor untuk grup aturan Prometheus

Aturan di Prometheus bertindak berdasarkan data saat data dikumpulkan, baik untuk melakukan prakompeksi nilai yang disimpan dalam rangkaian waktu atau untuk memperingatkan kondisi yang telah ditentukan sebelumnya dalam metrik yang Anda kumpulkan. Azure Monitor layanan terkelola untuk Prometheus menyediakan set yang telah ditentukan sebelumnya dari setiap jenis aturan dan memungkinkan Anda membuat dan mengelola aturan kustom menggunakan portal Azure.

Jenis grup aturan

Grup aturan Prometheus adalah kumpulan aturan pemberitahuan/atau aturan perekaman yang dievaluasi bersama-sama. Setiap aturan harus menjadi anggota dari satu grup aturan. Grup aturan menentukan cakupan semua aturan dalam grup dan frekuensi evaluasinya.

Ada dua jenis aturan Prometheus.

Tipe	Deskripsi
Peringatan	Semua aturan memungkinkan Anda membuat pemberitahuan Azure Monitor berdasarkan hasil kueri Prometheus Query Language (PromQL). Pemberitahuan yang dipicu oleh aturan pemberitahuan Prometheus Terkelola Azure diproses dan memicu notifikasi dengan cara yang mirip dengan pemberitahuan Azure Monitor lainnya.
Rekaman	Aturan perekaman memungkinkan Anda untuk melakukan prakomputasi ekspresi yang sering diperlukan atau ekstensif secara komputasi dan menyimpan hasilnya sebagai serangkaian rangkaian waktu baru. Rangkaian waktu yang dibuat oleh aturan perekaman diserap kembali ke ruang kerja Azure Monitor Anda sebagai metrik Prometheus baru.

Kelompok aturan Prometheus Terkelola di Azure mengikuti struktur dan terminologi dari kelompok aturan Prometheus sumber terbuka. Nama aturan, ekspresi, label, dan anotasi semuanya didukung dalam Azure.

Ada beberapa perbedaan antara grup aturan Prometheus Terkelola Azure dan grup aturan Prometheus sumber terbuka sekalipun. Grup aturan Prometheus Terkelola Azure dikelola sebagai sumber daya Azure dan menyertakan informasi yang diperlukan untuk manajemen sumber daya, seperti langganan dan grup sumber daya tempat grup aturan Azure seharusnya berada. Aturan peringatan mencakup properti khusus, seperti tingkat keparahan peringatan, asosiasi grup tindakan, dan konfigurasi autoresolve peringatan, yang memungkinkan peringatan diproses seperti peringatan Azure Monitor lainnya.

Cakupan grup aturan

Cakupan grup aturan dalam grup aturan Azure Prometheus Terkelola menentukan sumber daya apa yang diterapkan aturan dalam grup. Aturan individual tidak dapat diterapkan langsung ke kluster Kubernetes. Tabel berikut ini menjelaskan cakupan grup aturan yang berbeda.

Ruang lingkup	Deskripsi
Semua kluster di ruang kerja	Semua aturan yang diaktifkan dalam grup akan diterapkan ke semua kluster yang saat ini terhubung ke ruang kerja Azure Monitor.
Kluster tertentu - Nama kluster	Semua aturan yang diaktifkan dalam grup hanya akan diterapkan ke kluster yang dipilih.
Kluster tertentu - Nama kluster dalam kueri	Semua aturan yang diaktifkan dalam grup akan diterapkan pada kluster yang memiliki teks tertentu dalam namanya.

Menampilkan grup aturan Prometheus

Ada beberapa cara untuk melihat grup aturan Prometheus dan aturannya di portal Azure.

Rules di ruang kerja Azure Monitor

Pilih Grup aturan dari ruang kerja Azure Monitor di portal Azure untuk melihat semua grup aturan di ruang kerja tersebut. Anda dapat memperluas grup aturan apa pun untuk melihat daftar aturan dalam grup tersebut. Pilih grup atau aturan apa pun untuk melihat detailnya.

Semua aturan

Dari halaman Alerts di menu Monitor di portal Azure, pilih kelompok aturan Prometheus untuk melihat semua kelompok aturan dalam langganan yang dapat Anda akses.

Tampilan ini mengidentifikasi ruang kerja tempat grup aturan berada, apakah itu diaktifkan, dan kluster jika grup aturan terbatas pada cakupan kluster tertentu. Gunakan filter di bagian atas layar untuk mempersempit daftar grup aturan menurut berbagai properti. Anda bisa menghapus beberapa grup aturan dari tampilan ini dengan memilihnya lalu mengklik Hapus. Ini dapat berguna, misalnya, untuk membersihkan grup aturan yang tidak lagi diperlukan setelah menghapus kluster.

Petunjuk / Saran

Anda juga dapat mengakses tampilan yang sama ini dari halaman Pemberitahuan kluster Kubernetes. Ini akan mengatur filter awal ke grup aturan yang terlingkup dalam kluster tersebut.

Membuat grup dan aturan aturan Prometheus

Azure

Buka tampilan Semua aturan yang dijelaskan tentang dan pilih + Buat

Cakupan

Setting	Deskripsi
ruang kerja Azure Monitor	Ruang kerja Azure Monitor tempat grup aturan akan mengkueri data. Nilai ini tidak dapat diubah untuk grup aturan yang sudah ada.
Lokasi	Lokasi ruang kerja Azure Monitor yang dipilih.
Kelompok	Menentukan di mana grup aturan berlaku untuk semua kluster di ruang kerja atau kluster tertentu. Pilih kluster tertentu atau masukkan teks untuk dicocokkan dengan nama kluster.

Rincian

Setting	Deskripsi
Subscription	Langganan di mana sumber daya grup aturan akan dibuat. Nilai ini tidak dapat diubah untuk grup aturan yang sudah ada.
Grup sumber daya	Grup sumber daya tempat sumber daya grup peraturan akan dibuat. Nilai ini tidak dapat diubah untuk grup aturan yang sudah ada.
Nama	Nama sumber daya grup aturan. Nama ini harus unik dalam grup sumber daya yang dipilih. Nilai ini tidak dapat diubah untuk grup aturan yang sudah ada.
Deskripsi	Deskripsi dari grup aturan tersebut.
Mengevaluasi setiap	Frekuensi evaluasi aturan dalam grup. Defaultnya adalah 1 menit.
Diaktifkan	Mengaktifkan atau menonaktifkan grup aturan. Grup aturan yang dinonaktifkan masih akan dibuat, tetapi aturan hanya akan dijalankan jika grup diaktifkan.
Label	Pasangan kunci/nilai label opsional untuk aturan tersebut. Label ini ditambahkan ke metrik yang dibuat oleh aturan.

Aturan

Pilih Tambahkan aturan perekaman atau Tambahkan aturan pemberitahuan untuk menambahkan aturan ke grup. Setiap jenis aturan memiliki pengaturan yang berbeda seperti yang dijelaskan di bawah ini.

Aturan perekaman

Setting	Deskripsi
Nama	Nama aturan perekaman. Nama ini digunakan untuk metrik yang dibuat oleh aturan.
Diaktifkan	Menentukan apakah aturan diaktifkan atau dinonaktifkan. Aturan yang dinonaktifkan akan dibuat, tetapi tidak akan dievaluasi hingga diaktifkan.
Expression	Ekspresi PromQL yang menentukan aturan. Pilih Jalankan Kueri untuk melihat hasil kueri ekspresi yang divisualisasikan dalam bagan pratinjau. Ubah rentang waktu pratinjau untuk memperbesar atau memperkecil riwayat hasil ekspresi.

Aturan pemberitahuan

Setting	Deskripsi
Nama	Nama aturan perekaman. Nama ini adalah nama peringatan yang diaktifkan oleh aturan.
Severity	Nilai tingkat keparahan untuk peringatan yang dipicu oleh aturan ini.
Expression	Ekspresi PromQL yang menentukan aturan. Pilih Jalankan Kueri untuk melihat hasil kueri ekspresi yang divisualisasikan dalam bagan pratinjau. Ubah rentang waktu pratinjau untuk memperbesar atau memperkecil riwayat hasil ekspresi.
Menunggu	Periode waktu antara saat ekspresi pemberitahuan pertama kali menjadi benar dan hingga pemberitahuan diaktifkan.
Label	Pasangan kunci/nilai label opsional untuk aturan tersebut. Label ini ditambahkan ke peringatan yang dipicu oleh aturan.
Annotations	Pasangan kunci/nilai anotasi opsional untuk aturan. Anotasi ini ditambahkan ke peringatan yang diaktifkan oleh aturan.
Kelompok Aksi	Grup tindakan yang menentukan respons terhadap pemberitahuan yang diaktifkan.
Diaktifkan	Menentukan apakah aturan diaktifkan atau dinonaktifkan. Aturan yang dinonaktifkan akan dibuat, tetapi tidak akan dievaluasi hingga diaktifkan.
Mengatasi pemberitahuan secara otomatis	Atasi pemberitahuan secara otomatis jika kondisi aturan tidak lagi benar selama periode Waktu penyelesaian otomatis .

Mengonfigurasi ruang lingkup grup aturan

Pada tab Scope

1. Pilih ruang kerja Azure Monitor dari daftar ruang kerja yang tersedia di langganan Anda. Aturan dalam grup ini menanyakan data dari ruang kerja ini.

2. Untuk membatasi grup aturan Anda ke cakupan kluster, pilih opsi Kluster tertentu :

   • Pilih kluster dari daftar kluster yang sudah tersambung ke ruang kerja Azure Monitor yang dipilih.
   • Nama kluster default dimasukkan untuk Anda. Ubah nilai ini hanya jika Anda mengubah nilai label kluster dengan menggunakan cluster_alias.

3. Pilih Berikutnya untuk mengonfigurasi detail grup aturan.

   

CLI

Gunakan perintah az alerts-management prometheus-rule-group create untuk membuat grup aturan Prometheus baru.

 az alerts-management prometheus-rule-group create \
--name my-rule-group --resource-group my-resource-group --location westus --enabled \
--description "Sample Prometheus resource group" --interval PT10M \
--scopes "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/testrg/providers/microsoft.monitor/accounts/testaccount" \
--rules [{"record":"test","expression":"test","labels":{"team":"prod"}},{"alert":"Billing_Processing_Very_Slow","expression":"test","enabled":"true","severity":2,"for":"PT5M","labels":{"team":"prod"},"annotations":{"annotationName1":"annotationValue1"},"resolveConfiguration":{"autoResolved":"true","timeToResolve":"PT10M"},"actions":[{"actionGroupId":"/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/microsoft.insights/actionGroups/test-action-group-name1","actionProperties":{"key11":"value11","key12":"value12"}},{"actionGroupId":"/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/microsoft.insights/actionGroups/test-action-group-name2","actionProperties":{"key21":"value21","key22":"value22"}}]}]

PowerShell

Untuk membuat grup aturan Prometheus dengan menggunakan PowerShell, gunakan cmdlet new-azprometheusrulegroup .

$rule1 = New-AzPrometheusRuleObject -Record "job_type:billing_jobs_duration_seconds:99p5m"
$action = New-AzPrometheusRuleGroupActionObject -ActionGroupId /subscriptions/fffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/MyresourceGroup/providers/microsoft.insights/actiongroups/MyActionGroup -ActionProperty @{"key1" = "value1"}
$Timespan = New-TimeSpan -Minutes 15
$rule2 = New-AzPrometheusRuleObject -Alert Billing_Processing_Very_Slow -Expression "job_type:billing_jobs_duration_seconds:99p5m > 30" -Enabled $false -Severity 3 -For $Timespan -Label @{"team"="prod"} -Annotation @{"annotation" = "value"} -ResolveConfigurationAutoResolved $true -ResolveConfigurationTimeToResolve $Timespan -Action $action
$rules = @($rule1, $rule2)
$scope = "/subscriptions/fffffffff-ffff-ffff-ffff-ffffffffffff/resourcegroups/MyresourceGroup/providers/microsoft.monitor/accounts/MyAccounts"
New-AzPrometheusRuleGroup -ResourceGroupName MyresourceGroup -RuleGroupName MyRuleGroup -Location eastus -Rule $rules -Scope $scope -Enabled

ARM (JSON)

Contoh templat berikut membuat grup aturan Prometheus, termasuk satu aturan perekaman dan satu aturan pemberitahuan. Templat ini membuat sumber daya jenis Microsoft.AlertsManagement/prometheusRuleGroups. Cakupan grup ini terbatas pada satu kluster AKS. Aturan dijalankan dalam urutan di mana mereka muncul dalam grup.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {},
    "variables": {},
    "resources": [
        {
           "name": "sampleRuleGroup",
           "type": "Microsoft.AlertsManagement/prometheusRuleGroups",
           "apiVersion": "2023-03-01",
           "location": "northcentralus",
           "properties": {
                "description": "Sample Prometheus Rule Group",
                "scopes": [
                    "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.monitor/accounts/<azure-monitor-workspace-name>",
                    "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.containerservice/managedclusters/<myClusterName>"
                ],
                "enabled": true,
                "clusterName": "<myCLusterName>",
                "interval": "PT1M",
                "rules": [
                    {
                        "record": "instance:node_cpu_utilisation:rate5m",
                        "expression": "1 - avg without (cpu) (sum without (mode)(rate(node_cpu_seconds_total{job=\"node\", mode=~\"idle|iowait|steal\"}[5m])))",
                        "labels": {
                            "workload_type": "job"
                        },
                        "enabled": true
                    },
                    {
                        "alert": "KubeCPUQuotaOvercommit",
                        "expression": "sum(min without(resource) (kube_resourcequota{job=\"kube-state-metrics\", type=\"hard\", resource=~\"(cpu|requests.cpu)\"})) /  sum(kube_node_status_allocatable{resource=\"cpu\", job=\"kube-state-metrics\"}) > 1.5",
                        "for": "PT5M",
                        "labels": {
                            "team": "prod"
                        },
                        "annotations": {
                            "description": "Cluster has overcommitted CPU resource requests for Namespaces.",
                            "runbook_url": "https://github.com/kubernetes-monitoring/kubernetes-mixin/tree/master/runbook.md#alert-name-kubecpuquotaovercommit",
                            "summary": "Cluster has overcommitted CPU resource requests."
                        },
                        "enabled": true,
                        "severity": 3,
                        "resolveConfiguration": {
                            "autoResolved": true,
                            "timeToResolve": "PT10M"
                        },
                        "actions": [
                            {
                               "actionGroupID": "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.insights/actiongroups/<action-group-name>"
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

Grup aturan berisi properti berikut.

Nama	Diperlukan	Tipe	Deskripsi
name	Benar	string	Nama grup aturan Prometheus.
type	Benar	string	Microsoft.AlertsManagement/prometheusRuleGroups
apiVersion	Benar	string	2023-03-01
location	Benar	string	Lokasi sumber daya di luar wilayah yang didukung.
properties.description	Tidak benar	string	Deskripsi grup aturan.
properties.scopes	Benar	string[]	Harus mencantumkan ID ruang kerja Azure Monitor yang dituju. Dapat secara opsional menyertakan satu ID kluster lagi.
properties.enabled	Tidak benar	Boolean	Aktifkan/nonaktifkan grup. Defaultnya adalah true.
properties.clusterName	Tidak benar	string	Harus cocok dengan label cluster yang ditambahkan ke metrik yang dikumpulkan dari kluster target Anda. Secara default, atur ke bagian terakhir (nama sumber daya) ID kluster yang muncul di scopes[].
properties.interval	Tidak benar	string	Interval evaluasi grup. Default = PT1M.

Aturan perekaman

Bagian berisi rules properti berikut untuk aturan perekaman.

Nama	Diperlukan	Tipe	Deskripsi
record	Benar	string	Nama aturan rekaman. Nama ini digunakan untuk rangkaian waktu baru.
expression	Benar	string	Ekspresi PromQL untuk menghitung nilai rangkaian waktu baru.
labels	Benar	string	Pasangan kunci/nilai label aturan Prometheus. Label ini ditambahkan ke rangkaian waktu yang direkam.
enabled	Tidak benar	Boolean	Aktifkan/nonaktifkan grup. Defaultnya adalah true.

Aturan pemberitahuan

Bagian rules berisi properti berikut untuk aturan pemberitahuan.

Nama	Diperlukan	Tipe	Deskripsi
alert	Tidak benar	string	Nama aturan peringatan.
expression	Benar	string	Ekspresi PromQL untuk dievaluasi.
for	Tidak benar	string	Batas waktu berakhirnya peringatan. Nilai = PT1M, PT5M, dan seterusnya.
labels	Tidak benar	objek	Label aturan peringatan Prometheus. Label ini ditambahkan ke peringatan yang diaktifkan oleh aturan ini.
rules.annotations	Tidak benar	objek	Pasangan kunci/nilai anotasi untuk ditambahkan ke peringatan.
enabled	Tidak benar	Boolean	Aktifkan/nonaktifkan grup. Defaultnya adalah true.
rules.severity	Tidak benar	bilangan bulat	Tingkat keparahan peringatan. 0-4, defaultnya adalah 3 (informasi).
rules.resolveConfigurations.autoResolved	Tidak benar	Boolean	Saat diaktifkan, pemberitahuan secara otomatis diselesaikan ketika kondisi tidak lagi benar. Default = true.
rules.resolveConfigurations.timeToResolve	Tidak benar	string	Waktu habis penyelesaian otomatis untuk peringatan. Default = PT5M.
rules.action[].actionGroupId	tidak benar	string	Satu atau beberapa ID sumber daya grup tindakan. Masing-masing diaktifkan ketika peringatan dipicu.

Bicep

Contoh templat berikut membuat grup aturan Prometheus, termasuk satu aturan perekaman dan satu aturan pemberitahuan. Templat ini membuat sumber daya jenis Microsoft.AlertsManagement/prometheusRuleGroups. Cakupan grup ini terbatas pada satu kluster AKS. Aturan dijalankan dalam urutan di mana mereka muncul dalam grup.

resource sampleRuleGroup 'Microsoft.AlertsManagement/prometheusRuleGroups@2023-03-01' = {
    name: 'sampleRuleGroup'
    location: 'northcentralus'
    properties: {
        description: 'Sample Prometheus Rule Group'
        scopes: [
            '/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.monitor/accounts/<azure-monitor-workspace-name>'
            '/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.containerservice/managedclusters/<myClusterName>'
        ]
        enabled: true
        clusterName: '<myCLusterName>'
        interval: 'PT1M'
        rules: [
            {
              record: 'instance:node_cpu_utilisation:rate5m'
              expression: '1 - avg without (cpu) (sum without (mode)(rate(node_cpu_seconds_total{job="node", mode=~"idle|iowait|steal"}[5m])))'
              labels: {
                  workload_type: 'job'
              }
              enabled: true
            }
            {
                alert: 'KubeCPUQuotaOvercommit'
                expression: 'sum(min without(resource) (kube_resourcequota{job="kube-state-metrics", type="hard", resource=~"(cpu|requests.cpu)"})) /  sum(kube_node_status_allocatable{resource="cpu", job="kube-state-metrics"}) > 1.5'
                for: 'PT5M'
                labels: {
                    team: 'prod'
                }
                annotations: {
                    description: 'Cluster has overcommitted CPU resource requests for Namespaces.'
                    runbook_url: 'https://github.com/kubernetes-monitoring/kubernetes-mixin/tree/master/runbook.md#alert-name-kubecpuquotaovercommit'
                    summary: 'Cluster has overcommitted CPU resource requests.'
                }
                enabled: true
                severity: 3
                resolveConfiguration: {
                    autoResolved: true
                    timeToResolve: 'PT10M'
                }
                actions: [
                    {
                        actionGroupId: '/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.insights/actiongroups/<action-group-name>'
                    }
                ]
            }
        ]
    }
}

Grup aturan berisi properti berikut.

Nama	Diperlukan	Tipe	Deskripsi
name	Benar	string	Nama grup aturan Prometheus.
type	Benar	string	Microsoft.AlertsManagement/prometheusRuleGroups
apiVersion	Benar	string	2023-03-01
location	Benar	string	Lokasi sumber daya di luar wilayah yang didukung.
properties.description	Tidak benar	string	Deskripsi grup aturan.
properties.scopes	Benar	string[]	Harus menyertakan ID ruang kerja Azure Monitor target. Dapat secara opsional menyertakan satu ID kluster lagi.
properties.enabled	Tidak benar	Boolean	Aktifkan/nonaktifkan grup. Defaultnya adalah true.
properties.clusterName	Tidak benar	string	Harus cocok dengan label cluster yang ditambahkan ke metrik yang dikumpulkan dari kluster target Anda. Secara default, atur ke bagian terakhir (nama sumber daya) ID kluster yang muncul di scopes[].
properties.interval	Tidak benar	string	Interval evaluasi grup. Default = PT1M.

Aturan perekaman

Bagian berisi rules properti berikut untuk aturan perekaman.

Nama	Diperlukan	Tipe	Deskripsi
record	Benar	string	Nama aturan rekaman. Nama ini digunakan untuk rangkaian waktu baru.
expression	Benar	string	Ekspresi PromQL untuk menghitung nilai rangkaian waktu baru.
labels	Benar	string	Pasangan kunci/nilai label aturan Prometheus. Label ini ditambahkan ke rangkaian waktu yang direkam.
enabled	Tidak benar	Boolean	Aktifkan/nonaktifkan grup. Defaultnya adalah true.

Aturan pemberitahuan

Bagian rules berisi properti berikut untuk aturan pemberitahuan.

Nama	Diperlukan	Tipe	Deskripsi
alert	Tidak benar	string	Nama aturan peringatan.
expression	Benar	string	Ekspresi PromQL untuk dievaluasi.
for	Tidak benar	string	Batas waktu berakhirnya peringatan. Nilai = PT1M, PT5M, dan seterusnya.
labels	Tidak benar	objek	Label aturan peringatan Prometheus. Label ini ditambahkan ke peringatan yang diaktifkan oleh aturan ini.
rules.annotations	Tidak benar	objek	Pasangan kunci/nilai anotasi untuk ditambahkan ke peringatan.
enabled	Tidak benar	Boolean	Aktifkan/nonaktifkan grup. Defaultnya adalah true.
rules.severity	Tidak benar	bilangan bulat	Tingkat keparahan peringatan. 0-4, defaultnya adalah 3 (informasi).
rules.resolveConfigurations.autoResolved	Tidak benar	Boolean	Saat diaktifkan, pemberitahuan secara otomatis diselesaikan ketika kondisi tidak lagi benar. Default = true.
rules.resolveConfigurations.timeToResolve	Tidak benar	string	Waktu habis penyelesaian otomatis untuk peringatan. Default = PT5M.
rules.action[].actionGroupId	tidak benar	string	Satu atau beberapa ID sumber daya grup tindakan. Masing-masing diaktifkan ketika peringatan dipicu.

Mengonversi file aturan Prometheus ke grup aturan Prometheus Terkelola

Jika Anda memiliki file konfigurasi aturan Prometheus dalam format YAML, Anda dapat mengonversinya ke templat ARM untuk grup aturan Prometheus Terkelola Azure menggunakan utilitas az-prom-rules-converter. File aturan dapat berisi definisi satu atau beberapa grup aturan.

Selain file aturan, utilitas memerlukan properti lain yang diperlukan untuk membuat grup aturan Azure Prometheus termasuk langganan, grup sumber daya, lokasi, ruang kerja Azure Monitor target, ID dan nama kluster target, dan grup tindakan. Utilitas membuat file templat yang dapat Anda sebarkan menggunakan metode standar apa pun untuk menyebarkan templat ARM.

Membatasi aturan ke kluster tertentu

Anda dapat secara opsional membatasi aturan dalam grup aturan untuk mengkueri data yang berasal dari satu kluster tertentu dengan menambahkan cakupan kluster ke grup aturan Anda atau dengan menggunakan properti grup clusterName aturan. Batasi aturan ke satu kluster jika ruang kerja Azure Monitor Anda berisi sejumlah besar data dari beberapa kluster. Dalam kasus seperti itu, ada kekhawatiran bahwa menjalankan satu set aturan pada semua data dapat menyebabkan masalah performa atau pembatasan. Dengan menggunakan cakupan kluster, Anda dapat membuat beberapa grup aturan, masing-masing dikonfigurasi dengan aturan yang sama, dengan setiap grup mencakup kluster yang berbeda.

Untuk membatasi grup aturan Anda ke cakupan kluster menggunakan templat ARM, tambahkan nilai ID sumber daya Azure kluster Anda ke grup aturan scopes[] daftar. Daftar cakupan masih harus menyertakan ID sumber daya ruang kerja Azure Monitor. Jenis sumber daya kluster berikut didukung sebagai cakupan kluster:

• kluster Azure Kubernetes Service (Microsoft.ContainerService/managedClusters)
• Kluster Kubernetes dengan dukungan Azure Arc (Microsoft.kubernetes/connectedClusters)
• Perangkat Azure yang terhubung (Microsoft.ResourceConnector/appliances)

Selain ID kluster, Anda dapat mengonfigurasi atribut clusterName dari grup aturan Anda. Properti clusterName harus cocok dengan label cluster yang ditambahkan ke metrik Anda ketika diekstrak dari kluster tertentu. Secara default, label ini diatur ke bagian terakhir (nama sumber daya) ID kluster Anda. Jika Anda mengubah label ini dengan menggunakan pengaturan cluster_alias di ConfigMap dari kluster yang di-scrape, Anda harus menyertakan nilai yang diperbarui dalam properti rule group clusterName. Jika pengikisan Anda menggunakan nilai label default cluster, properti clusterName adalah opsional.

Berikut adalah contoh bagaimana grup aturan dikonfigurasi untuk membatasi kueri ke kluster tertentu:

{
    "name": "sampleRuleGroup",
    "type": "Microsoft.AlertsManagement/prometheusRuleGroups",
    "apiVersion": "2023-03-01",
    "location": "northcentralus",
    "properties": {
         "description": "Sample Prometheus Rule Group limited to a specific cluster",
         "scopes": [
             "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.monitor/accounts/<azure-monitor-workspace-name>",
             "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.containerservice/managedclusters/<myClusterName>"
         ],
         "clusterName": "<myCLusterName>",
         "rules": [
             {
                ...
             }
         ]
    }
}

Jika baik cakupan ID kluster maupun properti clusterName tidak ditentukan untuk grup aturan, aturan dalam grup ini akan mengkueri data dari semua kluster dalam ruang kerja.

Konfigurasikan detail grup aturan

Nota

Untuk aturan pemberitahuan, kueri ekspresi biasanya hanya mengembalikan rangkaian waktu yang memenuhi kondisi ekspresi. Jika bagan pratinjau tidak ditampilkan dan Anda mendapatkan pesan "Kueri tidak mengembalikan hasil," kemungkinan kondisi tidak terpenuhi dalam rentang waktu pratinjau.

Selesaikan pembuatan grup aturan

1. Pada tab Tags, atur tag sumber daya Azure yang diperlukan untuk ditambahkan ke sumber daya grup aturan.

   

2. Pada tab Tinjau + Buat Baru, grup aturan divalidasi dan memberi tahu Anda tentang setiap masalah. Pada tab ini, Anda juga dapat memilih opsi Tampilkan templat otomatisasi dan mengunduh templat untuk grup yang akan Anda buat.

3. Setelah validasi berlalu dan Anda meninjau pengaturan, pilih Buat.

   

4. Anda dapat menindaklanjuti penyebaran grup aturan untuk memastikan bahwa penyebaran berhasil diselesaikan atau diberi tahu tentang kesalahan apa pun.

Menampilkan status kesehatan sumber daya grup aturan Prometheus Anda

Sekarang Anda dapat melihat status kesehatan sumber daya grup aturan Prometheus Anda di portal. Anda dapat mendeteksi masalah dalam grup aturan Anda, seperti konfigurasi yang salah, atau masalah pembatasan kueri.

1. Di portal, buka gambaran umum grup aturan Prometheus yang ingin Anda pantau.

2. Di panel kiri, di bawah Bantuan, pilih Kesehatan sumber daya.

   

3. Pada panel Kesehatan sumber daya , Anda bisa melihat status ketersediaan grup aturan saat ini. Anda juga dapat melihat riwayat peristiwa kesehatan sumber daya terbaru, hingga 30 hari terakhir.

   

   • Jika grup aturan ditandai sebagai Tersedia, grup tersebut berfungsi seperti yang diharapkan.
   • Jika grup aturan ditandai sebagai Terdegradasi, satu atau beberapa aturan dalam grup tidak berfungsi seperti yang diharapkan. Kueri aturan mungkin dibatasi, atau masalah lain dapat menyebabkan evaluasi aturan gagal. Perluas entri status untuk informasi selengkapnya tentang masalah yang terdeteksi, saran untuk mitigasi, atau pemecahan masalah lebih lanjut.
   • Jika grup aturan ditandai sebagai Tidak Tersedia, seluruh grup aturan tidak berfungsi seperti yang diharapkan. Mungkin ada masalah konfigurasi (misalnya, ruang kerja Azure Monitor tidak dapat dideteksi) atau masalah layanan internal. Perluas entri status untuk informasi selengkapnya tentang masalah yang terdeteksi, saran untuk mitigasi, atau pemecahan masalah lebih lanjut.
   • Jika grup aturan ditandai sebagai Tidak Diketahui, seluruh grup aturan dinonaktifkan atau dalam status tidak diketahui.

Menonaktifkan dan mengaktifkan grup aturan

Untuk mengaktifkan atau menonaktifkan aturan, pilih grup aturan di portal Azure. Pilih Aktifkan atau Nonaktifkan untuk mengubah statusnya.

Konten terkait

• Pelajari selengkapnya tentang pemberitahuan Azure
• Dokumentasi Prometheus untuk aturan perekaman
• Dokumentasi Prometheus untuk aturan pemberitahuan