請求
Usage Metering
API usage summary と product credit ledger の違いを説明します。
このページの内容3項目
Signal Foundry には 2 種類の metering があります。
| Metering | 何を見るか | 主な用途 |
|---|---|---|
| API usage summary | request count、endpoint、response bytes | API key の利用状況・rate limit 調整 |
| Product credit ledger | Basic / enrichment / grant / reservation | ユーザーが使える credit 残高と消費 |
API usage summary
主に見ている項目は次のとおりです。
- request count
- endpoint breakdown
- response bytes
- last request at
これらは API キー設定画面の usage summary で確認できます。
Product credit ledger
credit の残高と grant breakdown は次で確認します。
sf credits balance --json sf credits summary --json
credits balance は残高、credits summary は直近期間の usage event summary です。請求計算そのものではなく、プロダクト上の利用可能量と消費履歴を確認するために使います。
何に使うか
- 利用頻度の把握
- heavy endpoint の特定
- pilot 顧客の利用実態確認
- rate limit の見直し
- Basic / enrichment credit の使われ方の確認
Stripe subscription / order は grant を作る入口です。実際のプロダクト利用可否は sf_credit_grants と ledger allocation で判断します。
operation ごとの credit 消費は Credit Schedule を見ます。source と evidence の出所は Data Provenance を見ます。