Fastly 문제 해결

다음 정보를 사용하여 클라우드 인프라 프로젝트 환경의 Adobe Commerce에서 Magento 2에 대한 Fastly CDN 모듈의 문제를 해결하고 관리하십시오. 예를 들어 응답 헤더 값과 캐싱 동작을 조사하여 Fastly 서비스 및 성능 문제를 해결할 수 있습니다.

Pro 프로덕션 및 스테이징 환경에서 New Relic 로그를 사용하여 Fastly CDN 및 WAF 로그 데이터를 보고 분석하여 오류 및 성능 문제를 해결할 수 있습니다.

Fastly 서비스 ID 찾기

관리자에서 Fastly를 구성하거나 고급 Fastly 구성 및 문제 해결을 위해 Fastly API 요청을 제출하려면 Fastly 서비스 ID가 필요합니다.

프로젝트 환경에서 Fastly가 활성화된 경우 관리자로부터 서비스 ID를 가져올 수 있습니다. Fastly 자격 증명 가져오기를 참조하십시오.

개발자와 고급 VCL 사용자는 사용자 지정 VCL을 사용하여 Fastly 변수 req.service_id을(를) 사용하여 서비스 ID를 검색할 수 있습니다. 예를 들어 VCL의 사용자 지정 logging 지시문에 req.service_id을(를) 추가하여 서비스 ID 값을 캡처할 수 있습니다.

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

프로덕션 및 스테이징 환경에 동일한 VCL을 사용할 수 있습니다. vcl_log를 구성하는 방법을 참조하세요.

사이트 성능, 제거 및 캐시 문제

다음 목록을 사용하여 클라우드 인프라 환경의 Adobe Commerce에 대한 Fastly 서비스 구성과 관련된 문제를 식별하고 해결하십시오.

Fastly에서 503 오류 발생

Fastly가 503 시간 초과 오류를 반환하는 경우 오류 로그와 503 오류 페이지를 확인하여 근본 원인을 파악하십시오.

503 오류가 발생하면 프로덕션 또는 스테이징 환경 오류 로그와 php 액세스 로그를 확인하여 문제를 해결하십시오.

오류 로그를 확인하려면:

503 오류가 발생하면 Fastly는 오류 및 유지 관리 페이지에서 이유를 반환합니다. 사용자 지정 응답 페이지에 대한 코드를 추가한 경우 이유를 확인하지 못할 수 있습니다. 기본 오류 페이지에서 원인 코드를 보려면 사용자 지정 오류 페이지의 HTML 코드를 제거할 수 있습니다.

Fastly 503 오류 페이지를 확인하려면:

Fastly 계정과 이미 연결된 Apex 및 하위 도메인

클라우드 인프라 프로젝트의 Adobe Commerce에 대한 Apex 도메인 및 하위 도메인이 할당된 서비스 ID를 가진 기존 Fastly 계정과 이미 연결되어 있는 경우 Fastly 구성을 업데이트할 때까지 를 시작할 수 없습니다.

Fastly 서비스 확인 또는 디버그

사이트 URL을 테스트하고 응답에서 반환된 헤더 값을 검사하여 클라우드 인프라 사이트의 Adobe Commerce에 대한 성능 또는 캐싱 문제를 해결할 수 있습니다.

Fastly를 통해 라이브 사이트 확인

Fastly API를 사용하여 라이브 사이트에서 반환된 Fastly-Magento-VCL-Uploaded 및 X-Cache 응답 헤더를 확인합니다.

Fastly API 요청은 Fastly 확장을 통해 전달되어 원본 서버에서 응답을 가져옵니다. 응답이 잘못된 헤더를 반환하는 경우 원본 서버를 직접 테스트하십시오.

응답 헤더를 확인하려면:

헤더에 올바른 값이 없으면 다음 정보를 참조하십시오.

Adobe Commerce 사이트를 확인하기 위해 Fastly 캐시 우회

Fastly 서비스가 잘못된 헤더를 반환하는 경우 Fastly 캐시를 우회하는 요청을 제출할 수 있도록 해 주는 VCL 코드 조각을 만들 수 있습니다. Fastly 캐시 우회를 참조하십시오.

VCL 코드 조각을 추가한 후 cURL 명령을 사용하여 지정된 IP 주소에서 원천 서버에 요청을 제출합니다. 그런 다음 응답에 오류가 있는지 확인합니다.

캐시 적중 및 실패 응답 헤더 확인

반환된 응답에 다음 정보가 포함되어 있는지 확인합니다.

cURL 명령 출력에서 발췌한 다음 내용은 Pragma, X-Magento-Tags 및 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

응답 헤더에서 발견된 오류 해결

이 섹션에서는 Fastly API를 사용하여 응답 헤더를 확인할 때 반환되는 오류를 해결하기 위한 제안 사항을 제공합니다.

Fastly 모듈이 활성화되지 않음

Fastly 모듈이 활성화되어 있지 않거나(Fastly-Module-Enabled: no) 헤더가 누락된 경우 SSH를 사용하여 프로젝트에 로그인합니다. 그런 다음 다음 다음 명령을 실행하여 모듈 상태를 확인합니다.

php bin/magento module:status Fastly_Cdn

반환된 상태에 따라 다음 지침에 따라 Fastly 구성을 업데이트합니다.

Fastly VCL이 업로드되지 않았습니다.

Fastly VCL이 업로드되지 않은 경우(Fastly-Magento-VCL-Uploaded: false), 관리자의 VCL 업로드 옵션을 사용하여 업로드하십시오. 가장 빠른 VCL 조각 업로드를 참조하십시오.

X-Cache에 MISS만 포함되고, 히트는 없습니다.

X-Cache 헤더에 HIT(HIT, HIT 또는 HIT, MISS)이 포함된 경우 Fastly가 캐시된 콘텐츠를 성공적으로 반환함을 나타냅니다.

X-Cache 헤더가 MISS, MISS이고 HIT을(를) 포함하지 않는 경우 curl 명령을 다시 실행하여 최근에 캐시에서 페이지가 삭제되지 않았는지 확인하십시오.

동일한 결과를 얻으면 curl 명령을 사용하고 응답 헤더를 확인하십시오.

문제가 지속되면 다른 확장이 이러한 헤더를 재설정할 수 있습니다. 모든 확장을 비활성화한 후 다시 활성화하여 스테이징 환경에서 다음 절차를 반복하여 헤더를 재설정하는 확장을 확인합니다. 문제를 일으키는 확장을 식별한 후 프로덕션 환경에서 비활성화해야 합니다.

응답 헤더를 재설정하는 확장을 식별하려면:

Fastly 헤더를 재설정하는 확장을 식별한 후 추가 지원이 필요하면 확장 개발자에게 문의하십시오. 타사 확장이 Fastly 캐싱에서 작동하도록 하는 수정 사항 또는 업데이트를 제공할 수 없습니다.

Fastly 구성 롤백

사용자 지정 VCL 코드 조각 업데이트 또는 기타 Fastly 구성 변경으로 인해 클라우드 인프라 사이트의 Adobe Commerce이 오류를 중단하거나 반환하는 경우 Fastly API activate 명령을 사용하여 이전 VCL 버전으로 롤백합니다. 관리에서 VCL 버전을 롤백할 수 없습니다.

VCL 버전을 롤백하려면:

Fastly API를 사용하여 VCL을 검토하고 관리하는 방법에 대한 자세한 내용은 API를 사용하여 VCL 관리를 참조하십시오.