DocsDigest
Back to listLanguage: JA
ClaudeCloudflare 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.

claudeenmodel: claude-sonnet-4-20250514

Workers Observability Adds Structured Query Language for Logs and Traces

workersobservabilityquery-languageloggingtracingfilteringcloudflare

Key Points

  • Structured query language for Workers logs and traces
  • Integrated Query Builder with visual and text interfaces
  • Support for field queries, functions, and boolean logic

Summary

Cloudflare Workers Observability now supports a structured query language that enables developers to write precise queries directly in the search bar to filter logs and traces. The feature combines free-text search capabilities with field-level filtering and integrates with a visual Query Builder.

Key Points

  • Dual Search Interface: Search bar functions as both free-text search and structured query interface with autocomplete suggestions
  • Query Builder Integration: Hand-written queries sync with visual Query Builder sidebar for seamless workflow between manual and visual query construction
  • Comprehensive Query Support:
    • Free text search with keyword matching and exact phrase search using quotes
    • Field-level queries with comparison operators (=, !=, >, >=, <, <=, :)
    • Built-in functions: contains(), startsWith(), regex(), exists()
    • Boolean logic operators: AND, OR, NOT
  • Developer Experience: Built-in help documentation with full syntax reference and keyboard shortcuts accessible via help icon

Full Translation

Translations

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

claudejamodel: claude-sonnet-4-20250514

Workers - 構造化クエリを記述してWorkersのログとトレースをフィルタリング・検索する

構造化クエリを記述してWorkersのログとトレースをフィルタリング・検索する

2026年2月25日

Workers Observabilityに、検索バーで直接構造化クエリを記述してログとトレースをフィルタリングできるクエリ言語が追加されました。

検索バーは自由テキスト検索ボックスとしても機能します。任意の用語を入力してすべてのメタデータと属性を検索したり、正確なフィルタリングのためにフィールドレベルのクエリを記述したりできます。

検索バーで記述されたクエリはQuery Builderサイドバーと同期するため、手動でクエリを記述してからビジュアルに調整したり、Query Builderでフィルターを構築して対応するクエリ構文を確認したりできます。

検索バーでは、入力時にメタデータフィールドと演算子のオートコンプリート候補が表示されます。

クエリ言語の機能

  • 自由テキスト検索 — errorのようなキーワードでどこでも検索、または"exact phrase"で完全一致フレーズを検索
  • フィールドクエリ — 比較演算子を使用して特定のフィールドでフィルタリング（例：status = 500または$workers.wallTimeMs > 100）
  • 演算子 — =、!=、>、>=、<、<=、および:（含む）
  • 関数 — contains(field, value)、startsWith(field, prefix)、regex(field, pattern)、およびexists(field)
  • ブール論理 — AND、OR、NOTで条件を追加

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

Workers Observabilityダッシュボードでクエリ言語をお試しください。