Message Filtering

Message Filtering

HZN Queue Console lets you search and filter messages within a queue without consuming them. Filters are applied on top of the fetched message set and update results as you type.

Opening the Filter Bar

Select a queue to open the message browser, then click the Filter bar above the message table (or press / to focus it).

Filter Types

Type any string to match against the raw message payload. The match is case-insensitive and works on any content type — JSON, XML, plain text, or binary (shown as hex).

Example: typing invoice_id will show only messages whose payload contains that string.

Correlation ID

Filter by exact or partial correlationId. Useful when tracing a single request through multiple queues.

Message ID

Filter by the AMQP messageId property. Useful when you know the exact message you’re looking for.

Routing Key

Filter by the routing key the message was published with. Supports partial matching.

Header filter

Filter by a custom header key/value pair:

  1. Enter the header key in the left field
  2. Enter the header value in the right field

Both fields support partial matching. Leave the value field empty to match any message that has the header key, regardless of value.

Combining Filters

All active filters are applied together (AND logic). A message must match every active filter to appear in the results. Clear individual filters by clicking the × next to each field, or click Clear all to reset.

Schema-Aware Filtering

If you have an AsyncAPI schema (see Schema Validation) loaded for the queue’s message type, the filter bar gains extra typed fields derived from the schema — one input per top-level property. This makes it easy to filter by domain-specific fields like customerId, orderId, or status without knowing the exact JSON path.

Table View Filters

In Table View mode, each column header has an inline filter input. These work the same as the filter bar but are scoped to that column’s value.