az monitor metrics alert

  • 參考

管理近乎即時的計量警示規則。

命令

名稱 Description 類型 狀態
az monitor metrics alert condition

管理近乎即時的計量警示規則條件。

 核心 GA
az monitor metrics alert condition create

建置計量警示規則條件。

 核心 預覽版
az monitor metrics alert create

建立以計量為基礎的警示規則。

 核心 GA
az monitor metrics alert delete

刪除以計量為基礎的警示規則。

 核心 GA
az monitor metrics alert dimension

管理近乎即時的計量警示規則維度。

 核心 GA
az monitor metrics alert dimension create

建置計量警示規則維度。

 核心 預覽版
az monitor metrics alert list

列出以計量為基礎的警示規則。

 核心 GA
az monitor metrics alert show

顯示以計量為基礎的警示規則。

 核心 GA
az monitor metrics alert update

更新以計量為基礎的警示規則。

 核心 GA

az monitor metrics alert create

編輯

建立以計量為基礎的警示規則。

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]

範例

在沒有動作的 VM 上建立高 CPU 使用量警示。

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

使用電子郵件和 Webhook 動作在 VM 上建立高 CPU 使用量警示。

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"

當記憶體帳戶使用多維度篩選顯示大量緩慢交易時，建立警示。

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"

建立監視自定義計量的計量型警示規則。

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

在數個沒有動作的 VM 上建立高 CPU 使用量警示。

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

在沒有動作的數部 VM 上建立動態 CPU 使用量警示。

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

必要參數

--condition

觸發規則的條件。 它可以由 'az monitor metrics alert condition create' 命令建立。

使用量： --condition {avg，min，max，total，count} [NAMESPACE.]METRIC [{=，！=，>，>=<，，<=} THRESHOLD] [{<，>，><} 評估動態敏感度違規 [自 DATETIME]] [WHERE DIMENSION {includes，excludes} VALUE [or VALUE ...][and DIMENSION {includes，excludes} VALUE [or VALUE ...] ...]][含 skipmetricvalidation]

敏感度可以是 「低」、「中」、「高」。

違規可能是觸發警示的違規次數。 它應該較小或等於評估。

評估可以是動態閾值的評估期間數目。

Datetime 可以是開始學習計量歷程記錄數據的日期，並計算動態閾值（以ISO8601格式）。

您可以藉由新增 『where』 關鍵詞和多個維度來查詢維度，方法是結合 『and』 關鍵詞來查詢維度。

您可以從 命令取得 az monitor metrics list-definitions METRIC、DIMENSION 和適當 THRESHOLD 值的值。

由於伺服器限制，當警示規則包含多個準則時，每個準則內的維度使用限制為每個維度的一個值。

您可以使用多個 --condition 自變數來指定多個條件。

--name -n

警示規則的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--scopes

規則所套用的範圍以空格分隔的清單。 此參數中指定的資源必須具有相同類型，且存在於相同的位置。

選擇性參數

--action -a

新增動作群組和選擇性 Webhook 屬性，以在觸發警示時引發。

使用方式：-action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

您可以使用多個 --action 自變數來指定多個動作群組。

--auto-mitigate

自動解決警示。

接受的值: false, true
--description

規則的任意文字描述。

--disabled

以停用狀態建立規則。

接受的值: false, true
預設值: False
--evaluation-frequency

以 「##h##m##s」 格式評估規則的頻率。

預設值: 1m
--region --target-resource-region

範圍中目標資源的區域。 當範圍是資源群組或訂用帳戶時，必須提供此專案。

--severity

警示的嚴重性從 0 （重大） 到 4 （詳細資訊）。

預設值: 2
--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--target-resource-type --type

範圍中目標資源的資源類型。 當範圍是資源群組或訂用帳戶時，必須提供此專案。

--window-size

以 「##h##m##s」 格式匯總計量的時間。

預設值: 5m
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az monitor metrics alert delete

編輯

刪除以計量為基礎的警示規則。

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

範例

刪除以計量為基礎的警示規則。

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

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

警示規則的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az monitor metrics alert list

編輯

列出以計量為基礎的警示規則。

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

範例

列出以計量為基礎的警示規則。

az monitor metrics alert list --resource-group MyResourceGroup

選擇性參數

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az monitor metrics alert show

編輯

顯示以計量為基礎的警示規則。

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

範例

顯示以計量為基礎的警示規則。

az --name MyAlertRule --resource-group MyResourceGroup

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

警示規則的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az monitor metrics alert update

編輯

更新以計量為基礎的警示規則。

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]

範例

停用/啟用以計量為基礎的警示規則。

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

選擇性參數

--add

藉由指定路徑和索引鍵值組，將 物件加入物件清單。 範例：--add property.listProperty < key=value、string 或 JSON 字串 > 。

--add-action --add-actions

新增動作群組和選擇性 Webhook 屬性，以在觸發警示時引發。

使用方式：--add-action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

您可以使用多個 --add-action 引數來指定多個動作群組。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--add-condition --add-conditions

新增觸發規則的條件。

使用量：--add-condition {avg，min，max，total，count} [NAMESPACE.]METRIC [{=，！=， > ， > = < ，， < =} THRESHOLD] [{ < ， > ， >< } 評估動態敏感度違規 [自 DATETIME]] [WHERE DIMENSION {includes，excludes} VALUE [or VALUE ...][and DIMENSION {includes，excludes} VALUE [or VALUE ...] ...]]

敏感度可以是 「低」、「中」、「高」。

違規可能是觸發警示的違規次數。 它應該較小或等於評估。

評估可以是動態閾值的評估期間數目。

Datetime 可以是開始學習計量歷程記錄資料的日期，並計算動態閾值（以ISO8601格式）。

您可以藉由新增 'where' 關鍵字和多個維度來查詢維度，方法是結合 'and' 關鍵字來查詢維度。

您可以從 命令取得 az monitor metrics list-definitions METRIC、DIMENSION 和適當 THRESHOLD 值的值。

由於伺服器限制，當警示規則包含多個準則時，每個準則內的維度使用限制為每個維度的一個值。

您可以使用多個 --add-condition 引數來指定多個條件。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--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

用來評估格式規則 ##h##m##s 的頻率。

--force-string

使用 'set' 或 'add' 時，請保留字元串常值，而不是嘗試轉換成 JSON。

接受的值: 0, 1, f, false, n, no, t, true, y, yes
--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

警示規則的名稱。

--remove

從清單中移除屬性或專案。 範例：--remove property.list OR --remove 屬性ToRemove。

--remove-actions

要移除之動作組名的空間分隔清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--remove-conditions

要移除之條件名稱的空間分隔清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--scopes

規則所套用的範圍以空格分隔的清單。 此參數中指定的資源必須具有相同類型，且存在於相同的位置。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--set

指定要設定的屬性路徑和值，以更新物件。 範例：--set property1.property2=。

--severity

警示的嚴重性從 0 （重大） 到 4 （詳細資訊）。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--window-size

要匯總 ##h##m##s 格式計量的時間。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。