Cloud Monitor:Criar um alerta global para limites de taxa de API

Casos de uso

Altos volumes de chamadas de API podem causar limitações frequentes, afetando a estabilidade do negócio. Em vez de configurar regras de alerta individuais por API, uma regra de alerta global monitora todos os limites de taxa de um serviço cloud e permite um planejamento proativo de cotas.

É possível monitorar o uso global de APIs e as cotas por meio do console ou de operações de API.

Faturamento

As regras de alerta de limite de taxa de API consomem sua cota de notificações do CloudMonitor. O faturamento varia conforme o método de notificação:

• Chamada telefônica — Não há cota gratuita disponível. Ative o método de faturamento pagamento conforme o uso ou adquira um plano de recursos. Para mais informações, consulte {{XREF_0}} e {{XREF_1}}.

• SMS — Uma cota gratuita de 1.000 mensagens por mês é fornecida. Caso a cota gratuita seja excedida, ative o método de faturamento pagamento conforme o uso ou adquira um plano de recursos. Para mais informações, consulte {{XREF_2}}, {{XREF_3}} e {{XREF_4}}.

• E-mail e callback de alerta — Ambos os métodos são gratuitos.

Pré-requisitos

• Crie contatos de alerta e um grupo de contatos de alerta no console do CloudMonitor para receber mensagens de alerta. Para obter instruções, consulte {{XREF_5}}.

• Se você utilizar um usuário do Resource Access Management (RAM) para gerenciar alertas de cota, esse usuário deverá ter a permissão de gerenciamento do Quota Center (AliyunQuotasFullAccess) e as permissões para criar e excluir alertas de cota no CloudMonitor. O exemplo a seguir mostra o conteúdo da política personalizada. Para mais informações, consulte {{XREF_6}} e {{XREF_7}}.

Criar um alerta global pelo console

Este exemplo cria uma regra de alerta global para todos os limites de taxa de API do Compute Nest, acionada quando o uso atingir 80%. Uma notificação de nível Warning é enviada por SMS e e-mail para o grupo de contatos de alerta.

Utilize o console do Quota Center ou do CloudMonitor.

Criar um alerta global por API

Este exemplo cria uma regra de alerta global para todos os limites de taxa de API do Compute Nest, acionada quando o uso atingir 80%. Uma notificação de nível Warning é enviada por SMS e e-mail para o grupo de contatos de alerta.

1. Verifique se o serviço cloud alvo (Compute Nest) oferece suporte a regras de alerta global para limites de taxa de API.

   Chame {{XREF_10}} e verifique o parâmetro de resposta UsageMetric. Um valor não vazio para UsageMetric indica suporte a regras de alerta global.

   • Parâmetros de solicitação: Defina ProductCode como computenest e QuotaCategory como FlowControl. Mantenha os valores padrão para os outros parâmetros.

   • Parâmetros de resposta: O objeto UsageMetric contém informações de monitoramento de limites de taxa de API do CloudMonitor. O valor de MetricNamespace é acs_quotas_flowcontrol. Exemplo de resposta para um limite de taxa de API:

     {
       "Message": "",
       "RequestId": "BE4CAC0F-A134-55BA-909B-FF62568FE884",
       "FailedListResult": {
         "Target": []
       },
       "Code": "200",
       "Success": true
     }

     Nota

     metricKey é usado para criar uma regra de alerta para um único limite de taxa de API específico.

2. Chame {{XREF_11}} para consultar dados de monitoramento dos limites de taxa de API. Utilize as tendências de uso para determinar os limiares de alerta.

   • Parâmetros de solicitação: Defina Namespace como acs_quotas_flowcontrol, MetricName como UsagePercentage e Dimensions como [{"productCode":"computenest"}]. Mantenha os valores padrão para os outros parâmetros.

     Nota

     O MetricName no Quota Center inclui: Quota (valor da cota), Usage (uso da cota), UsagePercentage (porcentagem de uso da cota) e AvailablePercentage (porcentagem de cota disponível).

   • Parâmetros de retorno: O campo Value em Datapoints pode servir de referência para o limiar de alerta. Exemplo de resposta:

     {
       "Message": "",
       "RequestId": "BE4CAC0F-A134-55BA-909B-FF62568FE884",
       "FailedListResult": {
         "Target": []
       },
       "Code": "200",
       "Success": true
     }

3. Chame {{XREF_12}} para criar uma regra de alerta global para os limites de taxa de API.

   • Parâmetros de solicitação: A tabela a seguir lista os parâmetros obrigatórios e valores de exemplo.

     Parâmetro	Descrição	Exemplo
     MetricName	Nome da métrica. Valores válidos: Quota: valor da cota Usage: uso da cota UsagePercentage: porcentagem de uso AvailablePercentage: porcentagem disponível Nota Regras de alerta global só podem usar UsagePercentage e AvailablePercentage.	UsagePercentage
     Escalations.Warn.Threshold	Limiar para alertas de nível Warning.	80
     EffectiveInterval	Período de vigência da regra de alerta.	00:00-23:59 +0800 dayofweek 1,2,3,4,5,6,7
     RuleId	ID da regra de alerta.	quota-computenest-ruleid-test
     Escalations.Warn.ComparisonOperator	Operador de comparação para o limiar de nível Warning. Valores válidos: GreaterThanOrEqualToThreshold: maior ou igual a GreaterThanThreshold: maior que LessThanOrEqualToThreshold: menor ou igual a LessThanThreshold: menor que NotEqualToThreshold: diferente de GreaterThanYesterday: aumento percentual em relação ao mesmo horário ontem LessThanYesterday: redução percentual em relação ao mesmo horário ontem GreaterThanLastWeek: aumento percentual em relação ao mesmo horário na semana passada LessThanLastWeek: redução percentual em relação ao mesmo horário na semana passada GreaterThanLastPeriod: aumento percentual em relação ao período anterior LessThanLastPeriod: redução percentual em relação ao período anterior	GreaterThanOrEqualToThreshold
     Resources	Informações do recurso. Nota Para criar um alerta para uma única API, especifique o parâmetro Resources como: [{"productCode":"computenest","metricKey":"GetServiceTemplateParameterConstraints/2021-06-01"}].	[{"productCode":"computenest"}]
     ContactGroups	Grupo de contatos de alerta.	CloudMonitor
     Namespace	Namespace de dados do serviço cloud.	acs_quotas_flowcontrol
     RuleName	Nome da regra de alerta.	quota-computenest-rulename-test
     Escalations.Warn.Times	Número de períodos consecutivos em que a condição deve ser atendida para acionar um alerta de nível Warning.	3
     Escalations.Warn.Statistics	Método estatístico para um alerta de nível Warning.	Value

   • Uma resposta bem-sucedida indica que a regra foi criada.

     {
       "Message": "",
       "RequestId": "BE4CAC0F-A134-55BA-909B-FF62568FE884",
       "FailedListResult": {
         "Target": []
       },
       "Code": "200",
       "Success": true
     }

4. Chame {{XREF_13}} para verificar a regra de alerta por RuleName ou RuleId.

Documentos relacionados

• Criar um alerta para um único limite de taxa de API: {{XREF_14}}

• Solicitar aumento de cota após um alerta: {{XREF_15}}

• Visualizar detalhes da regra de alerta: {{XREF_16}}

• Visualizar histórico de alertas: {{XREF_17}}