DescribeGroupMonitoringAgentProcess - : Central de Documentação do Alibaba Cloud

Crie uma tarefa de monitoramento de processos para monitorar todas as instâncias do Elastic Compute Service (ECS) em um grupo de aplicações — ou apenas as instâncias especificadas — e defina regras de alerta para essa tarefa.

Debugging

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar o uso, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeGroupMonitoringAgentProcess	A operação a ser executada. Defina o valor como DescribeGroupMonitoringAgentProcess.
GroupId	String	Yes	12345	O ID do grupo de aplicações.
ProcessName	String	No	sshd	O nome da tarefa de monitoramento de processos.
PageNumber	Integer	No	1	O número da página a ser retornada. Valor padrão: 1.
PageSize	Integer	No	10	O número de entradas a serem retornadas por página. Valor padrão: 10.

Response parameters

Parameter	Type	Example	Description
RequestId	String	7985D471-3FA8-4EE9-8F4B-45C19DF3D36F	O ID da solicitação.
Code	String	200	O código de status HTTP. Nota O código de status 200 indica que a chamada foi bem-sucedida.
Success	Boolean	true	Indica se a chamada foi bem-sucedida. O valor true indica êxito; o valor false indica falha.
Processes	Array	N/A	As tarefas de monitoramento de processos criadas para o grupo de aplicações.
Process	N/A	N/A	N/A
AlertConfig	Array	N/A	As configurações da regra de alerta.
AlertConfig	N/A	N/A	N/A
ComparisonOperator	String	GreaterThanOrEqualToThreshold	O operador de comparação do limiar para alertas de nível crítico. Valores válidos: GreaterThanOrEqualToThreshold: maior ou igual ao limiar GreaterThanThreshold: maior que o limiar LessThanOrEqualToThreshold: menor ou igual ao limiar LessThanThreshold: menor que o limiar NotEqualToThreshold: diferente do limiar GreaterThanYesterday: maior que o valor da métrica no mesmo horário do dia anterior LessThanYesterday: menor que o valor da métrica no mesmo horário do dia anterior GreaterThanLastWeek: maior que o valor da métrica no mesmo horário da semana anterior LessThanLastWeek: menor que o valor da métrica no mesmo horário da semana anterior GreaterThanLastPeriod: maior que o valor da métrica no último ciclo de monitoramento LessThanLastPeriod: menor que o valor da métrica no último ciclo de monitoramento
EffectiveInterval	String	00:00-23:59	O período durante o qual a regra de alerta está ativa.
EscalationsLevel	String	warn	O nível do alerta. Valores válidos: critical warn info
NoEffectiveInterval	String	00:00-23:59	O período durante o qual a regra de alerta está inativa.
SilenceTime	String	86400	A duração do período de silêncio, durante o qual novos alertas não são enviados mesmo que as condições de gatilho sejam atendidas. Unidade: segundos. Valor mínimo: 3600, equivalente a uma hora. Valor padrão: 86400, equivalente a um dia. Nota Somente uma notificação de alerta é enviada a cada período de silêncio, mesmo que o valor da métrica exceda o limiar de alerta consecutivamente várias vezes.
Statistics	String	Average	O método usado para calcular os valores de métrica que disparam alertas.
Threshold	String	5	O limiar para o disparo de alertas.
Times	String	3	O número de vezes que o limiar pode ser excedido consecutivamente. Nota Uma métrica dispara um alerta somente após seu valor atingir o limiar consecutivamente pelo número de vezes especificado.
Webhook	String	http://www.aliyun.com	A URL de callback para a qual uma solicitação POST é enviada quando um alerta é disparado com base na regra de alerta.
GroupId	String	12345	O ID do grupo de aplicações.
Id	String	3F6150F9-45C7-43F9-9578-A58B2E72****	O ID da tarefa de monitoramento de processos.
MatchExpress	Array	N/A	As expressões condicionais usadas para corresponder às instâncias. Nota Somente as instâncias que atendem às expressões condicionais são monitoradas pela tarefa de monitoramento de processos.
MatchExpress	N/A	N/A	N/A
Function	String	all	O método usado para corresponder às instâncias. Valor padrão: all. Valores válidos: all startWith endWith contains notContains equals Nota As instâncias correspondentes são monitoradas pela tarefa de monitoramento de processos.
Name	String	name	O critério com base no qual as instâncias são correspondidas. Nota Defina o valor como `name`, indicando que as instâncias são correspondidas pelo nome da instância.
Value	String	portalHost	A palavra-chave usada para corresponder ao nome da instância.
MatchExpressFilterRelation	String	and	O operador lógico aplicado entre as expressões condicionais usadas para corresponder às instâncias. Valores válidos: all and or
ProcessName	String	sshd	O nome da tarefa de monitoramento de processos.
Message	String	The Request is not authorization.	A mensagem retornada.
PageNumber	String	1	O número da página retornada. Valor padrão: 1.
PageSize	String	10	O número de entradas retornadas por página. Valor padrão: 10.
Total	String	28	O número total de entradas retornadas.

Examples

Exemplos de requisições

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

Exemplos de respostas bem-sucedidas

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"
}

Error codes

Para consultar a lista de códigos de erro, acesse o API Error Center.