OpenAICloudflare Developer Platform2026/02/25 0:00

Workers - Write structured queries to filter and search your Workers logs and traces

要点だけを先に読めるように短く再構成したセクションです。

元記事

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

openaijamodel: gpt-5-mini-2025-08-07

Workers で構造化クエリによるログ/トレース検索が可能に

Key Points

  • 検索バーで構造化クエリ
  • Query Builder と同期
  • オートコンプリートと関数サポート

Summary

Workers Observability にクエリ言語が追加され、検索バーで直接構造化クエリを書いてログやトレースをフィルタできます。フリーテキスト検索とフィールド単位の条件を併用でき、入力は Query Builder サイドバーと同期します。オートコンプリートでフィールド名や演算子を補助し、ヘルプアイコンから構文参照を確認できます。

Key Points

  • フリーテキスト検索: 単語例 error、フレーズ例 "exact phrase" で全メタデータを検索
  • フィールドクエリ: 例 status = 500$workers.wallTimeMs > 100。比較演算子は =, !=, >, >=, <, <=, :(contains)
  • 関数サポート: contains(field, value), startsWith(field, prefix), regex(field, pattern), exists(field)
  • 論理演算: 条件の組合せに AND, OR, NOT を使用
  • 実務ヒント: 手入力で構築してから Query Builder で視覚的に微調整、オートコンプリートで正しいフィールドと演算子を選ぶ
  • 参照: 検索バー横のヘルプアイコンで完全な構文参照とキーボードショートカットを確認。Workers Observability ダッシュボードで操作を試してください。

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

openaijamodel: gpt-5-mini-2025-08-07

Workers — 構造化クエリで Workers のログとトレースをフィルタ/検索する

Workers — 構造化クエリで Workers のログとトレースをフィルタ/検索する

Workers Observability では、検索バーに直接構造化クエリを書いてログとトレースをフィルタリングできるクエリ言語を導入しました。検索バーはフリーテキスト検索ボックスとしても機能します — 任意の語句を入力してすべてのメタデータと属性を横断的に検索するか、フィールド単位のクエリを記述して精密にフィルタできます。

検索バーに書いたクエリは Query Builder サイドバーと同期するため、手でクエリを書いてから視覚的に調整したり、Query Builder でフィルタを構築して対応するクエリ構文を確認したりできます。検索バーは入力中にメタデータフィールドや演算子のオートコンプリート候補を表示します。

クエリ言語は次をサポートします:

  • フリーテキスト検索 — error のようなキーワードで全体を検索、または "exact phrase" のように正確なフレーズ一致
  • フィールドクエリ — 比較演算子を使って特定フィールドでフィルタ(例: status = 500$workers.wallTimeMs > 100
  • 演算子 — =, !=, >, >=, <, <=, および :(contains)
  • 関数 — contains(field, value), startsWith(field, prefix), regex(field, pattern), exists(field)
  • ブール論理 — AND, OR, NOT で条件を組み合わせ

検索バーの横にあるヘルプアイコンを選択すると、サポートされるすべての演算子、関数、キーボードショートカットを含む完全な構文リファレンスを表示できます。

クエリ言語を試すには、Workers Observability dashboard ↗ に移動してください。