Các đồng hồ đo xác định cách các sự kiện sử dụng của bạn được tổng hợp và đo lường cho mục đích thanh toán.Trước khi tạo một đồng hồ đo, hãy lập kế hoạch chiến lược theo dõi mức sử dụng của bạn:
Xác định các sự kiện sử dụng mà bạn muốn theo dõi
Xác định cách các sự kiện nên được tổng hợp (đếm, tổng, v.v.)
Định nghĩa bất kỳ yêu cầu lọc nào cho các trường hợp sử dụng cụ thể
Đơn giản là đếm số sự kiện đã nhận.Trường hợp sử dụng: Các cuộc gọi API, lượt xem trang, tải tệpPhép tính: Tổng số sự kiện
Cộng các giá trị từ một thuộc tính cụ thể trong sự kiện của bạn.Trường hợp sử dụng: Chuyển dữ liệu, tiêu thụ lưu trữ, thời gian xử lýPhép tính: Tổng các giá trị thuộc tính
Ghi lại giá trị cao nhất của một thuộc tính cụ thể trong chu kỳ thanh toán.Trường hợp sử dụng: Người dùng đồng thời cao nhất, lưu trữ tối đa đã sử dụng, băng thông cao nhấtPhép tính: Giá trị thuộc tính lớn nhất được quan sát
Sử dụng giá trị gần nhất của một thuộc tính cụ thể.Trường hợp sử dụng: Cấp độ gói hiện tại, cài đặt cấu hình mới nhấtPhép tính: Giá trị thuộc tính được ghi lại cuối cùng
Xác định nhãn đơn vị để hiển thị trong báo cáo và thanh toán.Ví dụ: “calls”, “GB”, “hours”, “tokens”
3
Configure Event Filtering (Optional)
Thiết lập tiêu chí để kiểm soát sự kiện nào được bao gồm trong đồng hồ đo.
Lọc sự kiện cho phép bạn tạo ra các quy tắc tinh vi quyết định sự kiện nào góp phần vào việc tính toán sử dụng. Điều này hữu ích để loại trừ sự kiện thử nghiệm, lọc theo tầng người dùng hoặc tập trung vào hành động cụ thể.
Kích hoạt lọc sự kiệnBật Kích hoạt lọc sự kiện để kích hoạt xử lý sự kiện có điều kiện.Chọn logic lọcChọn cách nhiều điều kiện được đánh giá:
AND Logic
OR Logic
Tất cả điều kiện phải đúng để một sự kiện được tính. Dùng khi bạn cần sự kiện đáp ứng nhiều tiêu chí nghiêm ngặt cùng lúc.Ví dụ: Đếm các cuộc gọi API nơi user_tier = "premium" AND endpoint = "/api/v2/users"
Ít nhất một điều kiện phải đúng để một sự kiện được tính. Dùng khi bạn muốn bao gồm các sự kiện đáp ứng bất kỳ tiêu chí nào trong số nhiều tiêu chí.Ví dụ: Đếm các sự kiện nơi method = "POST" OR method = "PUT" OR method = "DELETE"
Thiết lập điều kiện lọc
1
Add Condition
Nhấn Add condition để tạo quy tắc bộ lọc mới.
2
Configure Property Key
Chỉ định tên thuộc tính từ siêu dữ liệu sự kiện của bạn.
3
Select Comparator
Chọn từ các toán tử có sẵn:
equals - Khớp chính xác
not_equals - Bộ lọc loại trừ
greater_than - So sánh số
greater_than_or_equals - So sánh số (bao gồm)
less_than - So sánh số
less_than_or_equals - So sánh số (bao gồm)
contains - Chuỗi chứa chuỗi con
does_not_contain - Bộ lọc loại trừ chuỗi
4
Set Comparison Value
Đặt giá trị mục tiêu để so sánh.
5
Add Groups
Dùng Add Group để tạo nhóm điều kiện bổ sung cho logic phức tạp.
Các thuộc tính được lọc phải có trong siêu dữ liệu sự kiện để các điều kiện hoạt động chính xác. Các sự kiện thiếu thuộc tính bắt buộc sẽ bị loại khỏi việc tính toán.
4
Create Meter
Xem lại cấu hình đồng hồ đo và nhấn Create Meter.
Đồng hồ đo của bạn giờ đã sẵn sàng nhận và tổng hợp các sự kiện sử dụng.
Khi bạn đã tạo đồng hồ đo của mình, bạn cần liên kết nó với một sản phẩm để kích hoạt thanh toán dựa trên mức sử dụng. Quy trình này kết nối dữ liệu sử dụng của đồng hồ đo với các quy tắc định giá cho việc thanh toán của khách hàng.Liên kết các đồng hồ đo với các sản phẩm thiết lập kết nối giữa theo dõi mức sử dụng và thanh toán:
Các sản phẩm xác định các quy tắc định giá và hành vi thanh toán
Các đồng hồ đo cung cấp dữ liệu sử dụng cho các phép tính thanh toán
Nhiều đồng hồ đo có thể được liên kết với một sản phẩm duy nhất cho các kịch bản thanh toán phức tạp
Biến dữ liệu sử dụng của bạn thành các khoản phí có thể tính bằng cách cấu hình đúng cài đặt sản phẩm của bạn:
1
Choose Usage-Based Billing Product Type
Đi tới trang tạo hoặc chỉnh sửa sản phẩm của bạn và chọn Usage-Based làm loại sản phẩm.
2
Select Associated Meter
Nhấn vào Associated Meter để mở bảng chọn đồng hồ đo từ bên cạnh.Bảng này cho phép bạn cấu hình những đồng hồ đo sẽ theo dõi việc sử dụng cho sản phẩm này.
3
Add Your Meter
Trong bảng chọn đồng hồ đo:
Nhấp vào Thêm đồng hồ đo để xem các đồng hồ đo có sẵn
Chọn đồng hồ đo bạn đã tạo từ danh sách thả xuống
Đồng hồ đo đã chọn sẽ xuất hiện trong cấu hình sản phẩm của bạn
4
Configure Price Per Unit
Đặt giá cho mỗi đơn vị sử dụng được đồng hồ đo ghi nhận.
Số đơn vị mà khách hàng có thể sử dụng miễn phí trước khi bắt đầu tính phí theo sử dụng trả tiền.Cách hoạt động:
Ngưỡng miễn phí: 100 đơn vị
Giá mỗi đơn vị: $0.50
Khách hàng sử dụng: 250 đơn vị
Phép tính: (250 - 100) × 0.50=∗∗75.00** được tính phí
Ngưỡng miễn phí lý tưởng cho mô hình freemium, thời gian dùng thử hoặc cung cấp một mức cho phép cơ bản trong gói của khách hàng.
Ngưỡng miễn phí áp dụng cho mỗi chu kỳ thanh toán, mang đến cho khách hàng hạn mức mới hàng tháng hoặc theo lịch trình thanh toán của bạn.
6
Save Configuration
Xem lại cấu hình đồng hồ đo và định giá, sau đó nhấn Save Changes để hoàn tất thiết lập.
Sản phẩm của bạn giờ đã được cấu hình cho thanh toán theo mức sử dụng và sẽ tự động tính phí khách hàng dựa trên mức tiêu thụ thực tế.
Điều gì sẽ xảy ra tiếp theo:
Các sự kiện sử dụng gửi tới đồng hồ đo sẽ được theo dõi và tổng hợp
Các phép tính thanh toán sẽ tự động áp dụng quy tắc định giá của bạn
Khách hàng sẽ bị tính phí dựa trên mức tiêu thụ thực tế trong mỗi chu kỳ thanh toán
Hãy nhớ rằng bạn có thể thêm tối đa 10 đồng hồ đo cho mỗi sản phẩm, cho phép theo dõi sử dụng tinh vi trên nhiều chiều như cuộc gọi API, lưu trữ, thời gian tính toán và các chỉ số tùy chỉnh.
Các thuộc tính bổ sung để lọc và tổng hợp. Bao gồm mọi giá trị được tham chiếu trong thiết lập “Over Property” hoặc các điều kiện lọc của đồng hồ đo của bạn.
Những điều quan trọng cần biết để thu thập dữ liệu đáng tin cậy
Hãy tuân thủ các phương pháp này để việc theo dõi mức sử dụng luôn chính xác và ổn định trong môi trường production.
Sử dụng các event_id mang tính xác định và idempotent.event_id phải là duy nhất trên tất cả các event và đóng vai trò là idempotency key — event_id được sử dụng lại sẽ bị xem là bản trùng lặp và không được tính lại, vì vậy việc retry sẽ không dẫn đến tính phí hai lần. Hãy suy ra ID từ action thay vì sử dụng giá trị ngẫu nhiên, ví dụ `${customer_id}_${action}_${timestamp}`.
Gộp các event, tối đa 1.000 event trong mỗi request. Endpoint /events/ingest áp dụng giới hạn cứng là 1.000 event cho mỗi lần gọi; các batch lớn hơn sẽ bị từ chối, vì vậy hãy chia khối lượng lớn thành nhiều lần gọi. Đối với workload có lưu lượng lớn, hãy lưu tạm các event và gửi theo batch thay vì gửi một request cho mỗi event.
Retry 5xx và 429, không retry 4xx. Hãy retry khi xảy ra lỗi server (5xx) và giới hạn tốc độ (429), sử dụng exponential backoff. Không retry các lỗi validation 400/422 — payload bị sai định dạng và sẽ luôn thất bại; hãy sửa payload rồi gửi lại. Đưa các event vẫn thất bại sau khi retry vào queue để không event nào bị mất.
Thiết lập timestamps một cách có chủ đích. Bỏ qua timestamp đối với các event real-time; giá trị này sẽ mặc định là thời điểm ingestion. Hãy đặt giá trị này một cách rõ ràng (ISO 8601) khi backfill hoặc gửi các event bị trì hoãn/theo batch để mức sử dụng được ghi nhận vào đúng kỳ billing.
Gửi metadata được aggregate dưới dạng số, không phải chuỗi. Bất kỳ property nào được tham chiếu bởi Over Property của meter (Sum, Max, Last) đều phải có kiểu dữ liệu số — { "tokens": 150 }, không phải { "tokens": "150" }. Các giá trị chuỗi sẽ không được aggregate.
Theo dõi và phân tích dữ liệu billing dựa trên mức sử dụng với dashboard analytics toàn diện. Theo dõi các mô hình tiêu thụ của khách hàng, hiệu suất của meter và xu hướng billing để tối ưu hóa chiến lược định giá cũng như hiểu rõ hành vi sử dụng.
Biểu đồ số lượng meter trực quan hóa xu hướng sử dụng theo thời gian với các tính năng sau:
Trực quan hóa chuỗi thời gian: Theo dõi các mô hình sử dụng theo ngày, tuần hoặc tháng
Hỗ trợ nhiều meter: Xem dữ liệu từ nhiều meter cùng lúc
Phân tích xu hướng: Xác định các đột biến, mô hình và quỹ đạo tăng trưởng của mức sử dụng
Biểu đồ tự động điều chỉnh tỷ lệ dựa trên khối lượng sử dụng và phạm vi thời gian đã chọn, giúp hiển thị rõ cả những dao động nhỏ lẫn các thay đổi lớn về mức sử dụng.
Bảng event cung cấp chế độ xem rõ ràng về từng event sử dụng với các cột sau:
Tên event: Action hoặc trigger cụ thể tạo ra event sử dụng
Event ID: Mã định danh duy nhất cho mỗi instance của event
Customer ID: Khách hàng liên kết với event
Timestamp: Thời điểm event xảy ra
Chế độ xem này cho phép bạn theo dõi và giám sát từng event sử dụng trong toàn bộ customer base, mang lại tính minh bạch cho việc tính toán billing và các mô hình sử dụng.
Các kiểu aggregation khác nhau phục vụ những kịch bản billing khác nhau. Hãy chọn kiểu phù hợp dựa trên cách bạn muốn đo lường và tính phí cho mức sử dụng.