DescribeAlertLogList - - Centre de documentation Alibaba Cloud

Consulte l'historique des alertes en appelant l'opération DescribeAlertLogList.

Description de l'opération

Cette opération permet d'interroger l'historique des alertes uniquement au cours de la dernière année.

Cette rubrique fournit un exemple montrant comment interroger l'historique des alertes d'Elastic Compute Service (ECS) à partir de la dimension product du service cloud.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

cms:DescribeAlertLogList

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
StartTime	integer	Non	Le début de la plage de temps pour interroger l'historique des alertes. Unité : millisecondes. Vous ne pouvez interroger que l'historique des alertes de l'année écoulée. Si la plage de temps de la requête dépasse un an, la valeur renvoyée pour le paramètre AlertLogList est vide. Remarque L'intervalle entre l'heure de début (StartTime) et l'heure de fin (EndTime) doit être inférieur ou égal à 15 jours. Les deux paramètres doivent être spécifiés ou omis simultanément. S'ils ne sont pas spécifiés, l'historique des alertes des 15 dernières minutes est interrogé par défaut.	1609988009694
EndTime	integer	Non	La fin de la plage de temps pour interroger l'historique des alertes. Unité : millisecondes. Vous ne pouvez interroger que l'historique des alertes de l'année écoulée. Si la période de la requête dépasse un an, la valeur renvoyée pour le paramètre AlertLogList est vide. Remarque L'intervalle entre l'heure de début (StartTime) et l'heure de fin (EndTime) doit être inférieur ou égal à 15 jours. Les deux paramètres doivent être spécifiés ou non spécifiés simultanément. S'ils ne sont pas spécifiés, l'historique des alertes des 15 dernières minutes est interrogé par défaut.	1610074409694
PageNumber	integer	Non	Le numéro de page.	1
PageSize	integer	Non	Le nombre d'entrées par page.	10
SearchKey	string	Non	Le mot-clé utilisé pour consulter l'historique des alertes.	alert
GroupId	string	Non	L'identifiant du groupe d'applications.	7301****
Namespace	string	Non	L'espace de noms du service cloud. Remarque Pour plus d'informations sur les espaces de noms des services cloud, consultez Métriques.	acs_ecs_dashboard
Product	string	Non	L'abréviation du nom du service cloud. Pour plus d'informations sur la manière d'obtenir l'abréviation du nom d'un service cloud, consultez DescribeProductsOfActiveMetricRule.	ECS
Level	string	Non	Le niveau d'alerte et les méthodes de notification. Valeurs valides : P4 : e-mails et chatbots DingTalk. OK : aucune alerte.	P4
SendStatus	string	Non	L'état de l'alerte. Valeurs valides : 0 : Une alerte est déclenchée ou effacée. 1 : L'heure actuelle ne se situe pas dans la période de validité de l'alerte. 2 : L'heure actuelle se situe dans la période de silence du canal. 3 : L'hôte est en cours de redémarrage. 4 : Aucune alerte n'est envoyée. Lorsque l'état de l'alerte est 0, une alerte est déclenchée si Level est défini sur P4 ; l'alerte est effacée si Level est défini sur OK.	0
ContactGroup	string	Non	Le groupe de contacts d'alerte.	ECS_Group
RuleName	string	Non	Le nom de la règle d'alerte.	test123
MetricName	string	Non	Le nom de la métrique. Remarque Pour plus d'informations sur les métriques des services cloud, consultez Métriques.	IntranetInRate
LastMin	string	Non	L'intervalle auquel les journaux sont obtenus. Unité : minutes.	360
GroupBy	string	Non	La dimension spatiale selon laquelle les données sont agrégées, ce qui équivaut à Group By en SQL. Valeurs valides : `product` : agrège les données par service cloud. `level` : agrège les données par niveau d'alerte. `groupId` : agrège les données par groupe d'applications. `contactGroup` : agrège les données par groupe de contacts d'alerte. `product,metricName` : agrège les données par service cloud et métrique.	product
RuleId	string	Non	L'identifiant de la règle d'alerte. Pour plus d'informations sur la façon d'obtenir l'identifiant d'une règle d'alerte, consultez DescribeMetricRuleList.	bc369e8_30f87e517ed2fc****
SourceType	string	Non	Le type de la règle d'alerte. Valeur valide : METRIC, qui indique une règle d'alerte de métrique de séries temporelles.	METRIC
EventType	string	Non	Le type d'alerte. Valeurs valides : TRIGGERED : L'alerte est déclenchée. RESOLVED : L'alerte est résolue.	TRIGGERED

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

Éléments de réponse

Élément	Type	Description	Exemple
	object	Aucun.
RequestId	string	L'identifiant de la requête.	1C4A3709-BF52-42EE-87B5-7435F0929585
Success	boolean	Indique si l'appel a réussi. Valeurs valides : true : l'appel a réussi. false : l'appel a échoué.	true
Code	string	Le code d'état HTTP. Remarque Le code d'état 200 indique que l'appel a réussi.	200
Message	string	Le message d'erreur.	La ressource spécifiée est introuvable
PageNumber	integer	Le numéro de page.	1
PageSize	integer	Le nombre d'entrées par page.	10
AlertLogList	array<object>	La liste des entrées de l'historique des alertes.
	array<object>	Aucun.
MetricName	string	Le nom de la métrique.	cpu_total
EventName	string	Le nom de l'événement.	IOHang
Product	string	L'identifiant du service cloud. Valeurs valides : Pour un service Alibaba Cloud, la valeur est l'abréviation du nom du service cloud. Exemple : ECS. Pour un service non Alibaba Cloud, la valeur est au format `acs_Mot-clé du produit`. Exemple : acs_networkmonitor.	ECS
BlackListUUID	string	L'UUID de la liste noire d'alertes correspondante.	8410dbbd-7d30-41c5-94cb-****
Message	string	Les informations relatives à l'alerte, sous forme de chaîne JSON.	{"alertName":"e47aa0ac-4076-44db-a47d-d1083968****_Availability"}
Namespace	string	L'espace de noms du service cloud.	acs_ecs_dashboard
LevelChange	string	Le changement de niveau d'alerte. Valeurs valides :\n- `P4->OK` : le niveau d'alerte passe de P4 à OK, ce qui indique que l'alerte est levée.\n- `P4->P4` : indique une alerte de niveau P4.	P4->OK
InstanceId	string	L'identifiant de la ressource.	i-m5e1qg6uo38rztr4****
RuleName	string	Le nom de la règle d'alerte.	Utilisation du CPU
RuleId	string	L'identifiant de la règle d'alerte.	d582b9e9-b1c1-4f17-9279-0fe7333a****_ResponseTime
BlackListName	string	Le nom de la liste noire d'alertes correspondante.	Black_Test
GroupName	string	Le nom du groupe d'applications.	ECS_Instances
GroupId	string	L'identifiant du groupe d'applications.	7301****
AlertTime	string	L'horodatage auquel l'alerte a été déclenchée.	1610043776621
InstanceName	string	Le nom de la ressource.	portalHost
BlackListDetail	string	Les détails de la liste noire d'alertes correspondante.	{"id":12**,"metricProject":"acs_ecs_dashboard","userId":173651113438,"uuid":"8410dbbd-7d30-41c5-94cb-","name":"alert-","productCategory":"ecs","instances":[{"instanceId":"i-m5e1qg6uo38rztr4**"}],"metrics":null,"scopeType":"USER","scopeValue":"","startTime":"0001-01-01T00:00:00Z","endTime":"9999-12-31T23:59:59.999999999+08:00","effectiveTime":null,"isEnable":true,"status":1,"gmtCreate":"2021-11-02T16:35:59+08:00","gmtModified":"2021-11-02T16:35:59+08:00","loadTime":"2021-11-02T16:36:15.213072177+08:00"}
Level	string	Le niveau d'alerte et les méthodes de notification. Valeurs valides : P4 : e-mails et chatbots DingTalk. OK : aucune alerte.	P4
SendStatus	string	L'état de l'alerte. Valeurs valides : 0 : Une alerte est déclenchée ou effacée. 1 : L'heure actuelle n'est pas comprise dans la période de validité de l'alerte. 2 : L'heure actuelle est comprise dans la période de silence du canal. 3 : L'hôte est en cours de redémarrage. 4 : Aucune alerte n'est envoyée. Lorsque l'état de l'alerte est 0, une alerte est déclenchée si Level est défini sur P4 ; l'alerte est effacée si Level est défini sur OK.	0
ExtendedInfo	array<object>	Les informations étendues de l'alerte.
	object	Aucun.
Name	string	The name of the extension field.	userId
Value	string	The value of the extension field.	100931896542****
Dimensions	array<object>	Les dimensions de la ressource pour laquelle l'alerte est déclenchée.
	object	Aucun.
Key	string	The key of the alerting resource.	instanceId
Value	string	The value of the alerting resource.	i-m5e1qg6uo38rztr4****
WebhookList	array<object>	La liste des URL de rappel appelées lorsque l'alerte est déclenchée.
	object	Aucun.
code	string	The status code returned for the alert callback.	200
url	string	The URL that is called back when the alert is triggered.	https://www.aliyun.com/webhook.html
message	string	The information returned for the alert callback.	success
DingdingWebhookList	array	La liste des URL de webhook des robots DingTalk pour le contact d'alerte.
	string	La liste des URL de webhook des robots DingTalk pour le contact d'alerte.	https://oapi.dingtalk.com/robot/send?access_token=b7ff24032da1a5f86659ecda46797e13cc1d4e4da6903d7b014ea1d1488b****
ContactOnCallList	array	La liste des numéros de téléphone du contact d'alerte.
	string	La liste des numéros de téléphone du contact d'alerte. Remarque Ce paramètre s'applique uniquement au site chinois.	1368888****
ContactMailList	array	La liste des adresses e-mail du contact d'alerte.
	string	La liste des adresses e-mail du contact d'alerte.	username@example.com
ContactGroups	array	La liste des groupes de contacts d'alerte.
	string	Le groupe de contacts d'alerte.	ECS_Group
ContactALIIWWList	array	La liste des identifiants Wangwang du contact d'alerte.
	string	La liste des identifiants Wangwang du contact d'alerte. Remarque Ce paramètre s'applique uniquement au site chinois.	Alice
ContactSMSList	array	La liste des numéros de téléphone qui reçoivent les SMS du contact d'alerte.
	string	La liste des numéros de téléphone qui reçoivent les SMS du contact d'alerte. Remarque Ce paramètre s'applique uniquement au site chinois.	1368888****
ContactDingList	array	La liste des comptes DingTalk du contact d'alerte.
	string	La liste des comptes DingTalk du contact d'alerte.	CloudMonitor
SendDetail	object	Les détails du résultat de l'envoi de l'alerte.
ResultCode	string	The pushing status of the alert information. success: The alert was pushed. error code: If a configuration error occurs and the pushing list is empty, an error code is displayed.	success
ChannelResultList	array<object>	The list of alert pushing results by alert channel.
	array<object>	The alert pushing result by alert channel.
Channel	string	The alert pushing channel. Valid values: MAIL: email. SMS: text message. WEBHOOK: alert callback. SLS: Log Service. ONCALL: phone call. FC: Function Compute. MNS: Message Service (MNS).	MAIL
ResultList	array<object>	The list of alert information results that CloudMonitor sends to the alert channel.
	object	The alert information result that CloudMonitor sends to the alert channel.
Code	string	The status code. If `Channel` is set to `WEBHOOK`, the status code is 200 or 500. If `Channel` is set to `MAIL`, `SMS`, `SLS`, `ONCALL`, `FC`, or `MNS`, this parameter is unavailable or empty.	200
RequestId	string	The request ID returned by calling another cloud service.	0BDAF8A8-04DC-5F0C-90E4-724D42C4****
Success	boolean	The result of calling the target. true: The call was successful. false: The call failed.	true
Detail	string	The details of the returned result.	{ }
notifyTargetList	array	The list of channel notifications.
	string	The list of channel notifications.	MAIL
Escalation	object	La règle qui déclenche l'alerte.
Expression	string	The description of the rule that triggers the alert. Remarque The body of the alert rule. An alert rule is triggered when the monitoring data meets the alert conditions.	$Average<90
Times	integer	The number of times that the alert is retried.	1
Level	string	The alert level and notification methods. Valid values: P4: emails and DingTalk chatbots. OK: no alerts.	P4
SendResultList	array<object>	La liste des résultats d'envoi de l'alerte.
	object	La liste des résultats d'envoi de l'alerte.
Key	string	The channel that sends the alert. Valid values: MAIL: email. ALIIM: Wangwang. SMS: text message. CALL: phone call. DING: DingTalk chatbot. Merged: alert combination.	MAIL
Value	array	The notification target that corresponds to the alert channel.
	string	The notification target that corresponds to the alert channel.	username@example.com
LogId	string	L'identifiant du journal.	7510**::e8a472a0-46ae-4ac0-84b1-e46be368**

Exemples

JSON format

{
  "RequestId": "1C4A3709-BF52-42EE-87B5-7435F0929585",
  "Success": true,
  "Code": "200",
  "Message": "The specified resource is not found.",
  "PageNumber": 1,
  "PageSize": 10,
  "AlertLogList": [
    {
      "MetricName": "cpu_total",
      "EventName": "IOHang",
      "Product": "ECS",
      "BlackListUUID": "8410dbbd-7d30-41c5-94cb-****",
      "Message": "{\"alertName\":\"e47aa0ac-4076-44db-a47d-d1083968****_Availability\"}",
      "Namespace": "acs_ecs_dashboard",
      "LevelChange": "P4->OK",
      "InstanceId": "i-m5e1qg6uo38rztr4****",
      "RuleName": "CPU utilization",
      "RuleId": "d582b9e9-b1c1-4f17-9279-0fe7333a****_ResponseTime",
      "BlackListName": "Black_Test",
      "GroupName": "ECS_Instances",
      "GroupId": "7301****",
      "AlertTime": "1610043776621",
      "InstanceName": "portalHost",
      "BlackListDetail": "{\"id\":12****,\"metricProject\":\"acs_ecs_dashboard\",\"userId\":173651113438****,\"uuid\":\"8410dbbd-7d30-41c5-94cb-****\",\"name\":\"alert-****\",\"productCategory\":\"ecs\",\"instances\":[{\"instanceId\":\"i-m5e1qg6uo38rztr4****\"}],\"metrics\":null,\"scopeType\":\"USER\",\"scopeValue\":\"\",\"startTime\":\"0001-01-01T00:00:00Z\",\"endTime\":\"9999-12-31T23:59:59.999999999+08:00\",\"effectiveTime\":null,\"isEnable\":true,\"status\":1,\"gmtCreate\":\"2021-11-02T16:35:59+08:00\",\"gmtModified\":\"2021-11-02T16:35:59+08:00\",\"loadTime\":\"2021-11-02T16:36:15.213072177+08:00\"}",
      "Level": "P4",
      "SendStatus": "0",
      "ExtendedInfo": [
        {
          "Name": "userId",
          "Value": "100931896542****"
        }
      ],
      "Dimensions": [
        {
          "Key": "instanceId",
          "Value": "i-m5e1qg6uo38rztr4****"
        }
      ],
      "WebhookList": [
        {
          "code": "200",
          "url": "https://www.aliyun.com/webhook.html",
          "message": "success"
        }
      ],
      "DingdingWebhookList": [
        "https://oapi.dingtalk.com/robot/send?access_token=b7ff24032da1a5f86659ecda46797e13cc1d4e4da6903d7b014ea1d1488b****"
      ],
      "ContactOnCallList": [
        "1368888****"
      ],
      "ContactMailList": [
        "username@example.com"
      ],
      "ContactGroups": [
        "ECS_Group"
      ],
      "ContactALIIWWList": [
        "Alice"
      ],
      "ContactSMSList": [
        "1368888****"
      ],
      "ContactDingList": [
        "CloudMonitor"
      ],
      "SendDetail": {
        "ResultCode": "success",
        "ChannelResultList": [
          {
            "Channel": "MAIL",
            "ResultList": [
              {
                "Code": "200",
                "RequestId": "0BDAF8A8-04DC-5F0C-90E4-724D42C4****",
                "Success": true,
                "Detail": "{ }",
                "notifyTargetList": [
                  "MAIL"
                ]
              }
            ]
          }
        ]
      },
      "Escalation": {
        "Expression": "$Average<90",
        "Times": 1,
        "Level": "P4"
      },
      "SendResultList": [
        {
          "Key": "MAIL",
          "Value": [
            "username@example.com"
          ]
        }
      ],
      "LogId": "7510****::e8a472a0-46ae-4ac0-84b1-e46be368****"
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	ParameterInvalid	Parameter invalid.
500	InternalError	The request processing has failed due to some unknown error.
403	AccessForbidden	User not authorized to operate on the specified resource.
404	ResourceNotFound	The specified resource is not found.	The specified resource is not found.
409	ResourceConflict	Concurrent modification of resources.
409	ResourceExist	Resources already exist.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.