Skip to main content
Khả năng quan sát TokenLab tốt bắt đầu với các định danh công khai. Các bản ghi của bạn nên giúp bạn trả lời “người dùng đã yêu cầu gì, nhiệm vụ công khai nào đã được TokenLab tạo ra, và nó đã được tính phí như thế nào?” mà không tiết lộ chi tiết nhạy cảm của nhà cung cấp hoặc dữ liệu nhạy cảm của người dùng.

Các Định Danh Công Khai Cần Ghi Nhận

Không lưu trữ ID nhiệm vụ của nhà cung cấp, URL của nhà cung cấp, định danh của nhà cung cấp, khóa Redis hoặc siêu dữ liệu thực thi nhạy cảm như bản ghi hiển thị cho khách hàng.

Những Gì Cần Ghi Nhận

Ghi lại đủ thông tin để chẩn đoán yêu cầu mà không tiết lộ bí mật:
  • Điểm cuối, phương thức HTTP, mô hình, mã trạng thái, dấu thời gian và độ trễ.
  • Các định danh công khai: request_id, task_id, poll_url, và billing_transaction_id khi có.
  • Hình dạng yêu cầu đã được làm sạch: các trường nào có mặt, không phải toàn bộ lời nhắc hoặc nội dung phương tiện riêng tư.
  • Phản hồi trạng thái không đồng bộ cuối cùng, bao gồm các trường lỗi công khai.
  • Số lần thử lại của khách hàng và liệu lần thử lại có tạo ra một nhiệm vụ mới hay tiếp tục một nhiệm vụ hiện có.
Luôn xóa bỏ Authorization, API keys, management tokens, signed URLs, private media URLs, toàn bộ lời nhắc, và dữ liệu cá nhân của người dùng trừ khi bạn có sự cho phép rõ ràng để giữ lại chúng.

Ma Trận Khắc Phục Sự Cố

Đối Chiếu Sử Dụng

Sử dụng Management API để đối chiếu phía máy chủ:
GET /v1/management/api-keys/{keyId}/usage có thể lọc theo scene, model, modelVendor, startDate, và endDate. Sử dụng các bản ghi này thay vì lấy thông tin từ các trang bảng điều khiển hoặc dựa vào ID nhiệm vụ của nhà cung cấp. Các phản hồi phát trực tiếp có thể được thanh toán sau khi luồng được gửi, vì vậy một tiêu đề thanh toán có thể không có ngay cả khi việc sử dụng được ghi lại sau đó. Các nhiệm vụ phương tiện không đồng bộ có thể được thanh toán sau khi lấy thông tin cuối cùng.

Mẫu Gói Hỗ Trợ

Khi liên hệ với hỗ trợ, bao gồm:
  • request_id.
  • task_idpoll_url cho công việc không đồng bộ.
  • billing_transaction_id khi có.
  • Điểm cuối, phương thức, mô hình, dấu thời gian, và mã trạng thái.
  • Hình dạng yêu cầu đã được làm sạch và nội dung lỗi công khai.
  • Kết quả mong đợi của bạn và những gì người dùng thực sự thấy.
Không bao gồm API keys, management tokens, phương tiện riêng tư, toàn bộ lời nhắc, URL của nhà cung cấp, ID kênh hoặc định danh chẩn đoán riêng tư trừ khi hỗ trợ TokenLab yêu cầu rõ ràng một mẫu đã được che bớt.

Kiểm Tra Vận Hành

  • Cảnh báo về các phản hồi 401, 402, 429, và 5xx lặp lại riêng biệt; chúng thường có các chủ sở hữu khác nhau.
  • Theo dõi các công việc không đồng bộ vẫn không kết thúc lâu hơn SLA sản phẩm của bạn.
  • Theo dõi các nỗ lực tạo trùng lặp cho cùng một ID công việc của người dùng.
  • Lấy mẫu các công việc đã hoàn thành và xác minh tài sản có thể nhìn thấy của người dùng, hồ sơ sử dụng, và bản ghi nhiệm vụ đã lưu trữ đồng ý.

Tài Liệu API