Serverless App Engine:Proteção de tráfego

Item de configuração

Descrição

Whether to open

Ao ativar esta chave, a regra entra em vigor imediatamente após a criação. A chave vem desativada por padrão.

Per-instance QPS threshold

O limiar de QPS do objeto na dimensão estatística da API limitada.

Flow control effect

Selecione como lidar com o tráfego limitado. Fast failure: Ao atingir o limiar, as requisições são bloqueadas imediatamente. O conteúdo da resposta é determinado pelas configurações do módulo adaptador nas configurações do sistema da aplicação. Waiting in line: As requisições passam em uma taxa constante e as excedentes são enfileiradas. Este método é tipicamente usado para deslocamento de carga de pico. É necessário definir um período de timeout. Uma requisição falha rapidamente ao atingir o período de timeout.

Item de configuração

Descrição

Whether to open

Ao ativar esta chave, a regra entra em vigor imediatamente após a criação. A chave vem desativada por padrão.

Concurrency threshold

O limiar para o número de threads simultâneas do resource, correspondendo ao número de threads em execução para esse resource.

Item de configuração

Descrição

Statistical window duration

A duração da janela de tempo para estatísticas. Valores válidos: 1 segundo a 120 minutos.

Minimum number of requests

O número mínimo de requisições que aciona o circuit breaking. Se o número de requisições na janela de tempo estatística atual for menor que este valor, a regra não será acionada mesmo que a condição de circuit breaking seja atendida.

Threshold Type

Selecione Slow call ratio (%) ou Abnormal proportion (%) como limiar. Se você selecionar Slow call ratio como limiar, deverá especificar o Slow call RT permitido, que é o tempo máximo de resposta. Uma requisição com tempo de resposta superior a este valor conta como chamada lenta. No campo Circuit Breaking Ratio Threshold, defina a proporção de chamadas lentas que aciona o circuit breaking. Após ativar a regra, se o número de requisições em uma janela de tempo estatística for maior que o Minimum number of requests e a proporção de chamadas lentas for maior que o limiar, as requisições subsequentes serão bloqueadas automaticamente durante o Circuit Breaking Duration (s). Após a duração do circuit breaking, o disjuntor entra no estado de recuperação por sondagem. Se o tempo de resposta da próxima requisição for menor que o Slow call RT especificado, o circuit breaking termina. Se o tempo de resposta for maior que o Slow call RT especificado, o circuit breaking é acionado novamente. Caso selecione Abnormal proportion como limiar, defina a taxa de erros que aciona o circuit breaking no campo Circuit Breaking Ratio Threshold. Após ativar a regra, se o número de erros de negócio em uma janela de tempo estatística for maior que o Minimum number of requests e a taxa de erros for maior que o limiar, as requisições subsequentes serão bloqueadas automaticamente durante o Circuit Breaking Duration (s).

Circuit Breaking Duration (s)

Clique em Show Advanced Options para configurar este parâmetro. Representa a duração do circuit breaking após seu acionamento. Depois que um resource entra no estado de circuit breaking, as requisições falham rapidamente dentro da duração especificada.

Circuit Breaking Policy

Clique em Show Advanced Options para configurar este parâmetro. Define a política de recuperação que o disjuntor usa ao entrar na fase de recuperação (estado semiaberto). Single detection recovery: Após a duração do circuit breaking, o disjuntor sonda a próxima requisição. Se a requisição atender às expectativas (não sendo nem chamada lenta nem erro), o circuit breaking termina. Caso contrário, o disjuntor retorna à fase de circuit breaking. Progressive recovery: É necessário definir o Number of recovery phases e o Minimum number of passes per step . Após a duração do circuit breaking, o disjuntor se recupera progressivamente com base no número de fases de recuperação especificado. Se o número de requisições em uma fase atingir o número mínimo de aprovações por etapa, uma verificação é acionada. Se nenhuma das requisições verificadas exceder o limiar, o sistema aumenta gradualmente a proporção de requisições permitidas até a recuperação total do tráfego. Se uma métrica em uma das etapas exceder o limiar, o disjuntor retorna à fase de circuit breaking. A proporção de requisições é T = 100/N, onde N é o número de fases de recuperação. A proporção na primeira fase é T, na segunda é 2T, e assim por diante, até atingir 100%. Por exemplo, se o número de fases de recuperação for 3 e o número mínimo de aprovações por etapa for 5, as requisições serão permitidas nas proporções de 33%, 67% e 100% nas três fases. Quando o número de requisições em uma fase for maior ou igual a 5, uma verificação é realizada. Se as métricas da requisição não excederem o limiar, o disjuntor avança para a próxima fase de recuperação até a recuperação total do tráfego.

Item de configuração

Descrição

Parameter position Index

A posição de índice do parâmetro passado no resource do ponto de instrumentação. Corresponde à posição do índice do parâmetro em SphU.entry(xxx,args). Por exemplo, no ponto de instrumentação SphU.entry(resourceName,Entry Type.IN,1,paramA,paramB), o índice do parâmetro paramA é 0 e o índice do parâmetro paramB é 1.

Statistical dimension

É possível medir o número de requisições ou o número de threads simultâneas. Number of requests: Limita o número de chamadas dentro de um período. Concurrent number: Limita o número de chamadas simultâneas ao resource.

Statistical cycle time

A duração da janela de tempo estatística, em segundos. Por exemplo, se a janela de tempo estatística for de 10 segundos e o limiar de QPS for 5, cada parâmetro hotspot poderá ser acessado no máximo 5 vezes dentro de 10 segundos.

Single machine threshold

O limiar aplicado a cada parâmetro hotspot.

Flow control effect

Se a Statistical dimension estiver definida como Number of requests, selecione como lidar com o tráfego limitado. Fast failure: Ao atingir o limiar, as requisições são bloqueadas imediatamente. Neste modo, também é possível definir um Number of buffered requests, que é o número de requisições extras permitidas para rajadas de tráfego. Waiting in line: As requisições passam em uma taxa constante e as excedentes são enfileiradas. Este método é tipicamente usado para deslocamento de carga de pico. É necessário definir um período de timeout. Quando uma requisição é enfileirada, o sistema calcula seu tempo estimado de espera. Se esse tempo exceder o período máximo de timeout, a requisição é rejeitada. Por exemplo, se o Single machine threshold for definido como 5, apenas uma requisição passa a cada 200 milissegundos e as excedentes são enfileiradas. Se o Timeout for definido como 1000 milissegundos, novas requisições serão rejeitadas quando mais de 5 requisições já estiverem enfileiradas, o que corresponde a um tempo de espera superior a 1000 milissegundos.

Whether to open

Ao ativar esta chave, a regra entra em vigor imediatamente após a criação. A chave vem desativada por padrão.

Item de configuração

Descrição

Parameter Properties

Modela o tráfego com base nas propriedades do parâmetro da API selecionada. Client IP: O endereço IP do cliente. Se uma requisição passar por um proxy, o sistema tenta primeiro obter o IP do header de requisição X-Forwarded-For. Se esse header contiver informações de IP, o sistema usará esse endereço como o IP real do cliente. Remote Host: O header Host do cliente. Header: O sistema analisa a requisição com base no header HTTP especificado. Se você inserir uma chave de header específica, a regra limitará separadamente cada valor hotspot sob essa chave. Após selecionar Header, configure uma política de correspondência para valores de propriedade da requisição. Apenas os valores que corresponderem ao padrão serão incluídos nas estatísticas e na limitação. URL parameter: O sistema analisa a requisição com base no parâmetro de requisição HTTP especificado. Insira o nome do parâmetro. Após selecionar URL parameter, configure uma política de correspondência para valores de propriedade da requisição. Apenas os valores que corresponderem ao padrão serão incluídos nas estatísticas e na limitação.

Threshold Type

O valor padrão é Request count.

Threshold

O limiar de QPS do objeto na dimensão estatística da API limitada. Ao definir o limiar, selecione um intervalo estatístico. Os intervalos suportados são segundo, minuto, hora e dia. Por exemplo, se você definir o limiar como 10 e selecionar minute como intervalo, não mais que 10 requisições serão permitidas por minuto.

Whether to open

Ao ativar esta chave, a regra entra em vigor imediatamente após a criação. A chave vem desativada por padrão.

Throttling method

Clique em Show Advanced Options para configurar este parâmetro. Fast failure: Se o tipo de limiar for QPS, o tráfego limitado falha rapidamente, ou seja, as requisições são bloqueadas imediatamente ao atingir o limiar. Requisições rejeitadas recebem a resposta personalizada configurada no gerenciamento de comportamento. Se nenhuma resposta personalizada estiver configurada, aplica-se o comportamento padrão, que retorna o código de erro 429 e a mensagem de texto padrão. Waiting in line: Se o tipo de limiar for QPS, as requisições limitadas passam em uma taxa constante e podem ser enfileiradas. É necessário definir um período de timeout. Uma requisição cuja expectativa é atingir o período de timeout falha imediatamente em vez de ser enfileirada. Por exemplo, se o QPS for definido como 10, apenas uma requisição passa a cada 100 milissegundos e as excedentes são enfileiradas. O período de timeout é o tempo máximo de enfileiramento. Requisições que excederem esse tempo máximo são rejeitadas. Para o limite de QPS aplicável quando requisições são enfileiradas, consulte Limites.

Burst size

Clique em Show Advanced Options para configurar este parâmetro. Se o Throttling method estiver definido como Fast failure, defina um tamanho de rajada (burst size), que é o número de requisições extras permitidas para rajadas de tráfego.

Timeout

Clique em Show Advanced Options para configurar este parâmetro. Se o Throttling method estiver definido como Waiting in line, defina um período de timeout em milissegundos. Por exemplo, se o QPS for definido como 5, apenas uma requisição passa a cada 200 milissegundos e as excedentes são enfileiradas. O período de timeout é o tempo máximo de enfileiramento. Requisições que excederem esse tempo máximo são rejeitadas.

Parâmetro

Descrição

Valor de exemplo

Behavior Name

O nome do comportamento. O nome pode ter até 128 caracteres e deve ser único dentro da aplicação.

Test behavior

Resource Type

Selecione Web.

Web

**Web throttling handler Web Throttling Policy

Define como o sistema se comporta após o acesso a uma API web acionar uma regra. Resposta personalizada: Defina o código de status HTTP, o formato do conteúdo retornado e o conteúdo retornado. A API web retorna o conteúdo personalizado após o acesso acionar uma regra.

Custom response

HTTP Status Code

O valor padrão é 429. Este parâmetro é obrigatório quando o Web throttling handler está definido como Custom response.

429

Returned Content-Type

Defina o formato do conteúdo retornado como Plain text ou JSON.

JSON string

Returned HTTP Text

Insira o conteúdo retornado após o acesso à API web acionar uma regra. Este parâmetro é obrigatório quando o Web throttling handler está definido como Custom response.

{"message": "blocked oops"}

Parâmetro

Descrição

Valor de exemplo

Behavior Name

O nome do comportamento. O nome pode ter até 128 caracteres e deve ser único dentro da aplicação.

Test behavior

Resource Type

Selecione RPC. Para versões do Apache Dubbo que não suportam comportamentos personalizados, consulte Limites.

Rpc

RPC throttling handler

Define como o sistema se comporta após o acesso a uma API RPC acionar uma regra. Custom response: Retorna um resultado personalizado. Defina o código de status HTTP, o formato do conteúdo retornado e o conteúdo retornado. A API RPC retorna o conteúdo personalizado após o acesso acionar uma regra. Custom exception: Lança uma exceção personalizada. Defina o nome da classe de exceção e o texto da exceção. O sistema retorna as informações de exceção especificadas após o acesso à API RPC acionar uma regra.

Custom response/Custom exception

Custom response class name

Obrigatório quando o RPC throttling handler está definido como Custom response. Insira o caminho do nome da classe. Para tipos de objeto não suportados por resposta personalizada, consulte Limites.

com.alibaba.demo.OrderService:getOrder(long)

Custom response content (JSON)

Obrigatório quando o RPC throttling handler está definido como Custom response. Insira o conteúdo do objeto retornado quando o acesso à API RPC acionar uma regra.

{"id": "123", "name": "test"}

Exception class name

Obrigatório quando o RPC throttling handler está definido como Custom exception. Insira o caminho do nome da classe de exceção.

java.lang.RuntimeException

Exception message

Obrigatório quando o RPC throttling handler está definido como Custom exception. Insira o texto da exceção personalizada lançada após o acesso à API RPC acionar uma regra.

"Operation failed"