Application Real-Time Monitoring Service (ARMS) のブラウザ監視に関する代表的な質問とその回答です。SDK の構成、パフォーマンスデータ、JavaScript エラー、トレースについて説明します。
課金
SDK および構成
コンソール設定と setConfig メソッドの違いは何ですか?
| 方法 | 適用タイミング | 使用タイミング |
|---|---|---|
| コンソール設定 | 生成されたコードを公開した後 | アプリケーションに対する ARMS の初期構成時 |
setConfig メソッド | 即時 | アプリケーションがすでにモニタリング対象となっている場合 |
コンソール設定では、公開後にのみ有効となる構成コードが生成されます。アプリケーションがすでにモニタリング対象となっている場合は、setConfig メソッドを使用して構成を変更してください。

SDK で環境およびバージョンを設定するにはどうすればよいですか?
release パラメーターを使用してバージョンをタグ付けし、environment パラメーターを使用して環境を区別します。詳細については、「SDK リファレンス (release)」および「SDK リファレンス (environment)」をご参照ください。
サポートされている environment 値:
| 値 | 環境 |
|---|---|
prod | 本番環境 |
gray | 段階的リリース |
pre | ステージング環境 |
daily | 日次 |
local | ローカル環境 |
デプロイ済みのバージョンを確認するにはどうすればよいですか?
ARMS コンソール にログインします。
左側ナビゲーションウィンドウで、ブラウザ監視 > ブラウザ監視 を選択し、ご利用のアプリケーション名をクリックします。
アプリケーション > 詳細表示 を選択します。
バージョン 列は、ログ一覧 セクション内の各ログエントリに対応するバージョン番号を示します。

また、メニューバー から環境およびバージョンでログをフィルターすることもできます。ただし、このフィルター機能を利用するには、PV ログに既にバージョン番号が設定されている必要があります。

ARMS の構成が反映されない
これは通常、ブラウザのキャッシュによるものです。トラブルシューティング手順は以下のとおりです。
ARMS コンソールで、アプリケーション > 詳細表示 に移動します。
最新のバージョンに切り替え、トレンドチャートを確認します。
バージョン番号が表示されない場合は、ARMS SDK で
releaseパラメーターを設定します。詳細については、「SDK リファレンス」をご参照ください。releaseを設定した後、指定した値が最新バージョンとして正しく表示されることを確認します。
__bl.performance() を呼び出す際に SDK が読み込まれているかどうか不明
この問題を安全に処理するパターンについては、「シングルページアプリケーション (SPA) のページデータ送信」をご参照ください。
アプリケーション版およびホスト版のバージョン番号
| 版 | バージョン情報の出所 | 設定方法 |
|---|---|---|
| アプリケーション版 | ご利用中のオンラインプロジェクトの現在のバージョン | release パラメーターを設定します。「SDK リファレンス」をご参照ください。 |
| ホスト版 | プロジェクトをホストするアプリ(SDK により自動検出) | 自動設定です。淘宝、支付宝、WeChat のバージョンのみが解決可能です。その他のホストアプリのバージョンは解決できません。 |
ページビューおよびパフォーマンス
PV 一覧とページ速度一覧が異なる理由
これは、SPA 自動解決機能が有効なシングルページアプリケーション (SPA) で発生します。PV とページ速度は、以下のように異なる方法で測定されます。
| 指標 | 測定方法 | 結果 |
|---|---|---|
| PVs | hashchange イベントごとに PV レポートがトリガーされる | PV 一覧には、ハッシュ値ごとに分割されたページビューが表示される |
| ページ速度 | 完全なページ読み込み時のみ記録される | ハッシュ値の変更によって速度が変化せず、冗長なレポートを回避する |
ARMS コンソールのモジュール間で PV 数が異なる理由
| モジュール | PV 計算方法 |
|---|---|
| ページ速度 ページ | パフォーマンスログエントリ数 × サンプリング率 |
| ページ ページ(次元 下) | PV ログの直接カウント |
パフォーマンスログは、完全なページ読み込みごとに 1 回報告されます。SPA モードでは、ルート変更ごとに PV ログが報告されるため、PV ログのカウント数はパフォーマンスログのカウント数を上回ります。
特定のユーザーの滞在時間 (TP) を確認するにはどうすればよいですか?
ARMS コンソール にログインします。
左側ナビゲーションウィンドウで、ブラウザ監視 > ブラウザ監視 を選択し、ご利用のアプリケーション名をクリックします。
アプリケーション > セッショントレース を選択します。
セッション一覧 セクションの セッション ID 列から、任意のセッション ID をクリックします。
セッション追跡の詳細 ページの、訪問タイムライン 列のタイムライン領域にマウスを合わせると、滞在時間 (TP) を確認できます。
カスタムパフォーマンスメトリクスを確認するにはどうすればよいですか?
ARMS コンソール にログインします。
左側ナビゲーションウィンドウで、ブラウザ監視 > ブラウザ監視 を選択し、ご利用のアプリケーション名をクリックします。
アプリケーション > ページ速度 を選択します。
カスタムパフォーマンスメトリクスは、ページ速度 セクションに表示されます。
一部のリソースで「接続ダウンロード」時間が「持続時間」より短い理由
これはクロスドメインリソースのタイミングに関する問題です。ARMS は performance.getEntriesByType('resource') API からパフォーマンスデータを読み取ります。第三者の ARMS リソースのドメインは、そのリソースを要求するサイトのドメインと一致している必要があります。クロスドメインリソースの場合、同一オリジンポリシーにより、以下のタイミングプロパティの値が 0 として返されます。
redirectStart、redirectEnd、domainLookupStart、domainLookupEnd、connectStart、connectEnd、secureConnectionStart、requestStart、responseStart
connect download は responseEnd - responseStart に等しいため、responseStart がゼロになると、実際の duration を超える結果が得られます。
| シナリオ | 解決方法 |
|---|---|
| 自社管理 CDN リソース | ブラウザが詳細なタイミングデータにアクセスできるよう、Timing-Allow-Origin レスポンスヘッダーを追加します |
| 第三者リソース | クロスドメインリソースでも正確に維持される duration 値を主な参照値として使用します |
URL 収束
監視対象の URL や API にアスタリスク (*) が含まれる理由
アスタリスクは実際の URL の一部ではありません。これは URL 収束を示しており、ARMS は可変セグメント(ID、クエリパラメーターなど)を * で置き換えて、類似した URL をグループ化します。

ARMS は独自の URL 収束アルゴリズムを使用して、類似した URL をグループ化し、合計 URL 数を削減しつつ、意味的情報を保持します。URL 収束は以下の 2 段階で実行されます。
集約:構造が類似した URL をグループ化します。
変数の識別:可変セグメントをアスタリスクで置き換えます。

URL 収束を無効にするには、SDK の urlHelper オプションを構成します。
トレースおよび API 診断
API ログにトレース ID が表示されない
まず、アプリケーションモニタリングとの関連付け が有効になっているか確認します。
ARMS コンソール にログインします。
左側ナビゲーションウィンドウで、ブラウザ監視 > ブラウザ監視 を選択し、ご利用のアプリケーション名をクリックします。
設定項目 > アプリケーション設定 を選択します。
前提条件 タブで、アプリケーションモニタリングとの関連付け が選択されているか確認します。選択されていない場合は、これを選択し、ARMS エージェントをフロントエンドアプリケーションに再接続します。

それでもトレース ID が表示されない場合は、ページリクエストのドメインと API リクエストのドメインが一致しているか確認します。ドメインが一致しない場合、クロスドメインリクエストであることを示します。ARMS は、クロスドメイン認証による API 失敗を防ぐため、クロスドメインリクエストに対してトレース ID の生成をスキップします。
完全な解決手順については、「フロントエンドからバックエンドへのトレース機能を用いた API エラー診断」をご参照ください。
JavaScript エラー
JS エラーのトラブルシューティングにおけるソースマップファイルのエラー
| 原因の可能性 | 解決方法 |
|---|---|
| ファイル拡張子が不適切 | ファイルの拡張子が .js.map であることを確認します |
| 権限が不足 | ご利用のアカウントが ARMS への書き込み権限を持っているか確認します。権限がない場合は、管理者に連絡してください |
スクリプトエラー
「スクリプトエラーの原因と解決方法」をご参照ください。
ミニプログラム内の JS エラーが報告されない
ミニプログラムの基盤フレームワークは非同期操作において try-catch を使用しており、ARMS がエラーを検出する前にエラーを捕捉してしまいます。そのため、エラーは手動で報告する必要があります。詳細については、「API リファレンス」をご参照ください。
ARMS は console.error からの JS エラーを取得しますか?
| プラットフォーム | 動作 |
|---|---|
| Web ブラウザ | はい。ARMS は、JS エラー形式に一致する console.error 呼び出しを自動的に取得します。 |
| ミニプログラム | いいえ。エラーは手動で報告してください。「API リファレンス」をご参照ください。 |
ミニプログラム
Weex でミニプログラムに設定した UID が有効にならない
| シナリオ | 解決方法 |
|---|---|
setConfig が呼び出されていない | 初期化時に UID を指定したか確認します。指定していない場合は、追加してください。 |
setConfig がすでに呼び出されている | 別の UID を指定して、再度このメソッドを呼び出します。 |
ログ保持期間およびエディション
ログ保持期間
| エディション | 保持期間 |
|---|---|
| ARMS Basic Edition | 最大 7 日間 |
| ARMS Pro Edition | 最大 30 日間 |
ARMS Pro Edition を有効化した後も、トライアル期間中のサイトを継続して利用できますか?
いいえ。トライアル期間終了後 15 日以内に支払い遅延が発生すると、サイトは一時停止されます。アプリケーションを再起動することで、アクセスを復元できます。
15 日以内に Pro Edition を有効化しなかった場合、サイトは完全に削除され、すべてのリソースが解放されます。データは復元できません。