Today we are happy to release version 1.0.0 of PromLens! PromLens is the ultimate power tool for PromQL that helps you build, analyze, explain, and visualize your queries. In case you are unfamiliar with it, try a quick demo here.

Here is a summary of the most important changes since the last release that help you edit your PromQL expressions more confidently and effectively:

A new labels explorer

PromLens 1.0.0 extends the existing metrics explorer by allowing you to drill down into the label names and values of a specific metric name. This helps you get a quick idea of the available labels on a metric, their individual cardinality, and the number of series they produce. The labels explorer also allows you to progressively add label matching filters to narrow down the result. Finally, you can then insert the constructed selector into your text input:

New PromQL features

This version adds support for a number of new PromQL features that were added in Prometheus version 2.25.0 and 2.26.0. This includes support for the new PromQL functions last_over_time(), sgn(), and clamp(), as well as for the new experimental negative offsets in selectors and the new @ modifier that allows setting a non-relative evaluation timestamp for a selector or subquery.

The editor for the new @ modifier looks like this:

What does 1.0.0 mean?

Since PromLens is fairly mature by now, we just thought that the version number should reflect this. Other than that, nothing much will change. We already avoided most breaking changes in the past, but will be sure to increment the major version whenever a breaking change (affecting command-line flags, supported integrations, stored shared links, or similar) is required.

Become more productive with PromLens today

We are continuously improving PromLens and hope that you will enjoy these new features! You can see the full list of changes in the PromLens 1.0.0 changelog. Check out PromLens today, get the full on-premise version, and report any issues or feature requests you may encounter.

Trying out the free preview version of PromLens is as simple as:

docker run -p 8080:8080 promlabs/promlens:latest

...and navigating to https://localhost:8080/ in your browser.

Happy PromQL editing!