Azure Monitor-hanterad tjänst för Prometheus-regelgrupper

2025-10-30

Regler i Prometheus verkar på data när data samlas in, antingen för att förberäkna värden som lagras i tidsserien eller för att utlösa varningar för fördefinierade villkor i dina insamlade mätvärden. Azure Monitor managed service for Prometheus tillhandahåller fördefinierade uppsättningar av varje typ av regel och gör att du kan skapa och hantera anpassade regler med hjälp av Azure-portalen.

Typer av regelgrupper

En Prometheus-regelgrupp är en samling aviseringsregler/eller inspelningsregler som utvärderas tillsammans. Varje regel måste vara medlem i en enda regelgrupp. Regelgrupper definierar omfånget för alla regler i gruppen och den frekvens som de utvärderas.

Det finns två typer av Prometheus-regler.

Typ	Beskrivning
Varning	Med aviseringsregler kan du skapa en Azure Monitor-avisering baserat på resultatet av en Prometheus Query Language-fråga (PromQL). Aviseringar som utlösts av Azure Managed Prometheus-aviseringsregler bearbetas och utlöser meddelanden på liknande sätt som andra Azure Monitor-aviseringar.
Inspelning	Med inspelningsregler kan du förberäkna ofta nödvändiga eller beräkningsmässigt omfattande uttryck och lagra resultatet som en ny uppsättning tidsserier. Tidsserier som skapats av inspelningsregler matas tillbaka till Din Azure Monitor-arbetsyta som nya Prometheus-mått.

Azure Managed Prometheus-regelgrupper följer strukturen och terminologin för Prometheus-regelgrupperna med öppen källkod. Regelnamn, uttryck, etiketter och anteckningar stöds alla i Azure.

Det finns dock vissa skillnader mellan Azure Managed Prometheus-regelgrupper och Prometheus-regelgrupper med öppen källkod. Azure Managed Prometheus-regelgrupper hanteras som Azure-resurser och innehåller information som krävs för resurshantering, till exempel den prenumeration och resursgrupp där Azure-regelgruppen ska finnas. Aviseringsregler omfattar dedikerade egenskaper, till exempel allvarlighetsgrad för aviseringar, åtgärdsgruppsassociation och konfiguration av automatisk lösning av aviseringar som gör att aviseringar kan bearbetas som andra Azure Monitor-aviseringar.

Omfång för en regelgrupp

Omfånget för en regelgrupp i Azure Managed Prometheus-regelgrupper definierar vilka resurser reglerna i gruppen tillämpas på. Enskilda regler kan inte tillämpas direkt på ett Kubernetes-kluster. I följande tabell beskrivs de olika regelgruppsomfången.

Omfång	Beskrivning
Alla kluster på arbetsytan	Alla aktiverade regler i gruppen tillämpas på alla kluster som för närvarande är anslutna till Azure Monitor-arbetsytan.
Specifikt kluster – klusternamn	Alla aktiverade regler i gruppen tillämpas endast på det valda klustret.
Specifikt kluster – Klusternamn i fråga	Alla aktiverade regler i gruppen tillämpas på klustrerna som har den angivna texten i namnet.

Visa Prometheus-regelgrupper

Det finns flera sätt att visa Prometheus-regelgrupper och deras regler i Azure-portalen.

Regler på en Azure Monitor-arbetsyta Välj Regelgrupper från en Azure Monitor-arbetsyta i Azure-portalen för att visa alla regelgrupper på arbetsytan. Du kan expandera valfri regelgrupp för att visa listan över regler i gruppen. Välj valfri grupp eller regel för att visa dess information.

Alla regler På sidan Aviseringar på menyn Övervaka i Azure-portalen väljer du Prometheus-regelgrupper för att visa alla regelgrupper i prenumerationer som du har åtkomst till.

Skärmbild som visar hur du visar Prometheus-regelgrupper från aviseringsskärmen.

Den här vyn identifierar arbetsytan där regelgruppen finns, om den är aktiverad och klustret om regelgruppen är begränsad till ett specifikt klusteromfång. Använd filtren överst på skärmen för att begränsa listan över regelgrupper med olika egenskaper. Du kan ta bort flera regelgrupper från den här vyn genom att välja dem och sedan klicka på Ta bort. Detta kan till exempel vara användbart för att rensa regelgrupper som inte längre behövs efter att du har raderat ett kluster.

Tips/Råd

Du kan också komma åt samma vy från sidan Aviseringar i ett Kubernetes-kluster. Detta anger det första filtret till de regelgrupper som är begränsade till klustret.

Skapa Prometheus-regelgrupper och regler

Öppna vyn Alla regler som beskrivs och välj + Skapa

Scope

Inställning	Beskrivning
Azure Monitor-arbetsyta	Azure Monitor-arbetsytan som regelgruppen kommer att använda för att fråga data. Det här värdet kan inte ändras för en befintlig regelgrupp.
Plats	Plats för den valda Azure Monitor-arbetsytan.
Cluster	Anger var regelgruppen gäller för alla kluster på arbetsytan eller ett specifikt kluster. Välj antingen ett specifikt kluster eller ange text som ska matchas mot klusternamn.

Detaljer

Inställning	Beskrivning
Subscription	Prenumeration där regelgruppsresursen kommer att skapas. Det här värdet kan inte ändras för en befintlig regelgrupp.
Resursgrupp	Resursgrupp där regelgruppsresursen skapas. Det här värdet kan inte ändras för en befintlig regelgrupp.
Namn	Namnet på regelgruppens resurs. Det här namnet måste vara unikt i den valda resursgruppen. Det här värdet kan inte ändras för en befintlig regelgrupp.
Beskrivning	Beskrivning av regelgruppen.
Utvärdera varje	Frekvens som reglerna i gruppen utvärderas. Standardvärdet är 1 minut.
Enabled	Aktivera eller inaktivera regelgruppen. Inaktiverade regelgrupper skapas fortfarande, men reglerna körs bara om gruppen är aktiverad.
Etiketter	Valfria nyckel/värde-par för regeln. Dessa etiketter läggs till i det mått som har skapats av regeln.

Reglemente Välj Lägg till inspelningsregel eller Lägg till aviseringsregel för att lägga till regler i gruppen. Varje tpe av regeln har olika inställningar enligt beskrivningen nedan.

Inspelningsregler

Inställning	Beskrivning
Namn	Namn på inspelningsregeln. Det här namnet används för måttet som skapats av regeln.
Enabled	Anger om regeln är aktiverad eller inaktiverad. Inaktiverade regler skapas, men utvärderas inte förrän de är aktiverade.
Expression	PromQL-uttryck som definierar regeln. Välj Kör fråga för att se resultatet av uttrycksfrågan som visualiserats i förhandsgranskningsdiagrammet. Ändra tidsintervallet för förhandsversionen för att zooma in eller ut på uttrycksresultathistoriken.

Aviseringsregler

Inställning	Beskrivning
Namn	Namn på inspelningsregeln. Det här är namnet på de aviseringar som utlöses av regeln.
Severity	Allvarlighetsgradsvärde för aviseringar som utlösts av den här regeln.
Expression	PromQL-uttryck som definierar regeln. Välj Kör fråga för att se resultatet av uttrycksfrågan som visualiserats i förhandsgranskningsdiagrammet. Ändra tidsintervallet för förhandsversionen för att zooma in eller ut på uttrycksresultathistoriken.
Vänta	Tidsperioden mellan när aviseringsuttrycket först blir sant och tills aviseringen utlöses.
Etiketter	Valfria nyckel/värde-par för regeln. Dessa etiketter läggs till i aviseringarna som genereras av regeln.
Annotations	Valfria annoteringsnyckel/värdepar för regeln. Dessa anteckningar läggs till i de aviseringar som utlösts av regeln.
Åtgärdsgrupper	Åtgärdsgrupper som definierar svaret på aviseringen som utlöses.
Enabled	Anger om regeln är aktiverad eller inaktiverad. Inaktiverade regler skapas, men utvärderas inte förrän de är aktiverade.
Åtgärda aviseringar automatiskt	Lös automatiskt aviseringar om regelvillkoret inte längre är sant under perioden för automatisk lösning.

Konfigurera regelgruppens omfång

På fliken Omfång :

Välj Azure Monitor-arbetsytan från en lista över arbetsytor som är tillgängliga i dina prenumerationer. Reglerna i den här gruppen frågar efter data från den här arbetsytan.
Om du vill begränsa regelgruppen till ett klusteromfång väljer du alternativet Specifikt kluster :
- Välj klustret i listan över kluster som redan är anslutna till den valda Azure Monitor-arbetsytan.
- Standardvärdet för klusternamn anges åt dig. Ändra endast det här värdet om du har ändrat värdet för klusteretiketten med hjälp av cluster_alias.
Välj Nästa för att konfigurera information om regelgruppen.

Använd kommandot az alerts-management prometheus-rule-group create för att skapa en ny Prometheus-regelgrupp.

 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

Om du vill skapa en Prometheus-regelgrupp med hjälp av PowerShell använder du cmdleten 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

Följande exempelmall skapar en Prometheus-regelgrupp, inklusive en inspelningsregel och en aviseringsregel. Den här mallen skapar en resurs av typen Microsoft.AlertsManagement/prometheusRuleGroups. Omfånget för den här gruppen är begränsat till ett enda AKS-kluster. Reglerna körs i den ordning de framträder i en grupp.

{
    "$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>"
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

Regelgruppen innehåller följande egenskaper.

Namn	Krävs	Typ	Beskrivning
`name`	Sann	snöre	Namn på Prometheus-regelgrupp.
`type`	Sann	snöre	`Microsoft.AlertsManagement/prometheusRuleGroups`
`apiVersion`	Sann	snöre	`2023-03-01`
`location`	Sann	snöre	Resursplats utanför stödde regioner.
`properties.description`	Falsk	snöre	Beskrivning av regelgrupp.
`properties.scopes`	Sann	sträng[]	Måste innehålla målarbetsytans ID för Azure Monitor. Kan också inkludera ytterligare ett kluster-ID.
`properties.enabled`	Falsk	Boolean	Aktivera/inaktivera gruppen. Standard är `true`.
`properties.clusterName`	Falsk	snöre	Måste matcha etiketten `cluster` som läggs till i metrik som hämtats från målklustret. Som standard anger du den sista delen (resursnamn) för kluster-ID:t som visas i `scopes[]`.
`properties.interval`	Falsk	snöre	Grupputvärderingsintervall. Standard = `PT1M`.

Inspelningsregler

Avsnittet rules innehåller följande egenskaper för inspelningsregler.

Namn	Krävs	Typ	Beskrivning
`record`	Sann	snöre	Namn på inspelningsregel. Det här namnet används för den nya tidsserien.
`expression`	Sann	snöre	PromQL-uttryck för att beräkna det nya tidsserievärdet.
`labels`	Sann	snöre	Prometheus-regeln etiketterar nyckel/värde-par. Dessa etiketter läggs till i den inspelade tidsserien.
`enabled`	Falsk	booleskt	Aktivera/inaktivera grupp. Standard är `true`.

Aviseringsregler

Avsnittet rules innehåller följande egenskaper för aviseringsregler.

Namn	Krävs	Typ	Beskrivning
`alert`	Falsk	snöre	Namn på aviseringsregel.
`expression`	Sann	snöre	PromQL-uttryck som ska utvärderas.
`for`	Falsk	snöre	Timeout för aviseringsavfyrning. Värden = `PT1M`, `PT5M`, osv.
`labels`	Falsk	objekt	Prometheus-aviseringsregeletiketter. Dessa etiketter läggs till i varningar som utlösts av den här regeln.
`rules.annotations`	Falsk	objekt	Anteckningar för nyckel/värde-par som ska läggas till i aviseringen.
`enabled`	Falsk	Boolean	Aktivera/inaktivera grupp. Standard är `true`.
`rules.severity`	Falsk	heltal	Allvarlighetsgrad för aviseringar. 0–4, standardvärdet är `3` (informationsbaserat).
`rules.resolveConfigurations.autoResolved`	Falsk	Boolean	När den är aktiverad löses aviseringen automatiskt när villkoret inte längre är sant. Standard = `true`.
`rules.resolveConfigurations.timeToResolve`	Falsk	snöre	Timeout för automatisk lösning av avisering. Standard = `PT5M`.
`rules.action[].actionGroupId`	falskt	snöre	Ett eller flera resurs-ID för åtgärdsgruppen. Var och en aktiveras när en avisering utlöses.

Konvertera Prometheus-regelfil till en hanterad Prometheus-regelgrupp

Om du har en Konfigurationsfil för Prometheus-regler i YAML-format kan du konvertera den till en ARM-mall för en Azure Managed Prometheus-regelgrupp med hjälp av verktyget az-prom-rules-converter. Regelfilen kan innehålla definitionen av en eller flera regelgrupper.

Förutom regelfilen kräver verktyget andra egenskaper som behövs för att skapa Azure Prometheus-regelgrupper, inklusive prenumeration, resursgrupp, plats, målarbetsyta i Azure Monitor, målkluster-ID och namn och åtgärdsgrupper. Verktyget skapar en mallfil som du kan distribuera med alla standardmetoder för att distribuera ARM-mallar.

Begränsa regler till ett visst kluster

Du kan också begränsa reglerna i en regelgrupp för att fråga efter data som kommer från ett enda specifikt kluster genom att lägga till ett klusteromfång i regelgruppen eller med hjälp av egenskapen regelgrupp clusterName . Begränsa regler till ett enda kluster om din Azure Monitor-arbetsyta innehåller en stor mängd data från flera kluster. I sådana fall finns det en oro för att körning av en enda uppsättning regler för alla data kan orsaka prestanda- eller begränsningsproblem. Genom att använda klusteromfånget kan du skapa flera regelgrupper, var och en konfigurerad med samma regler, där varje grupp täcker ett annat kluster.

Om du vill begränsa regelgruppen till ett klusteromfång med hjälp av en ARM-mall lägger du till Azure-resurs-ID-värdet för klustret i regelgrupplistan scopes[] . Omfångslistan måste fortfarande innehålla resurs-ID:t för Azure Monitor-arbetsytan. Följande klusterresurstyper stöds som ett klusteromfång:

Azure Kubernetes Service-kluster (Microsoft.ContainerService/managedClusters)
Azure Arc-aktiverade Kubernetes-kluster (Microsoft.kubernetes/connectedClusters)
Azure-anslutna enheter (Microsoft.ResourceConnector/appliances)

Förutom kluster-ID:t kan du konfigurera egenskapen clusterName i din regelgrupp. Egenskapen clusterName måste matcha etiketten cluster som läggs till i dina mått när den skrapas från ett specifikt kluster. Som standard är den här etiketten inställd på den sista delen (resursnamnet) för ditt kluster-ID. Om du har ändrat den här etiketten genom att använda inställningen cluster_alias i din ConfigMap för klusterskrapning måste du inkludera det uppdaterade värdet i egenskapen för regelgruppen clusterName. Om din skrapning använder standardetikettvärdet cluster är egenskapen clusterName valfri.

Här är ett exempel på hur en regelgrupp har konfigurerats för att begränsa frågan till ett specifikt kluster:

{
    "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": [
             {
                ...
             }
         ]
    }
}

Om både kluster-ID-omfånget och clusterName egenskapen inte har angetts för en regelgrupp frågar reglerna i gruppen data från alla kluster på arbetsytan från alla kluster.

Konfigurera detaljer för regelgruppen

Skärmbild som visar konfigurationen av en Inspelningsregel för Prometheus-regelgrupp.

Skärmbild som visar konfigurationen av Prometheus regelgruppens aviseringsregel.

Anmärkning

För aviseringsregler returnerar uttrycksfrågan vanligtvis bara tidsserier som uppfyller uttrycksvillkoret. Om förhandsgranskningsdiagrammet inte visas och du får meddelandet "Frågan returnerade inget resultat" är det troligt att villkoret inte uppfylldes i tidsintervallet för förhandsversionen.

Slutför skapandet av regelgruppen

På fliken Taggar anger du alla nödvändiga Azure-resurstaggar som ska läggas till i regelgruppresursen.
På fliken Granska + skapa verifieras regelgruppen och eventuella problem meddelas dig. På den här fliken kan du också välja alternativet Visa automatiseringsmall och ladda ned mallen för den grupp som du ska skapa.
När valideringen har godkänts och du har granskat inställningarna väljer du Skapa.
Du kan följa upp distributionen av regelgruppen för att försäkra dig om att den slutförs framgångsrikt eller för att få ett meddelande om eventuella fel.

Visa resurshälsotillstånden för dina Prometheus-regelgrupper

Nu kan du visa resurshälsotillståndet för din Prometheus-regelgrupp i portalen. Du kan identifiera problem i regelgrupper, till exempel felaktig konfiguration eller problem med frågebegränsning.

I portalen går du till översikten över den Prometheus-regelgrupp som du vill övervaka.
I den vänstra rutan går du till Hjälp och väljer Resurshälsa.
I fönstret Resurshälsa kan du se det aktuella tillgänglighetstillståndet för regelgruppen. Du kan också se en historik över de senaste resurshälsohändelserna, upp till de senaste 30 dagarna.
- Om regelgruppen är markerad som Tillgänglig fungerar den som förväntat.
- Om regelgruppen har markerats som Degraderad fungerar inte en eller flera regler i gruppen som förväntat. Regelfrågan kan begränsas eller så kan andra problem orsaka att regelutvärderingen misslyckas. Expandera statusposten för mer information om det identifierade problemet, förslag på åtgärder eller ytterligare felsökning.
- Om regelgruppen är markerad som Ej tillgänglig fungerar inte hela regelgruppen som förväntat. Det kan finnas ett konfigurationsproblem (till exempel att Azure Monitor-arbetsytan inte kan identifieras) eller interna tjänstproblem. Expandera statusposten för mer information om det identifierade problemet, förslag på åtgärder eller ytterligare felsökning.
- Om regelgruppen är markerad som Okänd inaktiveras hela regelgruppen eller är i ett okänt tillstånd.

Inaktivera och aktivera regelgrupper

Om du vill aktivera eller inaktivera en regel väljer du regelgruppen i Azure Portal. Välj Antingen Aktivera eller Inaktivera för att ändra dess status.

Feedback

Var den här sidan till hjälp?