ContatoSign in

Como ajustar as configurações de cache

Utilize as capacidades do Edge Cache para configurar as políticas de cache da sua edge application, incluindo valores de expiração no edge ou no navegador, otimização de arquivos grandes para dividir conteúdos em partes menores e segmentação de cache key com base em métodos HTTP, query strings, cookies ou grupos de dispositivos.

Quando você cria uma edge application pela primeira vez, uma variável de configuração de cache será criada e ativada por padrão. Este guia mostrará como criar e ativar uma nova instância de configuração de cache.

  1. Acesse o Azion Console > Edge Application.
  2. Clique na edge application que você deseja configurar.
  3. Ative o módulo Application Accelerator para desbloquear configurações avançadas de cache key.
  4. Clique no botão Save.
  5. Navegue até a aba Cache Settings.
  6. Clique no botão + Cache Setting.
  7. Dê um nome para sua configuração de cache.

Cache Expiration Policies

Você pode personalizar o Time To Live (TTL) do cache nos navegadores e no edge. Esses dados são enviados em requisições e respostas através dos cabeçalhos HTTP Cache-Control e Expires.

  1. Em Browser Cache, selecione Override cache settings para determinar um valor de TTL personalizado.
  2. Adicione o TTL em segundos no campo Max Age (seconds). Por exemplo: 432000 = 5 dias.

Em Edge Cache, você pode determinar se o edge deve obedecer aos valores enviados nos cabeçalhos Cache-Control e Expires.

Você pode optar por manter Honor cache policies selecionado para respeitar os valores TTL enviados nos cabeçalhos pela origem ou pela própria aplicação.

Se a sua aplicação não estiver enviando cabeçalhos Cache-Control e Expires ou se os valores não estiverem configurados corretamente, você pode determinar um TTL máximo padrão para o cache ser mantido no edge no campo Max Age (seconds). Se a sua aplicação estiver enviando esses valores, para substituí-los:

  1. Em Edge Cache, selecione Override cache settings para determinar um valor de TTL personalizado.
  2. Adicione o TTL em segundos no campo Max Age (seconds). Por exemplo: 864000 = 10 dias.

Stale cache

A Azion oferece a capacidade de servir conteúdo obsoleto do cache quando o servidor de origem estiver inativo ou enquanto o cache estiver sendo renovado. A funcionalidade Stale Cache está habilitada por padrão, permitindo que sua aplicação continue servindo o conteúdo em um cache mais recente durante esses eventos.

Otimização de arquivos grandes

Em vez de baixar um arquivo de conteúdo grande e correr o risco de timeouts ou terminações de conexão, os arquivos podem ser divididos em partes menores e armazenados em cache sob demanda.

  1. Em Large file optimization, habilite o switch para ativar.
  2. A camada Edge Cache já está selecionada por padrão. Se você tiver o módulo Tiered Cache ativado, você também pode habilitar este recurso para a camada de tiered cache.

Application Accelerator

Esta seção permite que você personalize como o cache varia com base em métodos HTTP, campos de query string, cookies e grupos de dispositivos por meio de cache keys. Você pode escolher segmentar as cache keys usando esses atributos para controlar como os objetos são armazenados e servidos a partir do cache.

Para determinar a variação de conteúdo no cache:

  1. Em Cache vary by Query String, selecione Content varies by some query string fields (Allowlist).
  2. Em Query string fields, adicione o valor cidade.
  • Este campo diferencia letras maiúsculas de minúsculas e as trata de forma distinta ao armazenar objetos no cache.

Quando uma requisição é feita para uma URL de aplicação xxxxxxxxxx.map.azionedge.net/pagina?city=12345, a cache key para essa URL será diferente das cache keys feitas para xxxxxxxxxx.map.azionedge.net/pagina e quaisquer outras query strings adicionadas à URL.

Para desconsiderar a ordem dos dados enviados na query string e manter objetos com os mesmos valores de query string como uma única cache key:

  1. Ative Query String Sort.

Você também pode personalizar quais tipos de requisições podem ser armazenadas em cache:

  1. Ative Enable caching for POST para armazenar requisições POST em cache.

  2. Ative Enable caching for OPTIONS para armazenar requisições OPTIONS em cache.

  3. Em Cache vary by Cookies, selecione Content varies by some cookies (Allowlist).

  4. Em Cookie Names, adicione o valor nome_do_cookie.

  • Este campo diferencia letras maiúsculas de minúsculas e as trata de forma distinta ao armazenar objetos no cache.

Quando uma requisição é feita a uma aplicação e a resposta da origem envia um cabeçalho Set-Cookie, os objetos no cabeçalho de requisição Cookie que contêm o nome nome_do_cookie, independentemente do valor, serão considerados como um objeto diferente no cache de outras requisições.

  1. Em Cache vary by Devices, selecione Content varies by some device groups (Allowlist).
  2. Clique no botão + Add Device Group para adicionar um device group e selecione‑o da lista.
  3. Repita o passo anterior para cada device group para o qual você deseja especificar uma cache key diferente.

Depois de terminar de configurar a sua cache setting:

  1. Clique no botão Save.

Activating your cache setting

A página de configurações de cache agora lista a nova instância criada. No entanto, essa nova configuração de cache não está ativa em sua aplicação. Você precisa definir o que acionará a implementação das políticas de cache em sua aplicação. Para isso, você pode usar o Rules Engine de sua edge application.

As instruções abaixo ajudarão você a criar uma regra na qual qualquer requisição de seus usuários para xxxxxxxxxx.map.azionedge.net/cache aplicará a configuração de cache que você criou.

  1. Navegue até a aba Rules Engine.
  2. Clique no botão + Rule.
  3. Dê um nome para sua regra.
  4. Selecione Request Phase.
  5. Na seção Criteria, selecione a variável ${uri}.
  1. Como operador de comparação, selecione is equal.
  2. Como argumento, adicione /cache.
  3. Na seção Behaviors, selecione Set Cache Policy na lista de comportamentos.
  4. Selecione a nova cache setting que você criou.
  5. Clique no botão Save.
  6. Aguarde alguns minutos para que as alterações se propaguem.

Para analisar como seu conteúdo está sendo armazenado em cache, você pode verificar os indicadores de cache da aplicação usando o Modheader para Google Chrome.