DocsDigest
Back to listLanguage: JA
OpenAICloudflare Developer PlatformFeb 25, 2026, 12:00 AM

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

A condensed section focused on the key takeaways first.

Original Post
OpenAIClaude

Quick Digest

Summary

A condensed section focused on the key takeaways first.

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

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

workersobservabilityquery-languagelogstracesautocomplete

Key Points

  • Structured queries in search bar
  • Query Builder syncs with typed queries
  • Autocomplete plus operators and functions

Summary

Workers Observability adds a structured query language directly in the search bar so engineers can filter and search logs and traces with both free-text and field-level queries. Typed queries are kept in sync with the Query Builder sidebar for visual editing; the search bar also provides autocomplete and a help panel with full syntax and shortcuts.

Key Points

  • Free-text search across all metadata (e.g., error or "exact phrase").
  • Field queries with comparison examples: status = 500, $workers.wallTimeMs > 100.
  • Supported operators: =, !=, >, >=, <, <=, : (contains).
  • Functions: contains(field, value), startsWith(field, prefix), regex(field, pattern), exists(field).
  • Boolean logic supported: AND, OR, NOT.
  • Autocomplete suggestions for metadata fields and operators while typing.
  • Queries sync with the Query Builder: type a query or build filters visually and switch between them.
  • Open the help icon next to the search bar for the full syntax reference and shortcuts.
  • Try it in the Workers Observability dashboard ↗.

Full Translation

Translations

A translation section that keeps the flow of the original article.

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 ↗ に移動してください。