コンテンツにスキップ

macOS アプリケーションデータ収集

概要

アプリケーションデータをGuanceに収集した後、Guanceの管理画面でカスタム設定のシナリオや異常検知イベントを設定できます。

データタイプ

Guanceのリアルユーザーモニタリング（RUM）には、6種類のデータタイプがあります。

タイプ 説明
session ユーザーセッション情報の記録です。現在のセッションでは、セッション単位でユーザーページ、リソース、操作、エラー、ロングタスクに関連するアクセスデータを記録します。
view ユーザーがアプリケーションのページにアクセスするたびに、ビューレコードが生成されます。ユーザーが同じページに滞在している間、リソース、ロングタスク、エラー、操作レコードは view_id 属性を介して関連するRUMビューにリンクされます。
resource ユーザーがページにアクセスした際に読み込まれたリソース情報の記録です。
error アプリケーションが発行した例外またはクラッシュです。
long_task アプリケーション内でメインスレッドを指定された持続時間のしきい値を超えてブロックするタスクに対して、ロングタスクイベントが生成されます。
action アプリケーション内のユーザーアクティビティ（アプリケーション起動、クリック、スワイプ、戻るなど）を記録します。各アクションには一意の action_id が付与されます。

グローバル属性

RUMのシナリオ構築とイベントアラートは、以下のグローバル属性を使用してクエリできます。

SDK 属性

フィールド タイプ 説明
sdk_name string 収集プログラム名。固定値：
df_macos_rum_sdk
df_linux_rum_sdk
df_windows_rum_sdk
df_web_rum_sdk
df_miniapp_rum_sdk
df_ios_rum_sdk
df_android_rum_sdk
sdk_version string 収集プログラムのバージョン情報

アプリケーション属性

フィールド タイプ 説明
app_id string 必須。ユーザーアクセスアプリケーションの一意のIDです。Guanceの管理画面でモニターを作成する際に自動生成されます。
env string 必須。環境フィールドです。属性値：prod/gray/pre/common/local。各値の説明：
prod：本番環境
gray：カナリア環境
pre：ステージング環境
common：日常環境
local：ローカル環境
version string 必須。バージョン番号です。
service string 任意。所属するビジネスまたはサービスの名前です。固定値：
df_rum_ios
df_rum_macos
df_rum_android
df_rum_windows
df_rum_linux

ユーザー & セッション属性

フィールド タイプ 説明
userid string 未ログインユーザーはランダムな uuid を userid として使用し、ログインユーザーはアプリケーションのバックエンドで生成されたユーザーIDを使用します。
user_name string 任意。ユーザー名です。
user_email string 任意。ユーザーメールアドレスです。
session_id string セッションIDです。15分以上操作がない場合、新しい session_id が生成されます。
session_type string セッションタイプです。参考値：user & synthetics
user：RUM機能によって生成されたデータ
synthetics：ヘッドレスSynthetic テストによって生成されたデータ
is_signin boolean 登録ユーザーかどうかです。属性値：T & F。

デバイス & 解像度属性

フィールド タイプ 説明
device string デバイスメーカー
model string デバイスモデル
device_uuid string デバイスの一意のID
os string オペレーティングシステム情報
os_version string オペレーティングシステムのバージョン
os_version_major string オペレーティングシステムのメジャーバージョン
screen_size string 画面解像度

地理 & ネットワーク属性

フィールド タイプ 説明
ip string ユーザーアクセスIPアドレス
isp string 通信事業者
network_type string ネットワーク接続タイプです。属性値の参考：
wifi | 2g | 3g | 4g | 5g | unknown（不明なネットワーク）| unreachable（ネットワーク不可）
country string 国
country_iso_code string 国の ISO コード
province string 都道府県/省
city string 市区町村

カスタム属性

グローバル属性以外にも、カスタム属性（SDK はユーザーがカスタムタグデータを設定可能）を使用してシナリオを構築し、イベントアラートを設定できます。カスタム属性は非グローバル属性であり、カスタム属性を使用することで、ユーザーがアプリケーションにアクセスする全過程を追跡し、影響を受けたユーザーアクセス状況を特定・発見し、ユーザーアクセスパフォーマンスを監視できます。

その他のデータタイプ属性

Session

属性

フィールド タイプ 説明
session_id string セッションID
session_type string セッションタイプです。参考値：user & test
user：RUM機能によって生成されたデータ
test：ヘッドレスSynthetic テストによって生成されたデータ
session_referrer string セッションの参照元です。通常は参照元のページURLを記録します。
session_first_view_id string 現在のセッションの最初のページの view_id
session_first_view_name string 現在のセッションの最初のページのURL
session_last_view_id string 現在のセッションの最後にアクセスしたページの view_id
session_last_view_name string 現在のセッションの最後のページのURL

統計指標

フィールド タイプ 説明
time_spent number(ns) 現在のセッションの継続時間
session_view_count number 現在のセッションに関連する view_id の数
session_error_count number 現在のセッションで発生したエラーの数
session_resource_count number 現在のセッションで読み込まれたリソースの数
session_action_count number 現在のセッションでのユーザー操作の回数
session_long_task_count number 現在のセッションで発生したロングタスクの数

View

属性

フィールド タイプ 説明
view_id string ページアクセスごとに生成される一意のID
view_referrer string ページの参照元（親ページ）
view_name string ページ名

指標

フィールド タイプ 説明
loading_time number（ns） ページ読み込み時間
time_spent number（ns） ページ滞在時間
is_active boolean ユーザーがアクティブ状態かどうかの判定。参考値: true & false

統計指標

フィールド タイプ 説明
view_error_count number ページ読み込みごとに発生したエラーの数
view_resource_count number ページ読み込みごとにリクエストされたリソースの数
view_long_task_count number ページ読み込みごとに発生したロングタスクの数
view_action_count number ページ表示中の操作回数

監視指標

フィールド タイプ 説明
cpu_tick_count number 任意。当該ページのCPUティック数
cpu_tick_count_per_second number 任意。1秒あたりの平均CPUティック数
fps_avg number 任意。ページの平均フレームレート（FPS）
fps_mini number 任意。ページの最小フレームレート（FPS）
memory_avg number 任意。ページメモリ使用量の平均値
memory_max number 任意。ページメモリ使用量のピーク値

Resource

View 属性

フィールド タイプ 説明
view_id string ページアクセスごとに生成される一意のID
view_referrer string ページの参照元（親ページ）
view_name string ページ名

Action 属性

フィールド タイプ 説明
action_id string ユーザーのページ操作時に生成される一意のID
action_name string 操作名
action_type string 操作タイプ（コールド/ウォームスタート、クリックなどの操作）

Resource 属性

フィールド タイプ 説明
resource_url string リソースURL
resource_url_host string リソースURLのドメイン部分
resource_url_path string リソースURLのパス部分
resource_url_query string リソースURLのクエリ部分
resource_url_path_group string リソースURLのパスグループ
resource_type string リソースのカテゴリ
resource_method string リソースのリクエストメソッド
resource_status string リソースリクエストのレスポンスステータス
resource_status_group string リソースリクエストのレスポンスステータスグループ値

指標

フィールド タイプ 説明
resource_size number リソースサイズ。デフォルト単位：byte
resource_dns number（ns） リソース読み込み時のDNS解決時間
計算方法：domainLookupEnd - domainLookupStart
resource_tcp number（ns） リソース読み込み時のTCP接続時間
計算方法：connectEnd - connectStart
resource_ssl number（ns） リソース読み込み時のSSL接続時間
計算方法：connectEnd - secureConnectStart
resource_ttfb number（ns） リソース読み込み時のリクエスト応答時間
計算方法：responseStart - requestStart
resource_trans number（ns） リソース読み込み時のコンテンツ転送時間
計算方法：responseEnd - responseStart
resource_first_byte number（ns） リソース読み込み時の最初のバイト到着時間
計算方法：responseStart - domainLookupStart
duration number（ns） リソース読み込み時間
計算方法：duration (responseEnd-startTime)
request_header string リソースリクエストヘッダー
response_header string リソースレスポンスヘッダー

Error

View 属性

フィールド タイプ 説明
view_id string ページアクセスごとに生成される一意のID
view_referrer string ページの参照元（親ページ）
view_name string ページ名

Action 属性

フィールド タイプ 説明
action_id string ユーザーのページ操作時に生成される一意のID
action_name string 操作名
action_type string 操作タイプ（コールド/ウォームスタート、クリックなどの操作）

Error 属性

フィールド タイプ 説明
error_source string エラーの発生源。参考値：logger | network
error_type string エラータイプ
logger エラータイプ: java_crash | native_crash | anr_error | anr_crash | ios_crash
network エラータイプ：network_error
error_situation string エラーが発生したタイミング。参考値：startup（起動時）と run（実行時）

type=networkの場合、以下のNetwork Error属性が追加されます。

フィールド タイプ 説明
resource_status string リソースリクエストのレスポンスステータス値
resource_url string リソースURL
resource_url_host string リソースURLのドメイン部分
resource_url_path string リソースURLのパス部分
resource_url_path_group string リソースURLのパスグループ
resource_method string リソースのリクエストメソッド

Error 監視属性

フィールド タイプ 説明
memory_total string 任意。メモリ総量
memory_use number 任意。メモリ使用率
cpu_use number 任意。CPU使用率
battery_use number 任意。現在のデバイスのバッテリー残量
locale string 現在のシステム言語

指標

フィールド タイプ 説明
error_message string エラーメッセージ
error_stack string エラースタックトレース

Long Task

View 属性

フィールド タイプ 説明
view_id string ページアクセスごとに生成される一意のID
view_referrer string ページの参照元（親ページ）
view_name string ページ名

Action 属性

フィールド タイプ 説明
action_id string ユーザーのページ操作時に生成される一意のID
action_name string 操作名
action_type string 操作タイプ（コールド/ウォームスタート、クリックなどの操作）

指標

フィールド タイプ 説明
duration number（ns） 処理遅延時間
long_task_message string 処理遅延情報
long_task_stack string 処理遅延スタックトレース

Action

View 属性

フィールド タイプ 説明
view_id string ページアクセスごとに生成される一意のID
view_referrer string ページの参照元（親ページ）
view_name string ページ名

Action 属性

フィールド タイプ 説明
action_id string ユーザーのページ操作時に生成される一意のID
action_name string 操作名
action_type string 操作タイプ（コールド/ウォームスタート、クリックなどの操作）

指標

フィールド タイプ 説明
duration number（ns） ページ操作にかかった時間

統計指標

フィールド タイプ 説明
action_long_task_count number 操作に関連するロングタスクの数
action_resource_count number 操作に関連するリソースリクエストの数
action_error_count number 操作に関連するエラーの数

フィードバック

このページは役に立ちましたか？