logs_errors

ページから送られた error レベルのログだけを、アップロードしたソースマップで解決したスタック付きで返します。

入力 出力
project、since、boxId、limit、cursor 同上。error レベルのみで stackResolved 付き

これらのツールが読むのは ParallelSandbox 自身のログサービスで、ページはブラウザ SDK でそこにログを送ります。Sentry などほかのエラートラッカーは読みません。ログプロジェクトはアプリではなく REST で作ります。アカウントのトークン(API キーか OAuth アクセストークン)で POST https://log.parallelsandbox.com/v1/projects すると、id prj_... と書き込みキー psw_... が返ります。

  • project:プロジェクト id prj_... またはその名前。アカウントにない名前は project not found で失敗し、続けてアカウントにあるプロジェクト(name (prj_...))が、1 つもなければ作り方が示されます。ParallelSandbox 自身のサービスのプロジェクトはなく、自分のサーバーやコンテナのものもありません。それらはボックスで見ます(docker logs、バックグラウンドコマンドの logPath)。
  • since:期間(15m、2h、3d、1w)、RFC3339 のタイムスタンプ、または unix 時刻。既定は 1h。
  • query:プレーンテキストは語全体として一致します。{、?、-、"、%、[ で始まるものは CloudWatch のフィルタパターンとしてそのまま使われます。例: { $.level = "warn" }、?timeout ?retry。
  • boxId:そのボックスが配信したページからのログだけに絞ります。
  • limit:1 ページの行数。既定 200、最大 1000。次のページは nextCursor を cursor として渡します。
  • logs_tail はロングポーリングです。新しい行が届けばすぐに、なければ waitSec(既定 20、最大 25)で返り、次の呼び出しに渡す cursor が付きます。cursor を省略すると今から読み始めます。
  • 各行は ts、ingestedAt、level、box、release、platform、route、msg、stack、stackResolved、extra、stream を持ちます。ログは期限なく保持されます。

すべてのツールとトピックはツールリファレンスに並んでいます。