メインコンテンツへスキップ
メーターは生のイベントを請求可能な数量に変換します。イベントをフィルタリングし、集計関数（カウント、合計、最大、最後）を適用して顧客ごとの使用量を計算します。
メーター作成インターフェース、イベント名、集計タイプ、フィルタリングオプションを表示

​
APIリソース

​
メーターの作成

1

基本情報

​
メーター名
string
required
説明的な名前（例：“APIリクエスト”、“トークン使用量”）
​
イベント名
string
required
一致させる正確なイベント名（大文字と小文字を区別）。例：api.call、image.generated
2

集計

​
集計タイプ
string
required
イベントの集計方法を選択：
  • カウント：イベントの総数（APIコール、アップロード）
  • 合計：数値を加算（トークン、バイト）
  • 最大：期間内の最高値（ピークユーザー）
  • 最後：最も最近の値
​
プロパティによる集計
string
集計するメタデータキー（カウント以外のすべてのタイプに必要）。例：tokens、bytes、duration_ms
​
測定単位
string
required
請求書用の単位ラベル。例：calls、tokens、GB、hours
3

フィルタリング（オプション）

イベントフィルタリング
カウントされるイベントをフィルタリングする条件を追加します：
  • ANDロジック：すべての条件が一致する必要があります
  • ORロジック：任意の条件が一致する可能性があります
比較演算子：等しい、等しくない、大きい、小さい、含むフィルタリングを有効にし、ロジックを選択し、プロパティキー、比較演算子、値を使って条件を追加します。
4

作成

設定を確認し、メーターを作成をクリックします。

​
分析の表示

メーター分析
メーターダッシュボードには次の情報が表示されます：
  • 概要：総使用量と使用量チャート
  • イベント：受信した個々のイベント
  • 顧客：顧客ごとの使用量と料金

​
トラブルシューティング

  • イベント名は正確に一致する必要があります（大文字と小文字を区別）
  • メーターフィルターがイベントを除外していないか確認します
  • 顧客IDが存在することを確認します
  • テストのためにフィルターを一時的に無効にします
  • プロパティによる集計がメタデータキーと正確に一致することを確認します
  • 文字列ではなく数値を使用します：tokens: 150ではなく"150"
  • すべてのイベントに必要なプロパティを含めます
  • 大文字と小文字を正確に一致させます
  • データ型に対して正しい演算子を使用します
  • イベントにフィルタリングされたプロパティが含まれていることを確認します
  • 実際に受信したイベントをカウントするためにイベントタブを確認します
  • 集計タイプ（カウント対合計）を確認します
  • 合計/最大のために値が数値であることを確認します

​
次のステップ

イベントを送信

アプリケーションからメーターに使用イベントを送信し始めます。

ブループリントを見る

一般的なユースケースのための既製のメーター設定を使用します。