Como ajustar as configurações de cache

Aprimore a eficiência da sua application com um gerenciamento estratégico de cache, com valores de TTL personalizados, métodos de segmentação de objetos e otimização de arquivos grandes.

Ver como Markdown

Utilize as capacidades do Cache para configurar as políticas de cache da sua 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 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 > Applications.
  2. Clique na 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.

O TTL é determinado pela diretiva max-age em Cache-Control. Se Cache-Control não estiver presente na requisição ou resposta, o timestamp enviado no cabeçalho Expires determina o TTL do cache.

  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 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 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.

Os valores máximo e padrão de TTL para o edge devem estar entre 60 e 31536000 segundos (1 ano). Se você tiver o módulo Application Accelerator ativado, você pode definir este valor para um mínimo de 0. Além disso, se você tiver o módulo Cache ativado e desejar manter o cache na camada de Cache, você deve definir o TTL para pelo menos 3 segundos.

Um TTL zero não é o mesmo que um cache bypass. Para mais detalhes, leia sobre a diferença entre essas configurações na documentação behavior Bypass Cache.

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 Cache já está selecionada por padrão. Se você tiver o módulo Cache ativado, você também pode habilitar este recurso para a camada de Cache.

O tamanho padrão dos fragmentos é de 1024 kB.

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.

Use a opção Content varies by query string, except for some fields (Blocklist) para fazer o inverso: manter todas as requisições com query strings como cache keys diferentes; as especificadas em Query string fields serão agrupadas em uma única cache key.

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.

Use a opção Content varies by cookies, with the exception of a few (Blocklist) para fazer o inverso: manter todas as requisições com cookies como cache keys diferentes; as especificadas em Cookie names serão agrupadas em uma única cache key.

  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 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}.

A variável ${uri} pode já estar selecionada por padrão se você não ativou o módulo Application Accelerator.

  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.