次の方法で共有


az monitor metrics alert

ほぼリアルタイムのメトリック アラート ルールを管理します。

コマンド

名前 説明 状態
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] [{>,><,<} 評価の動的秘密度違反 [since DATETIME]] [WHERE DIMENSION {includes,excludes} VALUE [or VALUE ...][AND DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]][skipmetricvalidation を使用する]

感度は、"低"、"中"、"高" にすることができます。

違反には、アラートをトリガーする違反の数を指定できます。 評価と同じか小さいか等しい必要があります。

評価には、動的しきい値の評価期間の数を指定できます。

Datetime は、メトリック履歴データの学習を開始し、動的しきい値を計算する日付 (ISO8601形式) です。

"where" キーワードを追加することでディメンションを照会でき、複数のディメンションを 'and' キーワードと組み合わせることでクエリを実行できます。

METRIC、DIMENSION、および適切な THRESHOLD 値の値は、az monitor metrics list-definitions コマンドから取得できます。

サーバーの制限により、アラート ルールに複数の条件が含まれている場合、ディメンションの使用は、各条件内のディメンションごとに 1 つの値に制限されます。

複数の --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

サブスクリプションの名前または ID。 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

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

アラート ルールの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 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

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

アラート ルールの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 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 or JSON string>

--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] [{>,><,<} 評価の動的秘密度違反 [since DATETIME]] [WHERE DIMENSION {includes,excludes} VALUE [or VALUE ...][AND DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]]

感度は、"低"、"中"、"高" にすることができます。

違反には、アラートをトリガーする違反の数を指定できます。 評価と同じか小さいか等しい必要があります。

評価には、動的しきい値の評価期間の数を指定できます。

Datetime は、メトリック履歴データの学習を開始し、動的しきい値を計算する日付 (ISO8601形式) です。

"where" キーワードを追加することでディメンションを照会でき、複数のディメンションを 'and' キーワードと組み合わせることでクエリを実行できます。

METRIC、DIMENSION、および適切な THRESHOLD 値の値は、az monitor metrics list-definitions コマンドから取得できます。

サーバーの制限により、アラート ルールに複数の条件が含まれている場合、ディメンションの使用は、各条件内のディメンションごとに 1 つの値に制限されます。

複数の --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

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

アラート ルールの名前。

--remove

リストからプロパティまたは要素を削除します。 例: --remove property.list <indexToRemove> OR --remove propertyToRemove

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

--severity

アラートの重大度が 0 (重大) から 4 (詳細) です。

--subscription

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。