ソケット
- 認証から受信まで、1 つの UDP ソケットを使い続けてください。送信元のポートが変わると、別の購読者として扱われます。
- 受信バッファは大きめ(数 MB)に取ってください。全シンボルを購読すると、毎秒数千のデータグラムが届くことがあります。Linux では
SO_RCVBUFの上限がnet.core.rmem_maxで決まります。 - ファイアウォールや NAT の内側からでも、Tick サーバーへ送ったのと同じソケットで受け取れば、ティックは届きます。1 秒ごとの
Heartbeatが NAT の対応を保ちます。
受信の処理
- 受信のループでは、
templateIdで種類を見分けてください。認証や購読の応答を待っている間にもTicksが届きます。 Ticksの要素は前から順に処理してください。1 つのデータグラムに、同じシンボルのティックが複数入ることがあります。- Python のように 1 件ずつの処理が遅い言語で全シンボルを受け取るときは、受信のスレッドを分けて、受け取ったデータグラムをすぐキューに移してください。
欠損の検知
sequenceは購読者ごとのデータグラムの連番で、1 から始まります。前に受け取った値より 2 以上大きければ、その間のデータグラムが失われています。- 認証し直して新しい購読者になると、
sequenceは 1 から始まり直します。 - 失われたティックは送り直されません。そのシンボルの値は、次のティックで最新になります。
時刻と価格
- 時刻はすべて UTC の、1970-01-01 からのナノ秒です。LP ごとのタイムゾーンは、Tick サーバーが外してから送ります。
- 価格は × 10⁸ の固定小数点(int64)です。浮動小数点に変換する前に、整数のまま比べたり差を取ったりできます。
届くまでの時間を測る
受信時刻(receiveTime)と、クライアントがデータグラムを受け取った時刻の差が、Tick サーバーからクライアントまでにかかった時間の目安です。2 台の時計のずれを含むので、クライアントの時計は NTP(AWS なら Amazon Time Sync Service)で合わせてください。
終わり方
- プロセスを止める前に、空の
Subscribeを送ってください。IP アドレスの枠がすぐに空きます。 - 送らずに止めた場合は、
Heartbeatが途絶えてから 5 秒で枠が空きます。その前に別の IP アドレスから接続しようとすると、IpLimitReachedになることがあります。