Bzzz. Bzzz. Bzzz.
It’s 3am, your pager is going off, and you have to figure out why.
You log into Lightstep. You see spikes on your dashboards. You see alerts have been triggered. You need to find out why before you get back to sleep. At 3am (or 3pm) navigating between multiple UIs (or products) to investigate an issue by running ad hoc queries is both time consuming, and mentally exhausting.
With our Unified Query Builder, you don’t need to know explicitly which data type (metrics or traces) contains the answer for whatever investigative question(s) you have; your SREs, your dev team, or even your ops team, can now query across metrics and traces in a single, unified view.
The new Unified Query Builder is now available in Lightstep’s Notebooks (currently in beta), where users can easily document their investigative steps. This will be rolled out throughout the Lightstep Platform as we look to simplify access to all your telemetry in one place.
Why query builders are important
Modern Observability is a single braid of data, and your ability to access this data should be treated in the same way. Correlating activity across multiple data sources is a precondition for actually solving our problems. When you’re firefighting an issue, or trying to troubleshoot what went wrong with your most recent deployment, the speed with which you can access relevant information is critical.
In your observability product, you expect to be able to:
Visualize the data that is important to you so you can monitor and alert on it
Ask questions about your data so you can investigate changes to application health
For our customers, they are responsible for a variety of things: endpoints, user journeys, the experience of specific customers or regions, and/or specific shared resources in their system. No two customers are the same: for one customer, the “service” they are responsible for may be a collection of endpoints across multiple microservices; for another, a “service” is a single endpoint in a single microservice.
In both cases they’re often writing queries to translate the “things” they care about into dashboards, alerts, and ad-hoc investigative questions.
Lightstep's Query Builder - Unifying metric and trace data
It's hard to make a good query builder that suits such a large and diverse group of needs and users, and it was really important to us to get it right. Query builders run the gamut of complex to specific, powerful to simple, and anywhere in between. The challenges we saw with query builders is ensuring that it balances the needs of the novice and expert user. We wanted to create a solution that is easy for a novice to get started with, but powerful enough for an expert to be able to rely on and have the flexibility they need.
Here are the core user goals we focused on for Lightstep’s Unified Query Builder:
Speed: A user needs to quickly interact with the component to ask a question about their data - across all telemetry. Some users prefer UI selections, while others prefer to use their keyboard to tab through their options. Having a solution that can accommodate both saves precious seconds when a pager goes off at 3am (or 3pm).
More speed: The ability to quickly visualize the output of a query can save precious seconds while investigating and refining your search space. In addition to quickly visualizing a query, autocomplete populates quickly to guide users' faster, so you’re not sitting and waiting for the field to populate, again saving time and mental energy.
Flexible for all types of user: Every developer on your team should be able to ask a question about their data quickly, ensuring expert and novice users get to value fast. This means using clear and standard language to describe your telemetry and your query building options without burying you with additional education.
Easy data exploration: Sometimes you don’t know what you don’t know. With Lightstep’s Unified Query Builder, you can explore what metrics, data keys and values are available all in one place. Having the ability to “browse” your system can lead you to new discoveries about your data leading to new value for your users and customers.
Maximum expressiveness: Our query builder is able to represent the majority of use cases a user could want to represent in our system (and we're continuing to add more) to:
Monitor
Visualize
Alert on
Build an SLO on
Investigate
Regardless of the specific workflow or the telemetry type in which they want to represent that thing, Lightstep can represent and enhance that data.
Context-aware guardrails when you need them in certain workflows / states: To ensure your teams aren’t wasting time trying to create “the perfect query,”™ the query builder can leverage input validation and/or enabling (or disabling) certain input fields for a specific workflow or state:
e.g., we only want to show percentile check boxes when the user is querying a distribution metric or a latency span KPI.
Another example: Certain chart types don’t make sense when you have a group by, so we disable them as an option if your query has a group by.
Let’s get started!
Want to try out our Unified Query Builder?
Explore more articles

Strengthening our commitment to the OpenTelemetry project
Carter Socha | Apr 20, 2023Lightstep is the first company to natively provide customers with complete control of their telemetry pipeline which saves time and money, and provides the freedom to innovate at scale. By embracing OpenTelemetry support without vendor lock-in, Lightstep helps you make complex app development easier and faster.
Learn moreLearn more
Transform ServiceNow workflows with Service Graph Connector for Observability - Lightstep
Andrew Gardner | Dec 20, 2022The Service Graph Connector for Observability - Lightstep is the bridge between IT Operations and DevOps teams. When combined with ITOM Visibility, it provides organizations with a complete, end-to-end view of their entire cloud estate.
Learn moreLearn more
Evolving our incident response strategy
Lightstep | Nov 2, 2022Lightstep’s Incident Response offering will be sunset effective January 31, 2023. Current customers may continue to use the service until then. Lightstep Observability will not be affected.
Learn moreLearn moreLightstep sounds like a lovely idea
Monitoring and observability for the world’s most reliable systems