リアルユーザーモニタリング(RUM)メトリクス検知¶
このドキュメントの位置づけ
このドキュメントは、検知ルール設定フローの 2 番目のステップです。設定が完了したら、メインドキュメントに戻ってステップ 3:イベント通知に進んでください。
ワークスペース内の RUM メトリクスデータを監視するための機能です。Web、Android、iOS、ミニアプリ(Miniapp)、React Native、HarmonyOS など多様なアプリケーションタイプのパフォーマンスメトリクスに対してしきい値範囲を設定でき、メトリクスがしきい値を超えるとシステムが自動的にアラートをトリガーします。
フロントエンドアプリケーションのパフォーマンスを監視する必要があるユースケースに適しています。たとえば、Web の都市ディメンション別の JS エラー率を監視する場合や、ミニアプリのページ読み込み時間、モバイルアプリケーションのクラッシュ率などを監視する場合です。
検知設定¶
検知頻度¶
検知を実行する時間周期を設定します。
-
プリセットオプション:1 分、5 分、10 分、15 分、30 分、1 時間
-
デフォルト選択:5 分
-
Crontab モード:「Crontab モードに切り替え」をクリックするとカスタム周期を設定でき、秒、分、時、日、月、週などの周期に基づいて定期タスクの実行状況を設定できます。
検知期間¶
各検知でクエリするデータの時間範囲を設定します(❗️検知期間は検知頻度以上である必要があり、またデータの実際のレポート周期と一致させることで、検知漏れや誤検知を防ぎます)。
| 検知頻度 | 検知期間(ドロップダウン選択肢) |
|---|---|
| 30s | 1m/5m/15m/30m/1h/3h |
| 1m | 1m/5m/15m/30m/1h/3h |
| 5m | 5m/15m/30m/1h/3h |
| 15m | 15m/30m/1h/3h/6h |
| 30m | 30m/1h/3h/6h |
| 1h | 1h/3h/6h/12h/24h |
| 6h | 6h/12h/24h |
| 12h | 12h/24h |
| 24h | 24h |
- カスタム形式:検知期間を自由に入力できます。例:20m(直近 20 分)、2h(直近 2 時間)、1d(直近 1 日)。
検知メトリクス¶
検知するメトリクスデータを設定します。現在のワークスペース内の単一のアプリケーションタイプにおけるアプリケーションメトリクスデータに対して設定できます(❗️カーディナリティの高いフィールドを検知ディメンションとして選択しないでください。設定が不適切でトリガー条件が緩すぎると、頻繁なアラートが発生する可能性があります。現在のクエリの最大返却件数は 10 万件です)。
設定項目¶
| 設定項目 | 説明 |
|---|---|
| アプリケーションタイプ | RUM がサポートするアプリケーションタイプ(Web、Android、iOS、Miniapp、HarmonyOS など) |
| アプリケーション名 | 選択したアプリケーションタイプに基づいて対応するアプリケーション一覧を取得し、すべてまたは特定のアプリケーションを選択できます |
| メトリクス | アプリケーションタイプに応じて対応するパフォーマンスメトリクスを表示します。詳細は後述のメトリクス説明を参照してください |
| フィルター条件 | メトリクスのタグに基づいて検知メトリクスのデータをフィルターし、検知するデータ範囲を限定します。1 つまたは複数のタグフィルターを追加でき、あいまい一致およびあいまい不一致のフィルター条件をサポートします |
| 検知ディメンション | 設定データ内の対応する文字列型(keyword)フィールドを検知ディメンションとして選択できます。現在、検知ディメンションは最大 3 フィールドまで選択できます。複数の検知ディメンションフィールドの組み合わせにより、特定の検知対象を確定でき、システムはある検知対象に対応する統計メトリクスがトリガー条件のしきい値を満たすかどうかを判定し、満たす場合はイベントを生成します。(たとえば検知ディメンションで host と host_ip を選択した場合、検知対象は {host: host1, host_ip: 127.0.0.1} となります。) |
| 追加情報 | 追加フィールドは追加クエリにのみ使用され、トリガー条件の判定には使用されません。これらをイベント通知に設定できます。複数の一致値が検知された場合は、ランダムに 1 件のレコードが返されます |
Web / ミニアプリのメトリクス説明¶
| メトリクス | DQL クエリ例 |
|---|---|
| JS エラー数 | R::error:(count(__docid) asJS 错误数) { app_id = '<应用 ID>' } |
| JS エラー率 | Web: eval(A/B, alias='页面 JS 错误率', A="R::view:(count(view_url)) {view_error_count > 0, app_id = '<应用 ID>'}", B="R::view:(count(view_url)) { app_id = '<应用 ID>'}")ミニアプリ: eval(A/B, alias='JS 错误率', A="R::view:(count(view_name)) {view_error_count > 0, app_id = '<应用 ID>' }", B="R::view:(count(view_name)) { app_id = '<应用 ID>' }") |
| リソースエラー数 | R::resource:(count(resource_url) as资源错误数) {resource_status >=400, app_id = '<应用 ID>'}" |
| リソースエラー率 | eval(A/B, alias='资源错误率', A="R::resource:(count(resource_url)) { resource_status >= '400',app_id = '<应用 ID>' }", B="R::resource:(count(resource_url)) { app_id = '<应用 ID>' }") |
| 初回レンダリング平均時間 | R::page:(avg(page_fpt)){app_id = '<应用 ID>'} |
| ページ読み込み平均時間 | R::view:(avg(loading_time)){app_id = '<应用 ID>'} |
| ページ低速読み込み回数 | R::resource:(count(resource_load)){app_id = '<应用 ID>',resource_load>8000000000,resource_type='document'}" |
| リソース読み込み平均時間 | R::resource:(avg(resource_load) as加载耗时) {app_id = '<应用 ID>',resource_type!='document'}" |
| LCP (largest_contentful_paint) | サポートする集計関数: avg、percentileR::view:(avg(largest_contentful_paint)){app_id = '<应用 ID>'}R::view:(percentile(largest_contentful_paint,75)){app_id = '<应用 ID>'}R::view:(percentile(largest_contentful_paint,90)){app_id = '<应用 ID>'}R::view:(percentile(largest_contentful_paint,99)){app_id = '<应用 ID>'} |
| FID (first_input_delay) | サポートする集計関数: avg、percentileR::view:(avg(first_input_delay)){app_id = '<应用 ID>'}R::view:(percentile(first_input_delay,75)){app_id = '<应用 ID>'}R::view:(percentile(first_input_delay,90)){app_id = '<应用 ID>'}R::view:(percentile(first_input_delay,99)){app_id = '<应用 ID>'} |
| CLS (cumulative_layout_shift) | サポートする集計関数: avg、percentileR::view:(avg(cumulative_layout_shift)){app_id = '<应用 ID>'}R::view:(percentile(cumulative_layout_shift,75)){app_id = '<应用 ID>'}R::view:(percentile(cumulative_layout_shift,90)){app_id = '<应用 ID>'}R::view:(percentile(cumulative_layout_shift,99)){app_id = '<应用 ID>'} |
| FCP (first_contentful_paint) | サポートする集計関数: avg、percentileR::view:(avg(first_contentful_paint)){app_id = '<应用 ID>'}R::view:(percentile(first_contentful_paint,75)){app_id = '<应用 ID>'}R::view:(percentile(first_contentful_paint,90)){app_id = '<应用 ID>'}R::view:(percentile(first_contentful_paint,99)){app_id = '<应用 ID>'} |
Android / iOS のメトリクス説明¶
| メトリクス | DQL クエリ例 |
|---|---|
| 起動時間 | R::action:(avg(duration)) { app_id = '<应用 ID>' ,action_type='app_cold_launch'}" |
| 総クラッシュ数 | R::error:(count(error_type)) {app_id='<应用 ID>',error_source = 'logger' and is_web_view !='true'}" |
| 総クラッシュ率 | eval(A.a1/B.b1, alias='总崩溃率',A="R::error:(count(error_type) as a1) {app_id='<应用 ID>',error_source = 'logger',is_web_view !='true'} ",B="R::action:(count(action_name) as b1) { app_id = '<应用 ID>',action_type in [launch_cold,launch_hot,launch_warm]} ")" |
| リソースエラー数 | R::resource:(count(resource_url) as资源错误数) {resource_status >=400, app_id = '<应用 ID>'}" |
| リソースエラー率 | eval(A/B, alias='资源错误率', A="R::resource:(count(resource_url)) { resource_status >= '400',app_id = '<应用 ID>' }", B="R::resource:(count(resource_url)) { app_id = '<应用 ID>' }") |
| 平均 FPS | R::view:(avg(fps_avg)) { app_id = '<应用 ID>' }" |
| ページ読み込み平均時間 | R::view:(avg(loading_time)) { app_id = '<应用 ID>' }" |
| リソース読み込み平均時間 | R::resource:(avg(duration)) { app_id = '<应用 ID>' }" |
| スタッター回数 | R::long_task:(count(view_id)) { app_id = '<应用 ID>' }" |
| ページエラー率 | eval(A/B, alias='页面错误率',A="R::view:(count(view_name)) {view_error_count > 0, app_id = '<应用 ID>' }",B="R::view:(count(view_name)) { app_id = '<应用 ID>' }")" |
トリガー条件¶
トリガー条件と重要度を設定します。クエリ結果が複数ある場合、いずれかの値がトリガー条件を満たすとイベントが生成されます。
致命的、重大、重要、警告の 4 段階のしきい値、および正常の復旧条件を設定できます。
| レベル | 設定 | 説明 |
|---|---|---|
| 致命的 | Result >= [値] の場合 |
最高レベルのアラートであり、直ちに対処する必要があります |
| 重大 | Result >= [値] の場合 |
高レベルのアラートであり、優先的に対処する必要があります |
| 重要 | Result >= [値] の場合 |
中レベルのアラートであり、注意を払う必要があります |
| 警告 | Result >= [値] の場合 |
低レベルのアラートであり、留意する必要があります |
| 正常 | [N] 回の検知でイベントが発生しない |
検知ルールの有効化後、設定されたカスタム検知回数内でデータ検知結果が異常(致命的、重大、重要、警告)から正常に復旧した場合、復旧アラートイベントがトリガーされます。 ❗️復旧アラートイベントはアラートミュートの制限を受けません。復旧アラートイベントの検知回数を設定していない場合、アラートイベントは復旧せず、イベント > 未復旧イベント一覧に表示され続けます |
詳細はイベントレベル説明を参照してください。
詳細オプション¶
連続トリガー判定¶
有効にすると、トリガー条件を継続的に満たした場合にのみイベントを生成し、一時的な変動による誤検知を防ぎます(❗️設定の上限は最大 10 回です)。
大量アラート保護¶
システムではデフォルトで有効になっています。
1 回の検知で生成されるアラート数がプリセットのしきい値を超えると、システムは自動的にステータス別集約ポリシーに切り替わります。アラート対象を 1 件ずつ処理するのではなく、イベントステータスに基づいて少数のサマリーアラートを生成してプッシュします。
これにより、通知の迅速性を確保しつつアラートノイズを大幅に削減し、過剰なアラート処理によるタイムアウトのリスクを回避できます。
このスイッチが有効な場合、以降モニターが異常を検知して生成されるこの種のイベント詳細には、履歴と関連イベントが表示されません。
データ欠損¶
検知メトリクスの検知期間内のクエリ結果が空の場合の処理ポリシーです:
| オプション | 説明 |
|---|---|
| イベントをトリガーしない(デフォルト) | データがない場合はイベントをトリガーしません。データ欠損を許容するユースケースに適しています。 |
| クエリ結果を 0 とみなす | 空のデータを 0 とみなし、設定されたトリガー条件に従って異常イベントを生成するかどうかを引き続き判定します。 |
| データ欠損イベントをトリガー | 同一オブジェクトで欠損が発生するたびに 1 回データ欠損イベントを生成し、復旧後に再度欠損した場合は新たに生成できます。 |
| データ欠損イベントを継続的にトリガー | 同一オブジェクトが欠損条件を継続的に満たす場合、検知頻度に従って欠損イベントを生成し、データが復旧するまで続きます。設定方法はデータ欠損を参照してください。 |
| 致命的イベントをトリガー | データがない場合に致命的レベルのイベントをトリガーします。 |
| 重大イベントをトリガー | データがない場合に重大レベルのイベントをトリガーします。 |
| 重要イベントをトリガー | データがない場合に重要レベルのイベントをトリガーします。 |
| 警告イベントをトリガー | データがない場合に警告レベルのイベントをトリガーします。 |
| 復旧イベントをトリガー | データがない場合に復旧イベントをトリガーします。 |
イベントをトリガーするアクションを選択したら、欠損期間を入力します。≥ 検知期間の時間間隔に設定することを推奨します。欠損と異常条件が同時に満たされた場合、システムは欠損の処理結果を優先して適用します。
トリガー条件、データ欠損、情報生成を同時に設定した場合、次の優先順位でトリガーを判定します:データ欠損 > トリガー条件 > 情報イベント生成。
つまり、まず欠損かどうかを判定し、次にしきい値をトリガーするかどうかを判定し、最後に情報イベントを生成するかどうかを判定します。
情報生成¶
このオプションを有効にすると、情報生成条件を設定する必要があります。検知結果が「致命的」「重大」「重要」「警告」のいずれのしきい値もトリガーせず、かつ情報生成条件を満たす場合にのみ、システムは「情報」イベントを書き込みます。
正常状態の変化や低優先度の情報を記録する必要があるユースケースに適しています。
後続の設定¶
上記の検知設定が完了したら、続いて以下を設定してください: