Microsoft.Insights scheduledQueryRules
Bemerkungen
Anleitungen zum Bereitstellen von Überwachungslösungen finden Sie unter Erstellen von Überwachungsressourcen mithilfe von Bicep.
Bicep-Ressourcendefinition
Der ressourcentyp "scheduledQueryRules" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Insights/scheduledQueryRules-Ressource zu erstellen, fügen Sie ihrer Vorlage die folgende Bicep hinzu.
resource symbolicname 'Microsoft.Insights/scheduledQueryRules@2025-01-01-preview' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
kind: 'string'
location: 'string'
name: 'string'
properties: {
actions: {
actionGroups: [
'string'
]
actionProperties: {
{customized property}: 'string'
}
customProperties: {
{customized property}: 'string'
}
}
autoMitigate: bool
checkWorkspaceAlertsStorageConfigured: bool
criteria: {
allOf: [
{
alertSensitivity: 'string'
criterionType: 'string'
dimensions: [
{
name: 'string'
operator: 'string'
values: [
'string'
]
}
]
failingPeriods: {
minFailingPeriodsToAlert: int
numberOfEvaluationPeriods: int
}
ignoreDataBefore: 'string'
metricMeasureColumn: 'string'
metricName: 'string'
minRecurrenceCount: int
operator: 'string'
query: 'string'
resourceIdColumn: 'string'
threshold: int
timeAggregation: 'string'
}
]
}
description: 'string'
displayName: 'string'
enabled: bool
evaluationFrequency: 'string'
muteActionsDuration: 'string'
overrideQueryTimeRange: 'string'
resolveConfiguration: {
autoResolved: bool
timeToResolve: 'string'
}
scopes: [
'string'
]
severity: int
skipQueryValidation: bool
targetResourceTypes: [
'string'
]
windowSize: 'string'
}
tags: {
{customized property}: 'string'
}
}
Eigenschaftswerte
Aktionen
Name | Beschreibung | Wert |
---|---|---|
actionGroups | Aktionsgruppenressourcen-IDs, die beim Auslösen der Warnung aufgerufen werden sollen. | string[] |
actionProperties | Die Eigenschaften einer Aktionseigenschaft. | ActionsActionProperties- |
customProperties | Die Eigenschaften einer Warnungsnutzlast. | ActionsCustomProperties |
ActionsActionProperties
Name | Beschreibung | Wert |
---|
ActionsCustomProperties
Name | Beschreibung | Wert |
---|
Zustand
Name | Beschreibung | Wert |
---|---|---|
alertSensitivity | Der Umfang der Abweichung, die erforderlich ist, um eine Warnung auszulösen. Zulässige Werte sind "Niedrig", "Mittel" und "Hoch". Dies wirkt sich darauf aus, wie eng der Schwellenwert für das metrische Reihenmuster ist. Nur für dynamische Schwellenwertregeln der Art LogAlert relevant. | Schnur |
criterionType | Gibt den Typ der Schwellenwertkriterien an. | "DynamicThresholdCriterion" "StaticThresholdCriterion" |
Dimensionen | Liste der Dimensionensbedingungen | Dimension[] |
failPeriods | Die minimale Anzahl von Verletzungen, die innerhalb des ausgewählten Nachschlagezeitfensters erforderlich sind, um eine Warnung auszuheben. Nur für Regeln der Art LogAlert relevant. | ConditionFailingPeriods |
ignoreDataBefore | Verwenden Sie diese Option, um das Datum festzulegen, ab dem sie mit dem Erlernen der metrischen Verlaufsdaten beginnen und die dynamischen Schwellenwerte (im ISO8601 Format) berechnen möchten. Nur für dynamische Schwellenwertregeln der Art LogAlert relevant. | Schnur |
metricMeasureColumn | Die Spalte, die die Metrik-Measurenummer enthält. Nur für Regeln der Art LogAlert relevant. | Schnur |
metricName | Der Name der zu sendenden Metrik. Relevant und nur für Regeln der Art LogToMetric erforderlich. | Schnur |
minRecurrenceCount | Die Mindestanzahl der Ergebnisse, die zum Auslösen einer Warnung gefunden werden sollen. Nur für Regeln der Art SimpleLogAlert relevant. | Int |
Operator | Der Kriterienoperator. Relevant und nur für Regeln der Art LogAlert erforderlich. | "Gleich" "GreaterOrLessThan" "GreaterThan" "GreaterThanOrEqual" "LessThan" "LessThanOrEqual" |
Frage | Protokollabfragebenachrichtigung | Schnur |
resourceIdColumn | Die Spalte, die die Ressourcen-ID enthält. Der Inhalt der Spalte muss ein URI sein, der als Ressourcen-ID formatiert ist. Nur für Regeln der Art LogAlert relevant. | Schnur |
Schwelle | der Schwellenwert für Kriterien, der die Warnung aktiviert. Relevant und nur für statische Schwellenwertregeln der Art LogAlert erforderlich. | Int |
timeAggregation | Aggregationstyp. Relevant und nur für Regeln der Art LogAlert erforderlich. | "Mittelwert" 'Count' "Maximum" "Minimum" "Gesamtsumme" |
ConditionFailingPeriods
Name | Beschreibung | Wert |
---|---|---|
minFailingPeriodsToAlert | Die Anzahl der Verletzungen, um eine Warnung auszulösen. Sollte kleiner oder gleich "NumberOfEvaluationPeriods" sein. Standardwert ist 1 | Int |
numberOfEvaluationPeriods | Die Anzahl der aggregierten Lookbackpunkte. Das Nachschlagezeitfenster wird basierend auf der Aggregations granularität (windowSize) und der ausgewählten Anzahl aggregierter Punkte berechnet. Standardwert ist 1 | Int |
Dimension
Name | Beschreibung | Wert |
---|---|---|
Name | Name der Dimension | Zeichenfolge (erforderlich) |
Operator | Operator für Dimensionswerte | "Ausschließen" "Einschließen" (erforderlich) |
Werte | Liste der Dimensionswerte | string[] (erforderlich) |
Identität
Name | Beschreibung | Wert |
---|---|---|
Art | Typ der verwalteten Dienstidentität. | 'None' 'SystemAssigned' "UserAssigned" (erforderlich) |
userAssignedIdentities | Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
Name | Beschreibung | Wert |
---|
Microsoft.Insights/scheduledQueryRules
Name | Beschreibung | Wert |
---|---|---|
Identität | Die Identität der Ressource. | Identity |
Art | Gibt den Typ der geplanten Abfrageregel an. Der Standardwert ist LogAlert. | 'LogAlert' 'LogToMetric' "SimpleLogAlert" |
Ort | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
Name | Der Ressourcenname | Schnur Zwänge: Pattern = ^[^#<>%&:\?/{}*]{1,260}$ (erforderlich) |
Eigenschaften | Die Regeleigenschaften der Ressource. | ScheduledQueryRuleProperties (erforderlich) |
Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
RuleResolveConfiguration
Name | Beschreibung | Wert |
---|---|---|
autoResolved | Das Kennzeichen, das angibt, ob eine ausgelöste Warnung automatisch aufgelöst werden soll. | Bool |
timeToResolve | Die Dauer, die eine Regel als fehlerfrei ausgewertet werden muss, bevor die ausgelöste Warnung automatisch aufgelöst wird, dargestellt im ISO 8601-Dauerformat. | Schnur |
ScheduledQueryRuleCriteria
Name | Beschreibung | Wert |
---|---|---|
allOf | Eine Liste der Bedingungen, die für die angegebenen Bereiche ausgewertet werden sollen | Bedingung[] |
ScheduledQueryRuleProperties
Name | Beschreibung | Wert |
---|---|---|
Aktionen | Aktionen, die beim Auslösen der Warnung aufgerufen werden sollen. | Aktionen |
autoMitigate | Das Kennzeichen, das angibt, ob die Warnung automatisch aufgelöst werden soll oder nicht. Der Standardwert ist "true". Nur für Regeln der Art LogAlert und SimpleLogAlert relevant. | Bool |
checkWorkspaceAlertsStorageConfigured | Das Kennzeichen, das angibt, ob diese geplante Abfrageregel im Speicher des Kunden gespeichert werden soll. Der Standardwert ist "false". Nur für Regeln der Art LogAlert relevant. | Bool |
Kriterien | Die Regelkriterien, die die Bedingungen der geplanten Abfrageregel definieren. | ScheduledQueryRuleCriteria |
Beschreibung | Die Beschreibung der geplanten Abfrageregel. | Schnur |
displayName | Der Anzeigename der Warnungsregel | Schnur |
ermöglichte | Das Kennzeichen, das angibt, ob diese geplante Abfrageregel aktiviert ist. Der Wert sollte wahr oder falsch sein. | Bool |
evaluationFrequency | Wie oft die geplante Abfrageregel im ISO 8601-Dauerformat ausgewertet wird. Relevant und nur für Regeln der Art LogAlert erforderlich. | Schnur |
muteActionsDuration | Stummschalten sie Aktionen für den ausgewählten Zeitraum (im ISO 8601-Dauerformat), nachdem die Warnung ausgelöst wurde. Nur für Regeln der Art LogAlert relevant. | Schnur |
overrideQueryTimeRange | Wenn angegeben, wird der Abfragezeitbereich überschrieben (Standardwert ist WindowSize*NumberOfEvaluationPeriods). Nur für Regeln der Art LogAlert relevant. | Schnur |
resolveConfiguration | Definiert die Konfiguration zum Auflösen ausgelöster Warnungen. Nur für Regeln der Art LogAlert und SimpleLogAlert relevant. | RuleResolveConfiguration |
Bereiche | Die Liste der Ressourcen-IDs, auf die diese geplante Abfrageregel eingestellt ist. | string[] |
Strenge | Schweregrad der Warnung. Sollte eine ganze Zahl zwischen [0-4] sein. Der Wert 0 ist am schwerwiegendsten. Relevant und nur für Regeln der Art LogAlert erforderlich. | Int |
skipQueryValidation | Das Kennzeichen, das angibt, ob die bereitgestellte Abfrage überprüft werden soll. Der Standardwert ist "false". Nur für Regeln der Art LogAlert relevant. | Bool |
targetResourceTypes | Liste der Ressourcentypen der Zielressource(n), für die die Warnung erstellt/aktualisiert wird. Wenn der Bereich beispielsweise eine Ressourcengruppe ist und targetResourceTypes "Microsoft.Compute/virtualMachines" ist, wird für jeden virtuellen Computer in der Ressourcengruppe, der die Warnungskriterien erfüllt, eine andere Warnung ausgelöst. Nur für Regeln der Art LogAlert relevant | string[] |
windowSize | Der Zeitraum (im ISO 8601-Dauerformat), für den die Warnungsabfrage ausgeführt wird (Bin-Größe). Relevant und nur für Regeln der Art LogAlert erforderlich. | Schnur |
ScheduledQueryRuleResourceTags
Name | Beschreibung | Wert |
---|
UserIdentityProperties
Name | Beschreibung | Wert |
---|
Verwendungsbeispiele
Von Azure verifizierte Module
Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.
Modul | Beschreibung |
---|---|
geplante Abfrageregel | AVM-Ressourcenmodul für geplante Abfrageregel |
ARM-Vorlagenressourcendefinition
Der ressourcentyp "scheduledQueryRules" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Insights/scheduledQueryRules-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden JSON-Code hinzu.
{
"type": "Microsoft.Insights/scheduledQueryRules",
"apiVersion": "2025-01-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"kind": "string",
"location": "string",
"properties": {
"actions": {
"actionGroups": [ "string" ],
"actionProperties": {
"{customized property}": "string"
},
"customProperties": {
"{customized property}": "string"
}
},
"autoMitigate": "bool",
"checkWorkspaceAlertsStorageConfigured": "bool",
"criteria": {
"allOf": [
{
"alertSensitivity": "string",
"criterionType": "string",
"dimensions": [
{
"name": "string",
"operator": "string",
"values": [ "string" ]
}
],
"failingPeriods": {
"minFailingPeriodsToAlert": "int",
"numberOfEvaluationPeriods": "int"
},
"ignoreDataBefore": "string",
"metricMeasureColumn": "string",
"metricName": "string",
"minRecurrenceCount": "int",
"operator": "string",
"query": "string",
"resourceIdColumn": "string",
"threshold": "int",
"timeAggregation": "string"
}
]
},
"description": "string",
"displayName": "string",
"enabled": "bool",
"evaluationFrequency": "string",
"muteActionsDuration": "string",
"overrideQueryTimeRange": "string",
"resolveConfiguration": {
"autoResolved": "bool",
"timeToResolve": "string"
},
"scopes": [ "string" ],
"severity": "int",
"skipQueryValidation": "bool",
"targetResourceTypes": [ "string" ],
"windowSize": "string"
},
"tags": {
"{customized property}": "string"
}
}
Eigenschaftswerte
Aktionen
Name | Beschreibung | Wert |
---|---|---|
actionGroups | Aktionsgruppenressourcen-IDs, die beim Auslösen der Warnung aufgerufen werden sollen. | string[] |
actionProperties | Die Eigenschaften einer Aktionseigenschaft. | ActionsActionProperties- |
customProperties | Die Eigenschaften einer Warnungsnutzlast. | ActionsCustomProperties |
ActionsActionProperties
Name | Beschreibung | Wert |
---|
ActionsCustomProperties
Name | Beschreibung | Wert |
---|
Zustand
Name | Beschreibung | Wert |
---|---|---|
alertSensitivity | Der Umfang der Abweichung, die erforderlich ist, um eine Warnung auszulösen. Zulässige Werte sind "Niedrig", "Mittel" und "Hoch". Dies wirkt sich darauf aus, wie eng der Schwellenwert für das metrische Reihenmuster ist. Nur für dynamische Schwellenwertregeln der Art LogAlert relevant. | Schnur |
criterionType | Gibt den Typ der Schwellenwertkriterien an. | "DynamicThresholdCriterion" "StaticThresholdCriterion" |
Dimensionen | Liste der Dimensionensbedingungen | Dimension[] |
failPeriods | Die minimale Anzahl von Verletzungen, die innerhalb des ausgewählten Nachschlagezeitfensters erforderlich sind, um eine Warnung auszuheben. Nur für Regeln der Art LogAlert relevant. | ConditionFailingPeriods |
ignoreDataBefore | Verwenden Sie diese Option, um das Datum festzulegen, ab dem sie mit dem Erlernen der metrischen Verlaufsdaten beginnen und die dynamischen Schwellenwerte (im ISO8601 Format) berechnen möchten. Nur für dynamische Schwellenwertregeln der Art LogAlert relevant. | Schnur |
metricMeasureColumn | Die Spalte, die die Metrik-Measurenummer enthält. Nur für Regeln der Art LogAlert relevant. | Schnur |
metricName | Der Name der zu sendenden Metrik. Relevant und nur für Regeln der Art LogToMetric erforderlich. | Schnur |
minRecurrenceCount | Die Mindestanzahl der Ergebnisse, die zum Auslösen einer Warnung gefunden werden sollen. Nur für Regeln der Art SimpleLogAlert relevant. | Int |
Operator | Der Kriterienoperator. Relevant und nur für Regeln der Art LogAlert erforderlich. | "Gleich" "GreaterOrLessThan" "GreaterThan" "GreaterThanOrEqual" "LessThan" "LessThanOrEqual" |
Frage | Protokollabfragebenachrichtigung | Schnur |
resourceIdColumn | Die Spalte, die die Ressourcen-ID enthält. Der Inhalt der Spalte muss ein URI sein, der als Ressourcen-ID formatiert ist. Nur für Regeln der Art LogAlert relevant. | Schnur |
Schwelle | der Schwellenwert für Kriterien, der die Warnung aktiviert. Relevant und nur für statische Schwellenwertregeln der Art LogAlert erforderlich. | Int |
timeAggregation | Aggregationstyp. Relevant und nur für Regeln der Art LogAlert erforderlich. | "Mittelwert" 'Count' "Maximum" "Minimum" "Gesamtsumme" |
ConditionFailingPeriods
Name | Beschreibung | Wert |
---|---|---|
minFailingPeriodsToAlert | Die Anzahl der Verletzungen, um eine Warnung auszulösen. Sollte kleiner oder gleich "NumberOfEvaluationPeriods" sein. Standardwert ist 1 | Int |
numberOfEvaluationPeriods | Die Anzahl der aggregierten Lookbackpunkte. Das Nachschlagezeitfenster wird basierend auf der Aggregations granularität (windowSize) und der ausgewählten Anzahl aggregierter Punkte berechnet. Standardwert ist 1 | Int |
Dimension
Name | Beschreibung | Wert |
---|---|---|
Name | Name der Dimension | Zeichenfolge (erforderlich) |
Operator | Operator für Dimensionswerte | "Ausschließen" "Einschließen" (erforderlich) |
Werte | Liste der Dimensionswerte | string[] (erforderlich) |
Identität
Name | Beschreibung | Wert |
---|---|---|
Art | Typ der verwalteten Dienstidentität. | 'None' 'SystemAssigned' "UserAssigned" (erforderlich) |
userAssignedIdentities | Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
Name | Beschreibung | Wert |
---|
Microsoft.Insights/scheduledQueryRules
Name | Beschreibung | Wert |
---|---|---|
apiVersion | Die API-Version | "2025-01-01-preview" |
Identität | Die Identität der Ressource. | Identity |
Art | Gibt den Typ der geplanten Abfrageregel an. Der Standardwert ist LogAlert. | 'LogAlert' 'LogToMetric' "SimpleLogAlert" |
Ort | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
Name | Der Ressourcenname | Schnur Zwänge: Pattern = ^[^#<>%&:\?/{}*]{1,260}$ (erforderlich) |
Eigenschaften | Die Regeleigenschaften der Ressource. | ScheduledQueryRuleProperties (erforderlich) |
Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
Art | Der Ressourcentyp | "Microsoft.Insights/scheduledQueryRules" |
RuleResolveConfiguration
Name | Beschreibung | Wert |
---|---|---|
autoResolved | Das Kennzeichen, das angibt, ob eine ausgelöste Warnung automatisch aufgelöst werden soll. | Bool |
timeToResolve | Die Dauer, die eine Regel als fehlerfrei ausgewertet werden muss, bevor die ausgelöste Warnung automatisch aufgelöst wird, dargestellt im ISO 8601-Dauerformat. | Schnur |
ScheduledQueryRuleCriteria
Name | Beschreibung | Wert |
---|---|---|
allOf | Eine Liste der Bedingungen, die für die angegebenen Bereiche ausgewertet werden sollen | Bedingung[] |
ScheduledQueryRuleProperties
Name | Beschreibung | Wert |
---|---|---|
Aktionen | Aktionen, die beim Auslösen der Warnung aufgerufen werden sollen. | Aktionen |
autoMitigate | Das Kennzeichen, das angibt, ob die Warnung automatisch aufgelöst werden soll oder nicht. Der Standardwert ist "true". Nur für Regeln der Art LogAlert und SimpleLogAlert relevant. | Bool |
checkWorkspaceAlertsStorageConfigured | Das Kennzeichen, das angibt, ob diese geplante Abfrageregel im Speicher des Kunden gespeichert werden soll. Der Standardwert ist "false". Nur für Regeln der Art LogAlert relevant. | Bool |
Kriterien | Die Regelkriterien, die die Bedingungen der geplanten Abfrageregel definieren. | ScheduledQueryRuleCriteria |
Beschreibung | Die Beschreibung der geplanten Abfrageregel. | Schnur |
displayName | Der Anzeigename der Warnungsregel | Schnur |
ermöglichte | Das Kennzeichen, das angibt, ob diese geplante Abfrageregel aktiviert ist. Der Wert sollte wahr oder falsch sein. | Bool |
evaluationFrequency | Wie oft die geplante Abfrageregel im ISO 8601-Dauerformat ausgewertet wird. Relevant und nur für Regeln der Art LogAlert erforderlich. | Schnur |
muteActionsDuration | Stummschalten sie Aktionen für den ausgewählten Zeitraum (im ISO 8601-Dauerformat), nachdem die Warnung ausgelöst wurde. Nur für Regeln der Art LogAlert relevant. | Schnur |
overrideQueryTimeRange | Wenn angegeben, wird der Abfragezeitbereich überschrieben (Standardwert ist WindowSize*NumberOfEvaluationPeriods). Nur für Regeln der Art LogAlert relevant. | Schnur |
resolveConfiguration | Definiert die Konfiguration zum Auflösen ausgelöster Warnungen. Nur für Regeln der Art LogAlert und SimpleLogAlert relevant. | RuleResolveConfiguration |
Bereiche | Die Liste der Ressourcen-IDs, auf die diese geplante Abfrageregel eingestellt ist. | string[] |
Strenge | Schweregrad der Warnung. Sollte eine ganze Zahl zwischen [0-4] sein. Der Wert 0 ist am schwerwiegendsten. Relevant und nur für Regeln der Art LogAlert erforderlich. | Int |
skipQueryValidation | Das Kennzeichen, das angibt, ob die bereitgestellte Abfrage überprüft werden soll. Der Standardwert ist "false". Nur für Regeln der Art LogAlert relevant. | Bool |
targetResourceTypes | Liste der Ressourcentypen der Zielressource(n), für die die Warnung erstellt/aktualisiert wird. Wenn der Bereich beispielsweise eine Ressourcengruppe ist und targetResourceTypes "Microsoft.Compute/virtualMachines" ist, wird für jeden virtuellen Computer in der Ressourcengruppe, der die Warnungskriterien erfüllt, eine andere Warnung ausgelöst. Nur für Regeln der Art LogAlert relevant | string[] |
windowSize | Der Zeitraum (im ISO 8601-Dauerformat), für den die Warnungsabfrage ausgeführt wird (Bin-Größe). Relevant und nur für Regeln der Art LogAlert erforderlich. | Schnur |
ScheduledQueryRuleResourceTags
Name | Beschreibung | Wert |
---|
UserIdentityProperties
Name | Beschreibung | Wert |
---|
Verwendungsbeispiele
Azure-Schnellstartvorlagen
Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.
Schablone | Beschreibung |
---|---|
Erstellen einer Warnungsregel für Azure-Geschäftskontinuitätselemente |
Diese Vorlagen erstellen eine Warnungsregel und vom Benutzer zugewiesene MSI.This templates creates an alert rule and user assigned MSI. Außerdem weist sie dem Abonnement den MSI-Readerzugriff zu, damit die Warnungsregel Zugriff auf die erforderlichen geschützten Elemente und die neuesten Details des Wiederherstellungspunkts hat. |
Terraform -Ressourcendefinition (AzAPI-Anbieter)
Der ressourcentyp "scheduledQueryRules" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Insights/scheduledQueryRules-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Insights/scheduledQueryRules@2025-01-01-preview"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
kind = "string"
properties = {
actions = {
actionGroups = [
"string"
]
actionProperties = {
{customized property} = "string"
}
customProperties = {
{customized property} = "string"
}
}
autoMitigate = bool
checkWorkspaceAlertsStorageConfigured = bool
criteria = {
allOf = [
{
alertSensitivity = "string"
criterionType = "string"
dimensions = [
{
name = "string"
operator = "string"
values = [
"string"
]
}
]
failingPeriods = {
minFailingPeriodsToAlert = int
numberOfEvaluationPeriods = int
}
ignoreDataBefore = "string"
metricMeasureColumn = "string"
metricName = "string"
minRecurrenceCount = int
operator = "string"
query = "string"
resourceIdColumn = "string"
threshold = int
timeAggregation = "string"
}
]
}
description = "string"
displayName = "string"
enabled = bool
evaluationFrequency = "string"
muteActionsDuration = "string"
overrideQueryTimeRange = "string"
resolveConfiguration = {
autoResolved = bool
timeToResolve = "string"
}
scopes = [
"string"
]
severity = int
skipQueryValidation = bool
targetResourceTypes = [
"string"
]
windowSize = "string"
}
}
}
Eigenschaftswerte
Aktionen
Name | Beschreibung | Wert |
---|---|---|
actionGroups | Aktionsgruppenressourcen-IDs, die beim Auslösen der Warnung aufgerufen werden sollen. | string[] |
actionProperties | Die Eigenschaften einer Aktionseigenschaft. | ActionsActionProperties- |
customProperties | Die Eigenschaften einer Warnungsnutzlast. | ActionsCustomProperties |
ActionsActionProperties
Name | Beschreibung | Wert |
---|
ActionsCustomProperties
Name | Beschreibung | Wert |
---|
Zustand
Name | Beschreibung | Wert |
---|---|---|
alertSensitivity | Der Umfang der Abweichung, die erforderlich ist, um eine Warnung auszulösen. Zulässige Werte sind "Niedrig", "Mittel" und "Hoch". Dies wirkt sich darauf aus, wie eng der Schwellenwert für das metrische Reihenmuster ist. Nur für dynamische Schwellenwertregeln der Art LogAlert relevant. | Schnur |
criterionType | Gibt den Typ der Schwellenwertkriterien an. | "DynamicThresholdCriterion" "StaticThresholdCriterion" |
Dimensionen | Liste der Dimensionensbedingungen | Dimension[] |
failPeriods | Die minimale Anzahl von Verletzungen, die innerhalb des ausgewählten Nachschlagezeitfensters erforderlich sind, um eine Warnung auszuheben. Nur für Regeln der Art LogAlert relevant. | ConditionFailingPeriods |
ignoreDataBefore | Verwenden Sie diese Option, um das Datum festzulegen, ab dem sie mit dem Erlernen der metrischen Verlaufsdaten beginnen und die dynamischen Schwellenwerte (im ISO8601 Format) berechnen möchten. Nur für dynamische Schwellenwertregeln der Art LogAlert relevant. | Schnur |
metricMeasureColumn | Die Spalte, die die Metrik-Measurenummer enthält. Nur für Regeln der Art LogAlert relevant. | Schnur |
metricName | Der Name der zu sendenden Metrik. Relevant und nur für Regeln der Art LogToMetric erforderlich. | Schnur |
minRecurrenceCount | Die Mindestanzahl der Ergebnisse, die zum Auslösen einer Warnung gefunden werden sollen. Nur für Regeln der Art SimpleLogAlert relevant. | Int |
Operator | Der Kriterienoperator. Relevant und nur für Regeln der Art LogAlert erforderlich. | "Gleich" "GreaterOrLessThan" "GreaterThan" "GreaterThanOrEqual" "LessThan" "LessThanOrEqual" |
Frage | Protokollabfragebenachrichtigung | Schnur |
resourceIdColumn | Die Spalte, die die Ressourcen-ID enthält. Der Inhalt der Spalte muss ein URI sein, der als Ressourcen-ID formatiert ist. Nur für Regeln der Art LogAlert relevant. | Schnur |
Schwelle | der Schwellenwert für Kriterien, der die Warnung aktiviert. Relevant und nur für statische Schwellenwertregeln der Art LogAlert erforderlich. | Int |
timeAggregation | Aggregationstyp. Relevant und nur für Regeln der Art LogAlert erforderlich. | "Mittelwert" 'Count' "Maximum" "Minimum" "Gesamtsumme" |
ConditionFailingPeriods
Name | Beschreibung | Wert |
---|---|---|
minFailingPeriodsToAlert | Die Anzahl der Verletzungen, um eine Warnung auszulösen. Sollte kleiner oder gleich "NumberOfEvaluationPeriods" sein. Standardwert ist 1 | Int |
numberOfEvaluationPeriods | Die Anzahl der aggregierten Lookbackpunkte. Das Nachschlagezeitfenster wird basierend auf der Aggregations granularität (windowSize) und der ausgewählten Anzahl aggregierter Punkte berechnet. Standardwert ist 1 | Int |
Dimension
Name | Beschreibung | Wert |
---|---|---|
Name | Name der Dimension | Zeichenfolge (erforderlich) |
Operator | Operator für Dimensionswerte | "Ausschließen" "Einschließen" (erforderlich) |
Werte | Liste der Dimensionswerte | string[] (erforderlich) |
Identität
Name | Beschreibung | Wert |
---|---|---|
Art | Typ der verwalteten Dienstidentität. | 'None' 'SystemAssigned' "UserAssigned" (erforderlich) |
userAssignedIdentities | Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
Name | Beschreibung | Wert |
---|
Microsoft.Insights/scheduledQueryRules
Name | Beschreibung | Wert |
---|---|---|
Identität | Die Identität der Ressource. | Identity |
Art | Gibt den Typ der geplanten Abfrageregel an. Der Standardwert ist LogAlert. | 'LogAlert' 'LogToMetric' "SimpleLogAlert" |
Ort | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
Name | Der Ressourcenname | Schnur Zwänge: Pattern = ^[^#<>%&:\?/{}*]{1,260}$ (erforderlich) |
Eigenschaften | Die Regeleigenschaften der Ressource. | ScheduledQueryRuleProperties (erforderlich) |
Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. |
Art | Der Ressourcentyp | "Microsoft.Insights/scheduledQueryRules@2025-01-01-preview" |
RuleResolveConfiguration
Name | Beschreibung | Wert |
---|---|---|
autoResolved | Das Kennzeichen, das angibt, ob eine ausgelöste Warnung automatisch aufgelöst werden soll. | Bool |
timeToResolve | Die Dauer, die eine Regel als fehlerfrei ausgewertet werden muss, bevor die ausgelöste Warnung automatisch aufgelöst wird, dargestellt im ISO 8601-Dauerformat. | Schnur |
ScheduledQueryRuleCriteria
Name | Beschreibung | Wert |
---|---|---|
allOf | Eine Liste der Bedingungen, die für die angegebenen Bereiche ausgewertet werden sollen | Bedingung[] |
ScheduledQueryRuleProperties
Name | Beschreibung | Wert |
---|---|---|
Aktionen | Aktionen, die beim Auslösen der Warnung aufgerufen werden sollen. | Aktionen |
autoMitigate | Das Kennzeichen, das angibt, ob die Warnung automatisch aufgelöst werden soll oder nicht. Der Standardwert ist "true". Nur für Regeln der Art LogAlert und SimpleLogAlert relevant. | Bool |
checkWorkspaceAlertsStorageConfigured | Das Kennzeichen, das angibt, ob diese geplante Abfrageregel im Speicher des Kunden gespeichert werden soll. Der Standardwert ist "false". Nur für Regeln der Art LogAlert relevant. | Bool |
Kriterien | Die Regelkriterien, die die Bedingungen der geplanten Abfrageregel definieren. | ScheduledQueryRuleCriteria |
Beschreibung | Die Beschreibung der geplanten Abfrageregel. | Schnur |
displayName | Der Anzeigename der Warnungsregel | Schnur |
ermöglichte | Das Kennzeichen, das angibt, ob diese geplante Abfrageregel aktiviert ist. Der Wert sollte wahr oder falsch sein. | Bool |
evaluationFrequency | Wie oft die geplante Abfrageregel im ISO 8601-Dauerformat ausgewertet wird. Relevant und nur für Regeln der Art LogAlert erforderlich. | Schnur |
muteActionsDuration | Stummschalten sie Aktionen für den ausgewählten Zeitraum (im ISO 8601-Dauerformat), nachdem die Warnung ausgelöst wurde. Nur für Regeln der Art LogAlert relevant. | Schnur |
overrideQueryTimeRange | Wenn angegeben, wird der Abfragezeitbereich überschrieben (Standardwert ist WindowSize*NumberOfEvaluationPeriods). Nur für Regeln der Art LogAlert relevant. | Schnur |
resolveConfiguration | Definiert die Konfiguration zum Auflösen ausgelöster Warnungen. Nur für Regeln der Art LogAlert und SimpleLogAlert relevant. | RuleResolveConfiguration |
Bereiche | Die Liste der Ressourcen-IDs, auf die diese geplante Abfrageregel eingestellt ist. | string[] |
Strenge | Schweregrad der Warnung. Sollte eine ganze Zahl zwischen [0-4] sein. Der Wert 0 ist am schwerwiegendsten. Relevant und nur für Regeln der Art LogAlert erforderlich. | Int |
skipQueryValidation | Das Kennzeichen, das angibt, ob die bereitgestellte Abfrage überprüft werden soll. Der Standardwert ist "false". Nur für Regeln der Art LogAlert relevant. | Bool |
targetResourceTypes | Liste der Ressourcentypen der Zielressource(n), für die die Warnung erstellt/aktualisiert wird. Wenn der Bereich beispielsweise eine Ressourcengruppe ist und targetResourceTypes "Microsoft.Compute/virtualMachines" ist, wird für jeden virtuellen Computer in der Ressourcengruppe, der die Warnungskriterien erfüllt, eine andere Warnung ausgelöst. Nur für Regeln der Art LogAlert relevant | string[] |
windowSize | Der Zeitraum (im ISO 8601-Dauerformat), für den die Warnungsabfrage ausgeführt wird (Bin-Größe). Relevant und nur für Regeln der Art LogAlert erforderlich. | Schnur |
ScheduledQueryRuleResourceTags
Name | Beschreibung | Wert |
---|
UserIdentityProperties
Name | Beschreibung | Wert |
---|