New-AzMetricAlertRuleV2Criteria

リファレンス

モジュール:: Az.Monitor

新しいメトリックアラートの作成に使用できるローカル条件オブジェクトを作成します

構文

PowerShell

New-AzMetricAlertRuleV2Criteria
   -MetricName <String>
   [-MetricNamespace <String>]
   [-SkipMetricValidation <Boolean>]
   [-DimensionSelection <PSMetricDimension[]>]
   -TimeAggregation <String>
   -Operator <String>
   -Threshold <Double>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

PowerShell

New-AzMetricAlertRuleV2Criteria
   [-DynamicThreshold]
   -MetricName <String>
   [-MetricNamespace <String>]
   [-SkipMetricValidation <Boolean>]
   [-DimensionSelection <PSMetricDimension[]>]
   -TimeAggregation <String>
   -Operator <String>
   [-ThresholdSensitivity <String>]
   [-ViolationCount <Int32>]
   [-ExaminedAggregatedPointCount <Int32>]
   [-IgnoreDataBefore <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

PowerShell

New-AzMetricAlertRuleV2Criteria
   [-WebTest]
   -WebTestId <String>
   -ApplicationInsightsId <String>
   [-FailedLocationCount <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

New-AzMetricAlertRuleV2Criteria コマンドレットは、新しいメトリックアラートルールを作成する Add-AzMetricAlertRuleV2 コマンドレット入力として使用するローカルメトリック抽出条件オブジェクトを作成します。

例

例 1: 単純なメトリックアラート条件を作成する

PowerShell

New-AzMetricAlertRuleV2Criteria -MetricName "Percentage CPU" -MetricNameSpace "Microsoft.Compute/virtualMachines" -TimeAggregation Average -Operator GreaterThan -Threshold 5

CriterionType        : StaticThresholdCriterion
OperatorProperty     : GreaterThan
Threshold            : 5
AdditionalProperties :
Name                 : metric1
MetricName           : Percentage CPU
MetricNamespace      : Microsoft.Compute/virtualMachines
TimeAggregation      : Average
Dimensions           :

このコマンドは、メトリックアラートルールで使用できる単純なメトリックアラート条件を作成します

例 2: 動的メトリックアラート条件を作成する

PowerShell

New-AzMetricAlertRuleV2Criteria -DynamicThreshold -MetricName "Percentage CPU" -MetricNameSpace "Microsoft.Compute/virtualMachines" -TimeAggregation Average -Operator GreaterThan -ThresholdSensitivity Medium -ViolationCount 2 -ExaminedAggregatedPointCount 4

CriterionType        : DynamicThresholdCriterion
OperatorProperty     : GreaterThan
AlertSensitivity     : Medium
FailingPeriods       : Microsoft.Azure.Management.Monitor.Models.DynamicThresholdFailingPeriods
IgnoreDataBefore     :
AdditionalProperties :
Name                 : metric1
MetricName           : Percentage CPU
MetricNamespace      : Microsoft.Compute/virtualMachines
TimeAggregation      : Average
Dimensions           :

このコマンドは、メトリックアラートルールで使用できる動的メトリックアラート条件を作成します

例 3: より複雑なメトリックアラート条件を作成する

PowerShell

New-AzMetricAlertRuleV2DimensionSelection -DimensionName "availabilityResult/name" -ValuesToInclude "gdtest" | New-AzMetricAlertRuleV2Criteria -MetricName "availabilityResults/availabilityPercentage" -TimeAggregation Average -Operator GreaterThan -Threshold 2

CriterionType        : StaticThresholdCriterion
OperatorProperty     : GreaterThan
Threshold            : 2
AdditionalProperties :
Name                 : metric1
MetricName           : availabilityResults/availabilityPercentage
MetricNamespace      :
TimeAggregation      : Average
Dimensions           : {availabilityResult/name}

この一連のコマンドにより、ディメンションの選択を含む、より複雑なメトリックアラート条件が作成されます

例 4: Web テストの可用性基準を作成する

PowerShell

New-AzMetricAlertRuleV2Criteria -WebTest -WebTestId "/subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/012345/providers/Microsoft.Insights/webtests/PingTest-appInsights" -ApplicationInsightsId "/subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/012345/providers/Microsoft.Insights/components/appInsights" -FailedLocationCount 3

CriterionType        : WebtestLocationAvailabilityCriterion
WebTestId            : /subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/012345/providers/Microsoft.Insights/webtests/PingTest-appInsights
ComponentId          : /subscriptions/00000000-0000-0000-0000-0000000/resourceGroups/012345/providers/Microsoft.Insights/components/appInsights
FailedLocationCount  : 3
AdditionalProperties :

このコマンドは、メトリックアラートルールで使用できる Web テストの可用性基準を作成します

パラメーター

-ApplicationInsightsId

Application Insights リソース ID。

型:	String
Aliases:	componentId
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

型:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DimensionSelection

ディメンション条件の一覧

型:	PSMetricDimension[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DynamicThreshold

動的しきい値の種類を使用するためのスイッチパラメーター

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ExaminedAggregatedPointCount

調べたポイントの合計数

型:	Int32
Aliases:	TotalPeriod, NumberOfExaminedAggregatedPoints
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FailedLocationCount

アラートを発生させる失敗した場所の最小数。

型:	Int32
Aliases:	AlertLocationThreshold
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IgnoreDataBefore

IgnoreDataBefore パラメーター

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MetricName

ルールのメトリック名

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MetricNamespace

メトリックの名前空間

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Operator

ルール条件演算子

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SkipMetricValidation

メトリックの検証をスキップして、まだ出力されていないカスタムメトリックに対してアラートルールを作成できるようにします

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Threshold

ルール条件のしきい値

型:	Double
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ThresholdSensitivity

ルール条件の秘密度

型:	String
Aliases:	Sensitivity
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TimeAggregation

ウィンドウ間隔で複数のメトリック値をロールアップするために使用される集計操作

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ViolationCount

アラートを発生させるために必要な、選択したルックバック時間枠内に必要な違反の最小数

型:	Int32
Aliases:	FailingPeriod, NumberOfViolations
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WebTest

可用性条件の種類を使用するためのスイッチパラメーター

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WebTestId

Application Insights Web テスト ID。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

PSMetricDimension[]

出力

IPSMultiMetricCriteria

次の方法で共有

New-AzMetricAlertRuleV2Criteria

構文

説明

例

例 1: 単純なメトリックアラート条件を作成する

例 2: 動的メトリックアラート条件を作成する

例 3: より複雑なメトリックアラート条件を作成する

例 4: Web テストの可用性基準を作成する

パラメーター

-ApplicationInsightsId

-DefaultProfile

-DimensionSelection

-DynamicThreshold

-ExaminedAggregatedPointCount

-FailedLocationCount

-IgnoreDataBefore

-MetricName

-MetricNamespace

-Operator

-SkipMetricValidation

-Threshold

-ThresholdSensitivity

-TimeAggregation

-ViolationCount

-WebTest

-WebTestId

入力

出力

その他のリソース

次の方法で共有

New-AzMetricAlertRuleV2Criteria

構文

説明

例

例 1: 単純なメトリック アラート条件を作成する

例 2: 動的メトリック アラート条件を作成する

例 3: より複雑なメトリック アラート条件を作成する

例 4: Web テストの可用性基準を作成する

パラメーター

-ApplicationInsightsId

-DefaultProfile

-DimensionSelection

-DynamicThreshold

-ExaminedAggregatedPointCount

-FailedLocationCount

-IgnoreDataBefore

-MetricName

-MetricNamespace

-Operator

-SkipMetricValidation

-Threshold

-ThresholdSensitivity

-TimeAggregation

-ViolationCount

-WebTest

-WebTestId

入力

出力

その他のリソース

例 1: 単純なメトリックアラート条件を作成する

例 2: 動的メトリックアラート条件を作成する

例 3: より複雑なメトリックアラート条件を作成する