Skip to content
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
4 changes: 2 additions & 2 deletions cid-redirects.json
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@
"/01Start-Here/Library/Library_Filters": "/docs/get-started/library",
"/01Start-Here/Library/Library-Keyboard-Shortcuts": "/docs/get-started/keyboard-shortcuts",
"/01Start-Here/Library/Move-Content-Personal-Folder": "/docs/get-started/library",
"/01Start-Here/Library/Pinned-Searches": "/docs/get-started/library",
"/01Start-Here/Library/Pinned-Searches": "/docs/search/get-started-with-search/search-page/pin-a-search",
"/01Start-Here/Library/Recent-Searches": "/docs/get-started/library",
"/01Start-Here/Library/Search-the-Library": "/docs/get-started/library",
"/01Start-Here/Library/Share-a-Saved-Search-from-the-Library": "/docs/get-started/library",
Expand Down Expand Up @@ -376,7 +376,7 @@
"/05Search/Library/Export-and-Import-Content-in-the-Library": "/docs/get-started/library",
"/05Search/Library/Favorites": "/docs/get-started/library",
"/Search/Library/Library_Keyboard_Shortcuts": "/docs/get-started/keyboard-shortcuts",
"/05Search/Library/Pinned-Searches": "/docs/get-started/library",
"/05Search/Library/Pinned-Searches": "/docs/search/get-started-with-search/search-page/pin-a-search",
"/05Search/Library/Share-a-Saved-Search-from-the-Library": "/docs/get-started/library",
"/03Send-Data/Sources/03Use-JSON-to-Configure-Sources/Local-Configuration-File-Management/View-or-Download-Source-JSON-Configuration": "/docs/send-data/use-json-configure-sources/local-configuration-file-management/view-download-source-json-configuration",
"/05Search/Anomaly-Detection/Anomalies-Page/Drill-Down-into-Events": "/docs/dashboards/drill-down-to-discover-root-causes",
Expand Down
58 changes: 2 additions & 56 deletions docs/get-started/library.md
Original file line number Diff line number Diff line change
Expand Up @@ -179,63 +179,9 @@ The Home page lists all currently running searches and any searches performed ov

### Pinned searches

The **Pinned Search** feature allows you to start a search, then pin it, so it will continue running in the background independent of the browser session. Then, you can close the Search tab or log out and find your results later in the library on the [Recent](#recent-searches) tab in a folder named Pinned Searches.
The *pinned search* feature allows you to start a search, then "pin" it, so it will continue running in the background independent of the browser session. Then, you can close the **Search** page or log out and find your results later.

Once pinned, a search will run in the background for up to 24 hours. If it has not finished by then, it will be paused. There is no notification when your search is paused, but you can just restart the search to continue the query. Search results are available for three days.

There is a limit of ten pinned searches per user. Also, queries that use the [save operator](/docs/search/search-query-language/search-operators/save) cannot be pinned.

A search must be started in order for the pin button to show up in the Search tab. Once a search is pinned, you can easily unpin it, or remove it from the Pinned Searches tab. In the Pinned Searches folder, you can view the **Name**, **Status**, **Elapsed Time**, and monitor the **Progress** of each search.

There is a known issue that may cause Pinned Searches to be lost when Sumo Logic performs an upgrade. For information on Scheduled Maintenance for your deployment, see [Sumo Logic Status](http://status.sumologic.com). 

#### Pin and unpin a search

1. Enter a query in the search box and click **Start**.
1. Click the three-dot kebab icon and click **Pin** from the provided options. <br/> <img src={useBaseUrl('img/get-started/library/pin-search-option.png')} alt="pin-search-option.png" width="325"/>
1. A message displays that tells you where you can find it later in the library. The Pinned Search is named by default with the name of the search tab. <br/>![pinmessage.png](/img/get-started/library/pinmessage.png)
1. To change the name of the pinned search, double-click the **Search** tab to activate the name field and enter a new name.
1. To preserve the pinned search, follow the steps in Save a pinned search.
1. To unpin the search, click **Unpin** in the menu bar. <br/><img src={useBaseUrl('img/get-started/library/unpin-search-option.png')} alt="pin-search-option.png" width="300"/>

#### Save a pinned search

When you save a pinned search, it appears in your personal folder in the left navigation bar.

1. Click the name of the search to open it in the **Search** tab.
1. In the **Search** tab, click the three-vertical dot icon and click **Save As** from the provided options. The Save Item dialog appears.
1. Enter a unique **Name** in the text field. In our example below, we entered Invoke Frequency.
1. Optionally, enter a **Description**.
1. Click **Save**. <br/>![Save_As_Search_dialog.png](/img/get-started/library/Save_As_Search_dialog.png)

The search is saved to your **Personal** folder.

#### Manage pinned searches

This section shows you how to open previously pinned searches, rename a pinned search, and remove a search from the pinned search list,

To open a previously pinned search:

1. In the **Pinned Searches** tab, click the name of the search.
1. The search query and any existing results are displayed in the **Search** tab.
1. To run a new instance of the search, change the Time Range Expression, and click **Start**.

To rename a pinned search:

1. In the **Pinned Searches** tab, click the name of the search.
1. The search query and any existing results are displayed in the **Search** tab.
1. Double-click the **Search** tab to reactivate the name field.
1. Enter a new name and press **Enter**.

To remove a search from the pinned search List:

1. Hover over the search, then click the three-dot kebab menu icon to the right of the name.
1. Click **Unpin**.
1. In the **Confirm** dialog, click **OK**.

The search is removed from the list of Pinned Searches.

Removing an instance of a Saved Search from the list in the Pinned Searches tab does not delete the Saved Search from your Personal folder.
For more information, see [Pin a Search](/docs/search/get-started-with-search/search-page/pin-a-search).

### Share a saved search from the library

Expand Down
2 changes: 1 addition & 1 deletion docs/get-started/sumo-logic-ui-classic.md
Original file line number Diff line number Diff line change
Expand Up @@ -195,7 +195,7 @@ To pin a search, do the following:
1. A message appears telling you the location of your pinned search in the Library. The Pinned Search takes the name of the Search tab by default.<br/> ![pinmessage.png](/img/get-started/ui/pinmessage.png)
1. To change the name of a Pinned Search, double-click the Search tab and enter a new name in the name field.

For information on how to manage pinned searches, see the [Pinned Searches](/docs/get-started/library#pinned-searches) page.
For information on how to manage pinned searches, see [Pin a Search](/docs/search/get-started-with-search/search-page/pin-a-search).

### Manage your personal account preferences

Expand Down
2 changes: 1 addition & 1 deletion docs/get-started/sumo-logic-ui.md
Original file line number Diff line number Diff line change
Expand Up @@ -192,7 +192,7 @@ You must start a search for the **Pin** option to appear. To pin a search, do t

Once a search is pinned, it cannot be unpinned, but you can remove it from the **Pinned Searches** tab. You can pin up to 10 searches at a time. Queries that use the [`save` operator](/docs/search/search-query-language/search-operators/save) cannot be pinned.

For more information, see [Pinned Searches](/docs/get-started/library/#pinned-searches).
For more information, see [Pin a Search](/docs/search/get-started-with-search/search-page/pin-a-search).


## Administrator tasks
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ Sumo provides two index-based search optimization features: partitions and sched

## Use Search Parameters

If your search contains filtering criteria that could change each time the search is executed, take advantage of [Search Templates](search-templates.md). Search templates make it easier for less expert users to obtain search results, and also reduces the risk that such users will run expensive searches.
If your search contains filtering criteria that could change each time the search is executed, take advantage of [Search Templates](search-templates.md). Search templates make it easier for less expert users to obtain search results, and also reduces the risk that such users will run expensive searches.

## Aggregate before a lookup

Expand Down Expand Up @@ -135,4 +135,4 @@ _sourceCategory=Apache/Access and GET

## Pin searches with long time ranges

A query with a longer time range can run past the default time window for Sumo Logic. To protect against an interruption in a query with a significant time range, [pin it](/docs/get-started/library#pinned-searches). A pinned search can run in the background for up to 24 hours.
A query with a longer time range can run past the default time window for Sumo Logic. To protect against an interruption in a query with a significant time range, [pin it](/docs/search/get-started-with-search/search-page/pin-a-search). A pinned search can run in the background for up to 24 hours.
8 changes: 7 additions & 1 deletion docs/search/get-started-with-search/search-page/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ You can [run a saved search](../search-basics/save-search.md), [pause, or stop
| D | Click the gear icon to open the Search Config menu that has the options to use the [receipt time](../build-search/use-receipt-time.md) and [Auto Parse Mode](../build-search/dynamic-parsing.md). |
| E | [Share a link](../search-basics/share-link-to-search.md) for the currently running search. |
| F | [Save or schedule](../search-basics/save-search.md) a search. |
| G | Click the three-dot kebab icon to open a menu with the following options:<ul><li>Select between Basic or Advanced search mode.</li><li>Link to [search cheat sheets](/docs/search/search-cheat-sheets).</li><li>Edit the search, if it has already been saved.</li><li>[Save or schedule](../search-basics/save-search.md) a search.</li><li>[Share a link](../search-basics/share-link-to-search.md) for the currently running search.</li><li>Info provides detailed information about the search.</li><li>[Pin](/docs/get-started/library#search-the-library) the search to run in the background independent of the browser session.</li><li>[Favorite](add-saved-search-to-favorites.md) a saved search.</li><li>[Add a new monitor](/docs/alerts/monitors) based on the existing query in the search text box.</li><li>Use [Live Tail](/docs/search/live-tail) to see a real-time live feed of log events.</li></ul>The menu options are dynamically provided so depending on if you have run or saved the search or conducted aggregation some options will be grayed out and unclickable. |
| G | Click the three-dot kebab icon to open a menu with the following options:<ul><li>Select between Basic or Advanced search mode.</li><li>Link to [search cheat sheets](/docs/search/search-cheat-sheets).</li><li>Edit the search, if it has already been saved.</li><li>[Save or schedule](../search-basics/save-search.md) a search.</li><li>[Share a link](../search-basics/share-link-to-search.md) for the currently running search.</li><li>Info provides detailed information about the search.</li><li>[Pin](/docs/search/get-started-with-search/search-page/pin-a-search) the search to run in the background independent of the browser session.</li><li>[Favorite](add-saved-search-to-favorites.md) a saved search.</li><li>[Add a new monitor](/docs/alerts/monitors) based on the existing query in the search text box.</li><li>Use [Live Tail](/docs/search/live-tail) to see a real-time live feed of log events.</li></ul>The menu options are dynamically provided so depending on if you have run or saved the search or conducted aggregation some options will be grayed out and unclickable. |
| H | [Histogram](navigate-through-search-results.md) of the messages. |
| I | Search Details such as session, status, elapsed time, results, raw count, search expression, and [load](search-load-indicator.md). When searching an [Infrequent Partition](/docs/manage/partitions/data-tiers) the estimated and actual amount of data scanned is displayed. |
| J | Search results as messages. |
Expand Down Expand Up @@ -58,6 +58,12 @@ In this section, we'll introduce the following concepts:
<p>You can mark a saved search as a favorite so it appears in your Library.</p>
</div>
</div>
<div className="box smallbox card">
<div className="container">
<a href="/docs/search/get-started-with-search/search-page/pin-a-search"><img src={useBaseUrl('img/icons/search.png')} alt="icon" width="40"/><h4>Pin a Search</h4></a>
<p>You can pin a search so that it runs in the background independent of the browser session.</p>
</div>
</div>
<div className="box smallbox card">
<div className="container">
<a href="/docs/search/get-started-with-search/search-page/change-time-range-in-histogram"><img src={useBaseUrl('img/icons/search.png')} alt="icon" width="40"/><h4>Change the Time Range in the Histogram</h4></a>
Expand Down
54 changes: 54 additions & 0 deletions docs/search/get-started-with-search/search-page/pin-a-search.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
---
id: pin-a-search
title: Pin a Search
description: You can pin a search so that it runs in the background independent of the browser session.
---

import useBaseUrl from '@docusaurus/useBaseUrl';

The *pinned search* feature allows you to start a search, then "pin" it, so it will continue running in the background independent of the browser session. Then, you can close the **Search** page or log out and find your results later. To see your pinned searches:
* [**New UI**](/docs/get-started/sumo-logic-ui/). In the main Sumo Logic menu, select **Logs > Pinned searches**.
* [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Recent > Pinned Searches**.

Once pinned, a search will run in the background for up to 24 hours. If it has not finished by then, it will be paused. There is no notification when your search is paused, but you can just restart the search to continue the query. Search results are available for three days. Once a search is pinned, you can easily unpin it, or remove it from the **Pinned searches** list.

Limitations:
* There is a limit of ten pinned searches per user.
* Queries that use the [save operator](/docs/search/search-query-language/search-operators/save) cannot be pinned.
* There is a known issue that may cause pinned searches to be lost when Sumo Logic performs an upgrade. For information on scheduled maintenance for your deployment, see [Sumo Logic status](http://status.sumologic.com). 

#### Pin and unpin a search

1. Enter a query in the search box and click **Start Search**.
1. Click the three-dot kebab icon and click **Pin** from the provided options. <br/> <img src={useBaseUrl('img/get-started/library/pin-search-option.png')} alt="Pin menu option" style={{border: '1px solid gray'}} width="250"/>
1. A message displays that tells you where you can find the pinned search later. The pinned search is named by default with the name of the search. <br/><img src={useBaseUrl('img/get-started/library/pinmessage.png')} alt="Pinned search message" style={{border: '1px solid gray'}} width="400" />
1. To change the name of the pinned search, double-click the **Search** tab to activate the name field and enter a new name.
1. To preserve the pinned search, follow the steps in [Save a pinned search](#save-a-pinned-search).
1. To unpin the search, click **Unpin** in the menu bar. The search is removed from the **Pinned searches** list. (Removing an instance of a saved search from the **Pinned searches** list does not delete the saved search from your **Personal** folder.)<br/><img src={useBaseUrl('img/get-started/library/unpin-search-option.png')} alt="Unpin menu option" style={{border: '1px solid gray'}} width="200"/>

#### Save a pinned search

When you save a pinned search, it appears in your **Pinned searches** list.

1. Click the name of the search to open it in the **Search** tab.
1. In the **Search** tab, click the three-vertical dot icon and click **Save As** from the provided options. The **Save Item** dialog appears.
1. Enter a unique **Name** in the text field. In our example below, we entered "Invoke Frequency".
1. Optionally, enter a **Description**.
1. Click **Save**. <br/><img src={useBaseUrl('img/get-started/library/Save_As_Search_dialog.png')} alt="Save a search" style={{border: '1px solid gray'}} width="400" />

The search is saved to your **Personal** folder.

#### Manage pinned searches

To open a previously pinned search:

1. In the **Pinned searches** list, click the name of the search.
1. The search query and any existing results are displayed in the **Search** tab.
1. To run a new instance of the search, change the time range expression and click **Start Search**.

To rename a pinned search:

1. In the **Pinned searches** list, click the name of the search.
1. The search query and any existing results are displayed in the **Search** tab.
1. Double-click the **Search** tab to reactivate the name field.
1. Enter a new name and press **Enter**.
1 change: 1 addition & 0 deletions sidebars.ts
Original file line number Diff line number Diff line change
Expand Up @@ -1354,6 +1354,7 @@ module.exports = {
link: {type: 'doc', id: 'search/get-started-with-search/search-page/index'},
items: [
'search/get-started-with-search/search-page/add-saved-search-to-favorites',
'search/get-started-with-search/search-page/pin-a-search',
'search/get-started-with-search/search-page/change-time-range-in-histogram',
{
type: 'category',
Expand Down
Binary file modified static/img/get-started/library/pinmessage.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.