> ## Documentation Index
> Fetch the complete documentation index at: https://docs.honeycomb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Query

> Reference for the Honeycomb Query page, including Query Builder, Query Assistant, and how results are displayed in the query interface.

Query allows you to investigate your data with Query Builder.

When creating a new Query, the display includes the following components:

* [Query Builder](#query-builder) - to enter your query
* [Query Assistant](#query-assistant) - which translates your natural language query to Query Builder
* Suggested Queries - a list of suggested queries based on a selected Board configuration

After selecting **Run Query**, the screen refreshes to show:

* [Query Builder](#query-builder) with your query
* [Query Assistant](#query-assistant)
* [Query Results](/reference/honeycomb-ui/query/query-results/)

## Query Builder

<Frame>
  <img src="https://mintcdn.com/honeycomb/oJe-ncVHXR8RRGAw/_assets/images/query/query-builder.png?fit=max&auto=format&n=oJe-ncVHXR8RRGAw&q=85&s=0822d4192163796462863adda3890c64" alt="The Query Builder" width="1686" height="292" data-path="_assets/images/query/query-builder.png" />
</Frame>

A query in Honeycomb consists of up to six clauses:

* **SELECT** - Performs a calculation and displays a corresponding graph over time. Most **SELECT** queries return a line graph while the `HEATMAP` visualization shows the distribution of data over time
* **WHERE** - Filters based on field or attribute parameter(s)
* **GROUP BY** - Groups fields by field or attribute parameter(s)
* **ORDER BY** - Sort the results
* **LIMIT** - Specify a limit on how many results to return
* **HAVING** - Filter results based on aggregate criteria

Learn more about [creating a query](/investigate/query/build/) and refer to our [example queries](/investigate/query/examples-traces/) to try.

<Tip>
  You can create a calculated field, or derived column, from the Query Builder!
  Start by selecting the **GROUP BY** field, and then select **Create calculated field** from its menu.
  If you need more help creating a calculated field, visit [Manage Calculated Fields](/configure/environments/calculated-fields/).
</Tip>

### Frequently Queried Values

Dropdowns for the **SELECT**, **WHERE**, and **GROUP BY** clauses contain a section that shows the top five values that your team queries most frequently, so your team members can more easily construct repeated queries.

<Frame>
  <img src="https://mintcdn.com/honeycomb/oJe-ncVHXR8RRGAw/_assets/images/query/query-builder-top-queried-values.png?fit=max&auto=format&n=oJe-ncVHXR8RRGAw&q=85&s=c77fa4c25b4c20b3d3e56a733b2e57ae" alt="Query Builder with the WHERE clause dropdown open. The frequently-queried fields section is highlighted." width="1366" height="824" data-path="_assets/images/query/query-builder-top-queried-values.png" />
</Frame>

Listed values include data that has been most frequently queried and:

* used within the last three weeks
* used in manual queries
* specific to the currently selected dataset and environment

## Query Assistant

Query Assistant consists of:

* a search box
* **Get Query**
* suggested questions

Based on your entry or suggested question selection, Query Assistant creates and runs a query in the Query Builder.
Query results appear after the screen refreshes.

You can expand and collapse the Query Assistant display.
Any changes you make will persist.
You can also control your team's ability to use Query Assistant in [Team Settings](/reference/honeycomb-ui/account/team-settings/).
To learn how to enable or disable Query Assistant, visit [Teams: Manage Behavior](/configure/teams/manage-behavior/#manage-query-assistant).

## Tasks

* Query your data
* Edit query
* Change Datasets
* Change applicable Time Range
* Compare time ranges