Solución de problemas rápida

Utilice la siguiente información para solucionar los problemas y administrar el módulo CDN de Fastly para Magento 2 en los entornos de proyecto de Adobe Commerce en la nube. Por ejemplo, puede investigar los valores de encabezado de respuesta y el comportamiento de almacenamiento en caché para resolver los problemas de rendimiento y servicio de Fastly.

En entornos de ensayo y producción profesional, puede usar registros de New Relic para ver y analizar los datos de registro de Fastly CDN y WAF para solucionar errores y problemas de rendimiento.

Localizar ID de servicio de Fastly

Necesita el ID del servicio de Fastly para configurar Fastly desde el administrador o para enviar solicitudes de API de Fastly para una configuración avanzada de Fastly y la resolución de problemas.

Si Fastly está habilitado en el entorno del proyecto, puede obtener el ID de servicio del administrador. Ver Obtener credenciales de Fastly.

Los desarrolladores y los usuarios avanzados de VCL pueden utilizar VCL personalizado para recuperar el ID del servicio mediante la variable de Fastly req.service_id. Por ejemplo, puede agregar req.service_id a la directiva de registro personalizada en su VCL para capturar el valor del ID de servicio:

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

Puede utilizar el mismo VCL para los entornos Producción y Ensayo. Consulte Cómo configurar vcl_log.

Problemas de rendimiento del sitio, depuración y caché

Utilice la siguiente lista para identificar y solucionar los problemas relacionados con la configuración del servicio Fastly para su entorno de infraestructura en la nube de Adobe Commerce.

503 errores de Fastly

Si Fastly devuelve errores de tiempo de espera 503, compruebe los registros de errores y la página de error 503 para identificar la causa raíz.

Si recibe un error 503, compruebe el registro de errores del entorno de producción o ensayo y el registro de acceso a php para solucionar el problema.

Para comprobar los registros de errores:

Cuando se produce un error 503, Fastly devuelve el motivo en la página de error y mantenimiento. Es posible que no pueda ver el motivo si agregó código para una página de respuesta personalizada. Para ver el código de motivo en la página de error predeterminada, puede quitar el código de HTML de la página de error personalizada.

Para comprobar la página de error de Fastly 503:

Apex y subdominios ya asociados a una cuenta de Fastly

Si el dominio Apex y los subdominios del proyecto de infraestructura de Adobe Commerce en la nube ya están asociados con una cuenta existente de Fastly con un ID de servicio asignado, no puede iniciar hasta que actualice la configuración de Fastly:

Verificar o depurar los servicios de Fastly

Puede solucionar problemas de rendimiento o almacenamiento en caché para un Adobe Commerce en un sitio de infraestructura en la nube probando las direcciones URL del sitio y examinando los valores de encabezado devueltos en la respuesta.

Compruebe el sitio en directo mediante Fastly

Utilice la API de Fastly para comprobar los encabezados de respuesta Fastly-Magento-VCL-Uploaded y X-Cache devueltos desde el sitio activo.

Las solicitudes de API de Fastly se pasan a través de la extensión de Fastly para obtener una respuesta de los servidores de origen. Si la respuesta devuelve encabezados incorrectos, pruebe los servidores de origen directamente.

Para comprobar los encabezados de respuesta:

Si los encabezados no tienen los valores correctos, consulte la siguiente información:

Omitir la caché de Fastly para comprobar los sitios de Adobe Commerce

Si el servicio Fastly devuelve encabezados incorrectos, puede crear un fragmento de VCL que le permita enviar solicitudes que omitan la caché de Fastly. Ver Omitir caché de Fastly.

Después de agregar el fragmento de VCL, utilice los comandos cURL para enviar solicitudes al servidor de origen desde la dirección IP especificada. A continuación, compruebe si hay errores en las respuestas.

Comprobar encabezados de respuesta HIT y MISS de caché

Compruebe que la respuesta devuelta contiene la siguiente información:

El siguiente extracto del resultado del comando cURL muestra los valores correctos para los encabezados Pragma, X-Magento-Tags y 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 errores encontrados en los encabezados de respuesta

Esta sección proporciona sugerencias para resolver los errores devueltos al comprobar los encabezados de respuesta mediante la API de Fastly.

El módulo de Fastly no está habilitado

Si el módulo de Fastly no está habilitado (Fastly-Module-Enabled: no) o si falta el encabezado, use SSH para iniciar sesión en el proyecto. A continuación, ejecute el siguiente comando para comprobar el estado del módulo.

php bin/magento module:status Fastly_Cdn

En función del estado devuelto, utilice las siguientes instrucciones para actualizar la configuración de Fastly.

Fastly VCL no se ha cargado

Si no se ha cargado el VCL de Fastly (Fastly-Magento-VCL-Uploaded: false), use la opción Cargar VCL en el administrador para cargarlo. Ver Cargar fragmentos de VCL rápidamente.

X-Cache contiene solamente MISS, no HIT

Si el encabezado X-Cache contiene HIT (HIT, HIT o HIT, MISS), indica que Fastly devuelve el contenido almacenado en caché correctamente.

Si el encabezado X-Cache es MISS, MISS y no contiene HIT, ejecute de nuevo el comando curl para asegurarse de que la página no se haya purgado recientemente de la caché.

Si obtiene el mismo resultado, use los curl comandos y compruebe los encabezados de respuesta:

Si el problema persiste, es probable que otra extensión restablezca estos encabezados. Repita el siguiente procedimiento en el entorno de ensayo desactivando todas las extensiones y volviendo a activar cada una para determinar qué extensión está restableciendo los encabezados. Después de identificar la extensión que causa el problema, debe deshabilitarla en el entorno de producción.

Para identificar una extensión que restablece los encabezados de respuesta:

Después de identificar la extensión que está restableciendo los encabezados de Fastly, póngase en contacto con el desarrollador de la extensión para obtener ayuda adicional. No podemos proporcionar correcciones o actualizaciones para que las extensiones de terceros funcionen con el almacenamiento en caché de Fastly.

Deshacer configuración de Fastly

Si las actualizaciones de fragmentos de VCL personalizadas u otros cambios de configuración de Fastly provocan que un Adobe Commerce en el sitio de infraestructura de la nube rompa o devuelva errores, use el comando activate de la API de Fastly para revertir a una versión de VCL anterior. No se puede revertir la versión de VCL desde el administrador.

Para revertir la versión de VCL:

Para obtener más información acerca del uso de la API de Fastly para revisar y administrar VCL, consulte Administrar VCL mediante la API.