Managing Your Sumo Logic Library

You can save, share, and manage log searches, dashboards, apps, and other Sumo Logic content in your library. The library also allows you to launch searches and dashboards with a single click, speeding up access to the searches you find yourself running consistently. Additionally, you can use the content that others in your organization have already developed to continually discover new insights in your data.

Open the Library page to expose additional search options and to organize and manage library contents.

1. Classic UI. At the top of the screen, select the Library (folder) tab.
   New UI. In the main Sumo Logic menu, select Library, and then click Open library page.
2. You'll see two View as options:
   • Me. See your own saved searches and dashboards.
   • Content Administrator. Available if you have a Sumo Logic role that grants you Manage Content capability, this option turns off your personal content in the library and allows you to see the entire Sumo file tree. In this mode you can migrate content from one location to another, as well as highlight important content in the Admin Recommended folder. For more information, see Admin Mode.
     
3. Once you've made your choice of what you want to see, you can enter a string in the Search bar to display matching search results.
   

Explore the library

1. Classic UI. At the top of the screen, select the Library (folder) tab.
   New UI. In the main Sumo Logic menu, select Library, and then click Open library page.
2. Select Personal to select your own saved searches and dashboards or Org to select those shared by others in your organization.
3. Search for items:
   • Enter a search string to display matching search results.
     
   • Narrow your search by selecting an option for Created by or Shared with. As you make your selections, the constructed query is entered into the search field and additional options are presented.
     
   • Select a Quick Search option to perform a quick search for log searches, folders, or dashboards. As you make your selections, the query you have constructed is entered into the search field.
     

The left nav also includes shortcuts to other convenient features:

• Click Recent to list all currently running searches and any searches performed over the last three hours. Pinned Searches are also listed.
• Click Favorites to list searches and dashboards that you've marked as favorites to keep handy. To add an item to Favorites, hover over the item in the left nav and click the star, which changes to solid which. Click again to unfavorite. 

Organize the library

Folders are available for organizing content in the library. Some folders are set up automatically. You can also create custom folders and move items among folders. 

The path to the current library folder is shown near the top of the Library page.

To create a new folder, click Add New > New Folder, enter the folder name and an optional description, and click Add.

To get information on items in the library, click an item in the library to open an information panel. If you click a folder in the library, information about the folder is shown in the information panel. Double-click the folder to list the items that it contains.

Do any of the following from the information panel in the library:

• Click Edit to modify the name or description of the item.
• Click the Trash icon to delete the item from the library. Deleting an item from the library means that the search, Dashboard, or folder is no longer available.
• Click the dotted More icon and select Export to open a window with the JSON code for the item, which you can copy or download.
• Click the dotted More icon and select Copy to make a copy of the item. Select the location in the library to copy it to, and click Copy.
• Click Share or Unshare to change the sharing settings for the item.
• Click Move to move the item to another folder in the library. Select the new location, and click Move.

Personal Folder

You can add folders and subfolders to the library in order to organize your content for easy access or to share content.

In the Library, your Personal folder is the root folder for all your saved content. Any time you save a search, a dashboard, or install an app, it is automatically saved here in a flat folder structure, ordered alphabetically.

Move Content in Personal Folders

You can organize your saved content into subfolders in your Personal Folder.

1. Mouse over the icon next to a library item you want to move to display the checkbox.
   
2. Click the checkbox to select the item.
3. Select other items as desired.
4. After selecting the content you want to move, click the three-dot kebab menu and select the Move option.
   
5. In the Move Item dialog, select the location you want to move the content to, and click Move.
   
6. The item(s) will be moved and appear in the new location.

When your content is moved, you’ll need to click the new folder location to view its contents in the list on the right.

Add Folders

To add a folder to the library:

1. Classic UI. At the top of the screen, select the Library (folder) tab.
   New UI. In the main Sumo Logic menu, select Library, and then click Open library page.
2. Click Add New > New Folder.
3. In the Add Folder dialog, enter a name for the new folder, and click Add. 
   
4. The new folder is added to the folder list in alphabetical order.

Add Subfolders

1. Create a subfolder by clicking Add New > New Folder in your Personal folder.
2. In the Add Folder dialog, enter a folder name, for example My Apps, and click Add. The new subfolder is added to the folder list.

note

You can only nest subfolders to six levels. If you add any more beyond that, you will receive this error message: You’ve reached the depth limit on the number of nested items that can be created/moved.

Share Subfolders

If want to share the apps you have installed in order to share them with your organization, you can share your entire My Apps folder that you created in the previous section. This way, any app that you install in the future to this subfolder would be automatically published and shared with your team.

To publish a subfolder:

1. Select My Apps, click the details icon.
2. Click Share.
3. The Share Folder dialog appears. Choose Your organization to share with. Anyone in your org will be able to see this folder.
4. Click Save. The My Apps folder is added to the Org folder, in a subfolder labeled with your name. Now everyone in your organization can access your published content.

In the future, any apps that you install in this published folder will be automatically published. If you want to create a folder hierarchy, create the desired hierarchical subfolders and publish the topmost folder. All subfolders will be published with the parent folder.

Favorites

Keep track of content you use regularly with Favorites, or content that you want to keep handy. Just click the star icon for your saved search, dashboard, installed app, or folder, and it will be saved to Favorites in the left nav for easy access.

You can also favorite saved searches from the Search page, and favorite dashboards from the Dashboards page.

There is a limit of 20 favorite items per user.

Mark content as favorite

1. Classic UI. At the top of the screen, select the Library (folder) tab.
   New UI. In the main Sumo Logic menu, select Library, and then click Open library page.
2. Hover your mouse over an item in the library, and click the star icon that appears.
   
3. The star darkens, and the item now appears in Favorites.

Unfavorite content

1. Go to Favorites in the left nav.
2. Hover your mouse over an item and click the star that appears to the right. The item is removed from the Favorites folder.

Search the library

To find Sumo Logic content you have saved in the library, you can search the Personal and Org folders using the search field.

You can search on the:

• Content name
• Content description

In the Library search field, you can use keywords and wildcards (*), though leading wildcard searches (*ab) are not supported. You can add one or more keywords. With multiple keywords, the default assumed operator is AND, not OR.

You can also search for Content types in the Personal folder using the following prefixes:

• type:search - Finds all searches.
• type:search keyword - Lists all the searches that match the keyword.
• type:search is:scheduled - Finds all scheduled searches that you own.
• type:search is:scheduled keyword - Finds all scheduled searches that you own, which match the keyword.
• is:scheduled - Finds all scheduled searches that you own.
• is:scheduled keyword - Lists all scheduled searches that you own, which match the keyword.  
• type:folder - Finds all folders.
• type:folder keyword - Lists all folders that match the keyword.
• type:dashboard - Finds all dashboards.
• type:dashboard keyword - Lists all dashboards that match the keyword.

Limitations

• Library search is only supported in the Personal and Org folders.
• Content type search is only supported in the Personal folder. 
• Leading wildcards (*ab) are not supported.
• For multiple keywords, the assumed operator is AND, not OR.

Search content in the library

1. Classic UI. At the top of the screen, select the Library (folder) tab.
   New UI. In the main Sumo Logic menu, select Library, and then click Open library page.
2. Click in the search field and select what you want to search for.
   
3. Enter your text. You can use any of the following:
   • Keyword
   • Wildcard (*)
   • Personal tab only: Content type prefix (with one or more keywords, if desired).

Recent searches

When you run a search in Sumo Logic, that search and its results are saved automatically in Recent in the left nav. This is useful in case you lose your browser session, accidentally close the Search tab, log out, or just want to refer to a search you performed recently.

Recent Searches that are still running are paused after 15 minutes. If not reopened or restarted, the search is deleted after three hours.

The Home page lists all currently running searches and any searches performed over the last three hours:

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 tab in a folder named 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.

There is a limit of ten pinned searches per user. Also, queries that use the save operator 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. 

Pin and unpin a search

1. Enter a query in the search box and click Start.
2. Click the three-dot kebab icon and click Pin from the provided options. 
   
3. 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. 
   
4. To change the name of the pinned search, double-click the Search tab to activate the name field and enter a new name.
5. To preserve the pinned search, follow the steps in Save a pinned search.
6. To unpin the search, click Unpin in the menu bar.
   

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.
2. In the Search tab, click the three-vertical dot icon and click Save As from the provided options. The Save Item dialog appears.
3. Enter a unique Name in the text field. In our example below, we entered Invoke Frequency.
4. Optionally, enter a Description.
5. Click Save.
   

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.
2. The search query and any existing results are displayed in the Search tab.
3. 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.
2. The search query and any existing results are displayed in the Search tab.
3. Double-click the Search tab to reactivate the name field.
4. 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.
2. Click Unpin.
3. 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.

Share a saved search from the library

Once you’ve saved content, you can choose to share it, which makes it available to other users. Your shared content is automatically added to the library in the Org > [Your Name] folder.

To share a search and its results, see Share a Link to a Search. 

Once shared, other users in your organization can:

• Search for and find your shared search.
• Click your search to run it in the Search page.
• Copy your search to save and edit it. 
• Export the text of your search. 

Searches and dashboards can be shared and unshared at any time. Additionally, other users can copy what you've shared and make further customizations.

Share

1. In your Personal folder, highlight a search and click the share icon.
   
2. On the sharing popup, click in the Share this content... field.
   
3. You can share the search with Your Entire Organization, or any combination of roles and users.
   
4. The default permission level is Edit. Use the Access pull-down to select a different permission level. For information about permission levels and advanced options, see Available Permission Levels.
   
5. You can share the search with a different set of users and roles, and different permission level. To do so, click Add users with another access level, and repeat steps 3 and 4.
6. Click Share. 

Unshare

1. In the library, highlight a search and click the share icon.
   
2. Click See who has access.
   
3. Click the trash can icon to unshare the search with a user or role.
   
4. Click Save.

Import and Export Content in the library

In the Library, you can export content as JSON, including whole folders with subfolders, saved log searches, saved metric queries, and dashboards. Then you can import the content as JSON into the same or another Sumo Logic organization.

The Export and Import functions are provided in order for you to transfer data immediately. The Sumo Logic JSON format may change without notice. There is no guarantee that you will be able to import the JSON in the future.

limitations

• Recent Searches, Favorites, Scheduled Views, Partitions, Field Extraction Rules (FERs), and lookups are not supported.
• For content that is shared, only the content is imported, not the Shared state. You can share it again as necessary.
• All content names must be unique within a folder in the library.
• Only error free JSON will import successfully.
• Import is limited to 1000 objects at a time.
• For IE 11, in the Export Content dialog, the Download button is not available, due to the default IE 11 security configuration, which blocks this kind of download.

Export Content

1. In the Library, do either:
   • To export an item, navigate to it, click the details icon for that item, and select Export.
   • To export a whole folder (with any subfolders), click the details icon for that folder select Export.
2. In the Export Item dialog, do either:
   • Click Copy to send it to the clipboard.
   • Click Download to download the content as a JSON file.
3. Click DONE to close the window.

If you modify your JSON manually after export, we recommend that you use JSONLint to confirm that you are importing valid JSON.

Import Content

1. Navigate to the folder into which you want to import the library item.
2. Select Import from the options menu.
3. In the Content Import dialog, enter Name. The item name must be unique with a folder. Check your JSON before importing to make sure that there is no organization-specific content. All content names in an organization must be unique. If the name is not unique, you will get an error that prevents you from importing the content.
4. Paste the JSON you copied from the JSON dialog to the clipboard, or from the JSON file you downloaded.
5. Click Import. The Import button is only available if you have pasted in a valid JSON.

Library filters

You can search through the content in your library with these three main filters. The filters can also be used in tandem, allowing you to filter through filtered content.

Created By

When selected this filter shows a list of users in your network. Once a creator is selected only content created by this user will show up in your search.

Shared With

When selected this filter shows a list of users in your network. Once a user is selected only content that was shared with this user will show up in your search.

Type

When selected this filter shows a list of different types of content within the library. Once a type is selected only that type of content will show up in your search.