次の方法で共有

az monitor metrics alert

  • リファレンス

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

コマンド

名前 説明 型 Status
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] [{<,>,><} DYNAMIC Standard Edition NSITIVITY VIOLATIONS of EVALUATIONS [since DATETIME]] [where DIMENSION {includes,excludes} VALUE [or VALUE ...][AND DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]][skipmetricvalidation を使用する]

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

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

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

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

ディメンションは、"where" キーワード (keyword)を追加することでクエリを実行でき、複数のディメンションを 'and' キーワード (keyword)と組み合わせることによってクエリを実行できます。

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、または 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] [{<,>,><} DYNAMIC Standard Edition NSITIVITY VIOLATIONS of EVALUATIONS [since DATETIME]] [where DIMENSION {includes,excludes} VALUE [or VALUE ...][AND DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]]

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

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

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

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

ディメンションは、"where" キーワード (keyword)を追加することでクエリを実行でき、複数のディメンションを 'and' キーワード (keyword)と組み合わせることによってクエリを実行できます。

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

--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 を使います。