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

イベント

lyrelog events は、エクスプローラーのフィルターで検索し、新しいイベントをライブで追いかけ、1 件のイベントを詳しく表示します。

lyrelog events は、ターミナルで使うエクスプローラーです。プロジェクトのイベントを新しい順に一覧します。特に指定しなければ、過去 24 時間分です。lyrelog logs や lyrelog log でも呼び出せます。

lyrelog events --level warning+ --since 7d
Tilefall · 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, --querymessage、領域、属性を検索
--category領域(category):checkout、"a|b"、"!a"
--attr属性。path:value、否定なら path!:value。複数指定するには繰り返します。
--user1 人のユーザーの ID(アプリが送る user_id)
--session1 つのセッションの ID
--install1 つのインストールの ID
--versionアプリのバージョン:2.4.0、または "2.4.0|2.4.1"
--platformプラットフォーム:ios、android、web、python など
--deviceデバイスのモデル
--osOS のバージョン
--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-first
Tilefall · 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 -f
Tilefall · production · following, Ctrl-C to stop

10:41:52 ▌info     app_launch  app  cold_start_ms=612 launch_reason=icon

lyrelog 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 7d
Tilefall · 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 7d
Tilefall · 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        8
lyrelog events values attr.board.size
フラグ内容
--searchこれを含む値だけ

events のフィルターと期間のフラグも使えます。

events attributes

イベントが持つ属性のパスを、多い順に表示します。lyrelog events attrs でも呼び出せます。

lyrelog events attributes --of game_won --numeric
Attribute   Events
hints_used     360
seconds        360
フラグ内容
--ofこれらのイベント(message)に限定:"a|b"
--numeric数値を持つ属性だけ。insights trend --metric value でグラフにできるものです

events のフィルターと期間のフラグも使えます。