ドキュメント一覧 | API

帯域幅/遅延 プラグイン API

帯域幅プラグインはサーバーへのユーザーのネットワークコネクションの帯域幅と遅延を測定します。帯域幅 API は BOOMR.plugins.BW に内包されます。

Configuration

bandwidth プラグインの全ての設定は BW の名前空間の下に入ります。設定オブジェクトについては 使用方法 #6 — boomerang の設定 をご覧ください。

base_url
[推奨] 初期値では、bandwidth プラグインは帯域幅測定用の画像を現在のページのディレクトリーの images/ サブディレクトリーから見つけます。これはあなたのサイト上の全てのページで正しいとは限りません。画像があるディレクトリーのパスを base_url パラメーターで設定ができます。絶対 URL または相対 URL で指定ができます。相対パスの場合、JavaScript ファイルからではなく boomerang が読み込まれたページからの相対パスになることを覚えておいてください。
cookie
[オプション] ユーザーのコネクションの帯域幅と遅延の測定結果を格納する Cookie の名前。初期値は BA です。詳細は 使用方法 #3 をご覧ください。Cookie を無視して開始時間を完全に WebTiming API に依存させるには、ここに null のような偽の値か空文字を指定します。
cookie_exp
[オプション] 秒で表した Cookie の有効期限。初期値は7日間です。これはユーザーの帯域幅テストを再度行うまでにどれくらい空けるかを記述します。IP アドレスをもとにその間は変更されません。ネットワークコネクションの帯域幅は通常は定期的に大きくは変わらないため、実際はこの設定を何も変更する必要はありません。
もしあなたがレアルタイムストリーミングのようなことを行っている場合、帯域幅のテストは適切ではなく、Cookie に短い値を設定するのは正しい方法ではありません。
timeout
[オプション] ミリ秒で表した帯域幅のテスト全体のタイムアウト値。初期値は15秒です。帯域幅のテストは長時間実行できるため、時々ネットワークエラーが発生し終了しないかもしれません。タイムアウトは強制的にテストを終了させます。これはハードリミットです。もしタイムアウトになると、テストの続行を停止してこの時点で取得できているデータから帯域幅を計算しようとします。タイムアウトを長くすればさらに多くのデータを取得し精度を向上できますが、長くした分、ユーザーがページを離れる前にテストが終了しないリスクも増えます。
nruns
[オプション] 帯域幅のテストを実行する回数。初期値は5回です。初回のテストは常に残りのテストを続行するためにベストな計算をするための試験的なものです。この回数が増えるとテストの精度も向上していきますが、増やした分、テストがタイムアウトするリスクも増えます。これは実行毎に約2秒から4秒かかるため、この値は timeout の値よりも超えるように考慮しなければなりません。

メソッド

init(oConfig)

帯域幅プラグインを設定するために BOOMR.init() メソッドによって呼び出されます。

パラメーター

oConfig
BOOMR.init() を通して渡された設定オブジェクト。詳しくは 設定項目の説明 をご覧ください。

返り値

BOOMR.plugins.BW オブジェクトへの参照。メソッドチェーンをサポートします。

run()

帯域幅テストを開始します。 このメソッドは page_ready イベントが発生したときに自動的に呼び出されます。もし必要であれば自分で呼び出してもかまいません。

返り値

BOOMR.plugins.BW オブジェクトへの参照。メソッドチェーンをサポートします。

abort()

すぐに帯域幅のテストを中断して、すでに収集した値から帯域幅と遅延を計算します。このメソッドは帯域幅のテストが中断されると自動的に呼び出されます。BOOMR.init() メソッドを呼び出すときに適切な timeout 値を設定することを推奨します。

返り値

BOOMR.plugins.BW オブジェクトへの参照。メソッドチェーンをサポートします。

is_complete()

帯域幅プラグインが終了したのかどうかを確認するために BOOMR.sendBeacon() によって呼び出されます。

返り値

ビーコンパラメーター

このプラグインはビーコンに次のパラメーターを追加します:

bw
秒間のバイト数にしたユーザーの測定された帯域幅
bw_err
測定したユーザーの帯域幅でエラーを除いた95%信頼できる値
lat
ミリ秒にしたユーザーの HTTP 遅延
lat_err
測定したユーザーの HTTP 遅延でエラーを除いた95%信頼できる値
bw_time
帯域幅と遅延を測定したときのユーザーのブラウザーのタイムスタンプ

最新のソースコードとドキュメントは github.com/SOASTA/boomerang に公開されています。