Skip to content

Query Assist GA doc #5559

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Jul 14, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions docs/search/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,12 @@ In this section, we'll introduce the following concepts:
<p>Learn about Lookup tables and the search operators you can use with them.</p>
</div>
</div>
<div className="box smallbox card">
<div className="container">
<a href="/docs/search/query-assist"><img src={useBaseUrl('img/icons/search.png')} alt="icon" width="35"/><h4>Logs Query Assist</h4></a>
<p>Learn how Logs Query Assist makes it easier to discover relevant fields and minimize errors.</p>
</div>
</div>
<div className="box smallbox card">
<div className="container">
<a href="/docs/search/optimize-search-performance"><img src={useBaseUrl('img/icons/search.png')} alt="icon" width="35"/><h4>Optimize Search Performance</h4></a>
Expand Down
45 changes: 27 additions & 18 deletions docs/search/query-assist.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,19 @@
---
id: query-assist
title: Logs Query Assist - Preview
title: Logs Query Assist
description: Logs Query Assist improvements reduce the complexity of Sumo Logic’s query language, making it easier to discover relevant fields, minimize errors, and benefit from intelligent query-building assistance.
---

<head>
<meta name="robots" content="noindex" />
</head>

import useBaseUrl from '@docusaurus/useBaseUrl';

<!-- Originally added as a beta article with DOCS-409. -->

:::sumo Preview release
This is a Preview release. [Register here](https://docs.google.com/forms/d/e/1FAIpQLSdtmzRn1NyAdk1rXGZrJrpQQwR2i9FKOYd3uKLwEzrkZGVrwQ/viewform). To learn more, contact your Sumo Logic account executive.
:::

Query Assist enhances the query-building experience in Sumo Logic by providing real-time syntax suggestions, schema prompts, and partial query predictions. These enhancements simplify the process for users at all skill levels, making it easier to write accurate and efficient queries, enabling easier discovery of relevant fields, minimizing errors, and providing intelligent assistance for query creation.
Query Assist enhances the query-building experience in Sumo Logic by providing real-time syntax suggestions, schema prompts, and partial query predictions. These enhancements simplify the process for users at all skill levels, making it easier to write accurate and efficient queries, enabling easier discovery of relevant fields, minimizing errors, and providing intelligent assistance for query creation. The suggestions that appear comply with the user's role-based access restrictions.

<img src={useBaseUrl('img/search/get-started-search/query-assist-preview1.gif')} alt="query assist demo gif" style={{border: '1px solid gray'}} width="700"/>

## Key enhancements

* **Simplified learning curve**. Receive syntax suggestions and schema prompts to write queries without extensive knowledge of query syntax.
* **Enhanced autocomplete**. Benefit from context-aware suggestions improve accuracy and efficiency, adapting to your queries and organizational patterns.
* **Enhanced autocomplete**. Benefit from context-aware suggestions to improve accuracy and efficiency, adapting to your queries and organizational patterns.
* **Streamlined field discovery**. Automatically receive suggestions for relevant fields, especially in structured data like JSON, reducing the need for manual searches.

## How to get started
Expand All @@ -40,15 +30,20 @@ Query Assist enhances the query-building experience in Sumo Logic by providing r

Get real-time suggestions for query completion as you type, with token-by-token predictions that help you quickly finish your queries.

<img src={useBaseUrl('img/search/get-started-search/token-by-token-prediction-and-autocomplete.png')} style={{border: '1px solid gray'}} alt="token-by-token-prediction-and-autocomplete" width="400"/>

* **Operator suggestions**. When typing the first letters of an operator, the system displays all matching operators related to those letters, helping you quickly find and select the appropriate one. For example, typing `co` might suggest `count`, `count_distinct`, `count_frequent`, `compare`, `compose`, or other related operators.
* **Value suggestions**. When you start typing a source expression (e.g. `_sourceCategory=`), you will be provided with relevant built-in metadata field options to help autocomplete your query.
* **Metadata Key-Value suggestions**. When you start typing a source expression (for example, `_sourceCategory=`), you will be provided with relevant metadata keys options to help autocomplete your query. And once you select a particular key, it displays the available values for the selected metadata. This not only displays the built-in metadata fields but also discovers the custom fields configured in your system.
* **Clause Suggestions**. When you start typing the operators, you will be provided with the entire clause to complete the remaining portion of the clause. Clause suggestions are currently restricted to the `where`, `count`, `min`, `max`, `count_distinct`, `avg`, `first`, `last`, `stddev`, `sum`, `if`, `sort`, `limit`, `timeslice`, and `fields` operators.

For example, as you start typing, the system provides relevant metadata options and autocompletes your query. Simply press the `Tab` key to accept a suggestion.

### Schema discovery and field suggestions

Automatically receive suggestions for relevant [fields](/docs/manage/fields) in structured data like JSON logs, making field discovery much easier.

<img src={useBaseUrl('img/search/get-started-search/schema-discovery-and-field-suggestion.png')} style={{border: '1px solid gray'}} alt="schema-discovery-and-field-suggestion" width="400"/>

* **Field suggestions**. For structured logs, the system automatically suggests relevant fields such as `userID`, `eventType`, or `timestamp` as you type. This eliminates the need for manual inspection of logs, making it easier to filter and aggregate data.
* **Inline suggestions**. An inline suggestion is a real-time, context-aware recommendation within the search editor. By default, the first item in the dropdown is treated as an inline suggestion, but you can use the keyboard navigations to explore other suggestions, which will be shown inline. To apply an inline suggestion, press the Tab key.

Expand All @@ -62,20 +57,34 @@ The system intelligently predicts the next search operator or offers partial que

Suggestions are ranked based on your organization’s common queries, making query completion smarter and more relevant.

* **Contextual suggestions**. The system ranks suggestions based on common queries from your organization or your own previous queries. This ensures that your autocomplete options are not only relevant but also contextually accurate, speeding up the query-writing process.
* **Contextual suggestions**. The system ranks suggestions based on common queries from your organization or your own previous queries. This ensures that your autocomplete options are not only relevant but also contextually accurate, speeding up the query-writing process. However, if you occasionally find that no suggestions appear, this could be because there is no relevant data available to offer a contextual suggestion.

## Limitations

Suggestions are predictive in nature and may not be comprehensive or completely accurate in every circumstance.

<!-- hold off
### Need more help?
Try [Sumo Logic Copilot](/docs/search/copilot), our AI-powered assistant that helps you write and execute natural language log search queries.
Copilot with Query Assist video: https://docs.google.com/presentation/d/1HCaXROM6zrnapLaLo3gDm-S1uQPGAS0p9AquuLwiFXA/edit#slide=id.g3145b7936cd_0_8 -->

## Turn off autocomplete

1. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select your username and then **Preferences**. <br/>[**New UI**](/docs/get-started/sumo-logic-ui). In the top menu, select the person silhouette icon and then **Preferences**. <br/><img src={useBaseUrl('img/get-started/acct-pref.png')} alt="Account Preferences"style={{border: '1px solid gray'}} width="300"/>
1. Access your [Preferences](/docs/get-started/account-settings-preferences/#my-preferences).
1. Navigate to **My Preferences** and uncheck the **Show search autocomplete suggestions while typing** checkbox.<br/><img src={useBaseUrl('img/get-started/turn-off_autocomplete.png')} alt="turn-off_autocomplete"style={{border: '1px solid gray'}} width="500"/>

## Feedback

We value your input on Query Assist! Share your thoughts on its usability, relevance, accuracy, user experience, and the ranking of suggestions (syntax, schema, single phrase).

:::note
Query Assist is a working name. Final naming and branding may change before release. All feature updates and release dates are subject to change.
:::
Follow the below steps to provide your feedback:

1. Enter the query typehead to view the suggestions dropdown.
1. Press the thumbs up or down button to share your feedback.<br/><img src={useBaseUrl('img/search/get-started-search/query-suggestion-feedback.png')} alt="query-suggestion-feedback" style={{border: '1px solid gray'}} width="400"/>
1. When you press thumbs down, provide additional feedback in the dialog box.
1. Select the **Include query string and provided suggestions in the feedback automatically** checkbox.
1. Click **Submit**.<br/><img src={useBaseUrl('img/search/get-started-search/query-suggestion-thumbs-down-feedback.png')} alt="query-suggestion-thumbs-down-feedback" style={{border: '1px solid gray'}} width="400"/>

<!--
Phased Availability:
Expand Down
1 change: 1 addition & 0 deletions sidebars.ts
Original file line number Diff line number Diff line change
Expand Up @@ -1658,6 +1658,7 @@ module.exports = {
'search/lookup-tables/manage-update-lookup-tables',
],
},
'search/query-assist',
'search/optimize-search-performance',
'search/optimize-search-partitions',
'search/subqueries',
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/img/search/get-started-search/query-assist-preview1.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.