イベント
lyrelog events は、エクスプローラーのフィルターで検索し、新しいイベントをライブで追いかけ、1 件のイベントを詳しく表示します。
lyrelog events は、ターミナルで使うエクスプローラーです。プロジェクトのイベントを新しい順に一覧します。特に指定しなければ、過去 24 時間分です。lyrelog logs や lyrelog log でも呼び出せます。
lyrelog events --level warning+ --since 7dTilefall · production · last 7 days
10:30:07 ▌error cloud_save_failed sync reason=schema_mismatch record=progress status=422
10:27:43 ▌error cloud_save_failed sync reason=schema_mismatch record=progress status=422
10:24:48 ▌error cloud_save_failed sync reason=schema_mismatch record=progress status=422
10:22:05 ▌error cloud_save_failed sync reason=schema_mismatch record=progress status=422
10:17:06 ▌error chat_socket_gave_up chat attempts=4 match_id=0d9acb1f-503f-4818-a5a1-19336d1f0d8a
Showing 5 events. For more: --cursor MTc5NTE2NjIyNjExMTo3...1 行目にはプロジェクト、環境、期間が表示されます。各イベントは 1 行で、時刻、レベル、名前(message)、領域(category)、属性が並びます。別の日のイベントには日付も表示されます。
フィルター
フィルターはエクスプローラーと同じで、エクスプローラーの URL と同じ書き方が使えます。複数の値のどれかなら "a|b"、その値以外なら "!a" です。| と ! はシェルにとって意味があるので、引用符で囲んでください。
| フラグ | 絞り込む対象 |
|---|---|
--level | レベル:error、error,critical、または warning 以上なら warning+。レベルは trace、debug、info、notice、warning、error、critical です。 |
--message | イベント名(message)の完全一致 |
-q, --query | message、領域、属性を検索 |
--category | 領域(category):checkout、"a|b"、"!a" |
--attr | 属性。path:value、否定なら path!:value。複数指定するには繰り返します。 |
--user | 1 人のユーザーの ID(アプリが送る user_id) |
--session | 1 つのセッションの ID |
--install | 1 つのインストールの ID |
--version | アプリのバージョン:2.4.0、または "2.4.0|2.4.1" |
--platform | プラットフォーム:ios、android、web、python など |
--device | デバイスのモデル |
--os | OS のバージョン |
--country | 国コード:ES、または "ES|PT" |
--locale | ロケール:es_ES |
--verified | 送信元の証明方法:server、app_attest、key_attestation、none。"!none" で検証済みイベントだけに絞れます。 |
--env | 環境。デフォルトはダッシュボードと同じくプロジェクトのデフォルト環境です。all ですべての環境を検索します。 |
lyrelog events --attr board.size:9 --attr result!:win
lyrelog events --level error --version "2.4.0|2.4.1" --platform '!web'
lyrelog events --user pl-fe0958c6 --since 7d --limit 500
lyrelog events --verified '!none'
lyrelog events --env all -q "card declined"デフォルトの環境はプロジェクトのものなので、development で送られたイベントは、--env development か --env all を渡さない限り表示されません(環境を参照)。
期間
| フラグ | 内容 |
|---|---|
--since | 現在までの期間:15m、1h、6h、24h、7d、30d、または任意の数値に s、m、h、d、w を付けたもの。デフォルトは 24h。 |
--from | 開始 |
--to | 終了。デフォルトは現在。 |
--oldest-first | 期間の始まりから、古い順に表示 |
--from と --to には次の形式を指定できます。
- RFC 3339:
2026-11-19T10:00:00Z - コンピューターのタイムゾーンでの日付と時刻:
2026-11-19 10:00 - 日付:
2026-11-19。コンピューターのタイムゾーンでのその日の午前 0 時を意味します - Unix ミリ秒(
1763550000000)または秒 - どれくらい前か:
2h、3d
--since は --from や --to と一緒には使えません。--from だけなら期間は現在で終わり、--to だけならその 24 時間前から始まります。
lyrelog events --from 3d --to 2d
lyrelog events --from 2026-11-15 --to 2026-11-16 --oldest-firstTilefall · production · Nov 15 00:00 to Nov 16 00:00
Nov 15 00:00:00 ▌info leaderboard_submit_confirmed leaderboards board=tilefall.daily.pure latency_ms=420
Nov 15 00:00:11 ▌info game_started game board.seed=4052403362615 board.size=7 m…
Nov 15 00:00:17 ▌info match_round_won multiplayer match_id=b60cc0cc-b294-46a3-9186-35c71a…件数と続き
| フラグ | 内容 |
|---|---|
-n, --limit | 最大件数。デフォルトは 100。必要に応じて最大 1,000 件ずつページを取得します。 |
--cursor | 前回の一覧が止まったところから続けます |
--limit より多くのイベントがある場合、最後の行に次のイベントを取得するための --cursor が表示されます。同じフィルターのまま、そのフラグを加えて同じコマンドをもう一度実行してください。JSON モードでは、カーソルは stderr に {"more":true,"next":"--cursor ..."} として出力されます(JSON の取り決めを参照)。
新しいイベントを追いかける
-f(--follow)は、まず過去 1 時間の最新イベントを(--limit まで、古い順に)表示し、その後は Ctrl-C を押すまで、新しいイベントが届くたびに表示します。ダッシュボードのライブモードと同じく、4 秒ごとに前回以降に Lyrelog が受け取ったものを問い合わせます。新しいイベントは届いた順に表示されるので、オフラインだったスマートフォンが遅れて送ったバッチは、届いた時点で、それぞれの(古い)時刻とともに表示されます。ただし、その時刻が過去 2 日以内の場合に限ります。
lyrelog events -fTilefall · production · following, Ctrl-C to stop
10:41:52 ▌info app_launch app cold_start_ms=612 launch_reason=iconlyrelog events -f --level error はエラーだけを追いかけます。
フィルターは通常どおり使えます。--since、--from、--to は使えません。これから届くものを表示するからです。JSON モードでは 1 行に 1 つの JSON オブジェクトを書き出します(NDJSON)。各オブジェクトには、自身の ts と並んで、Lyrelog が受け取った時刻(Unix ミリ秒)を示す received_at が入ります。しばらくサーバーに接続できないときは、stderr にその旨を表示して再試行を続けます。セッションが終了するか、プロジェクトがなくなると止まります。
events get
1 件のイベントの詳細:誰が、どこで、アプリ、デバイス、属性、payload。
lyrelog events get adea33e4-26eb-422e-b904-96649c0e7830▌ cloud_save_failed error
sync
Time 2026-11-20 10:30:07.485 CET 8m ago
Event adea33e4-26eb-422e-b904-96649c0e7830
Player pl-fe0958c6
Session 51e19a18-ca3e-4428-a10b-baeadc7eaaf8
Install 76f5a7d0-81b0-4c36-8908-eefd6c936abf
App com.example.tilefall 1.6.3 (202609301304)
Device iPhone18,2 iOS 27.2.0
Locale fr_FR
Country FR
Environment production
Platform ios
Attributes
{
"reason": "schema_mismatch",
"record": "progress",
"status": 422
}
Payload
{
"description": "The server refused the save",
"detail": "field 'mode' is not allowed in format 3; expected format 4"
}ツールは、プロジェクトが保持しているすべてのデータ(保持期間全体)の中から ID でイベントを探します。イベントの時刻を Unix ミリ秒で(JSON の ts フィールド)--ts に渡すと、その検索を省いて直接取得します。
| フラグ | 内容 |
|---|---|
--ts | イベントの時刻(Unix ミリ秒)。検索を省きます |
events summary
合計(イベント、ユーザー、セッション、エラー)と、各フィールドで多い値を、エクスプローラーのサイドパネルと同じように表示します。events と同じフィルターと期間のフラグが使えます。
lyrelog events summary --since 7dTilefall · production · last 7 days
52,886 events 300 players 3,202 sessions 1,127 errors
category game 11.6k leaderboards 10k app 7,110 daily 5,362 campaign 5,126 account 3,304
level info 36.7k debug 13.7k error 1,110 warning 1,074 notice 292 critical 17
version 2.0 30.4k 1.6.3 22.5k
...events values
フィルターの範囲内で、1 つのフィールド、または属性(attr.<path>)で多い値を表示します。エクスプローラーのフィルターメニューに出てくるものと同じです。フィールドには level、category、message、version、device、country、environment、platform、verified などがあります。
lyrelog events values message --level error --since 7dTilefall · production · last 7 days
Message Events Players
cloud_save_failed 823 124
daily_upload_failed 178 124
match_update_denied 43 38
leaderboard_submit_failed 29 17
chat_socket_gave_up 28 28
purchase_failed 9 8lyrelog events values attr.board.size| フラグ | 内容 |
|---|---|
--search | これを含む値だけ |
events のフィルターと期間のフラグも使えます。
events attributes
イベントが持つ属性のパスを、多い順に表示します。lyrelog events attrs でも呼び出せます。
lyrelog events attributes --of game_won --numericAttribute Events
hints_used 360
seconds 360| フラグ | 内容 |
|---|---|
--of | これらのイベント(message)に限定:"a|b" |
--numeric | 数値を持つ属性だけ。insights trend --metric value でグラフにできるものです |
events のフィルターと期間のフラグも使えます。