Tous les produits
Search
Centre de documentation

:DescribeGroupMonitoringAgentProcess

Dernière mise à jour :Aug 08, 2026

Interroge les tâches de surveillance des processus pour un groupe d'applications.

Créez une tâche de surveillance des processus pour superviser toutes les instances Elastic Compute Service (ECS) ou certaines d'entre elles au sein d'un groupe d'applications, et définissez des règles d'alerte associées à cette tâche.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. 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

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

DescribeGroupMonitoringAgentProcess

Opération à effectuer. Définissez la valeur sur DescribeGroupMonitoringAgentProcess.

GroupId

String

Oui

12345

ID du groupe d'applications.

ProcessName

String

Non

sshd

Nom de la tâche de surveillance des processus.

PageNumber

Integer

Non

1

Numéro de la page à renvoyer. Valeur par défaut : 1.

PageSize

Integer

Non

10

Nombre d'entrées à renvoyer par page. Valeur par défaut : 10.

Paramètres de réponse

ParamètreTypeExempleDescription
RequestIdString7985D471-3FA8-4EE9-8F4B-45C19DF3D36F

ID de la requête.

CodeString200

Code d'état HTTP.

Remarque Le code d'état 200 indique que l'appel a réussi.
SuccessBooleantrue

Indique si l'appel a réussi. La valeur true signifie un succès. La valeur false signifie un échec.

ProcessesArrayN/A

Tâches de surveillance des processus créées pour le groupe d'applications.

ProcessN/AN/AN/A
AlertConfigArrayN/A

Configurations de la règle d'alerte.

AlertConfigN/AN/AN/A
ComparisonOperatorStringGreaterThanOrEqualToThreshold

Opérateur de comparaison du seuil pour les alertes de niveau critique. 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 métrique à la même heure la veille
  • LessThanYesterday : inférieur à la valeur de métrique à la même heure la veille
  • GreaterThanLastWeek : supérieur à la valeur de métrique à la même heure la semaine précédente
  • LessThanLastWeek : inférieur à la valeur de métrique à la même heure la semaine précédente
  • GreaterThanLastPeriod : supérieur à la valeur de métrique du dernier cycle de surveillance
  • LessThanLastPeriod : inférieur à la valeur de métrique du dernier cycle de surveillance
EffectiveIntervalString00:00-23:59

Période durant laquelle la règle d'alerte est effective.

EscalationsLevelStringwarn

Niveau de l'alerte. Valeurs valides :

  • critical
  • warn
  • info
NoEffectiveIntervalString00:00-23:59

Période durant laquelle la règle d'alerte n'est pas effective.

SilenceTimeString86400

Durée de la période de silence pendant laquelle aucune nouvelle alerte n'est envoyée, même si les conditions de déclenchement sont remplies. Unité : secondes. Valeur minimale : 3600, ce qui équivaut à une heure. Valeur par défaut : 86400, ce qui équivaut à un jour.

Remarque Une seule notification d'alerte est envoyée pendant chaque période de silence, même si la valeur de métrique dépasse consécutivement plusieurs fois le seuil d'alerte.
StatisticsStringAverage

Méthode utilisée pour calculer les valeurs de métrique qui déclenchent les alertes.

ThresholdString5

Seuil de déclenchement des alertes.

TimesString3

Nombre de fois consécutives où le seuil doit être dépassé.

Remarque Une métrique ne déclenche une alerte qu'après que sa valeur a atteint le seuil consécutivement pendant le nombre de fois spécifié.
WebhookStringhttp://www.aliyun.com

URL de rappel vers laquelle une requête POST est envoyée lorsqu'une alerte est déclenchée selon la règle d'alerte.

GroupIdString12345

ID du groupe d'applications.

IdString3F6150F9-45C7-43F9-9578-A58B2E72****

ID de la tâche de surveillance des processus.

MatchExpressArrayN/A

Expressions conditionnelles utilisées pour faire correspondre les instances.

Remarque Seules les instances qui satisfont aux expressions conditionnelles sont surveillées par la tâche de surveillance des processus.
MatchExpressN/AN/AN/A
FunctionStringall

Méthode utilisée pour faire correspondre les instances. Valeur par défaut : all. Valeurs valides :

  • all
  • startWith
  • endWith
  • contains
  • notContains
  • equals
Remarque Les instances correspondantes sont surveillées par la tâche de surveillance des processus.
NameStringname

Critères de mise en correspondance des instances.

Remarque Définissez la valeur sur name, indiquant que les instances sont mises en correspondance en fonction du nom de l'instance.
ValueStringportalHost

Mot-clé utilisé pour faire correspondre le nom de l'instance.

MatchExpressFilterRelationStringand

Opérateur logique utilisé entre les expressions conditionnelles servant à mettre en correspondance les instances. Valeurs valides :

  • all
  • and
  • or
ProcessNameStringsshd

Nom de la tâche de surveillance des processus.

MessageStringThe Request is not authorization.

Message renvoyé.

PageNumberString1

Numéro de la page renvoyée. Valeur par défaut : 1.

PageSizeString10

Nombre d'entrées renvoyées par page. Valeur par défaut : 10.

TotalString28

Nombre total d'entrées renvoyées.

Exemples

Exemple de requête

http(s)://[Endpoint]/? Action=DescribeGroupMonitoringAgentProcess
&GroupId=12345
&<Common request parameters>

Exemple de réponse réussie

XML format

<DescribeGroupMonitoringAgentProcess>
          <RequestId>7985D471-3FA8-4EE9-8F4B-45C19DF3D36F</RequestId>
          <PageSize>10</PageSize>
          <PageNumber>1</PageNumber>
          <Total>28</Total>
          <Processes>
                <Process>
                      <ProcessName>sshd</ProcessName>
                      <MatchExpressFilterRelation>and</MatchExpressFilterRelation>
                      <Id>3F6150F9-45C7-43F9-9578-A58B2E72****</Id>
                      <GroupId>12345</GroupId>
                </Process>
                <Process>
                      <AlertConfig>
                            <AlertConfig>
                                  <Function>all</Function>
                                  <Value>portalHost</Value>
                                  <Name>name</Name>
                            </AlertConfig>
                            <AlertConfig>
                                  <NoEffectiveInterval>00:00-23:59</NoEffectiveInterval>
                                  <SilenceTime>86400</SilenceTime>
                                  <ComparisonOperator>GreaterThanOrEqualToThreshold</ComparisonOperator>
                                  <Times>3</Times>
                                  <Webhook>http://www.aliyun.com</Webhook>
                                  <EffectiveInterval>00:00-23:59</EffectiveInterval>
                                  <EscalationsLevel>warn</EscalationsLevel>
                                  <Statistics>Average</Statistics>
                                  <Threshold>5</Threshold>
                            </AlertConfig>
                      </AlertConfig>
                      <MatchExpress>
                            <MatchExpress>
                                  <Function>all</Function>
                                  <Value>portalHost</Value>
                                  <Name>name</Name>
                            </MatchExpress>
                            <MatchExpress>
                                  <NoEffectiveInterval>00:00-23:59</NoEffectiveInterval>
                                  <SilenceTime>86400</SilenceTime>
                                  <ComparisonOperator>GreaterThanOrEqualToThreshold</ComparisonOperator>
                                  <Times>3</Times>
                                  <Webhook>http://www.aliyun.com</Webhook>
                                  <EffectiveInterval>00:00-23:59</EffectiveInterval>
                                  <EscalationsLevel>warn</EscalationsLevel>
                                  <Statistics>Average</Statistics>
                                  <Threshold>5</Threshold>
                            </MatchExpress>
                      </MatchExpress>
                </Process>
          </Processes>
          <Code>200</Code>
          <Success>true</Success>
</DescribeGroupMonitoringAgentProcess>

JSON format

{
    "RequestId":"7985D471-3FA8-4EE9-8F4B-45C19DF3D36F",
    "PageSize":"10",
    "PageNumber":"1",
    "Total":"28",
    "Processes":{
        "Process":[
            {
                "ProcessName":"sshd",
                "MatchExpressFilterRelation":"and",
                "Id":"3F6150F9-45C7-43F9-9578-A58B2E72****",
                "GroupId":"12345"
            },
            {
                "AlertConfig":{
                    "AlertConfig":[
                        {
                            "Function":"all",
                            "Value":"portalHost",
                            "Name":"name"
                        },
                        {
                            "NoEffectiveInterval":"00:00-23:59",
                            "SilenceTime":"86400",
                            "ComparisonOperator":"GreaterThanOrEqualToThreshold",
                            "Times":"3",
                            "Webhook":"http://www.aliyun.com",
                            "EffectiveInterval":"00:00-23:59",
                            "EscalationsLevel":"warn",
                            "Statistics":"Average",
                            "Threshold":"5"
                        }]
                },
                "MatchExpress":{
                    "MatchExpress":[
                        {
                            "Function":"all",
                            "Value":"portalHost",
                            "Name":"name"
                        },
                        {
                            "NoEffectiveInterval":"00:00-23:59",
                            "SilenceTime":"86400",
                            "ComparisonOperator":"GreaterThanOrEqualToThreshold",
                            "Times":"3",
                            "Webhook":"http://www.aliyun.com",
                            "EffectiveInterval":"00:00-23:59",
                            "EscalationsLevel":"warn",
                            "Statistics":"Average",
                            "Threshold":"5"
                        }]
                }
            }]
    },
    "Code":"200",
    "Success":"true"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.