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

--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形式) です。

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

複数の引数を使用して、複数の条件を --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

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

az monitor metrics alert

コマンド

az monitor metrics alert create

例

必須のパラメーター

省略可能のパラメーター

az monitor metrics alert delete

例

省略可能のパラメーター

az monitor metrics alert list

例

省略可能のパラメーター

az monitor metrics alert show

例

省略可能のパラメーター

az monitor metrics alert update

例

省略可能のパラメーター

フィードバック

その他のリソース