アーリーアクセス招待制です。SDK はまだ公開されていません。招待をリクエスト
本文へスキップ
ドキュメント

エラー、セッション、ユーザー

ダッシュボードの 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 errors
Tilefall · 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      ▄  █  █ ▄  ▄▄  ▄
フラグ内容
--warningswarning も数えます
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 longest
Tilefall · 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
--sortrecent(デフォルト)、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 errors
Tilefall · 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
--sortlast_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 4
Player 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, --platformevents と同じ
--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 releases
Tilefall · 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 version
Tilefall · 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
フラグ内容
--byversion、country、attr:<path> で内訳を出します
--metricevents(デフォルト)、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"
--byversion、country、attr:<path> で内訳を出します

insights funnel

フローの各ステップに順番どおり到達したユーザーの数と、各ステップにかかった時間を表示します。イベントを 2 つ以上指定します。

lyrelog insights funnel app_launch game_started game_won --window 1h
Tilefall · 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 usage
Alex 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%
フラグ内容
--org1 つの組織を ID か名前で指定。デフォルトは所属するすべての組織。