Microservices Engine:Configurar uma política de limitação

O recurso de limitação no console do MSE foi atualizado para incluir novos modos, disponíveis apenas para versões 1.1.0 e posteriores do gateway. O recurso de limitação legado ainda está disponível. Portanto, selecione o procedimento correspondente à versão do seu gateway.

• Se a versão do seu gateway for 1.1.0 ou posterior, consulte a seção Configurar uma política de limitação (nova).

• Se a versão do seu gateway for 1.0.0, consulte a seção Configurar uma política de limitação (legada).

Configurar uma política de limitação (nova)

1. Faça login no console do MSE. Na barra de navegação superior, selecione uma região.

2. No painel de navegação à esquerda, escolha Cloud-native Gateway > Gateways. Na página Gateways, clique em ID do gateway.

3. No painel de navegação à esquerda, clique em Routes. Em seguida, clique em aba Routes.

4. Localize a rota desejada e clique em Policies na coluna Actions.

5. Na aba Policies, clique em Throttling.

   Para versões 1.2.25 e posteriores do gateway

   • Regras de limitação

     As regras de limitação monitoram as consultas por segundo (QPS) de uma rota. Quando o QPS atinge o limiar configurado, o gateway intercepta imediatamente o tráfego. Essa ação protege os serviços de backend contra sobrecarga por picos repentinos de tráfego e garante alta disponibilidade.

     1. Na seção Throttling, clique em aba throttling rules.

     2. Na seção Throttling Rules, configure os seguintes parâmetros.

        Parâmetro	Descrição
        Gateway QPS threshold	O máximo de consultas por segundo (QPS) para todo o gateway.
        Web fallback behavior	Ação executada quando uma requisição é limitada. As opções incluem Return Specified Content e Go to Specified Page.
        Se você definir Web Fallback Behavior como Go to Specified Page:
        Redirect URL	URL para a qual as requisições limitadas são redirecionadas.
        Se você definir Web Fallback Behavior como Return Specified Content:
        HTTP status code	Código de status HTTP retornado. O valor padrão é 429.
        Returned content type	Tipo de conteúdo da resposta. As opções são Plain Text e JSON.
        HTTP response body	Corpo da resposta personalizada retornada.
        Enable	Ativa a regra quando habilitado.

     3. Clique em New ou Save e, em seguida, clique em OK na caixa de diálogo de confirmação.

   • Regras de concorrência

     As regras de concorrência monitoram o número total de requisições processadas pelo gateway. Quando o número de requisições simultâneas atinge o limiar configurado, o gateway intercepta imediatamente o novo tráfego. Defina este valor como a capacidade máxima de processamento simultâneo do seu serviço de backend para garantir sua disponibilidade sob alta concorrência.

     1. Na seção Throttling, clique em aba concurrency rules.

     2. Na aba concurrency rules, configure os seguintes parâmetros.

        Parâmetro	Descrição
        Gateway concurrency threshold	Número máximo de requisições simultâneas para todo o gateway.
        Web fallback behavior	Ação executada quando uma requisição é limitada. As opções incluem Return Specified Content e Go to Specified Page.
        Se você definir Web Fallback Behavior como Go to Specified Page:
        Redirect URL	URL para a qual as requisições limitadas são redirecionadas.
        Se você definir Web Fallback Behavior como Return Specified Content:
        HTTP status code	Código de status HTTP retornado. O valor padrão é 429.
        Returned content type	Tipo de conteúdo da resposta. As opções são Plain Text e JSON.
        HTTP response body	Corpo da resposta personalizada retornada.
        Enable	Ativa a regra quando habilitado.

     3. Clique em New ou Save e, em seguida, clique em OK na caixa de diálogo de confirmação.

   • Regras de disjuntor

     As regras de disjuntor monitoram o tempo de resposta ou a taxa de erro de uma rota. Ao atingir um limiar especificado, o disjuntor abre e interrompe as chamadas para o recurso instável por um período determinado. Isso protege o serviço de backend e garante alta disponibilidade. Após esse período, as chamadas para o recurso são retomadas.

     1. Na seção throttling, clique em aba Fuse rule.

     2. Na aba Fuse rule, configure os seguintes parâmetros.

        Parâmetro	Descrição
        Statistical window duration	Duração da janela de tempo para coleta de estatísticas. Valores válidos: 1 segundo a 120 minutos.
        Minimum requests	Número mínimo de requisições necessário para acionar o disjuntor. Se o número de requisições na janela de tempo atual for menor que este valor, a regra não será acionada mesmo que o limiar seja atingido.
        Threshold type	Selecione Slow Call Ratio ou Error Ratio como limiar. Ao selecionar slow call ratio como limiar, defina o slow call RT permitido (tempo máximo de resposta). Uma requisição é contada como chamada lenta se seu tempo de resposta for maior que este valor. Também é necessário definir a taxa de chamadas lentas que aciona o disjuntor. Com a regra ativada, se o número de requisições em uma janela de tempo estatística for maior que o mínimo de requisições e a taxa de chamadas lentas exceder o limiar, as requisições subsequentes serão bloqueadas automaticamente durante o período de disjuntor definido. Após o término desse período, o disjuntor entra em estado semiaberto. Se o tempo de resposta da próxima requisição única for menor que o slow call RT configurado, o disjuntor fecha. Caso contrário, ele abre novamente. Ao selecionar Error Ratio, defina o limiar para a taxa de erro. Com a regra ativada, se o número de requisições em uma janela de tempo exceder a contagem mínima de requisições e a taxa de erro superar o limiar, o disjuntor abre. Durante o período de disjuntor subsequente, todas as requisições falham rapidamente.
        Circuit breaking period (s)	Duração durante a qual o circuito permanece aberto após o disparo. Nesse período, todas as chamadas para o recurso falham rapidamente.
        Web fallback behavior	Ação executada quando uma requisição é limitada. As opções incluem Return Specified Content e Go to Specified Page.
        Se você definir Web Fallback Behavior como Go to Specified Page:
        Redirect URL	URL para a qual as requisições limitadas são redirecionadas.
        Se você definir Web Fallback Behavior como Return Specified Content:
        HTTP status code	Código de status HTTP retornado. O valor padrão é 429.
        Returned content type	Tipo de conteúdo da resposta. As opções são Plain Text e JSON.
        HTTP response body	Corpo da resposta personalizada retornada.
        Enable	Ativa a regra quando habilitado.

     3. Clique em New ou Save e, em seguida, clique em OK na caixa de diálogo de confirmação.

   Para versões 1.1.0 a 1.2.24 do gateway

   • Regra de limitação

     As regras de limitação monitoram as consultas por segundo (QPS) de uma rota. Quando o QPS atinge o limiar configurado, o gateway intercepta imediatamente o tráfego. Essa ação evita que os serviços de backend sejam sobrecarregados por picos repentinos de tráfego e garante alta disponibilidade.

     1. No painel Throttling, clique em aba Throttling Rules e, em seguida, clique em Add Throttling Rule.

     2. Na página Add Throttling Rule, configure as definições.

        1. Na etapa Configure Rule, defina o gateway QPS threshold conforme necessário e ative a chave Enable. Em seguida, clique em Next.

        2. Na etapa Configure Throttling Behavior, clique em New behavior para personalizar a resposta HTTP quando a limitação for acionada.

     3. Após configurar o comportamento de limitação, clique em New para criar a regra.

   • Regra de concorrência

     As regras de concorrência monitoram o número total de requisições processadas pelo gateway. Quando o número de requisições simultâneas atinge o limiar configurado, o gateway intercepta imediatamente o novo tráfego. Defina este valor como a capacidade máxima de processamento simultâneo do seu serviço de backend para garantir sua disponibilidade sob alta concorrência.

     1. No painel Throttling, clique em aba concurrency rules e, em seguida, clique em Add Concurrency Rule.

     2. Na página Add Concurrency Rule, configure as definições.

        1. Na etapa Configure Rule, defina o gateway concurrency threshold conforme necessário e ative a chave Enable. Em seguida, clique em Next.

        2. Na etapa Configure Throttling Behavior, clique em Add Behavior para personalizar a resposta HTTP quando a limitação for acionada.

     3. Após configurar o comportamento de limitação, clique em New para criar a regra.

   • Regra de disjuntor

     As regras de disjuntor monitoram o tempo de resposta ou a taxa de erro de uma rota. Ao atingir um limiar especificado, o disjuntor abre e interrompe as chamadas para o recurso instável por um período determinado. Isso protege o serviço de backend e garante alta disponibilidade. Após esse período, as chamadas para o recurso são retomadas.

     1. No painel throttling, clique em aba Fuse rule e, em seguida, clique em Added fusing rule.

     2. Na página Add Circuit Breaking Rule, configure as definições.

        1. Na etapa Configure Rule, defina os parâmetros conforme necessário e ative a chave Enable. Em seguida, clique em Next.

           Parâmetro	Descrição
           Statistical window duration	Duração da janela de tempo para coleta de estatísticas. Valores válidos: 1 segundo a 120 minutos.
           Minimum requests	Número mínimo de requisições necessário para acionar o disjuntor. Se o número de requisições na janela de tempo atual for menor que este valor, a regra não será acionada mesmo que o limiar seja atingido.
           Threshold type	Selecione Slow Call Ratio ou Error Ratio como limiar. Ao selecionar a taxa de chamadas lentas como limiar, defina um Tempo de Resposta (RT) permitido para chamadas lentas. Uma requisição é contada como chamada lenta se seu tempo de resposta for maior que este valor. Também é necessário definir a taxa de chamadas lentas que acionará o disjuntor. Com a regra ativada, se o número de requisições em uma janela de tempo estatística for maior que o mínimo de requisições e a taxa de chamadas lentas exceder o limiar definido, as requisições subsequentes serão bloqueadas automaticamente durante o período de disjuntor especificado. Após a expiração do período de disjuntor, o disjuntor entra em estado semiaberto. Se o tempo de resposta da próxima requisição única for menor que o slow call RT configurado, o disjuntor fecha. Caso contrário, ele abre novamente. Ao selecionar Error Ratio, defina o limiar para a taxa de erro. Com a regra ativada, se o número de requisições em uma janela de tempo exceder a contagem mínima de requisições e a taxa de erro superar o limiar, o disjuntor abre. Durante o período de disjuntor subsequente, todas as requisições falham rapidamente.
           Circuit breaking period	Duração durante a qual o circuito permanece aberto após o disparo. Nesse período, todas as chamadas para o recurso falham rapidamente.
           Circuit Breaking Recovery Strategy	Estratégia de recuperação para o disjuntor quando ele entra em estado semiaberto. Recuperação por sonda única: Após o período de disjuntor, o disjuntor permite a passagem de uma única requisição para teste. Se a requisição for bem-sucedida (não for uma chamada lenta nem um erro), o circuito fecha. Caso contrário, ele abre novamente.

        2. Na etapa Configure Throttling Behavior, clique em Add Behavior para personalizar a resposta HTTP quando a limitação for acionada.

     3. Após configurar o comportamento de limitação, clique em New para criar a regra.

Configurar uma política de limitação (legada)

1. Faça login no console do MSE.

2. No painel de navegação à esquerda, escolha Cloud-native Gateway > Gateways. Na barra de navegação superior, selecione uma região.

3. Na página Gateways, clique em ID do gateway.

4. No painel de navegação à esquerda, clique em routes > Route Settings. Localize a rota desejada e clique em policies na coluna Actions.

5. Na seção Policies, clique em aba throttling.

   • Caso ainda não tenha configurado uma política de limitação para a rota, clique em Configure policy.

   • Se já existir uma política de limitação configurada, clique em ícone de edição () ao lado da política.

6. Na regra de throttling threshold, defina a Time Window e o single-machine request threshold e, em seguida, clique em OK.

   A seguir estão descritos os parâmetros de limitação.

   • Time window: Período de tempo durante o qual o limiar de requisições é medido. O padrão é 1 segundo.

   • Single-machine request threshold: Número máximo de requisições permitidas para um único nó de gateway dentro da janela de tempo especificada.

7. Após configurar a regra de limitação, ative a chave Enable.

   • Ativado: Com a política de limitação habilitada, as requisições para esta rota são restritas pela janela de tempo e pelo limiar de requisições configurados.

   • Desativado: Com a política de limitação desabilitada, o número de requisições para esta rota não sofre restrições.

Verificar o resultado

curl -I http://121.196.XX.XX/demo/item/list     # The IP address of the ingress gateway

• Resposta quando a política de limitação está desativada:

  HTTP/1.1 200 OK
  x-content-type-options: nosniff
  x-xss-protection: 1; mode=block
  cache-control: no-cache, no-store, max-age=0, must-revalidate
  pragma: no-cache
  expires: 0
  x-frame-options: DENY
  content-type: application/json
  content-length: 86
  date: Mon, 29 Nov 2021 08:28:00 GMT
  x-envoy-upstream-service-time: 4
  server: istio-envoy

• Resposta quando a política de limitação está ativada e é acionada (o código de status HTTP 429 é retornado):

  HTTP/1.1 429 Too Many Requests
  x-local-rate-limit: true
  content-length: 18
  content-type: text/plain
  date: Mon, 29 Nov 2021 08:28:01 GMT
  server: istio-envoy