エラー、セッション、ユーザー
ダッシュボードの Errors、Sessions、People、Releases、Insights、Usage の各ページを、コマンドで。
これらのコマンドは、ダッシュボードの各ページと同じ内容を表示します。usage 以外は 1 つのプロジェクトを対象とし、lyrelog events のフィルターと期間のフラグ(--level、--attr、--version、--platform、--env、--since、--from、--to など)が使えます。期間は、特に指定しなければ過去 7 日間です。
例では、ユーザーを players と呼ぶプロジェクトを使っています。ツールはプロジェクトごとの呼び名を使います(プロジェクトの設定を参照)。
エラー
lyrelog errors(または lyrelog issues)は Errors ページにあたります。error と critical のイベントを、領域とイベント名でグループ化し、深刻なものから表示します。各行には、発生回数、直前の同じ長さの期間との比較、影響を受けたユーザー数、最後に発生した時刻、発生したバージョン、推移が表示されます。
lyrelog errorsTilefall · production · last 7 days
Event Area Count Change Players Last seen Versions Trend
● cloud_save_failed sync 823 new 124 7m ago 1.6.3 ▄▇▁▄▇▂▅▇▁▃▇▂▄▇▂▄▇▁▄█▂▁
● daily_upload_failed daily 178 new 124 32m ago 2.0, 1.6.3 ▄▄ ▃▅ ▃▇▂▃█▂▄▇▁▄▄▂▂▅▂▂
● match_update_denied multiplayer 43 new 38 38m ago 2.0, 1.6.3 ▂▇ ▄▅ ▂▂ █▂▄▅█▂▄▇ ▅▇ ▂
● chat_socket_gave_up chat 28 new 28 20m ago 2.0, 1.6.3 ▃▃ ▆█▃ █ ▆▆ ▆▆▃▃▃ ▃█ ▆
● leaderboard_submit_fa… leaderboards 29 new 17 1d ago 2.0, 1.6.3 █
● database_open_failed app 17 new 16 26m ago 2.0, 1.6.3 ▃▃▆▃ ▃ ▃▃ ▃▃▆▃ █ ▃
● purchase_failed purchases 9 new 8 12h ago 2.0, 1.6.3 ▄ █ █ ▄ ▄▄ ▄| フラグ | 内容 |
|---|---|
--warnings | warning も数えます |
lyrelog errors --since 24h --warnings
lyrelog errors --version 2.4.1 --json | jq '.[0]'JSON では、各問題に sample_event、sample_user、sample_session が入っていて、そのまま lyrelog events get、lyrelog person、lyrelog events --session に渡せます。
セッション
lyrelog sessions は Sessions ページにあたります。誰が、どれくらいの時間、イベントとエラーの数、デバイスとバージョン、最初と最後のイベント(エラーがあれば最初のエラーも)を表示します。
lyrelog sessions --with-event purchase_failed --sort longestTilefall · production · last 7 days
Started Player Length Events Errors Device Version From → to Session
3d ago pl-3860c35c 37m 21s 34 1 iPad14,1 2.0 app_launch → app_background ✗ purchase_fai… cfc2523d-c1a3-4b4f-b576-53d98d2826e1
12h ago pl-6405980a 28m 15s 24 1 iPhone17,1 1.6.3 app_launch → app_background ✗ purchase_fai… e567122a-70f9-42de-9f5b-f088684aa0a2
1d ago pl-dcb099d1 23m 23s 25 1 iPhone18,1 2.0 app_launch → app_background ✗ purchase_fai… c8c02c07-0f64-4d20-9575-835f2758432f| フラグ | 内容 |
|---|---|
--errors | エラーのあるセッションだけ |
--with-event | このイベント(message)を含むセッションだけ |
--min-duration | この長さ以上のセッションだけ:30s、5m |
--sort | recent(デフォルト)、longest、errors、events |
--page | ページ。1 ページ 50 セッションで、0 から数えます |
1 つのセッションのイベントを順に読むには、その ID(JSON の sid フィールド)を lyrelog events --session <id> --oldest-first に渡します。
ユーザー
lyrelog people は People ページにあたります。期間内にアプリを使ったユーザーを、イベント、セッション、エラー、最新のデバイスとバージョンとともに表示します。lyrelog users や lyrelog players でも呼び出せます。
lyrelog people --sort errorsTilefall · production · last 7 days
Player Events Sessions Errors Last seen First seen Device Version OS Country
pl-4e5d999b 553 30 24 1h ago 6d ago iPhone18,2 1.6.3 iOS 27.0.3 ES
pl-eb2cd82f 455 27 24 7h ago 6d ago iPad16,6 1.6.3 iOS 27.2.0 IT
pl-519465f0 443 27 20 11h ago 6d ago iPad14,1 1.6.3 iOS 27.0.3 FR
50 of 300 players. Next: --page 1| フラグ | 内容 |
|---|---|
--search | これで始まる ID |
--sort | last_seen(デフォルト)、events、errors、sessions、first_seen |
--page | ページ。1 ページ 50 人で、0 から数えます |
1 人のユーザー
lyrelog person <user-id>(または user、player)は、1 人のユーザーのページにあたります。イベントの数、最近のセッション、最新のイベントを表示します。ID はアプリが送る user_id で、完全一致で照合します。
lyrelog person pl-fe0958c6 -n 4Player pl-fe0958c6 in Tilefall
290 events in all, first 6d ago, last 8m ago
Sessions last 7 days
Started Length Events Errors Device Version From → to Session
8m ago 40s 5 1 iPhone18,2 1.6.3 app_launch → app_background ✗ cloud_save_failed 51e19a18-ca3e-4428-a10b-baeadc7eaaf8
2h ago 23m 58s 23 1 iPhone18,2 1.6.3 app_launch → app_background ✗ cloud_save_failed 2f396cf7-4741-4102-acba-abe64fe9b31e
12h ago 20m 38s 19 0 iPhone18,2 1.6.3 app_launch → app_background 5e9f9fee-7158-4ed1-87eb-46c6585d658e
Latest events
10:30:36 ▌info app_background app seconds_open=11
10:30:07 ▌error cloud_save_failed sync reason=schema_mismatch record=progress status=422
10:29:58 ▌info sign_in_completed account latency_ms=641 method=apple
10:29:57 ▌debug api_request network latency_ms=187 path=/app-version status=200
Everything of theirs: lyrelog events --user pl-fe0958c6 --since 7d| フラグ | 内容 |
|---|---|
-n, --limit | 表示する最近のイベントの数。デフォルトは 20。 |
--since, --from, --to | セッションとイベントの期間。デフォルトは 7d。 |
--env, --platform | events と同じ |
--export <file> | そのユーザーのすべてのイベントを JSON lines としてこのファイルに書き出します。- なら stdout |
--delete | そのユーザーのすべてのイベントを削除します(オーナーのみ。元に戻せません) |
-y, --yes | --delete と一緒に使い、確認を求めません |
プライバシーに関する請求
ダッシュボードの A person's data ツールと同じものです(プライバシーに関する請求を参照)。
lyrelog person pl-fe0958c6 --export pl-fe0958c6.ndjson # an access request (any member)
lyrelog person pl-fe0958c6 --export - | jq .message
lyrelog person pl-fe0958c6 --delete # an erasure request (owners)--delete は、確認のためにユーザーの ID を入力するよう求めます。JSON モードでは誰も答えられないので、--yes が必要です。
リリース
lyrelog releases(または lyrelog versions)は Releases ページにあたります。アプリのバージョンごとに、ユーザー、セッション、エラーのないセッションの割合、エラーと critical のイベント、最初と最後に見られた時刻を表示します。
lyrelog releasesTilefall · production · last 7 days
Version Players Sessions Without errors Errors Critical First seen Last seen
2.0 171 1,849 90% 194 13 6d ago 10m ago
1.6.3 129 1,353 36% 933 4 6d ago 7m agoインサイト
lyrelog insights は Insights ページにあたります。何かがどれくらい起きるか(trend)、どれくらい失敗するか(rate)、ユーザーがフローのどこまで進むか(funnel)を表示します。
insights trend
1 つ以上のイベントが時間とともにどれくらい起きるかを、必要なら内訳付きで表示します。
lyrelog insights trend game_won --by versionTilefall · production · last 7 days
Event Group Events Over time
game_won 2.0 1,552 ████▇▇▆▂
game_won 1.6.3 1,098 ▇██████▂lyrelog insights trend game_won --metric users --since 30d
lyrelog insights trend game_won --metric value --value-path seconds --stat p90| フラグ | 内容 |
|---|---|
--by | version、country、attr:<path> で内訳を出します |
--metric | events(デフォルト)、users(ユーザー数)、value(数値の属性) |
--value-path | --metric value のとき:数値を持つ属性 |
--stat | --metric value のとき:avg、p50、p90、p95、p99、max |
数値を持つ属性は lyrelog events attributes --numeric で一覧できます。
insights rate
あるイベントの集合が別の集合に占める割合です。たとえば試行に対する失敗の割合です。
lyrelog insights rate --hits purchase_failed --of "purchase_started|purchase_failed"Tilefall · production · last 7 days
Event Rate Hits / tries Over time
purchase_failed of purchase_started, purchase_failed 10.59% 9 / 85 ▁▅██▅▇▅▁| フラグ | 内容 |
|---|---|
--hits | 数えるイベント(失敗):"a|b" |
--of | 分母となるイベント(試行):"c|d" |
--by | version、country、attr:<path> で内訳を出します |
insights funnel
フローの各ステップに順番どおり到達したユーザーの数と、各ステップにかかった時間を表示します。イベントを 2 つ以上指定します。
lyrelog insights funnel app_launch game_started game_won --window 1hTilefall · production · last 7 days · within 1h
Step Players Of the first Median time
1. app_launch ████████████████████ 300 100%
2. game_started ███████████████████░ 291 97% 6m 56s
3. game_won ███████████████████░ 288 96% 5m 57s| フラグ | 内容 |
|---|---|
--window | 最初のステップから最後のステップまでに許される時間。デフォルトは 1d。 |
保存済みのビュー
lyrelog insights views は、プロジェクトの保存済みビューを一覧します。lyrelog insights delete-view <id> はビューを 1 つ削除します。事前に確認を求め、JSON モードでは --yes が必要です。
使用量
lyrelog usage は、所属する組織ごとに、今月のイベント数をプランと比べて表示し、それがプロジェクト間でどう分かれているかも示します(プランと使用量を参照)。
lyrelog usageAlex Rivera · Free plan
██░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 5.3%
52,925 of 1,000,000 events a month · counts start again on Dec 1
█ per day
Project Events Share
Tilefall 52,925 100%| フラグ | 内容 |
|---|---|
--org | 1 つの組織を ID か名前で指定。デフォルトは所属するすべての組織。 |