CLI、PowerShell、または ARM テンプレートを使って新しい警告ルールを作成する
新しい警告ルールは、CLI、PowerShell、または Azure Resource Manager テンプレートを使って作成できます。
前提条件
アラート ルールを作成または編集するには、次のアクセス許可が必要です。
- アラート ルールのターゲット リソースに対する読み取りアクセス許可。
- アラート ルールが作成されるリソース グループに対する書き込みアクセス許可。 Azure portal からアラート ルールを作成する場合は、そのアラート ルールが同じリソース グループ (ターゲット リソースが存在している) に既定で作成されます。
- アラート ルールに関連付けられているアクション グループに対する読み取りアクセス許可 (該当する場合)。
CLI を使用して新しいアラート ルールを作成する
Azure CLI を使用して、新しいアラート ルールを作成できます。 次の例では、Azure Cloud Shell を使用しています。 Azure Monitor 用の Azure CLI コマンドの完全な一覧を確認できます。
portal で Cloud Shell を選択します。 プロンプトで、次のコマンドを使用します。
- メトリック アラート ルールを作成するには、az monitor metrics alert create コマンドを使用します。
- ログ検索警告ルールを作成するには、az monitor scheduled-query create コマンドを使用します。
- アクティビティ ログ アラート ルールを作成するには、az monitor activity-log alert create コマンドを使用します。
たとえば、VM の平均 CPU 使用率が 90% を超えているかどうかを監視するメトリック警告ルールを作成するには、次のコマンドを使用します。
az monitor metrics alert create -n {nameofthealert} -g {ResourceGroup} --scopes {VirtualMachineResourceID} --condition "avg Percentage CPU > 90" --description {descriptionofthealert}
PowerShell を使用して新しいアラート ルールを作成する
- PowerShell を使用してメトリック アラート ルールを作成するには、Add-AzMetricAlertRuleV2 コマンドレットを使用します。
Note
1 つのリソースに対するメトリック アラートを作成する場合は、構文で
TargetResourceId
を使用します。 複数のリソースに対するメトリック アラートを作成する場合は、構文にTargetResourceScope
、TargetResourceType
、TargetResourceRegion
を含めます。 - PowerShell を使用してログ検索警告ルールを作成するには、New-AzScheduledQueryRule コマンドレットを使用します。
- PowerShell を使用してアクティビティ ログ アラート ルールを作成するには、New-AzActivityLogAlert コマンドレットを使用します。
ARM テンプレートを使用して新しいアラート ルールを作成する
Azure Resource Manager テンプレート (ARM テンプレート) を使用すると、すべての環境でアラート ルールを一貫して構成できます。
次のリソースの種類を使用して、新しいリソースを作成します。
- メトリック アラートの場合:
Microsoft.Insights/metricAlerts
Note
- ターゲット リソースと同じリソース グループを使用してメトリック アラートを作成することをお勧めします。
- Azure Log Analytics ワークスペース リソースの種類 (
Microsoft.OperationalInsights/workspaces
) のメトリック アラートは、他のメトリック アラートとは異なる方法で構成されます。 詳細については、「ログのメトリック アラートのリソース テンプレート」を参照してください。 - 1 つのリソースに対するメトリック アラートを作成している場合は、テンプレートでターゲット リソースの
ResourceId
を使用します。 複数のリソースに対するメトリック アラートを作成している場合は、テンプレートでターゲット リソースのscope
、TargetResourceType
、TargetResourceRegion
を使用します。
- ログ検索アラートの場合:
Microsoft.Insights/scheduledQueryRules
- アクティビティ ログ、サービス正常性、およびリソース正常性アラートの場合:
microsoft.Insights/activityLogAlerts
- メトリック アラートの場合:
これらのサンプル ARM テンプレートからいずれかのテンプレートをコピーします。
- メトリック アラートの場合: メトリック アラート ルール用の Resource Manager テンプレートのサンプル
- ログ検索アラートの場合: ログ検索警告ルール用の Resource Manager テンプレートのサンプル
- アクティビティ ログ アラートの場合: アクティビティ ログ アラート ルール用の Resource Manager テンプレートのサンプル
- サービス正常性アラートの場合: サービス正常性警告ルール用の Resource Manager テンプレートのサンプル
- リソース正常性アラートの場合: リソース正常性アラート ルール用の Resource Manager テンプレートのサンプルする
テンプレート ファイルを編集してアラートに適した情報を含め、ファイルを <your-alert-template-file>.json として保存します。
対応するパラメーター ファイルを編集してアラートをカスタマイズし、<your-alert-template-file>.parameters.json として保存します。
Azure Monitor でサポートされているメトリックのいずれかの値を使用して、
metricName
パラメーターを設定します。PowerShell または CLI を使用してテンプレートをデプロイします。