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. Esse comportamento reduz as requisições repetidas à origem e diminui a carga no servidor de origem.
Cenários
Normalmente, um POP do ESA armazena um recurso em cache apenas quando o servidor de origem retorna um código de status 2xx. Se o servidor de origem retornar um código diferente de 2xx, como 404 ou 502, configure um tempo de vida (TTL) de cache para esse código específico. 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 solicitação correspondentes. Para obter mais informações sobre configuração de regras, consulte Composição de expressões de regra.
Na seção Cache Eligibility, especifique se deve ignorar o cache. Para mais detalhes, consulte Elegibilidade de cache.
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. Suporta 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 de 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 falha no servidor de origem
Necessidade de negócio: O servidor de origem fica ocasionalmente indisponível 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 faz uma nova busca na origem para verificar se o servidor se recuperou.
Verifique a configuração
Após concluir a configuração, verifique se ela entrou em vigor usando um dos métodos a seguir.
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 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 solicitação.
Perguntas frequentes
Por que as solicitações ainda estão 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 de 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: Verifique 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?
Use 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 efetiva. Para obter detalhes, consulte Propriedades de recursos relacionados a regras.