API Chuyển đổi

Cổng API Chuyển đổi - Khắc phục lỗi và cảnh báo

Nếu bạn nhận thấy các sự kiện từ máy chủ bị thiếu hoặc số lượng sự kiện từ máy chủ ít hơn so với sự kiện trên trình duyệt, hãy sử dụng tài liệu này để khắc phục sự cố. Để biết thông tin về công cụ khắc phục sự cố, hãy xem bài viết Cổng API Chuyển đổi - Công cụ khắc phục sự cố.

Sử dụng các bước khắc phục sự cố sau để giúp xác định sự cố:

  1. Chuyển đến Trình quản lý sự kiện
  2. Mở trang web trong trình duyệt
  3. Giao diện người dùng quản trị của Cổng API Chuyển đổi

Miền chưa được đặt cấu hình để gửi sự kiện

Cổng API Chuyển đổi sẽ nhận sự kiện từ các miền được kết nối mà bạn đặt cấu hình trong quá trình thiết lập tiện ích tích hợp. Nếu số lượng sự kiện từ máy chủ có vẻ ít hơn so với sự kiện trên trình duyệt, nguyên nhân có thể là do Pixel đang kích hoạt trên các miền chưa được kết nối với Meta.

Chẩn đoán

  • Đăng nhập vào Trình quản lý sự kiện
  • Chọn sự kiện thích hợp
  • Nhấp vào Xem chi tiết và chọn Tổng quan về sự kiện
  • Từ menu thả xuống ở bên trái, hãy chọn Miền để tìm các miền mà sự kiện trên trình duyệt đang kích hoạt
  • Nếu những miền đó bị thiếu hoặc khác với miền đã đặt cấu hình thì sự kiện trên trình duyệt sẽ không được thu thập

Giải pháp

  • Thêm các miền bắt buộc vào kết nối Cổng API Chuyển đổi của bạn bằng cách làm theo hướng dẫn này.

DNS chưa được đặt cấu hình hoặc ánh xạ DNS không đúng

Cổng API Chuyển đổi được lưu trữ trên AWS và sẽ được AWS chỉ định địa chỉ IP khi tạo. Bạn phải ánh xạ một miền phụ cho miền của mình đến địa chỉ IP này để có thể truy cập điểm cuối Cổng API Chuyển đổi từ trình duyệt thông qua lệnh gọi yêu cầu của bên thứ nhất.

Chẩn đoán

  • Sử dụng trình kiểm tra DNS trực tuyến, chẳng hạn như https://dnschecker.org/ để xác minh xem miền Cổng API Chuyển đổi có được phân giải đến đúng địa chỉ IP và được truyền đầy đủ hay không. Nếu miền của bạn không phân giải đến bất kỳ địa chỉ IP nào, hãy tham khảo phần giải pháp khắc phục để biết các bước tiếp theo.
  • Lấy địa chỉ IP của máy chủ Cổng API Chuyển đổi từ bảng điều khiển AWS EC2 hoặc yêu cầu người liên hệ cơ sở hạ tầng đám mây của bạn cung cấp thông tin này.
  • Nếu 2 địa chỉ IP khác nhau, hãy tham khảo phần giải pháp khắc phục để biết các bước tiếp theo.

Giải pháp

  • Liên hệ với quản trị viên để biết cơ quan đăng ký miền.
  • Cập nhật bản ghi DNS tại cơ quan đăng ký miền bằng địa chỉ IP của máy chủ Cổng API Chuyển đổi (địa chỉ được hiển thị trên bảng điều khiển AWS EC2 của bạn).
    • Đặt bản ghi DNS A ánh xạ miền phụ Cổng API Chuyển đổi của bạn đến địa chỉ IP máy chủ được tạo trong quá trình thiết lập.

Chưa từng được cấp chứng chỉ

Nếu Cổng API Chuyển đổi chưa từng được Let's Encrypt cấp chứng chỉ, kể cả rất lâu sau khi DNS được đặt cấu hình chính xác, điều đó có nghĩa là miền của bạn phổ biến đến mức Let's Encrypt từ chối cấp chứng chỉ.

Giải pháp

  • Hãy cân nhắc đặt Trình cân bằng tải AWS (ALB) trước phiên bản Cổng API Chuyển đổi và sử dụng ALB để lưu trữ chứng chỉ mà bạn sở hữu.

Chứng chỉ đã được cấp nhưng đã hết hạn

Sự cố này xảy ra nếu bạn đóng cổng 80 sau khi cài đặt thành công Cổng API Chuyển đổi hoặc bạn đang chạy trong phiên bản cũ.

Giải pháp

Không thể truy cập giao diện người dùng của Cổng

Sự cố này xảy ra nếu bạn đóng cổng 80 sau khi cài đặt thành công Cổng API Chuyển đổi hoặc bạn đang chạy trong phiên bản cũ.

Giải pháp

  • Xác minh rằng địa chỉ IP của phiên bản Cổng API Chuyển đổi khớp với cấu hình DNS. Nếu không khớp, hãy xem phần DNS chưa được đặt cấu hình hoặc ánh xạ DNS không đúng.
  • Nếu máy chủ không phản hồi thì nguyên nhân có thể là do lỗi mạng tạm thời. Bạn có thể khởi động lại phiên bản để khắc phục sự cố. Quá trình khởi động Cổng API Chuyển đổi có thể mất vài phút. Vì vậy, hãy chờ khoảng 10 phút mới đăng nhập lại.

Cổng yêu cầu nâng cấp phiên bản

Có vẻ như các phiên bản trước v1.0.8 của Cổng API Chuyển đổi đã ngừng gửi sự kiện đến Meta. Bạn nên nâng cấp Cổng lên phiên bản tối thiểu là v1.0.8 để tối đa hóa lợi ích của cách thiết lập này. Thao tác này sẽ tiếp tục quy trình sự kiện và đảm bảo cập nhật tự động trong tương lai.

Chẩn đoán

  • Cách kiểm tra phiên bản hiện tại của Cổng API Chuyển đổi:
    • Mở giao diện người dùng quản trị của Cổng API Chuyển đổi:
https://<Conversions API Gateway Endpoint>/hub
  • Kiểm tra phiên bản hiện tại của máy chủ Cổng API Chuyển đổi:
    • Menu bên trái > Cài đặt > Cập nhật

Giải pháp

Để nâng cấp Cổng API Chuyển đổi, hãy thực hiện các thao tác sau:

Khắc phục sự cố với nhật ký EKS

Nếu gặp bất kỳ sự cố nào khi cài đặt Cổng API Chuyển đổi cho phiên bản EKS trên một tài khoản hoặc phiên bản nhiều tài khoản, bạn có thể tham khảo nhật ký để khắc phục sự cố.

Nhật ký cài đặt EKS có sẵn trong AWS Cloudwatch dưới tên nhóm "ConversionsAPIGateway/cloud-init-output.log". Bạn có thể kiểm tra xem có thông báo lỗi nào không. Các lỗi thường gặp bao gồm vượt quá giới hạn tài nguyên AWS và thiếu quyền AWS.



Bản ghi DNS thuộc loại CAA không có amazonaws.com

Nếu bản ghi DNS mà Cổng API Chuyển đổi yêu cầu thiết lập có chứng chỉ TLS phù hợp hoặc không có bản ghi CAA, bạn có thể bỏ qua phần này.

Nếu bạn có bản ghi CAA cho miền, vui lòng đảm bảo cung cấp amazonaws.com làm giá trị cho bản ghi CAA nếu bạn đã cài đặt phiên bản AWS EKS của Cổng API Chuyển đổi (đối với Một tài khoản) hoặc Cổng API Chuyển đổi dành cho nhiều tài khoản phiên bản 1.10.* trở lên và sử dụng Trình quản lý chứng chỉ AWS để tạo miền. Ví dụ về bản ghi CAA sẽ là:

0 issue "amazonaws.com"

Nếu bạn đã cài đặt Cổng API Chuyển đổi dành cho nhiều tài khoản phiên bản 1.9.* trở xuống, vui lòng đảm bảo cung cấp letsencrypt.org làm giá trị cho bản ghi CAA. Một ví dụ sẽ là:

0 issue "letsencrypt.org"

Xem thêm