Skip to content

Commit

Permalink
Custom views -> issue views, indicate that saved searches is deprecated
Browse files Browse the repository at this point in the history
  • Loading branch information
MichaelSun48 committed Sep 19, 2024
1 parent 65df11e commit 9535b9e
Show file tree
Hide file tree
Showing 4 changed files with 51 additions and 63 deletions.
3 changes: 1 addition & 2 deletions docs/concepts/search/saved-searches.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,7 @@ description: "Learn more about default, recommended, and saved searches."

{/* Maybe this note should be yellow/red since there is some time pressure? */}
<Note>
Saved Searches will be deprecated soon in favor of Custom Issue Views. Any user-level saved searches will still be available
to save as a view within the "Add View" menu in the Issues page.
Saved Searches is deprecated and will be removed at the end of the year. Your saved searches will still be available in the "Add View" menu on the **Issues** page, and they can easily be converted to a Issue Views.
</Note>

Sentry allows you to save searches you've made on the **Issues** page. At the top of the page, next to the search bar, click "Custom Search" to access the "Saved Searches" sidebar.
Expand Down
61 changes: 0 additions & 61 deletions docs/product/issues/custom-views/index.mdx

This file was deleted.

50 changes: 50 additions & 0 deletions docs/product/issues/issue-views/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
title: Issue Views
sidebar_order: 9
description: "Learn how to customize your issue stream in Sentry and quickly see the issues that are most important to you."
---

Issue views let you customize what shows up in your issue stream so you can quickly see what's most important to you. You have full control over which search query your issue stream renders by default, and which other queries are within a click's reach.


## Creating Your First View

To create your first custom issue view, navigate to the [**Issues**](https://sentry.io/orgredirect/organizations/:orgslug/issues/) page and click the **Add View** button. You'll see the following page:

{/* TODO(msun) Insert image here once it's been updated for EA (current state of custom views is LA-specific) */}

Here, you'll be able to select a view from one of the recommended options or create your own by following the instructions below:


1. **Name your view**: Give your view a name that describes the types of issues it will show.
2. **Set your view's search query**: Choose the search query that will be applied by default when you select this view. Don't forget to hit enter to apply the query!
3. **Set your view's sort**: Select how you want the issues to be sorted in this view (for example, by date, events, and so on).
4. **Save your view**: Click on the ellipsis menu within the tab and select **Save Changes**.

<Note>
If you had a default custom saved search, it'll be converted to an issue view and will appear as your default view automatically, just like before. Any other saved searches you created will be available in the **Add View** menu until the end of the yea. Please save them as views if you'd like to keep them.
</Note>

## Customizing Your Views


### Updating View Queries and Sorting

Views are defined by their search query and sort order, and you can safely change the query or sort within your view without changing the persistant query or sort. If you have inputted a different query from the one your view was saved with, you'll see an **unsaved changes indicator** (shown below). To update your view with this new query or sort, click the ellipsis menu and select **Save Changes**. To discard them, click **Discard Changes** within the ellipsis menu, or close your Sentry tab without saving.

![Unsaved Changes Indicator](./img/issue_views_unsaved_changes_indicator.png)
{/* <img src={'./img/issue_views_unsaved_changes_indicator.png'}/> */}

### Reordering Views and Setting a Default View

Your can reorder your view tabs by dragging them to where you want them to be. The first tab will always be your default view and will be what you see when you first open the **Issues** page.


### Renaming Views

To rename a view, select it from the tab list. Then, either double click on the view's name or click the ellipsis menu and select **Rename**, type in a new name, and hit enter.


## Sharing Views

We built Issue Views in a way that makes them easy to share with people in your organization. To share, just copy the link to your issue view and send it to a fellow org member. The link will take them to a **temporary tab** that contains the same query and sort as your view. They'll then be able to save the view as their own by clicking **Save View**, or discard it by clicking **Discard**. Note that temporary tabs will not be persisted across page navigations or reloads.

0 comments on commit 9535b9e

Please sign in to comment.