Udostępnij za pośrednictwem

az monitor metrics alert

  • Odwołanie

Zarządzanie regułami alertów dotyczących metryk niemal w czasie rzeczywistym.

Polecenia

Nazwa Opis Typ Stan
az monitor metrics alert condition

Zarządzanie warunkami reguły alertów dotyczących metryk niemal w czasie rzeczywistym.

 Podstawowe funkcje Ogólna dostępność
az monitor metrics alert condition create

Utwórz warunek reguły alertu metryki.

 Podstawowe funkcje Wersja Preview
az monitor metrics alert create

Utwórz regułę alertu opartą na metryce.

 Podstawowe funkcje Ogólna dostępność
az monitor metrics alert delete

Usuń regułę alertu opartą na metrykach.

 Podstawowe funkcje Ogólna dostępność
az monitor metrics alert dimension

Zarządzanie wymiarami reguły alertów dotyczących metryk niemal w czasie rzeczywistym.

 Podstawowe funkcje Ogólna dostępność
az monitor metrics alert dimension create

Utwórz wymiar reguły alertu dotyczącego metryki.

 Podstawowe funkcje Wersja Preview
az monitor metrics alert list

Wyświetlanie listy reguł alertów opartych na metryce.

 Podstawowe funkcje Ogólna dostępność
az monitor metrics alert show

Pokaż regułę alertu opartą na metrykach.

 Podstawowe funkcje Ogólna dostępność
az monitor metrics alert update

Zaktualizuj regułę alertu opartą na metryce.

 Podstawowe funkcje Ogólna dostępność

az monitor metrics alert create

Edytuj

Utwórz regułę alertu opartą na metryce.

az monitor metrics alert create --condition
                                --name
                                --resource-group
                                --scopes
                                [--action]
                                [--auto-mitigate {false, true}]
                                [--description]
                                [--disabled {false, true}]
                                [--evaluation-frequency]
                                [--region]
                                [--severity]
                                [--tags]
                                [--target-resource-type]
                                [--window-size]

Przykłady

Utwórz alert wysokiego użycia procesora CPU na maszynie wirtualnej bez akcji.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} --condition "avg Percentage CPU > 90" --description "High CPU"

Utwórz alert dotyczący wysokiego użycia procesora CPU na maszynie wirtualnej z akcjami poczty e-mail i elementu webhook.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} \
    --condition "avg Percentage CPU > 90" --window-size 5m --evaluation-frequency 1m \
    --action "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Insights/actionGroups/<actionGroupName>" apiKey={APIKey} type=HighCPU \
    --description "High CPU"

Utwórz alert, gdy konto magazynu wyświetla dużą liczbę powolnych transakcji przy użyciu filtrów wielowymiarowych.

az monitor metrics alert create -g {ResourceGroup} -n alert1 --scopes {StorageAccountId} \
    --description "Storage Slow Transactions" \
    --condition "total transactions > 5 where ResponseType includes Success" \
    --condition "avg SuccessE2ELatency > 250 where ApiName includes GetBlob"

Utwórz regułę alertu opartą na metrykach, która monitoruje niestandardową metrykę.

az monitor metrics alert create -n "metric alert rule on a custom metric" -g "Demos" --scopes {VirtualMachineID} \
    --condition "max Azure.VM.Windows.GuestMetrics.Memory\Available Bytes > 90" \
    --window-size 5m --evaluation-frequency 1m

Utwórz alert wysokiego użycia procesora CPU na kilku maszynach wirtualnych bez akcji.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > 90" --description "High CPU" --region westus

Utwórz dynamiczny alert użycia procesora CPU na kilku maszynach wirtualnych bez akcji.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > dynamic medium 2 of 4 since 2020-10-01T10:23:00.000Z"
    --description "Dynamic CPU"
    --window-size 5m
    --region westus

Parametry wymagane

--condition

Warunek, który wyzwala regułę. Można go utworzyć za pomocą polecenia "az monitor metrics alert condition create".

Użycie: --condition {avg,min,max,total,count} [NAMESPACE.] METRYKA [{=,!=,>=,<<>,=}PRÓG] [{<,>,><}dynamiczne NARUSZENIA POUFNOŚCI OCEN [od DATY/GODZINY]] [gdzie WYMIAR {zawiera,wyklucza} WARTOŚĆ [lub WARTOŚĆ ...] [i WYMIAR {zawiera,wyklucza} WARTOŚĆ [lub WARTOŚĆ ...] ...]] [z skipmetricvalidation]

Czułość może być "niska", "średnia", "wysoka".

Naruszenia mogą być liczbą naruszeń wyzwalania alertu. Powinna być mniejsza lub równa ocenie.

Oceny mogą być liczbą okresów oceny dla progu dynamicznego.

Data/godzina może być datą rozpoczęcia uczenia się danych historycznych metryki i obliczania progów dynamicznych (w formacie ISO8601).

Można wykonywać zapytania dotyczące wymiarów, dodając słowo kluczowe "where" i wiele wymiarów, łącząc je ze słowem kluczowym "and".

Wartości dla METRYKI, WYMIAR i odpowiednie wartości PROGowe można uzyskać z az monitor metrics list-definitions polecenia .

Ze względu na ograniczenie serwera, gdy reguła alertu zawiera wiele kryteriów, użycie wymiarów jest ograniczone do jednej wartości na wymiar w ramach każdego kryterium.

Wiele warunków można określić przy użyciu więcej niż jednego --condition argumentu.

--name -n

Nazwa reguły alertu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--scopes

Rozdzielona spacjami lista zakresów, do których ma zastosowanie reguła. Zasoby określone w tym parametrze muszą być tego samego typu i istnieją w tej samej lokalizacji.

Parametry opcjonalne

--action -a

Dodaj grupę akcji i opcjonalne właściwości elementu webhook do uruchomienia po wyzwoleniu alertu.

Użycie: --action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

Można określić wiele grup akcji przy użyciu więcej niż jednego --action argumentu.

--auto-mitigate

Automatycznie rozwiąż alert.

akceptowane wartości: false, true
--description

Dowolny tekst opisu reguły.

--disabled

Utwórz regułę w stanie wyłączonym.

akceptowane wartości: false, true
wartość domyślna: False
--evaluation-frequency

Częstotliwość oceniania reguły w formacie "##h##m##s".

wartość domyślna: 1m
--region --target-resource-region

Region zasobów docelowych w zakresach. Należy to podać, gdy zakresy są grupą zasobów lub subskrypcją.

--severity

Ważność alertu z zakresu od 0 (krytyczne) do 4 (pełne).

wartość domyślna: 2
--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--target-resource-type --type

Typ zasobu docelowego zasobów w zakresach. Należy to podać, gdy zakresy są grupą zasobów lub subskrypcją.

--window-size

Czas agregowania metryk w formacie "##h#m##s".

wartość domyślna: 5m
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az monitor metrics alert delete

Edytuj

Usuń regułę alertu opartą na metrykach.

az monitor metrics alert delete [--ids]
                                [--name]
                                [--resource-group]
                                [--subscription]

Przykłady

Usuń regułę alertu opartą na metrykach.

az monitor metrics alert delete --name MyAlertRule --resource-group MyResourceGroup

Parametry opcjonalne

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa reguły alertu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az monitor metrics alert list

Edytuj

Wyświetlanie listy reguł alertów opartych na metryce.

az monitor metrics alert list [--resource-group]

Przykłady

Wyświetlanie listy reguł alertów opartych na metryce.

az monitor metrics alert list --resource-group MyResourceGroup

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az monitor metrics alert show

Edytuj

Pokaż regułę alertu opartą na metrykach.

az monitor metrics alert show [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

Przykłady

Pokaż regułę alertu opartą na metrykach.

az --name MyAlertRule --resource-group MyResourceGroup

Parametry opcjonalne

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa reguły alertu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az monitor metrics alert update

Edytuj

Zaktualizuj regułę alertu opartą na metryce.

az monitor metrics alert update [--add]
                                [--add-action]
                                [--add-condition]
                                [--auto-mitigate {0, 1, f, false, n, no, t, true, y, yes}]
                                [--description]
                                [--enabled {0, 1, f, false, n, no, t, true, y, yes}]
                                [--evaluation-frequency]
                                [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                [--ids]
                                [--name]
                                [--remove]
                                [--remove-actions]
                                [--remove-conditions]
                                [--resource-group]
                                [--scopes]
                                [--set]
                                [--severity]
                                [--subscription]
                                [--tags]
                                [--window-size]

Przykłady

Wyłącz/włącz regułę alertu opartą na metryce.

az monitor metrics alert update --enabled false --name MyAlertRule --resource-group MyResourceGroup

Parametry opcjonalne

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string lub ciąg> JSON.

--add-action --add-actions

Dodaj grupę akcji i opcjonalne właściwości elementu webhook do uruchomienia po wyzwoleniu alertu.

Użycie: --add-action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

Można określić wiele grup akcji przy użyciu więcej niż jednego --add-action argumentu. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--add-condition --add-conditions

Dodaj warunek, który wyzwala regułę.

Użycie: --add-condition {avg,min,max,total,count} [NAMESPACE.] METRYKA [{=,!=,>=,<<>,=}PRÓG] [{<,>,><}dynamiczne NARUSZENIA POUFNOŚCI OCEN [od DATY/GODZINY]] [gdzie WYMIAR {zawiera,wyklucza} WARTOŚĆ [lub WARTOŚĆ ...] [i WYMIAR {zawiera,wyklucza} WARTOŚĆ [lub WARTOŚĆ ...] ...]]

Czułość może być "niska", "średnia", "wysoka".

Naruszenia mogą być liczbą naruszeń wyzwalania alertu. Powinna być mniejsza lub równa ocenie.

Oceny mogą być liczbą okresów oceny dla progu dynamicznego.

Data/godzina może być datą rozpoczęcia uczenia się danych historycznych metryki i obliczania progów dynamicznych (w formacie ISO8601).

Można wykonywać zapytania dotyczące wymiarów, dodając słowo kluczowe "where" i wiele wymiarów, łącząc je ze słowem kluczowym "and".

Wartości dla METRYKI, WYMIAR i odpowiednie wartości PROGowe można uzyskać z az monitor metrics list-definitions polecenia .

Ze względu na ograniczenie serwera, gdy reguła alertu zawiera wiele kryteriów, użycie wymiarów jest ograniczone do jednej wartości na wymiar w ramach każdego kryterium.

Wiele warunków można określić przy użyciu więcej niż jednego --add-condition argumentu. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--auto-mitigate

Automatycznie rozwiąż alert.

akceptowane wartości: 0, 1, f, false, n, no, t, true, y, yes
--description

Dowolny tekst opisu reguły.

--enabled

Określa, czy reguła alertu metryki jest włączona.

akceptowane wartości: 0, 1, f, false, n, no, t, true, y, yes
--evaluation-frequency

Częstotliwość oceniania reguły w ##h##m##s formacie.

--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

akceptowane wartości: 0, 1, f, false, n, no, t, true, y, yes
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa reguły alertu.

--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list OR --remove propertyToRemove.

--remove-actions

Rozdzielona spacjami lista nazw grup akcji do usunięcia. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--remove-conditions

Rozdzielona spacjami lista nazw warunków do usunięcia. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--scopes

Rozdzielona spacjami lista zakresów, do których ma zastosowanie reguła. Zasoby określone w tym parametrze muszą być tego samego typu i istnieją w tej samej lokalizacji. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=.

--severity

Ważność alertu z zakresu od 0 (krytyczne) do 4 (pełne).

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

--window-size

Czas agregowania metryk w ##h##m##s formacie.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.