アプリ使用量の計測

IronFlockが課金のためにアプリの使用量をどのように追跡・測定するかについて説明します。

概要

IronFlockはシステム内で実行されるすべてのアプリの使用量を継続的に計測します。この計測データは月次の請求サイクルに供給され、各顧客のサードパーティアプリ使用料を計算します。

計測はバックグラウンドで自動的に実行されます。アプリディストリビューターとして、アプリに計測コードを組み込む必要はありません。IronFlockがすべての追跡を処理します。

計測対象

アプリ日数

アプリ日数は、サードパーティアプリの基本的な課金単位です。1台のデバイスが1日間アプリを使用することを表します。

• 顧客がアプリに5台のデバイスを追加し、30日間使用した場合、150アプリ日数になります。
• アプリ日数はデバイスごと、アプリごとに追跡され、顧客の月次請求書に集計されます。
• PRODモードのアプリのみが計測されます。DEVモード（開発およびテスト中）で実行されるアプリは課金されません。

アプリ日数は、サードパーティアプリの課金を決定する唯一のメトリックです。ネットワークトラフィック、ストレージ、その他のインフラリソースは、インフラ課金の一部として別途計測され、アプリディストリビューターの収益には影響しません。

計測の仕組み

データ収集

使用量データは、デバイスエージェントのレポートからデバイスごとに1時間粒度で収集されます。

集計

生の計測データは時系列テーブル（TimescaleDBベース）に保存され、課金可能な量に集計されます：

1. 時間ごとの集計 — 生のテレメトリがデバイスごと、アプリごとに1時間の要約にロールアップされます。
2. 月次集計 — 時間ごとのデータが各顧客の月次合計に集計されます。
3. 請求計算 — 月次合計がプロダクトの含まれるユニットと比較され、リベート式が適用されて最終的な課金額が決定されます。

DEVモードとPRODモード

IronFlockは開発と本番の使用を区別します：

PRODモードの使用のみが請求書を生成します。顧客は課金を発生させることなくDEVモードでアプリをテストできます。

インフラ計測とアプリ計測

IronFlockは2つの独立した計測ストリームを維持しています：

インフラリソースの計測

IronFlock自体のインフラ（ストレージ、ネットワークトラフィック、仮想デバイス、AIトークン）の使用を追跡します。これはIronFlockから顧客に直接課金され、アプリディストリビューターは関与しません。

サードパーティアプリの計測

ディストリビューターが公開したアプリの使用を追跡します。請求システムはディストリビューターごとに個別の課金レコードを作成します。顧客が複数のディストリビューターのアプリを使用している場合、各ディストリビューターのアプリは独立して課金されます。これにより、Stripeのデスティネーションチャージが各ディストリビューターの接続アカウントに正しい金額をルーティングできます。