Skip to content

Commit a13d8c0

Browse files
JV0812jpipkin1
andauthored
Query Assist GA doc (#5559)
* Query Assit GA doc * added border tags for the images * Update query-assist.md * Add article to index page * Update docs/search/query-assist.md Co-authored-by: John Pipkin (Sumo Logic) <[email protected]> * Update docs/search/query-assist.md Co-authored-by: John Pipkin (Sumo Logic) <[email protected]> * Update docs/search/query-assist.md Co-authored-by: John Pipkin (Sumo Logic) <[email protected]> * Update docs/search/query-assist.md Co-authored-by: John Pipkin (Sumo Logic) <[email protected]> --------- Co-authored-by: John Pipkin <[email protected]>
1 parent 684b029 commit a13d8c0

10 files changed

+34
-18
lines changed

docs/search/index.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,12 @@ In this section, we'll introduce the following concepts:
6565
<p>Learn about Lookup tables and the search operators you can use with them.</p>
6666
</div>
6767
</div>
68+
<div className="box smallbox card">
69+
<div className="container">
70+
<a href="/docs/search/query-assist"><img src={useBaseUrl('img/icons/search.png')} alt="icon" width="35"/><h4>Logs Query Assist</h4></a>
71+
<p>Learn how Logs Query Assist makes it easier to discover relevant fields and minimize errors.</p>
72+
</div>
73+
</div>
6874
<div className="box smallbox card">
6975
<div className="container">
7076
<a href="/docs/search/optimize-search-performance"><img src={useBaseUrl('img/icons/search.png')} alt="icon" width="35"/><h4>Optimize Search Performance</h4></a>

docs/search/query-assist.md

Lines changed: 27 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,19 @@
11
---
22
id: query-assist
3-
title: Logs Query Assist - Preview
3+
title: Logs Query Assist
44
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.
55
---
66

7-
<head>
8-
<meta name="robots" content="noindex" />
9-
</head>
10-
117
import useBaseUrl from '@docusaurus/useBaseUrl';
128

13-
<!-- Originally added as a beta article with DOCS-409. -->
14-
15-
:::sumo Preview release
16-
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.
17-
:::
18-
19-
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.
9+
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.
2010

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

2313
## Key enhancements
2414

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

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

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

33+
<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"/>
34+
4335
* **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.
44-
* **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.
36+
* **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.
37+
* **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.
4538

4639
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.
4740

4841
### Schema discovery and field suggestions
4942

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

45+
<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"/>
46+
5247
* **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.
5348
* **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.
5449

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

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

65-
* **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.
60+
* **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.
61+
62+
## Limitations
63+
64+
Suggestions are predictive in nature and may not be comprehensive or completely accurate in every circumstance.
6665

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

71+
## Turn off autocomplete
72+
73+
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"/>
74+
1. Access your [Preferences](/docs/get-started/account-settings-preferences/#my-preferences).
75+
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"/>
76+
7277
## Feedback
7378

7479
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).
7580

76-
:::note
77-
Query Assist is a working name. Final naming and branding may change before release. All feature updates and release dates are subject to change.
78-
:::
81+
Follow the below steps to provide your feedback:
82+
83+
1. Enter the query typehead to view the suggestions dropdown.
84+
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"/>
85+
1. When you press thumbs down, provide additional feedback in the dialog box.
86+
1. Select the **Include query string and provided suggestions in the feedback automatically** checkbox.
87+
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"/>
7988

8089
<!--
8190
Phased Availability:

sidebars.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1658,6 +1658,7 @@ module.exports = {
16581658
'search/lookup-tables/manage-update-lookup-tables',
16591659
],
16601660
},
1661+
'search/query-assist',
16611662
'search/optimize-search-performance',
16621663
'search/optimize-search-partitions',
16631664
'search/subqueries',
Loading
Loading
Loading
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)