Metric Alerts - Update
Ölçüm uyarısı tanımını güncelleştirme.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/metricAlerts/{ruleName}?api-version=2018-03-01
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir. |
rule
|
path | True |
string |
Kuralın adı. |
subscription
|
path | True |
string |
Hedef aboneliğin kimliği. |
api-version
|
query | True |
string |
Bu işlem için kullanılacak API sürümü. |
İstek Gövdesi
Name | Tür | Description |
---|---|---|
properties.actions |
uyarı kuralı etkin olduğunda ve bir uyarı koşulu çözümlendiğinde gerçekleştirilen eylemler dizisi. |
|
properties.autoMitigate |
boolean |
uyarının otomatik olarak çözümlenip çözümlenmeyeceğini belirten bayrak. Varsayılan değer true'dur. |
properties.criteria | MetricAlertCriteria: |
belirli uyarı ölçütü bilgilerini tanımlar. |
properties.description |
string |
uyarı e-postasında yer alacak ölçüm uyarısının açıklaması. |
properties.enabled |
boolean |
ölçüm uyarısının etkinleştirilip etkinleştirilmediğini gösteren bayrak. |
properties.evaluationFrequency |
string |
ölçüm uyarısının ISO 8601 süre biçiminde ne sıklıkta temsil edilir? |
properties.scopes |
string[] |
bu ölçüm uyarısının kapsamına alınan kaynak kimliklerinin listesi. |
properties.severity |
integer |
Uyarı önem derecesi {0, 1, 2, 3, 4} |
properties.targetResourceRegion |
string |
uyarının oluşturulduğu/güncelleştirildiği hedef kaynakların bölgesi. MultipleResourceMultipleMetricCriteria için zorunlu. |
properties.targetResourceType |
string |
uyarının oluşturulduğu/güncelleştirildiği hedef kaynakların kaynak türü. MultipleResourceMultipleMetricCriteria için zorunlu. |
properties.windowSize |
string |
eşiğe göre uyarı etkinliğini izlemek için kullanılan süre (ISO 8601 süre biçiminde). |
tags |
object |
Kaynak etiketleri |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam |
|
Other Status Codes |
BadRequest |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Flow
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
Create or update an alert rule
Örnek isteği
PATCH https://management.azure.com/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/Microsoft.Insights/metricAlerts/chiricutin?api-version=2018-03-01
{
"tags": {},
"properties": {
"description": "This is the description of the rule1",
"severity": 3,
"enabled": true,
"scopes": [
"/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/Microsoft.Compute/virtualMachines/gigwadme"
],
"evaluationFrequency": "Pt1m",
"windowSize": "Pt15m",
"criteria": {
"odata.type": "Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria",
"allOf": [
{
"criterionType": "StaticThresholdCriterion",
"name": "High_CPU_80",
"metricName": "\\Processor(_Total)\\% Processor Time",
"dimensions": [],
"operator": "GreaterThan",
"threshold": 80.5,
"timeAggregation": "Average"
}
]
},
"autoMitigate": true,
"actions": [
{
"actionGroupId": "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourcegroups/gigtest/providers/microsoft.insights/actiongroups/group2",
"webHookProperties": {
"key11": "value11",
"key12": "value12"
}
}
]
}
}
Örnek yanıt
{
"id": "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/providers/microsoft.insights/metricalerts/chiricutin",
"type": "Microsoft.Insights/metricAlerts",
"location": "global",
"tags": {
"hidden-link:/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/Rac46PostSwapRG/providers/Microsoft.Web/sites/leoalerttest": "Resource"
},
"properties": {
"description": "This is the description of the rule1",
"severity": 3,
"enabled": true,
"scopes": [
"/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/Microsoft.Compute/virtualMachines/gigwadme"
],
"evaluationFrequency": "Pt1m",
"windowSize": "Pt15m",
"criteria": {
"odata.type": "Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria",
"allOf": [
{
"criterionType": "StaticThresholdCriterion",
"name": "High_CPU_80",
"metricName": "\\Processor(_Total)\\% Processor Time",
"dimensions": [],
"operator": "GreaterThan",
"threshold": 80.5,
"timeAggregation": "Average"
}
]
},
"autoMitigate": true,
"actions": [
{
"actionGroupId": "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourcegroups/gigtest/providers/microsoft.insights/actiongroups/group2",
"webHookProperties": {
"key11": "value11",
"key12": "value12"
}
}
]
}
}
Tanımlar
Name | Description |
---|---|
Aggregation |
ölçüt zaman toplama türleri. |
Dynamic |
Dinamik eşik ölçütü. |
Dynamic |
Seçilen geri arama zamanı penceresinde uyarı vermek için gereken en düşük ihlal sayısı. |
Dynamic |
Ölçüm değerini eşikle karşılaştırmak için kullanılan işleç. |
Dynamic |
Bir uyarıyı tetikleyebilmek için gereken sapma kapsamı. Bu, eşiğin ölçüm serisi desenine ne kadar yakın olduğunu etkiler. |
Error |
Hata yanıtının biçimini açıklar. |
Metric |
Bir uyarı eylemi. |
Metric |
Birden çok ölçüm ölçütüne sahip birden çok kaynak için ölçüm uyarısı ölçütlerini belirtir. |
Metric |
Ölçüm uyarısı kaynağı. |
Metric |
Düzeltme eki işlemleri için ölçüm uyarısı kaynağı. |
Metric |
Birden çok ölçüm ölçütüne sahip tek bir kaynak için ölçüm uyarısı ölçütlerini belirtir. |
Metric |
Ölçümleri filtreleme ölçütü. |
Metric |
Ölçüm boyutunu belirtir. |
Operator |
ölçüt işleci. |
Webtest |
Web testi kaynağı için ölçüm uyarısı kuralı ölçütlerini belirtir. |
AggregationTypeEnum
ölçüt zaman toplama türleri.
Name | Tür | Description |
---|---|---|
Average |
string |
|
Count |
string |
|
Maximum |
string |
|
Minimum |
string |
|
Total |
string |
DynamicMetricCriteria
Dinamik eşik ölçütü.
Name | Tür | Description |
---|---|---|
alertSensitivity |
Bir uyarıyı tetikleyebilmek için gereken sapma kapsamı. Bu, eşiğin ölçüm serisi desenine ne kadar yakın olduğunu etkiler. |
|
criterionType |
string:
Dynamic |
Eşik ölçütlerinin türünü belirtir |
dimensions |
Boyut koşullarının listesi. |
|
failingPeriods |
Seçilen geri arama zamanı penceresinde uyarı vermek için gereken en düşük ihlal sayısı. |
|
ignoreDataBefore |
string |
Ölçüm geçmiş verilerini öğrenmeye başlanacağı tarihi ayarlamak ve dinamik eşikleri hesaplamak için bu seçeneği kullanın (ISO8601 biçimde) |
metricName |
string |
Ölçümün adı. |
metricNamespace |
string |
Ölçümün ad alanı. |
name |
string |
Ölçüt adı. |
operator |
Ölçüm değerini eşikle karşılaştırmak için kullanılan işleç. |
|
skipMetricValidation |
boolean |
Ölçüm doğrulamasının atlanmasına neden olarak henüz yayılmamış özel bir ölçümle ilgili uyarı kuralı oluşturmaya olanak sağlar. |
timeAggregation |
ölçüt zaman toplama türleri. |
DynamicThresholdFailingPeriods
Seçilen geri arama zamanı penceresinde uyarı vermek için gereken en düşük ihlal sayısı.
Name | Tür | Description |
---|---|---|
minFailingPeriodsToAlert |
number |
Uyarı tetikleme ihlallerinin sayısı. NumberOfEvaluationPeriods değerinden küçük veya buna eşit olmalıdır. |
numberOfEvaluationPeriods |
number |
Toplanan geri arama noktalarının sayısı. Geri arama zamanı penceresi, toplama ayrıntı düzeyi (windowSize) ve seçilen toplam nokta sayısına göre hesaplanır. |
DynamicThresholdOperator
Ölçüm değerini eşikle karşılaştırmak için kullanılan işleç.
Name | Tür | Description |
---|---|---|
GreaterOrLessThan |
string |
|
GreaterThan |
string |
|
LessThan |
string |
DynamicThresholdSensitivity
Bir uyarıyı tetikleyebilmek için gereken sapma kapsamı. Bu, eşiğin ölçüm serisi desenine ne kadar yakın olduğunu etkiler.
Name | Tür | Description |
---|---|---|
High |
string |
|
Low |
string |
|
Medium |
string |
ErrorResponse
Hata yanıtının biçimini açıklar.
Name | Tür | Description |
---|---|---|
code |
string |
Hata kodu |
message |
string |
İşlemin neden başarısız olduğunu belirten hata iletisi. |
MetricAlertAction
Bir uyarı eylemi.
Name | Tür | Description |
---|---|---|
actionGroupId |
string |
kullanılacak eylem grubunun kimliği. |
webHookProperties |
object |
Bu alan, web kancasına giriş olarak gönderilen uyarı yüküne eklenecek özel özelliklerin belirtilmesine olanak tanır. |
MetricAlertMultipleResourceMultipleMetricCriteria
Birden çok ölçüm ölçütüne sahip birden çok kaynak için ölçüm uyarısı ölçütlerini belirtir.
Name | Tür | Description |
---|---|---|
allOf | MultiMetricCriteria[]: |
bu 'tümü' işlemi için birden çok ölçüm ölçütünün listesi. |
odata.type |
string:
Microsoft. |
uyarı ölçütlerinin türünü belirtir. |
MetricAlertResource
Ölçüm uyarısı kaynağı.
Name | Tür | Description |
---|---|---|
id |
string |
Azure kaynak kimliği |
location |
string |
Kaynak konumu |
name |
string |
Azure kaynak adı |
properties.actions |
uyarı kuralı etkin olduğunda ve bir uyarı koşulu çözümlendiğinde gerçekleştirilen eylemler dizisi. |
|
properties.autoMitigate |
boolean |
uyarının otomatik olarak çözümlenip çözümlenmeyeceğini belirten bayrak. Varsayılan değer true'dur. |
properties.criteria | MetricAlertCriteria: |
belirli uyarı ölçüt bilgilerini tanımlar. |
properties.description |
string |
uyarı e-postasında yer alacak ölçüm uyarısının açıklaması. |
properties.enabled |
boolean |
ölçüm uyarısının etkinleştirilip etkinleştirilmediğini gösteren bayrak. |
properties.evaluationFrequency |
string |
ölçüm uyarısının ISO 8601 süre biçiminde temsil edilerek değerlendirilme sıklıkları. |
properties.isMigrated |
boolean |
bu uyarı kuralının geçirilip geçirildiğini gösteren değer. |
properties.lastUpdatedTime |
string |
Kural en son ISO8601 biçimde güncelleştirildi. |
properties.scopes |
string[] |
bu ölçüm uyarısının kapsamına alınan kaynak kimliğinin listesi. |
properties.severity |
integer |
Uyarı önem derecesi {0, 1, 2, 3, 4} |
properties.targetResourceRegion |
string |
uyarının oluşturulduğu/güncelleştirildiği hedef kaynakların bölgesi. Kapsam bir abonelik, kaynak grubu veya birden fazla kaynak içeriyorsa zorunlu. |
properties.targetResourceType |
string |
uyarının oluşturulduğu/güncelleştirildiği hedef kaynakların kaynak türü. Kapsam bir abonelik, kaynak grubu veya birden fazla kaynak içeriyorsa zorunlu. |
properties.windowSize |
string |
eşiğe göre uyarı etkinliğini izlemek için kullanılan süre (ISO 8601 süre biçiminde). |
tags |
object |
Kaynak etiketleri |
type |
string |
Azure kaynak türü |
MetricAlertResourcePatch
Düzeltme eki işlemleri için ölçüm uyarısı kaynağı.
Name | Tür | Description |
---|---|---|
properties.actions |
uyarı kuralı etkin olduğunda ve bir uyarı koşulu çözümlendiğinde gerçekleştirilen eylemler dizisi. |
|
properties.autoMitigate |
boolean |
uyarının otomatik olarak çözümlenip çözümlenmeyeceğini belirten bayrak. Varsayılan değer true'dur. |
properties.criteria | MetricAlertCriteria: |
belirli uyarı ölçüt bilgilerini tanımlar. |
properties.description |
string |
uyarı e-postasında yer alacak ölçüm uyarısının açıklaması. |
properties.enabled |
boolean |
ölçüm uyarısının etkinleştirilip etkinleştirilmediğini gösteren bayrak. |
properties.evaluationFrequency |
string |
ölçüm uyarısının ISO 8601 süre biçiminde temsil edilerek değerlendirilme sıklıkları. |
properties.isMigrated |
boolean |
bu uyarı kuralının geçirilip geçirildiğini gösteren değer. |
properties.lastUpdatedTime |
string |
Kural en son ISO8601 biçimde güncelleştirildi. |
properties.scopes |
string[] |
bu ölçüm uyarısının kapsamına alınan kaynak kimliğinin listesi. |
properties.severity |
integer |
Uyarı önem derecesi {0, 1, 2, 3, 4} |
properties.targetResourceRegion |
string |
uyarının oluşturulduğu/güncelleştirildiği hedef kaynakların bölgesi. MultipleResourceMultipleMetricCriteria için zorunlu. |
properties.targetResourceType |
string |
uyarının oluşturulduğu/güncelleştirildiği hedef kaynakların kaynak türü. MultipleResourceMultipleMetricCriteria için zorunlu. |
properties.windowSize |
string |
eşiğe göre uyarı etkinliğini izlemek için kullanılan süre (ISO 8601 süre biçiminde). |
tags |
object |
Kaynak etiketleri |
MetricAlertSingleResourceMultipleMetricCriteria
Birden çok ölçüm ölçütüne sahip tek bir kaynak için ölçüm uyarısı ölçütlerini belirtir.
Name | Tür | Description |
---|---|---|
allOf |
Bu 'tümü' işlemi için ölçüm ölçütlerinin listesi. |
|
odata.type |
string:
Microsoft. |
uyarı ölçütlerinin türünü belirtir. |
MetricCriteria
Ölçümleri filtreleme ölçütü.
Name | Tür | Description |
---|---|---|
criterionType |
string:
Static |
Eşik ölçütlerinin türünü belirtir |
dimensions |
Boyut koşullarının listesi. |
|
metricName |
string |
Ölçümün adı. |
metricNamespace |
string |
Ölçümün ad alanı. |
name |
string |
Ölçüt adı. |
operator |
ölçüt işleci. |
|
skipMetricValidation |
boolean |
Ölçüm doğrulamasının atlanmasına neden olarak henüz yayılmamış özel bir ölçümle ilgili uyarı kuralı oluşturmaya olanak sağlar. |
threshold |
number |
uyarıyı etkinleştiren ölçüt eşiği değeri. |
timeAggregation |
ölçüt zaman toplama türleri. |
MetricDimension
Ölçüm boyutunu belirtir.
Name | Tür | Description |
---|---|---|
name |
string |
Boyutun adı. |
operator |
string |
boyut işleci. Yalnızca 'Include' ve 'Exclude' desteklenir |
values |
string[] |
boyut değerlerinin listesi. |
Operator
ölçüt işleci.
Name | Tür | Description |
---|---|---|
Equals |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
WebtestLocationAvailabilityCriteria
Web testi kaynağı için ölçüm uyarısı kuralı ölçütlerini belirtir.
Name | Tür | Description |
---|---|---|
componentId |
string |
Application Insights kaynak kimliği. |
failedLocationCount |
number |
Başarısız konumların sayısı. |
odata.type |
string:
Microsoft. |
uyarı ölçütlerinin türünü belirtir. |
webTestId |
string |
Application Insights web testi kimliği. |