Monitoraggio di Azure servizio gestito per i gruppi di regole Prometheus

Le regole in Prometheus agiscono sui dati durante la raccolta dei dati, per precompilare i valori archiviati nella serie temporale o per avvisare le condizioni predefinite nelle metriche raccolte. Monitoraggio di Azure servizio gestito per Prometheus fornisce set predefiniti di ogni tipo di regola e consente di creare e gestire regole personalizzate usando il portale di Azure.

Tipi di gruppi di regole

Un gruppo di regole Prometheus è una raccolta di regole di avviso/o regole di registrazione valutate insieme. Ogni regola deve essere membro di un singolo gruppo di regole. I gruppi di regole definiscono l'ambito di tutte le regole nel gruppo e la frequenza di valutazione.

Esistono due tipi di regole di Prometheus.

TIPO	Descrizione
Avviso	regole Alert consentono di creare un avviso Monitoraggio di Azure in base ai risultati di una query PromQL (Prometheus Query Language). Gli avvisi generati dalle regole di allerta gestite di Azure Prometheus vengono elaborati e attivano notifiche in maniera simile ad altri avvisi di Monitoraggio di Azure.
Registrazione	Le regole di registrazione consentono di precompilare le espressioni frequenti o computazionali e archiviare il risultato come un nuovo set di serie temporali. Le serie temporali create dalle regole di registrazione vengono inserite nuovamente nell'area di lavoro Monitoraggio di Azure come nuove metriche di Prometheus.

Azure gruppi di regole Prometheus gestiti seguono la struttura e la terminologia dei gruppi di regole Prometheus open-source. I nomi delle regole, le espressioni, le etichette e le annotazioni sono tutti supportati in Azure.

Esistono tuttavia alcune differenze tra Azure gruppi di regole prometheus gestiti e gruppi di regole Prometheus open source. Azure i gruppi di regole di Prometheus gestiti vengono gestiti come risorse Azure e includono informazioni necessarie per la gestione delle risorse, ad esempio la sottoscrizione e il gruppo di risorse in cui deve risiedere il gruppo di regole Azure. Le regole di avviso includono proprietà dedicate, ad esempio gravità dell'avviso, associazione di gruppi di azioni e configurazione autoresolve degli avvisi, che consentono l'elaborazione degli avvisi come altri avvisi Monitoraggio di Azure.

Ambito di un gruppo di regole

L'ambito di un gruppo di regole nei gruppi di regole gestiti di Prometheus in Azure, definisce le risorse alle quali si applicano le regole nel gruppo. Le singole regole non possono essere applicate direttamente a un cluster Kubernetes. Nella tabella seguente vengono descritti i diversi ambiti del gruppo di regole.

Ambito	Descrizione
Tutti i cluster nell'area di lavoro	Tutte le regole abilitate nel gruppo verranno applicate a tutti i cluster attualmente connessi all'area di lavoro Monitoraggio di Azure.
Cluster specifico - Nome del cluster	Tutte le regole abilitate nel gruppo verranno applicate solo al cluster selezionato.
Cluster specificato - Nome del cluster nella query	Tutte le regole abilitate nel gruppo verranno applicate ai cluster con il testo specificato nel nome.

Visualizzare i gruppi di regole Prometheus

Esistono diversi modi per visualizzare i gruppi di regole Prometheus e le relative regole nel portale di Azure.

Rules in un'area di lavoro Monitoraggio di Azure

Selezionare Gruppi di regole da un'area di lavoro Monitoraggio di Azure nel portale di Azure per visualizzare tutti i gruppi di regole nell'area di lavoro. È possibile espandere qualsiasi gruppo di regole per visualizzare l'elenco delle regole in tale gruppo. Selezionare un gruppo o una regola per visualizzarne i dettagli.

Tutte le regole

Nella pagina Alerts del menu Monitor nel portale di Azure, selezionare Gruppi di regole Prometheus per visualizzare tutti i gruppi di regole nelle sottoscrizioni a cui si ha accesso.

Screenshot che mostra come visualizzare i gruppi di regole Prometheus dalla schermata degli avvisi.

Questa vista identifica l'area di lavoro in cui si trova il gruppo di regole, se è abilitata e il cluster se il gruppo di regole è limitato a un ambito cluster specifico. Usare i filtri nella parte superiore della schermata per restringere l'elenco dei gruppi di regole in base a varie proprietà. È possibile eliminare più gruppi di regole da questa visualizzazione selezionandoli e quindi facendo clic su Elimina. Ciò può essere utile, ad esempio, per pulire i gruppi di regole che non sono più necessari dopo l'eliminazione di un cluster.

Screenshot di tutti i gruppi di regole di Prometheus.

Suggerimento

È anche possibile accedere a questa stessa visualizzazione dalla pagina Avvisi di un cluster Kubernetes. Verrà impostato il filtro iniziale sui gruppi di regole limitati a quel cluster.

Creare gruppi di regole e regole Prometheus

Portal di Azure

Aprire la visualizzazione Tutte le regole descritte su e selezionare + Crea

Screenshot che mostra l'opzione per creare un nuovo gruppo di regole Prometheus.

Scope

Impostazione	Descrizione
area di lavoro Monitoraggio di Azure	L'area di lavoro Monitoraggio di Azure da cui il gruppo di regole eseguirà query sui dati. Questo valore non può essere modificato per un gruppo di regole esistente.
Posizione	Posizione dell'area di lavoro Monitoraggio di Azure selezionata.
Cluster	Specifica dove il gruppo di regole si applica a tutti i cluster nell'area di lavoro o in un cluster specifico. Selezionare un cluster specifico o immettere il testo da trovare in base ai nomi del cluster.

dettagli

Impostazione	Descrizione
Subscription	Abbonamento in cui verrà creata la risorsa del gruppo di regole. Questo valore non può essere modificato per un gruppo di regole esistente.
Gruppo di risorse	Gruppo di risorse in cui verrà creata la risorsa del gruppo di regole. Questo valore non può essere modificato per un gruppo di regole esistente.
Nome	Nome della risorsa del gruppo di regole. Questo nome deve essere univoco all'interno del gruppo di risorse selezionato. Questo valore non può essere modificato per un gruppo di regole esistente.
Descrizione	Descrizione del gruppo di regole.
Valutare ogni	Frequenza con cui vengono valutate le regole nel gruppo. Il valore predefinito è 1 minuto.
Enabled	Abilitare o disabilitare il gruppo di regole. I gruppi di regole disabilitati verranno comunque creati, ma le regole verranno eseguite solo se il gruppo è abilitato.
Etichette	Coppie di chiave/valore dell'etichetta opzionale per la regola. Queste etichette vengono aggiunte alla metrica creata dalla regola.

Regole

Selezionare Aggiungi regola di registrazione o Aggiungi regola di avviso per aggiungere regole al gruppo. Ogni tipo di regola ha impostazioni diverse, come descritto di seguito.

Regole di registrazione

Impostazione	Descrizione
Nome	Nome della regola di registrazione. Questo nome viene usato per la metrica creata dalla regola.
Enabled	Specifica se la regola è abilitata o disabilitata. Le regole disabilitate verranno create, ma non verranno valutate fino all'abilitazione.
Expression	Espressione PromQL che definisce la regola. Selezionare Esegui query per visualizzare i risultati della query dell'espressione visualizzata nel grafico di anteprima. Modificare l'intervallo di tempo di anteprima per ingrandire o ridurre la cronologia dei risultati dell'espressione.

Regole di avviso

Impostazione	Descrizione
Nome	Nome della regola di registrazione. Questo nome è il nome degli avvisi generati dalla regola.
Severity	Valore di gravità per gli avvisi attivati da questa regola.
Expression	Espressione PromQL che definisce la regola. Selezionare Esegui query per visualizzare i risultati della query dell'espressione visualizzata nel grafico di anteprima. Modificare l'intervallo di tempo di anteprima per ingrandire o ridurre la cronologia dei risultati dell'espressione.
Aspettare	Periodo di tempo compreso tra il primo momento in cui l'espressione di avviso diventa vera e fino a quando l'avviso viene attivato.
Etichette	Coppie di chiave/valore dell'etichetta opzionale per la regola. Queste etichette vengono aggiunte agli avvisi generati dalla regola.
Annotations	Coppie chiave/valore di annotazione facoltative per la regola. Queste annotazioni vengono aggiunte agli avvisi generati dalla regola.
Gruppi di azioni	Gruppi di azioni che definiscono la risposta all'avviso generato.
Enabled	Specifica se la regola è abilitata o disabilitata. Le regole disabilitate verranno create, ma non verranno valutate fino all'abilitazione.
Risolvere automaticamente gli avvisi	Risolvere automaticamente gli avvisi se la condizione della regola non è più vera durante il periodo di tempo per la risoluzione automatica.

Configurare l'ambito del gruppo di regole

Nella scheda Ambito :

1. Selezionare l'area di lavoro Monitoraggio di Azure da un elenco di aree di lavoro disponibili nelle sottoscrizioni. Le regole in questo gruppo eseguono query sui dati da questa area di lavoro.

2. Per limitare il gruppo di regole a un ambito cluster, selezionare l'opzione Cluster specifico :

   • Selezionare il cluster dall'elenco dei cluster già connessi all'area di lavoro selezionata Monitoraggio di Azure.
   • Il valore predefinito Nome cluster viene immesso automaticamente. Modificare questo valore solo se il valore dell'etichetta del cluster è stato modificato usando cluster_alias.

3. Selezionare Avanti per configurare i dettagli del gruppo di regole.

   Screenshot che mostra la configurazione dell'ambito del gruppo di regole Prometheus.

Usare il comando az alerts-management prometheus-rule-group create per creare un nuovo gruppo di regole Prometheus.

 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

Per creare un gruppo di regole Prometheus usando PowerShell, usare il 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

Il modello di esempio seguente crea un gruppo di regole Prometheus, inclusa una regola di registrazione e una regola di avviso. Questo modello crea una risorsa di tipo . L'ambito di questo gruppo è limitato a un singolo cluster AKS. Le regole vengono eseguite nell'ordine in cui vengono visualizzate all'interno di un gruppo.

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

Il gruppo di regole contiene le proprietà seguenti.

Nome	Obbligatorio	TIPO	Descrizione
name	Vero	string	Nome del gruppo di regole Prometheus.
type	Vero	string	Microsoft.AlertsManagement/prometheusRuleGroups
apiVersion	Vero	string	2023-03-01
location	Vero	string	Posizione della risorsa all'esterno delle aree supportate.
properties.description	Falso	string	Descrizione del gruppo di regole.
properties.scopes	Vero	string[]	Deve includere l'ID dell'area di lavoro Monitoraggio di Azure di destinazione. Facoltativamente, è possibile includere un altro ID cluster.
properties.enabled	Falso	Boolean	Abilitare/disabilitare il gruppo. Il valore predefinito è .
properties.clusterName	Falso	string	Deve corrispondere all'etichetta aggiunta alle metriche raccolte dal cluster di destinazione. Per impostazione predefinita, impostare sull'ultima parte (nome risorsa) dell'ID cluster visualizzato in .
properties.interval	Falso	string	Intervallo di valutazione di gruppo. Valore predefinito = .

Regole di registrazione

La sezione contiene le proprietà seguenti per le regole di registrazione.

Nome	Obbligatorio	TIPO	Descrizione
record	Vero	string	Nome regola di registrazione. Questo nome viene usato per la nuova serie temporale.
expression	Vero	string	Espressione PromQL per calcolare il nuovo valore della serie temporale.
labels	Vero	string	Le regole di Prometheus etichettano le coppie chiave/valore. Queste etichette vengono aggiunte alla serie temporale registrata.
enabled	Falso	boolean	Abilitare/disabilitare il gruppo. Il valore predefinito è .

Regole di avviso

La sezione contiene le proprietà seguenti per le regole di avviso.

Nome	Obbligatorio	TIPO	Descrizione
alert	Falso	string	Nome della regola di avviso.
expression	Vero	string	Espressione PromQL da valutare.
for	Falso	string	Timeout di attivazione avvisi. Valori = , e così via.
labels	Falso	oggetto	Etichette di regole di avviso di Prometheus. Queste etichette vengono aggiunte agli avvisi generati da questa regola.
rules.annotations	Falso	oggetto	Annotazioni coppie chiave/valore da aggiungere all'avviso.
enabled	Falso	Boolean	Abilitare/disabilitare il gruppo. Il valore predefinito è .
rules.severity	Falso	integer	Gravità degli avvisi. 0-4, il valore predefinito è (informativo).
rules.resolveConfigurations.autoResolved	Falso	Boolean	Se abilitato, l'avviso viene risolto automaticamente quando la condizione non è più true. Valore predefinito = .
rules.resolveConfigurations.timeToResolve	Falso	string	Timeout di risoluzione automatica degli avvisi. Valore predefinito = .
rules.action[].actionGroupId	falso	string	Uno o più ID risorsa del gruppo di azioni. Ognuno viene attivato quando viene generato un avviso.

Bicep

Il modello di esempio seguente crea un gruppo di regole Prometheus, inclusa una regola di registrazione e una regola di avviso. Questo modello crea una risorsa di tipo . L'ambito di questo gruppo è limitato a un singolo cluster AKS. Le regole vengono eseguite nell'ordine in cui vengono visualizzate all'interno di un gruppo.

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>'
                    }
                ]
            }
        ]
    }
}

Il gruppo di regole contiene le proprietà seguenti.

Nome	Obbligatorio	TIPO	Descrizione
name	Vero	string	Nome del gruppo di regole Prometheus.
type	Vero	string	Microsoft.AlertsManagement/prometheusRuleGroups
apiVersion	Vero	string	2023-03-01
location	Vero	string	Posizione della risorsa all'esterno delle aree supportate.
properties.description	Falso	string	Descrizione del gruppo di regole.
properties.scopes	Vero	string[]	Deve includere l'ID dell'area di lavoro Monitoraggio di Azure di destinazione. Facoltativamente, è possibile includere un altro ID cluster.
properties.enabled	Falso	Boolean	Abilitare/disabilitare il gruppo. Il valore predefinito è .
properties.clusterName	Falso	string	Deve corrispondere all'etichetta aggiunta alle metriche raccolte dal cluster di destinazione. Per impostazione predefinita, impostare sull'ultima parte (nome risorsa) dell'ID cluster visualizzato in .
properties.interval	Falso	string	Intervallo di valutazione di gruppo. Valore predefinito = .

Regole di registrazione

La sezione contiene le proprietà seguenti per le regole di registrazione.

Nome	Obbligatorio	TIPO	Descrizione
record	Vero	string	Nome regola di registrazione. Questo nome viene usato per la nuova serie temporale.
expression	Vero	string	Espressione PromQL per calcolare il nuovo valore della serie temporale.
labels	Vero	string	Le regole di Prometheus etichettano le coppie chiave/valore. Queste etichette vengono aggiunte alla serie temporale registrata.
enabled	Falso	boolean	Abilitare/disabilitare il gruppo. Il valore predefinito è .

Regole di avviso

La sezione contiene le proprietà seguenti per le regole di avviso.

Nome	Obbligatorio	TIPO	Descrizione
alert	Falso	string	Nome della regola di avviso.
expression	Vero	string	Espressione PromQL da valutare.
for	Falso	string	Timeout di attivazione avvisi. Valori = , e così via.
labels	Falso	oggetto	Etichette di regole di avviso di Prometheus. Queste etichette vengono aggiunte agli avvisi generati da questa regola.
rules.annotations	Falso	oggetto	Annotazioni coppie chiave/valore da aggiungere all'avviso.
enabled	Falso	Boolean	Abilitare/disabilitare il gruppo. Il valore predefinito è .
rules.severity	Falso	integer	Gravità degli avvisi. 0-4, il valore predefinito è (informativo).
rules.resolveConfigurations.autoResolved	Falso	Boolean	Se abilitato, l'avviso viene risolto automaticamente quando la condizione non è più true. Valore predefinito = .
rules.resolveConfigurations.timeToResolve	Falso	string	Timeout di risoluzione automatica degli avvisi. Valore predefinito = .
rules.action[].actionGroupId	falso	string	Uno o più ID risorsa del gruppo di azioni. Ognuno viene attivato quando viene generato un avviso.

Convertire il file delle regole di Prometheus in un gruppo di regole Prometheus gestito

Se si dispone di un file di configurazione delle regole Prometheus in formato YAML, è possibile convertirlo in un modello ARM per un gruppo di regole Prometheus gestito di Azure utilizzando l'utility az-prom-rules-converter. Il file delle regole può contenere la definizione di uno o più gruppi di regole.

Oltre al file delle regole, l'utilità richiede altre proprietà necessarie per creare i gruppi di regole di Azure Prometheus, tra cui la sottoscrizione, il gruppo di risorse, la posizione, l'area di lavoro di destinazione di Monitoraggio di Azure, l'ID e il nome del cluster di destinazione e i gruppi di azioni. L'utilità crea un file modello che è possibile distribuire usando qualsiasi metodo standard per la distribuzione di modelli ARM.

Limitare le regole a un cluster specifico

Facoltativamente, è possibile limitare le regole in un gruppo di regole per eseguire query sui dati provenienti da un singolo cluster aggiungendo un ambito cluster al gruppo di regole o usando la proprietà del gruppo di regole. Limitare le regole a un singolo cluster se l'area di lavoro Monitoraggio di Azure contiene una grande quantità di dati di più cluster. In questo caso, l'esecuzione di un singolo set di regole su tutti i dati potrebbe causare problemi di prestazioni o di limitazione della velocità. Usando l'ambito del cluster, è possibile creare più gruppi di regole, ognuno configurato con le stesse regole ognuno dei quali copre un cluster diverso.

Per limitare il gruppo di regole a un ambito cluster utilizzando un modello di Resource Manager, aggiungere il valore dell'ID risorsa Azure del cluster all'elenco del gruppo di regole scopes[]. L'elenco degli ambiti deve comunque includere l'ID risorsa dell'area di lavoro Monitoraggio di Azure. I tipi di risorse cluster seguenti sono supportati come ambito cluster:

• cluster servizio Azure Kubernetes (Microsoft.ContainerService/managedClusters)
• cluster Kubernetes abilitati per Azure Arc (Microsoft.kubernetes/connectedClusters)
• Azure dispositivi connessi (Microsoft.ResourceConnector/appliances)

Oltre all'ID cluster, è possibile configurare la proprietà del gruppo di regole. La proprietà deve corrispondere all'etichetta aggiunta alle metriche quando vengono raccolte da un determinato cluster. Per impostazione predefinita, questa etichetta è impostata sull'ultima parte (nome della risorsa) dell'ID cluster. Se questa etichetta è stata modificata usando l'impostazione cluster_alias nel cluster scraping ConfigMap, è necessario includere il valore aggiornato nella proprietà del gruppo di regole. Se lo scorporo usa il valore predefinito dell'etichetta , la proprietà è facoltativa.

Di seguito è riportato un esempio di configurazione di un gruppo di regole per limitare la query a un cluster specifico:

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

Se sia l'ambito ID cluster sia la proprietà non sono specificati per un gruppo di regole, le regole nel gruppo eseguono query sui dati da tutti i cluster nell'area di lavoro da tutti i cluster.

Configurare i dettagli del gruppo di regole

Screenshot che mostra la configurazione di una regola di registrazione del gruppo di regole Prometheus.

Screenshot che mostra la configurazione della regola di avviso del gruppo di regole Prometheus.

Annotazioni

Per le regole di avviso, la query di espressione in genere restituisce solo serie temporali che soddisfano la condizione dell'espressione. Se il grafico di anteprima non viene visualizzato e viene visualizzato il messaggio "La query non ha restituito alcun risultato", è probabile che la condizione non sia stata soddisfatta nell'intervallo di tempo di anteprima.

Completare la creazione del gruppo di regole

1. Nella scheda Tags impostare eventuali tag di risorsa Azure necessari da aggiungere alla risorsa del gruppo di regole.

   Screenshot che mostra la scheda Tag durante la creazione di una nuova regola di avviso.

2. Nella scheda Rivedi e crea il gruppo di regole viene convalidato e consente di conoscere eventuali problemi. In questa scheda è anche possibile selezionare l'opzione Visualizza modello di automazione e scaricare il modello per il gruppo che si sta per creare.

3. Dopo aver superato la convalida e aver esaminato le impostazioni, selezionare Crea.

   Screenshot che mostra la scheda Rivedi e crea quando si crea una nuova regola di avviso.

4. È possibile monitorare la distribuzione del gruppo di regole per assicurarsi del corretto completamento o per ricevere una notifica di eventuali errori.

Visualizzare gli stati di integrità delle risorse dei gruppi di regole Prometheus

È ora possibile visualizzare lo stato di integrità risorse del gruppo di regole Prometheus nel portale. È possibile rilevare problemi nei gruppi di regole, ad esempio una configurazione non corretta o problemi di limitazione delle query.

1. Nel portale passare alla panoramica del gruppo di regole Prometheus da monitorare.

2. Nel riquadro sinistro, in Guida, selezionare Integrità risorse.

   Screenshot che mostra come visualizzare lo stato di integrità delle risorse di un gruppo di regole Prometheus.

3. Nel riquadro Integrità risorse è possibile visualizzare lo stato di disponibilità corrente del gruppo di regole. È anche possibile visualizzare una cronologia degli eventi di integrità delle risorse recenti, fino agli ultimi 30 giorni.

   Screenshot che mostra come visualizzare la cronologia dello stato di salute delle risorse di un gruppo di regole di Prometheus.

   • Se il gruppo di regole è contrassegnato come Disponibile, funziona come previsto.
   • Se il gruppo di regole è contrassegnato come danneggiato, una o più regole nel gruppo non funzionano come previsto. La query della regola potrebbe presentare limitazioni o altri problemi potrebbero causare l'esito negativo della valutazione della regola. Espandere la voce di stato per altre informazioni sul problema rilevato, suggerimenti per la mitigazione o un'ulteriore risoluzione dei problemi.
   • Se il gruppo di regole è contrassegnato come Non disponibile, l'intero gruppo di regole non funziona come previsto. Potrebbe verificarsi un problema di configurazione( ad esempio, l'area di lavoro Monitoraggio di Azure non può essere rilevata) o problemi interni del servizio. Espandere la voce di stato per altre informazioni sul problema rilevato, suggerimenti per la mitigazione o un'ulteriore risoluzione dei problemi.
   • Se il gruppo di regole è contrassegnato come Sconosciuto, l'intero gruppo di regole è disabilitato o è in uno stato sconosciuto.

Disabilitare e abilitare i gruppi di regole

Per abilitare o disabilitare una regola, selezionare il gruppo di regole nel portale di Azure. Selezionare Abilita o Disabilita per modificarne lo stato.

Contenuti correlati

• Altre informazioni sugli avvisi di Azure
• Documentazione di Prometheus per le regole di registrazione
• Documentazione di Prometheus per le regole di avviso