Consulta tarefas acionadas por eventos, incluindo configurações e alterações nos dados de monitoramento. Use esta operação para detectar anomalias de recursos do sistema antecipadamente e garantir a estabilidade e a confiabilidade do ambiente.
Depuração
Parâmetros de solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
Action |
String |
Yes |
DescribeAlarms |
Operação a ser executada. Defina o valor como DescribeAlarms. |
|
RegionId |
String |
Yes |
cn-qingdao |
ID da região da tarefa acionada por evento. |
|
ScalingGroupId |
String |
No |
asg-bp18p2yfxow2dloq**** |
ID do grupo de dimensionamento monitorado pela tarefa acionada por evento. |
|
AlarmTaskId |
String |
No |
asg-bp1hvbnmkl10vll5**_f95ce797-dc2e-4bad-9618-14fee7d1** |
ID da tarefa acionada por evento. |
|
State |
String |
No |
OK |
Status da tarefa acionada por evento. Valores válidos:
|
|
IsEnable |
Boolean |
No |
true |
Especifica se o recurso de tarefa acionada por evento está ativado. Valores válidos:
|
|
MetricType |
String |
No |
system |
Tipo de métrica usada pela tarefa acionada por evento. Valores válidos:
|
|
MetricName |
String |
No |
CpuUtilization |
Nome da métrica. |
|
PageSize |
Integer |
No |
10 |
Número de entradas por página. Valor máximo: 50. Valor padrão: 10. |
|
PageNumber |
Integer |
No |
1 |
Número da página. Valor mínimo: 1. Valor padrão: 1. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
PageSize |
Integer |
10 |
Número de entradas por página. |
|
RequestId |
String |
871C7C53-34A4-45AA-8C14-4B72FA6A**** |
ID da solicitação. |
|
PageNumber |
Integer |
1 |
Número da página. |
|
TotalCount |
Integer |
2 |
Número total de tarefas acionadas por evento. |
|
AlarmList |
Array of Alarm |
Tarefas acionadas por evento. |
|
|
Alarm |
|||
|
AlarmTaskId |
String |
asg-bp1hvbnmkl10vll5**_f95ce797-dc2e-4bad-9618-14fee7d1** |
ID da tarefa acionada por evento. |
|
MetricName |
String |
CpuUtilization |
Nome da métrica. Valores válidos:
Para obter mais informações, consulte Tarefa acionada por evento para monitoramento do sistema. |
|
EvaluationCount |
Integer |
3 |
Número de vezes que o limiar deve ser atingido antes da execução de uma regra de dimensionamento. Por exemplo, se este parâmetro for definido como 3, a utilização média da CPU deverá atingir 80% três vezes consecutivas antes que a regra seja executada. |
|
State |
String |
ALARM |
Status da tarefa acionada por evento. Valores válidos:
|
|
Period |
Integer |
300 |
Período estatístico dos dados da métrica. Unidade: segundos. Valores válidos:
Nota
Defina este parâmetro como 15 segundos apenas para grupos de dimensionamento do tipo ECS. |
|
ScalingGroupId |
String |
asg-bp18p2yfxow2dloq**** |
ID do grupo de dimensionamento monitorado pela tarefa acionada por evento. |
|
ComparisonOperator |
String |
>= |
Operador usado para comparar o valor da métrica com o limiar.
|
|
Effective |
String |
* ? |
Período durante o qual a tarefa acionada por evento permanece vigente. |
|
Description |
String |
Test alarm task. |
Descrição da tarefa acionada por evento. |
|
MetricType |
String |
system |
Tipo de métrica. Valores válidos:
|
|
Name |
String |
TestAlarmTask |
Nome da tarefa acionada por evento. |
|
Threshold |
Float |
80.0 |
Limiar do valor da métrica. Se o limiar for atingido o número especificado de vezes dentro do período definido, uma regra de dimensionamento será executada. |
|
Enable |
Boolean |
true |
Indica se o recurso de tarefa acionada por evento está ativado. Valores válidos:
|
|
Statistics |
String |
Average |
Método estatístico dos dados da métrica. Unidade: segundos. Valores válidos:
|
|
Dimensions |
Array of Dimension |
Dimensões da métrica. |
|
|
Dimension |
|||
|
DimensionKey |
String |
device |
Chave de dimensão da métrica. Valores válidos:
|
|
DimensionValue |
String |
eth0 |
Valor da dimensão da métrica. O valor deste parâmetro varia conforme o valor de DimensionKey.
Valores válidos para
|
|
AlarmActions |
Array of String |
ari:acs:ess:cn-hangzhou:1406926474**:scalingrule/asr-bp163l21e07uh** |
Identificadores exclusivos das regras de dimensionamento associadas às tarefas acionadas por evento. |
|
Expressions |
Array of Expression |
Expressões definidas na regra de alerta de múltiplas métricas. |
|
|
Expression |
|||
|
MetricName |
String |
CpuUtilization |
Nomes das métricas na regra de alerta de múltiplas métricas. Valores válidos:
Para obter mais informações, consulte Tarefa acionada por evento para monitoramento do sistema. |
|
ComparisonOperator |
String |
>= |
Operador usado para comparar o valor da métrica com o limiar.
Valor padrão: >=. |
|
Period |
Integer |
900 |
Período estatístico dos dados da métrica na regra de alerta de múltiplas métricas. Unidade: segundos. Valores válidos:
Nota
Defina este parâmetro como 15 segundos apenas para grupos de dimensionamento do tipo ECS. |
|
Statistics |
String |
Average |
Método estatístico dos dados da métrica na regra de alerta de múltiplas métricas. Valores válidos:
|
|
Threshold |
Float |
40.0 |
Limiares dos valores das métricas na regra de alerta de múltiplas métricas. Se os limiares forem atingidos o número especificado de vezes dentro do período estatístico, uma regra de dimensionamento será executada. |
|
ExpressionsLogicOperator |
String |
&& |
Lógica de acionamento de alerta da regra de alerta de múltiplas métricas. Valores válidos:
|
|
HybridMonitorNamespace |
String |
aliyun-test |
ID do namespace do Hybrid Cloud Monitoring. Para obter informações sobre como gerenciar namespaces do Hybrid Cloud Monitoring, consulte Gerenciar namespaces. |
|
HybridMetrics |
Array of HybridMetric |
Métricas do Hybrid Cloud Monitoring. Para obter mais informações, consulte Criar uma regra de dimensionamento de rastreamento de destino personalizada. |
|
|
HybridMetric |
|||
|
Id |
String |
a |
ID de referência da métrica na expressão da métrica. |
|
Expression |
String |
(a+b)/2 |
Expressão da métrica composta por múltiplas métricas do Hybrid Cloud Monitoring. Calcula um resultado usado para acionar eventos de dimensionamento. A expressão usa o formato Notação Polonesa Reversa (RPN) e inclui apenas os seguintes operadores: |
|
MetricName |
String |
AliyunSmq_NumberOfMessagesVisible |
Nome da métrica do Hybrid Cloud Monitoring. |
|
Statistic |
String |
Average |
Método estatístico do valor da métrica. Valores válidos:
|
|
Dimensions |
Array of Dimension |
Dimensões da métrica. Use este parâmetro para especificar os recursos monitorados. |
|
|
Dimension |
|||
|
DimensionKey |
String |
queue |
Chave de dimensão da métrica. |
|
DimensionValue |
String |
testQueue |
Valor da dimensão da métrica. |
|
PromQL |
String |
(avg(last_over_time(AliyunMnsnew_ActiveMessages{region='cn-hangzhou',userId='123456**',queue='testQueue'}[900s])) by (userId))/(avg(last_over_time(AliyunEss_RunningInstanceCount{instanceId='asg-bp1**'}[900s])) by (userId) != 0) |
Instrução PromQL do Hybrid Cloud Monitoring. |
Exemplos
Solicitações de exemplo
http(s)://ess.aliyuncs.com/?Action=DescribeAlarms
&RegionId=cn-qingdao
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&AlarmTaskId=asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****
&State=OK
&IsEnable=true
&MetricType=system
&MetricName=CpuUtilization
&PageSize=10
&PageNumber=1
&<Common request parameters>
Respostas de sucesso de exemplo
XML formato
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeAlarmsResponse>
<PageSize>10</PageSize>
<RequestId>871C7C53-34A4-45AA-8C14-4B72FA6A****</RequestId>
<PageNumber>1</PageNumber>
<TotalCount>2</TotalCount>
<AlarmList>
<AlarmTaskId>asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****</AlarmTaskId>
<MetricName>CpuUtilization</MetricName>
<EvaluationCount>3</EvaluationCount>
<State>ALARM</State>
<Period>300</Period>
<ScalingGroupId>asg-bp18p2yfxow2dloq****</ScalingGroupId>
<ComparisonOperator>>=</ComparisonOperator>
<Effective>* * * * * ?</Effective>
<Description>Test alarm task.</Description>
<MetricType>system</MetricType>
<Name>TestAlarmTask</Name>
<Threshold>80</Threshold>
<Enable>true</Enable>
<Statistics>Average</Statistics>
<Dimensions>
<DimensionKey>device</DimensionKey>
<DimensionValue>eth0</DimensionValue>
</Dimensions>
<AlarmActions>ari:acs:ess:cn-hangzhou:1406926474****:scalingrule/asr-bp163l21e07uh****</AlarmActions>
<Expressions>
<MetricName>CpuUtilization</MetricName>
<ComparisonOperator>>=</ComparisonOperator>
<Period>900</Period>
<Statistics>Average</Statistics>
<Threshold>40</Threshold>
</Expressions>
<ExpressionsLogicOperator>&&</ExpressionsLogicOperator>
</AlarmList>
</DescribeAlarmsResponse>
JSON formato
HTTP/1.1 200 OK
Content-Type:application/json
{
"PageSize" : 10,
"RequestId" : "871C7C53-34A4-45AA-8C14-4B72FA6A****",
"PageNumber" : 1,
"TotalCount" : 2,
"AlarmList" : [ {
"AlarmTaskId" : "asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****",
"MetricName" : "CpuUtilization",
"EvaluationCount" : 3,
"State" : "ALARM",
"Period" : 300,
"ScalingGroupId" : "asg-bp18p2yfxow2dloq****",
"ComparisonOperator" : ">=",
"Effective" : "* * * * * ?",
"Description" : "Test alarm task.",
"MetricType" : "system",
"Name" : "TestAlarmTask",
"Threshold" : 80,
"Enable" : true,
"Statistics" : "Average",
"Dimensions" : [ {
"DimensionKey" : "device",
"DimensionValue" : "eth0"
} ],
"AlarmActions" : [ "ari:acs:ess:cn-hangzhou:1406926474****:scalingrule/asr-bp163l21e07uh****" ],
"Expressions" : [ {
"MetricName" : "CpuUtilization",
"ComparisonOperator" : ">=",
"Period" : 900,
"Statistics" : "Average",
"Threshold" : 40
} ],
"ExpressionsLogicOperator" : "&&"
} ]
}
Códigos de erro
Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.