Query Language for Workers Observability

Cloudflare has added a query language to Workers Observability, enabling developers to write structured queries directly in the search bar to filter logs and traces. The search bar functions as both a free text search box for broad keyword searches and a field-level query interface for precise filtering.

Key Features

The query language supports:

• Free text search — search everywhere with keywords like error, or match exact phrases with "exact phrase"
• Field queries — filter by specific fields using comparison operators (e.g., status = 500 or $workers.wallTimeMs > 100)
• Operators — =, !=, >, >=, <, <=, and : (contains)
• Functions — contains(field, value), startsWith(field, prefix), regex(field, pattern), and exists(field)
• Boolean logic — combine conditions with AND, OR, and NOT

Developer Workflow

Queries written in the search bar sync with the Query Builder sidebar, allowing developers to write queries by hand and refine them visually, or build filters in the Query Builder and see the corresponding query syntax. The search bar provides autocomplete suggestions for metadata fields and operators as you type, reducing the learning curve for new users.

Access the query language via the Workers Observability dashboard, where a help icon provides a full syntax reference including all supported operators, functions, and keyboard shortcuts.