CreateGroupMetricRules - - Centre de documentation Alibaba Cloud

Cette rubrique présente un exemple de création d'une règle d'alerte pour la métrique cpu_total du service Elastic Compute Service (ECS) au sein du groupe d'applications 123456. L'identifiant de la règle d'alerte est 456789. Le nom de la règle d'alerte est ECS_Rule1. Le niveau d'alerte est défini sur Critical. La méthode statistique utilisée est Average. L'opérateur de comparaison est GreaterThanOrEqualToThreshold. Le seuil d'alerte est fixé à 90. Le nombre de tentatives de réessai d'alerte est de 3. La réponse confirme la création de la règle d'alerte nommée ECS_Rule1.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateGroupMetricRules	L'opération à effectuer. Définissez la valeur sur CreateGroupMetricRules.
GroupId	Long	Yes	3607****	L'ID du groupe d'applications. Pour savoir comment obtenir l'ID d'un groupe d'applications, consultez DescribeMonitorGroups.
GroupMetricRules.N.Escalations.Info.Threshold	String	No	10	Le seuil pour les alertes de niveau Info. Valeurs valides pour N : 1 à 200. Remarque Sélectionnez au moins un des niveaux d'alerte Critical, Warn et Info, et spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau d'alerte sélectionné.
GroupMetricRules.N.MetricName	String	Yes	cpu_total	Le nom de la métrique. Valeurs valides pour N : 1 à 200. Pour savoir comment obtenir le nom d'une métrique, consultez DescribeMetricMetaList ou Annexe 1 : Métriques.
GroupMetricRules.N.Escalations.Warn.Threshold	String	No	20	Le seuil pour les alertes de niveau Warn. Valeurs valides pour N : 1 à 200. Remarque Sélectionnez au moins un des niveaux d'alerte Critical, Warn et Info, et spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau d'alerte sélectionné.
GroupMetricRules.N.EffectiveInterval	String	No	05:31-23:59	La période pendant laquelle la règle d'alerte est effective. Valeurs valides pour N : 1 à 200.
GroupMetricRules.N.NoEffectiveInterval	String	No	00:00-05:30	La période pendant laquelle la règle d'alerte n'est pas effective. Valeurs valides pour N : 1 à 200.
GroupMetricRules.N.RuleId	String	Yes	456789	L'ID de la règle d'alerte. Valeurs valides pour N : 1 à 200.
GroupMetricRules.N.Escalations.Critical.Times	Integer	No	3	Le nombre consécutif de fois où la valeur de la métrique doit satisfaire la condition d'alerte avant qu'une alerte de niveau Critical ne soit déclenchée. Valeurs valides pour N : 1 à 200. Remarque Sélectionnez au moins un des niveaux d'alerte Critical, Warn et Info, et spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau d'alerte sélectionné.
GroupMetricRules.N.Dimensions	String	No	[{"instanceId":"i-m5e1qg6uo38rztr4****"}]	Les dimensions de surveillance de la ressource spécifiée. Définissez la valeur comme une collection de paires `key:value`. Exemple : `{"userId":"120886317861**"}` ou `{"instanceId":"i-2ze2d6j5uhg20x47**"}`.
GroupMetricRules.N.Escalations.Critical.Threshold	String	No	90	Le seuil pour les alertes de niveau Critical. Valeurs valides pour N : 1 à 200. Remarque Sélectionnez au moins un des niveaux d'alerte Critical, Warn et Info, et spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau d'alerte sélectionné.
GroupMetricRules.N.Escalations.Critical.Statistics	String	No	Average	La méthode statistique pour les alertes de niveau Critical. Valeurs valides pour N : 1 à 200. La valeur de ce paramètre est déterminée par la colonne `Statistics` correspondant au paramètre `MetricName` du service cloud spécifié. La valeur de ce paramètre peut être Maximum, Minimum ou Average. Pour plus d'informations sur l'obtention de la valeur de ce paramètre, consultez Annexe 1 : Métriques. Remarque Sélectionnez au moins un des niveaux d'alerte Critical, Warn et Info, et spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau d'alerte sélectionné.
GroupMetricRules.N.Escalations.Warn.ComparisonOperator	String	No	GreaterThanOrEqualToThreshold	L'opérateur utilisé pour comparer la valeur de la métrique avec le seuil pour les alertes de niveau Warn. Valeurs valides : GreaterThanOrEqualToThreshold : supérieur ou égal au seuil GreaterThanThreshold : supérieur au seuil LessThanOrEqualToThreshold : inférieur ou égal au seuil LessThanThreshold : inférieur au seuil NotEqualToThreshold : différent du seuil GreaterThanYesterday : supérieur à la valeur de la métrique à la même heure la veille LessThanYesterday : inférieur à la valeur de la métrique à la même heure la veille GreaterThanLastWeek : supérieur à la valeur de la métrique à la même heure la semaine précédente LessThanLastWeek : inférieur à la valeur de la métrique à la même heure la semaine précédente GreaterThanLastPeriod : supérieur à la valeur de la métrique du dernier cycle de surveillance LessThanLastPeriod : inférieur à la valeur de la métrique du dernier cycle de surveillance Valeurs valides pour N : 1 à 200. Remarque Sélectionnez au moins un des niveaux d'alerte Critical, Warn et Info, et spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau d'alerte sélectionné.
GroupMetricRules.N.Escalations.Info.Times	Integer	No	1	Le nombre consécutif de fois où la valeur de la métrique doit satisfaire la condition d'alerte avant qu'une alerte de niveau Info ne soit déclenchée. Valeurs valides pour N : 1 à 200. Remarque Sélectionnez au moins un des niveaux d'alerte Critical, Warn et Info, et spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau d'alerte sélectionné.
GroupMetricRules.N.SilenceTime	Integer	No	86400	La période de silence pendant laquelle aucune nouvelle alerte n'est envoyée, même si les conditions de déclenchement sont remplies. Valeurs valides pour N : 1 à 200. Unité : secondes. Valeur par défaut : 86400. Valeur minimale : 3600.
GroupMetricRules.N.Webhook	String	No	https://www.aliyun.com	L'URL de rappel. Valeurs valides pour N : 1 à 200. L'URL de rappel doit être accessible via Internet. CloudMonitor envoie une requête POST pour pousser une notification d'alerte vers l'URL de rappel que vous spécifiez. Seules les requêtes HTTP sont prises en charge.
GroupMetricRules.N.Namespace	String	Yes	acs_ecs_dashboard	Le namespace du service cloud. Valeurs valides pour N : 1 à 200. Pour savoir comment obtenir le namespace d'un service cloud, consultez DescribeMetricMetaList ou Annexe 1 : Métriques.
GroupMetricRules.N.EmailSubject	String	No	ECS instance	L'objet de l'e-mail de notification d'alerte. Valeurs valides pour N : 1 à 200.
GroupMetricRules.N.Period	String	No	60	La période d'agrégation des données de métrique. Valeurs valides pour N : 1 à 200. Définissez le paramètre `Period` sur un multiple entier de 60. Unité : secondes. Valeur par défaut : 300.
GroupMetricRules.N.RuleName	String	Yes	ECS_Rule1	Le nom de la règle d'alerte. Valeurs valides pour N : 1 à 200.
GroupMetricRules.N.Escalations.Info.Statistics	String	No	Average	La méthode statistique pour les alertes de niveau Info. Valeurs valides pour N : 1 à 200. La valeur de ce paramètre est déterminée par la colonne `Statistics` correspondant au paramètre `MetricName` du service cloud spécifié. La valeur de ce paramètre peut être Maximum, Minimum ou Average. Pour plus d'informations sur l'obtention de la valeur de ce paramètre, consultez Annexe 1 : Métriques. Remarque Sélectionnez au moins un des niveaux d'alerte Critical, Warn et Info, et spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau d'alerte sélectionné.
GroupMetricRules.N.Escalations.Warn.Times	Integer	No	3	Le nombre consécutif de fois où la valeur de la métrique doit satisfaire la condition d'alerte avant qu'une alerte de niveau Warn ne soit déclenchée. Valeurs valides pour N : 1 à 200. Remarque Sélectionnez au moins un des niveaux d'alerte Critical, Warn et Info, et spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau d'alerte sélectionné.
GroupMetricRules.N.Escalations.Info.ComparisonOperator	String	No	GreaterThanOrEqualToThreshold	L'opérateur utilisé pour comparer la valeur de la métrique avec le seuil pour les alertes de niveau Info. Valeurs valides : GreaterThanOrEqualToThreshold : supérieur ou égal au seuil GreaterThanThreshold : supérieur au seuil LessThanOrEqualToThreshold : inférieur ou égal au seuil LessThanThreshold : inférieur au seuil NotEqualToThreshold : différent du seuil GreaterThanYesterday : supérieur à la valeur de la métrique à la même heure la veille LessThanYesterday : inférieur à la valeur de la métrique à la même heure la veille GreaterThanLastWeek : supérieur à la valeur de la métrique à la même heure la semaine précédente LessThanLastWeek : inférieur à la valeur de la métrique à la même heure la semaine précédente GreaterThanLastPeriod : supérieur à la valeur de la métrique du dernier cycle de surveillance LessThanLastPeriod : inférieur à la valeur de la métrique du dernier cycle de surveillance Valeurs valides pour N : 1 à 200. Remarque Sélectionnez au moins un des niveaux d'alerte Critical, Warn et Info, et spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau d'alerte sélectionné.
GroupMetricRules.N.Interval	String	No	60	L'intervalle auquel CloudMonitor vérifie si la règle d'alerte est déclenchée. Valeurs valides pour N : 1 à 200. Unité : secondes. La valeur par défaut correspond à la fréquence la plus basse à laquelle la métrique est interrogée. Remarque Nous vous recommandons de définir l'intervalle sur la période d'agrégation des données. Si l'intervalle est plus court que la période d'agrégation des données, les alertes ne peuvent pas être déclenchées en raison d'un manque de données.
GroupMetricRules.N.Category	String	Yes	ECS	L'abréviation du nom du service cloud. Valeurs valides pour N : 1 à 200. Pour plus d'informations sur l'obtention de l'abréviation du nom d'un service cloud, consultez `metricCategory` dans le paramètre de réponse `Labels` de l'opération DescribeProjectMeta.
GroupMetricRules.N.Escalations.Critical.ComparisonOperator	String	No	GreaterThanOrEqualToThreshold	L'opérateur utilisé pour comparer la valeur de la métrique avec le seuil pour les alertes de niveau Critical. Valeurs valides : GreaterThanOrEqualToThreshold : supérieur ou égal au seuil GreaterThanThreshold : supérieur au seuil LessThanOrEqualToThreshold : inférieur ou égal au seuil LessThanThreshold : inférieur au seuil NotEqualToThreshold : différent du seuil GreaterThanYesterday : supérieur à la valeur de la métrique à la même heure la veille LessThanYesterday : inférieur à la valeur de la métrique à la même heure la veille GreaterThanLastWeek : supérieur à la valeur de la métrique à la même heure la semaine précédente LessThanLastWeek : inférieur à la valeur de la métrique à la même heure la semaine précédente GreaterThanLastPeriod : supérieur à la valeur de la métrique du dernier cycle de surveillance LessThanLastPeriod : inférieur à la valeur de la métrique du dernier cycle de surveillance Valeurs valides pour N : 1 à 200. Remarque Sélectionnez au moins un des niveaux d'alerte Critical, Warn et Info, et spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau d'alerte sélectionné.
GroupMetricRules.N.Escalations.Warn.Statistics	String	No	Average	La méthode statistique pour les alertes de niveau Warn. Valeurs valides pour N : 1 à 200. La valeur de ce paramètre est déterminée par la colonne `Statistics` correspondant au paramètre `MetricName` du service cloud spécifié. La valeur de ce paramètre peut être Maximum, Minimum ou Average. Pour plus d'informations sur l'obtention de la valeur de ce paramètre, consultez Annexe 1 : Métriques. Remarque Sélectionnez au moins un des niveaux d'alerte Critical, Warn et Info, et spécifiez les paramètres Statistics, ComparisonOperator, Threshold et Times pour le niveau d'alerte sélectionné.
GroupMetricRules.N.NoDataPolicy	String	No	KEEP_LAST_STATE	La méthode utilisée pour gérer les alertes lorsqu'aucune donnée de surveillance n'est trouvée. Valeurs valides : KEEP_LAST_STATE (par défaut) : Aucune opération n'est effectuée. INSUFFICIENT_DATA : Une alerte dont le contenu est « Insufficient data » est déclenchée. OK : Le statut est considéré comme normal. Valeurs valides pour N : 1 à 200.
GroupMetricRules.N.ContactGroups	String	No	ECS_Group	Le groupe de contacts d'alerte. Valeurs valides pour N : 1 à 200. Pour savoir comment obtenir les groupes de contacts d'alerte, consultez DescribeContactGroupList.
GroupMetricRules.N.Labels.N.Key	String	No	key1	La clé de tag de la règle d'alerte. Le tag spécifié est inclus dans les notifications d'alerte. Valeurs valides pour N : 1 à 200.
GroupMetricRules.N.Labels.N.Value	String	No	value1	La valeur de tag de la règle d'alerte. Le tag spécifié est inclus dans les notifications d'alerte. Valeurs valides pour N : 1 à 200.

Pour plus d'informations sur les paramètres de requête communs, consultez Paramètres communs.

Paramètres de réponse

Parameter	Type	Example	Description
Code	Integer	200	Le code d'état HTTP. Remarque Le code d'état 200 indique que la requête a abouti.
Message	String	The Request is not authorization.	Le message d'erreur.
RequestId	String	461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D	L'ID de la requête.
Success	Boolean	true	Indique si la requête a abouti. Valeurs valides : true false
Resources	Array of AlertResult		Les détails des règles d'alerte.
AlertResult
Code	Integer	200	Le code d'état renvoyé pour la règle d'alerte. Remarque Le code d'état 200 indique que la requête a abouti.
Message	String	Metric not found.	Le message d'erreur renvoyé pour la règle d'alerte.
Success	Boolean	true	Indique si la règle d'alerte a été créée. Valeurs valides : true false
RuleName	String	ECS_Rule1	Le nom de la règle d'alerte.
RuleId	String	456789	L'ID de la règle d'alerte.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=CreateGroupMetricRules
&GroupId=123456
&GroupMetricRules.1.Category=ECS
&GroupMetricRules.1.MetricName=cpu_total
&GroupMetricRules.1.1amespace=acs_ecs_dashboard
&GroupMetricRules.1.RuleId=456789
&GroupMetricRules.1.RuleName=ECS_Rule1
&GroupMetricRules.1.Escalations.Critical.Statistics=Average
&GroupMetricRules.1.Escalations.Critical.ComparisonOperator=GreaterThanOrEqualToThreshold
&GroupMetricRules.1.Escalations.Critical.Threshold=90
&GroupMetricRules.1.Escalations.Critical.Times=3
&<Common request parameters>

Exemples de réponses réussies

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateGroupMetricRulesResponse>
	<RequestId>CED22B00-CFD8-5BDF-A645-CAF7B81FAE45</RequestId>
	<Resources>
		<AlertResult>
			<RuleId>456789</RuleId>
			<Code>200</Code>
			<Success>true</Success>
			<RuleName>ECS_Rule1</RuleName>
		</AlertResult>
	</Resources>
	<Code>200</Code>
	<Success>true</Success>
</CreateGroupMetricRulesResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "CED22B00-CFD8-5BDF-A645-CAF7B81FAE45",
  "Resources" : {
    "AlertResult" : [ {
      "RuleId" : "456789",
      "Code" : 200,
      "Success" : true,
      "RuleName" : "ECS_Rule1"
    } ]
  },
  "Code" : 200,
  "Success" : true
}

Codes d'erreur

Pour une liste des codes d'erreur, consultez Codes d'erreur de service.