Quando um servidor de origem retorna um código de status diferente de 2xx, os pontos de presença (POPs) do Edge Security Acceleration (ESA) podem armazenar esse código em cache e responder diretamente às solicitações subsequentes durante o período de validade. Essa prática reduz as requisições repetidas à origem e diminui a carga no servidor de origem.
Cenários
Por padrão, um POP do ESA armazena um recurso em cache apenas quando o servidor de origem retorna um código de status 2xx. Caso a origem retorne um código diferente de 2xx, como 404 ou 502, configure um tempo de vida (TTL) de cache específico para esse status. Assim, o POP do ESA responde diretamente, sem encaminhar todas as solicitações à origem.
Cenário típico
O Arquivo A foi excluído do servidor de origem, mas os clientes continuam tentando acessá-lo. Como o POP do ESA não tem o Arquivo A em cache, todas as solicitações são enviadas ao servidor de origem, que responde com o código de status 404. Isso aumenta significativamente a carga no servidor de origem.
Ao configurar o POP do ESA para armazenar o código de status 404 em cache, o POP o salva após a primeira busca na origem. As solicitações seguintes recebem uma resposta 404 diretamente do POP do ESA até que o cache expire, evitando buscas desnecessárias na origem.
Procedimento
No console do ESA, selecione Site Management. Na coluna Website, clique em o site desejado.
No painel de navegação à esquerda, escolha .
Clique em Create Rule e insira um Rule Name.
Na área If requests match..., defina os atributos de correspondência da solicitação. Para obter mais informações sobre a configuração de regras, consulte Composition of rule expressions.
Na seção Cache Eligibility, especifique se o cache deve ser ignorado. Para mais detalhes, consulte Cache eligibility.
Na área Edge Status Code Cache TTL, clique em Configure.
-
Na seção Status Code Cache Rule, clique em Add. Configure os parâmetros abaixo e clique em OK:
Status Code: Código de status HTTP a ser armazenado em cache. Compatível com códigos 4xx (erro do cliente) e 5xx (erro do servidor), como 404, 502 e 503.
Expired At: Período durante o qual o POP mantém o código de status em cache. O valor pode variar de 1 segundo a 31.536.000 segundos (1 ano). Após a expiração do TTL, o POP busca o código de status no servidor de origem novamente.
Exemplos de configuração
Cenário 1: Armazenar erros 404 em cache para recursos estáticos
Necessidade do negócio: Imagens na pasta de imagens do site podem ter sido excluídas, mas a página frontend ainda referencia os caminhos antigos.
Configuração:
Condição de correspondência: Caminho da URL contém
/imagesCódigo de status: 404
TTL de cache: 600 segundos (10 minutos)
Resultado: Na primeira solicitação de uma imagem inexistente, o POP obtém uma resposta 404 da origem e a armazena em cache por 10 minutos. Durante esse período, as solicitações subsequentes para a mesma imagem recebem uma resposta 404 diretamente do POP, sem nova busca na origem.
Cenário 2: Cache de curto prazo para falhas no servidor de origem
Necessidade do negócio: O servidor de origem fica indisponível ocasionalmente e retorna erros 5xx. O objetivo é reduzir o impacto nos usuários finais durante a interrupção.
Configuração:
Condição de correspondência: All Requests
Código de status: 5xx
TTL de cache: 60 segundos (1 minuto)
Resultado: Quando o servidor de origem falha, o POP armazena o código de status 5xx em cache por 1 minuto, impedindo que um pico de solicitações aumente ainda mais a carga na origem. Após 1 minuto, o POP consulta a origem novamente para verificar se o servidor se recuperou.
Verifique a configuração
Após concluir a configuração, valide se ela entrou em vigor utilizando um dos métodos abaixo.
Método 1: Usar o comando curl
-
Limpe o cache local e envie a primeira solicitação:
curl -I https://example.com/non-existent-pageO cabeçalho de resposta deve conter
x-site-cache-status: MISS. Isso indica a primeira busca na origem. -
Solicite imediatamente a mesma
URLnovamente:curl -I https://example.com/non-existent-pageO cabeçalho de resposta deve conter
x-site-cache-status: HIT, o que indica um acerto de cache. O valor de idade do cache também deve incrementar a cada solicitação subsequente.
Método 2: Usar ferramentas de desenvolvedor do navegador
Abra o Chrome DevTools (pressione F12), mude para a aba Network e marque a opção Preserve log.
Acesse um recurso inexistente, como
https://example.com/test404.Visualize os
Response Headersnos detalhes da solicitação. A primeira solicitação mostrax-site-cache-status: MISS. As solicitações subsequentes mostramx-site-cache-status: HIT, e o valor de idade do cache incrementa a cada requisição.
Perguntas frequentes
Por que as solicitações continuam sendo enviadas ao servidor de origem após a configuração?
O cache expirou: Verifique se o valor de
TTLconfigurado está muito curto. Examine cabeçalhos de resposta comoCache-Controlpara confirmar o TTL do cache.Parâmetros de URL diferentes: Por padrão, diferentes parâmetros de
URLsão tratados como chaves de cache distintas. Configure regras de chave de cache para ignorar parâmetros irrelevantes.A regra não entrou em vigor: Valide as condições de correspondência da regra, como o padrão de caminho, para garantir que cubram a solicitação alvo.
Como verifico o status de cache de uma URL específica?
Utilize o comando curl para visualizar os cabeçalhos de resposta detalhados:
curl -v -I https://example.com/target-urlPrincipais cabeçalhos de resposta:
x-site-cache-status: HIT— Acerto de cachex-site-cache-status: MISS— Falha de cache, busca na origem realizadaCache-Control:max-age=120— O cache está ativo há 120 segundos
Como limpo manualmente o cache para um código de status específico?
Documentação relacionada
Os recursos relacionados a regras variam em prioridade efetiva, reentrância e granularidade de aplicação. Para mais detalhes, consulte Characteristics of rule-based features.