Solução de problemas rápida

Use as informações a seguir para solucionar problemas e gerenciar o módulo Fastly CDN para o Magento 2 em seus ambientes de projeto do Adobe Commerce na infraestrutura em nuvem. Por exemplo, você pode investigar valores de cabeçalho de resposta e comportamento do armazenamento em cache para resolver problemas de serviço e desempenho do Fastly.

Em ambientes de produção e preparo profissionais, você pode usar os logs do New Relic para exibir e analisar os dados de log do Fastly CDN e do WAF para solucionar erros e problemas de desempenho.

Localizar ID de serviço do Fastly

Você precisa da ID de serviço do Fastly para configurar o Fastly no Admin ou para enviar solicitações da API do Fastly para obter configuração e solução de problemas avançadas do Fastly.

Se o Fastly estiver habilitado no ambiente do projeto, você poderá obter a ID do serviço do Administrador. Consulte Obter credenciais do Fastly.

Desenvolvedores e usuários avançados de VCL podem usar o VCL personalizado para recuperar a ID de serviço usando a variável Fastly req.service_id. Por exemplo, você pode adicionar o req.service_id à diretiva de log personalizada em seu VCL para capturar o valor da ID do serviço:

log {"syslog"} req.service_id {" my_logging_endpoint_name :: "}

Você pode usar o mesmo VCL para ambientes de produção e de preparo. Consulte Como configurar vcl_log.

Problemas de desempenho do site, limpeza e cache

Use a lista a seguir para identificar e solucionar problemas relacionados à configuração do serviço Fastly para seu ambiente do Adobe Commerce na infraestrutura em nuvem.

Erros 503 do Fastly

Se o Fastly retornar o erro de tempo limite 503, verifique os logs de erro e a página de erro 503 para identificar a causa raiz.

Se você receber um erro 503, verifique o log de erros do ambiente de Produção ou Preparo e o log de acesso php para solucionar o problema.

Para verificar os logs de erros:

Quando ocorre um erro 503, o Fastly retorna o motivo na página de erro e manutenção. Talvez não seja possível ver o motivo se você tiver adicionado o código para uma página de resposta personalizada. Para exibir o código de motivo na página de erro padrão, é possível remover o código de HTML da página de erro personalizada.

Para verificar a página de erro do Fastly 503:

Apex e subdomínios já associados a uma conta do Fastly

Se o domínio apex e os subdomínios do seu projeto do Adobe Commerce na infraestrutura em nuvem já estiverem associados a uma conta existente do Fastly com uma ID de Serviço atribuída, você não poderá iniciar o até atualizar a configuração do Fastly:

Verificar ou depurar os serviços do Fastly

Você pode solucionar problemas de desempenho ou de cache de um site do Adobe Commerce na infraestrutura em nuvem testando os URLs do site e examinando os valores do cabeçalho retornados na resposta.

Verifique o site ao vivo pelo Fastly

Use a API do Fastly para verificar os cabeçalhos de resposta Fastly-Magento-VCL-Uploaded e X-Cache retornados de seu site ativo.

As solicitações da API Fastly são transmitidas por meio da extensão Fastly para obter uma resposta dos servidores de origem. Se a resposta retornar cabeçalhos incorretos, teste os servidores de origem diretamente.

Para verificar os cabeçalhos de resposta:

Se os cabeçalhos não tiverem os valores corretos, consulte as seguintes informações:

Ignorar o cache do Fastly para verificar os sites do Adobe Commerce

Se o serviço Fastly retornar cabeçalhos incorretos, você poderá criar um trecho VCL que permitirá enviar solicitações que ignoram o cache do Fastly. Consulte Ignorar cache do Fastly.

Depois de adicionar o trecho VCL, use comandos cURL para enviar solicitações ao servidor de origem a partir do endereço IP especificado. Em seguida, verifique se há erros nas respostas.

Verificar cabeçalhos de resposta MISS e HIT do cache

Verifique se a resposta retornada contém as seguintes informações:

O seguinte trecho da saída do comando cURL mostra os valores corretos para os cabeçalhos Pragma, X-Magento-Tags e Fastly-Module-Enabled:

* STATE: INIT => CONNECT handle 0x600057800; line 1402 (connection #-5000)
* Rebuilt URL to: https://www.mymagento.biz.c.sv7gVom4qrpek.ent.magento.cloud/
* Added connection 0. The cache now contains 1 members
* Trying 192.0.2.31...
* STATE: CONNECT => WAITCONNECT handle 0x600057800; line 1455 (connection #0)

% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0* Connected to www.mymagento.biz.c.sv7gVom4qrpek.ent.magento.cloud (54.229.163.31) port 443 (#0)

* STATE: WAITCONNECT => SENDPROTOCONNECT handle 0x600057800; line 1562 (connection #0)
  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0* ALPN, offering h2

... portion omitted for brevity ...

< Set-Cookie: mage-messages=%5B%5D; expires=Wed, 22-Nov-2017 17:39:58 GMT; Max-Age=31536000; path=/
< Pragma: cache
< Expires: Wed, 23 Nov 2016 17:39:56 GMT
< Cache-Control: max-age=86400, public, s-maxage=86400, stale-if-error=5, stale-while-revalidate=5
< X-Magento-Tags: cb_welcome_popup store cb cb_store_info_mobile cb_header_promotional_bar cb_store_info cb_discount-promo-bar cpg_2 cb_83 cb_81 cb_84 cb_85 cb_86 cb_87 cb_88 cb_89 p5646 catalog_product p5915 p6040 p6197 p6227 p7095 p6109 p6122 p6331 p7592 p7651 p7690
< Fastly-Module-Enabled: yes
< Strict-Transport-Security: max-age=31536000
    < Content-Security-Policy: upgrade-insecure-requests
    < X-Content-Type-Options: nosniff
    < X-XSS-Protection: 1; mode=block
    < X-Frame-Options: SAMEORIGIN
    < X-Platform-Server: i-dff64b52
    <
    * STATE: PERFORM => DONE handle 0x600057800; line 1955 (connection #0)
    * multi_done
      0     0    0     0    0     0      0      0 --:--:--  0:00:02 --:--:--     0
    * Connection #0 to host www.mymagento.biz.c.sv7gVom4qrpek.ent.magento.cloud left intact

Resolver erros encontrados em cabeçalhos de resposta

Esta seção fornece sugestões para resolver erros retornados ao verificar cabeçalhos de resposta usando a API do Fastly.

O módulo Fastly não está habilitado

Se o módulo Fastly não estiver habilitado (Fastly-Module-Enabled: no) ou se o cabeçalho estiver ausente, use SSH para fazer logon no projeto. Em seguida, execute o seguinte comando para verificar o status do módulo.

php bin/magento module:status Fastly_Cdn

Com base no status retornado, use as instruções a seguir para atualizar a configuração do Fastly.

O Fastly VCL não foi carregado

Se o VCL do Fastly não tiver sido carregado (Fastly-Magento-VCL-Uploaded: false), use a opção Carregar VCL no Administrador para carregá-lo. Consulte Carregar fragmentos de VCL do Fastly.

O X-Cache contém apenas MISS, sem HIT

Se o cabeçalho X-Cache contiver HIT (HIT, HIT ou HIT, MISS), isso indicará que o Fastly retorna o conteúdo em cache com êxito.

Se o cabeçalho X-Cache for MISS, MISS e não contiver HIT, execute o comando curl novamente para verificar se a página não foi removida recentemente do cache.

Se você obtiver o mesmo resultado, use os curl comandos e verifique os cabeçalhos de resposta:

Se o problema persistir, outra extensão provavelmente redefinirá esses cabeçalhos. Repita o procedimento a seguir no ambiente de preparo, desativando todas as extensões e reativando cada uma para determinar qual extensão está redefinindo os cabeçalhos. Depois de identificar a extensão que está causando o problema, você deve desabilitá-la no ambiente de Produção.

Para identificar uma extensão que redefine cabeçalhos de resposta:

Depois de identificar a extensão que está redefinindo os cabeçalhos do Fastly, entre em contato com o desenvolvedor da extensão para obter assistência adicional. Não podemos fornecer correções ou atualizações para fazer com que extensões de terceiros funcionem com o armazenamento em cache do Fastly.

Reverter configuração do Fastly

Se as atualizações de trecho de VCL personalizado ou outras alterações de configuração do Fastly fizerem com que um site de infraestrutura na nuvem do Adobe Commerce interrompa ou retorne erros, use o comando Fastly API ativate para reverter para uma versão anterior do VCL. Não é possível reverter a versão do VCL a partir do Administrador.

Para reverter a versão do VCL:

Para obter detalhes sobre como usar a API do Fastly para revisar e gerenciar o VCL, consulte Gerenciar VCL usando a API.