전환 API 게이트웨이 - 오류 및 경고 해결
서버 이벤트가 누락되었거나 서버 이벤트 수가 브라우저 이벤트보다 적은 것을 발견한 경우, 이 문서를 사용하여 문제를 해결하세요. 문제 해결 도구에 대한 자세한 내용은 전환 API 게이트웨이 - 문제 해결 도구를 참조하세요.
다음의 문제 해결 단계에 따라 문제를 식별하세요.
- 이벤트 관리자로 이동
- 이 도메인이 이벤트를 전송하도록 구성되었는지 확인합니다.
- 브라우저에서 웹사이트 열기
- DNS가 올바르게 구성되었는지 확인합니다.
- 전환 API 게이트웨이 관리자 UI
- 전환 API 게이트웨이가 최신 버전인지 확인합니다.
도메인이 이벤트를 전송하도록 구성되지 않음
전환 API 게이트웨이는 통합 설정 중에 구성하는 연결된 도메인에서 이벤트를 수신합니다. 서버 이벤트 수가 브라우저 이벤트보다 적게 나타나는 경우, 이 픽셀이 Meta에 아직 연결되지 않은 도메인에서 실행되고 있기 때문일 수 있습니다.
진단
- 이벤트 관리자에 로그인합니다.
- 적절한 이벤트를 선택합니다.
- 상세 정보 보기를 클릭하고 이벤트 개요를 선택합니다.
- 왼쪽의 드롭다운 메뉴에서 도메인을 선택하여 브라우저 이벤트가 실행되는 도메인을 찾습니다.
- 이러한 도메인이 누락되었거나 구성된 도메인과 다를 경우, 브라우저 이벤트가 캡처되지 않습니다.
해결 방법
- 이 가이드에 따라 전환 API 게이트웨이 연결에 필요한 도메인을 추가합니다.
DNS가 구성되지 않았거나 DNS 매핑이 잘못됨
전환 API 게이트웨이는 AWS에서 호스팅되며, 생성 시 IP 주소가 할당됩니다. 전환 API 게이트웨이 엔드포인트가 자체 요청 호출을 통해 브라우저에서 연결될 수 있도록 도메인의 하위 도메인을 이 IP 주소에 매핑해야 합니다.
진단
- 온라인 DNS 검사 도구(예:
https://dnschecker.org/)를 사용하여 전환 API 게이트웨이 도메인이 적절한 IP 주소로 해석되고 완전히 전파되는지 확인합니다. 도메인이 IP 주소로 해석되지 않는 경우, 해결 방법 섹션에서 다음 단계를 참조하세요. - AWS EC2 대시보드에서 전환 API 게이트웨이 서버 IP 주소를 가져오거나 클라우드 인프라 담당자에게 해당 정보를 요청하세요.
- 두 IP 주소가 다를 경우, 해결 방법 섹션에서 다음 단계를 참조하세요.
해결 방법
- 도메인 등록 기관과 관련하여 관리자와 협력합니다.
- 도메인 등록 기관에서 전환 API 게이트웨이 서버의 IP 주소(AWS EC2 대시보드에 표시된 것)로 DNS 레코드를 업데이트합니다.
- 전환 API 게이트웨이 하위 도메인을 설정 중에 생성된 서버 IP 주소로 매핑하는 DNS A 레코드를 설정합니다.
인증서가 발급되지 않음
DNS가 올바르게 구성된 후에도 전환 API 게이트웨이가 Let’s Encrypt에서 인증서를 발급하지 않은 경우, 해당 도메인이 인기가 너무 많아서 Let’s Encrypt에서 인증서 발급을 거부했다는 것을 의미합니다.
해결 방법
- 전환 API 게이트웨이 인스턴스 앞에 AWS Load Balancer(ALB)를 넣고 ALB를 사용하여 자신이 소유한 인증서를 호스팅해 봅니다.
인증서가 발급되었으나 만료됨
전환 API 게이트웨이가 성공적으로 설치된 후 포트 80을 닫았거나 오래된 버전에서 실행 중인 경우 이 문제가 발생할 수 있습니다.
해결 방법
- 포트 80을 열고 전환 API 게이트웨이를 최신 버전으로 업그레이드합니다.
게이트웨이 UI에 액세스할 수 없음
전환 API 게이트웨이가 성공적으로 설치된 후 포트 80을 닫았거나 오래된 버전에서 실행 중인 경우 이 문제가 발생할 수 있습니다.
해결 방법
- 전환 API 게이트웨이 인스턴스의 IP 주소가 DNS 구성과 일치하는지 확인합니다. 그렇지 않을 경우 DNS가 구성되지 않았거나 DNS 매핑이 잘못됨을 참조하세요.
- 서버에서 응답이 없으면 일시적인 네트워크 오류 때문일 수 있으며, 인스턴스를 다시 시작하면 해결될 수도 있습니다. 전환 API 게이트웨이가 시작되기까지 몇 분이 걸릴 수 있으므로 10분간 정도 기다렸다가 다시 로그인하세요.
게이트웨이의 버전을 업그레이드해야 함
v1.0.8 이전 버전의 전환 API 게이트웨이는 Meta로 이벤트 전송을 중단한 것으로 보일 수 있습니다. v1.0.8 이상으로 업그레이드하여 설정의 이점을 극대화하는 것이 좋습니다. 그러면 이벤트 플로가 재개되고 향후에 자동 업데이트되도록 할 수 있습니다.
진단
- 아래의 방법으로 전환 API 게이트웨이가 최신 버전인지 확인합니다.
- 전환 API 게이트웨이 관리자 UI를 엽니다.
https://<Conversions API Gateway Endpoint>/hub
- 전환 API 게이트웨이 서버의 최신 버전을 확인합니다.
- 왼쪽 메뉴 > 설정 > 업데이트
해결 방법
전환 API 게이트웨이를 업그레이드하려면 다음의 단계를 따르세요.
- 오래된 버전을 제거합니다.
- 최신 버전을 설치합니다.
- 새 스택에서 IP를 사용하도록 DNS 레코드를 업데이트합니다.
EKS 로그로 문제 해결
단일 계정 EKS 버전 또는 복수 계정 버전에 대해 전환 API 게이트웨이를 설치하는 동안 문제가 발생하는 경우, 로그를 참조하여 문제를 해결하세요.
EKS 설치 로그를 'ConversionsAPIGateway/cloud-init-output.log'라는 그룹 이름 아래의 AWS Cloudwatch에서 확인할 수 있습니다. 오류 메시지가 있는지 확인할 수 있습니다. 일반적으로 발생하는 오류로는 AWS 리소스 제한 초과, AWS 권한 부족 등이 있습니다.
amazonaws.com이 없는 CAA 유형을 가진 DNS 레코드
전환 API 게이트웨이가 설정하도록 요청하는 DNS 레코드에 적절한 TLS 인증서가 있거나 CAA 레코드가 없는 경우, 이 섹션을 무시하셔도 됩니다.
이 도메인에 대한 CAA 레코드가 있는 경우, 전환 API 게이트웨이의 AWS EKS 버전을 설치했거나 도메인 생성 시 AWS Certificate Manager를 사용하는 복수 계정용 전환 API 게이트웨이 1.10.* 버전 이상을 설치했다면 amazonaws.com을 CAA 레코드 값으로 제공하세요. CAA 레코드의 예시는 다음과 같습니다.
0 issue "amazonaws.com"
복수 계정용 전환 API 게이트웨이 1.9* 이하 버전을 설치한 경우에는 letsencrypt.org를 CAA 레코드 값으로 제공하세요. 예를 들면 다음과 같습니다.
0 issue "letsencrypt.org"