Skip to content
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

implement SEO recs discover page #12577

Merged
merged 2 commits into from
Feb 6, 2025
Merged
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
18 changes: 9 additions & 9 deletions docs/product/explore/discover-queries/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ view comprehensive information sent to Sentry.

![Full view of the Discover Homepage with query cards and button to build new queries.](./img/discover-homepage.png)

The <SandboxLink scenario="discover" projectSlug="react">Discover</SandboxLink> homepage displays the query builder where you can immediately begin creating a new query. By default, the page shows the pre-built "All Events" query, but you can customize the homepage and [set the custom version as your default](#set-as-default). To navigate back to the query management page, where you can find [pre-built](#pre-built-queries) and [saved](#saved-queries) queries, click the "Saved Queries" button.
The Discover homepage displays the query builder where you can immediately begin creating a new query. By default, the page shows the pre-built "All Events" query, but you can customize the homepage and [set the custom version as your default](#set-as-default). To navigate back to the query management page, where you can find [pre-built](#pre-built-queries) and [saved](#saved-queries) queries, click the "Saved Queries" button.

The query management page offers views of all your saved and pre-built queries so you can quickly see areas that need immediate attention. For example, if a query on errors shows a spike has occurred in the past 24 hours, you might want to investigate that first. Each query is saved as a card that displays a summarized view of the following data:

Expand All @@ -30,15 +30,15 @@ The query management page offers views of all your saved and pre-built queries s

## Pre-built Queries

Pre-built queries can be accessed by clicking the "Saved Queries" button on the discover homepage. Query cards with Sentry avatars are pre-built and cannot be removed.
Pre-built queries can be accessed by clicking the "Saved Queries" button on the Discover homepage. Query cards with Sentry avatars are pre-built and cannot be removed.

- All Events: Users can see the raw error stream for any group of projects. This replaces the Events feature and gives users the ability to add additional columns and change groupings to achieve their desired breakdown.
- Errors by Title: Users can see their most frequently occurring errors by the total number of raw errors, as well as the total number of users affected.
- Errors by URL: Users can see the pages that generated the most errors and different types of issues. As a reminder, issues are a group of fingerprinted Events. For more details, see the [full documentation on fingerprinting](/concepts/data-management/event-grouping/fingerprint-rules/).

## Saved Queries

Saved queries can be accessed by clicking the "Saved Queries" button on the discover homepage. Query cards with a user avatar indicate saved queries. The user who created a saved query will have their avatar display on the query card. Saved Queries are viewable by anyone in your organization and **are not** scoped to the user's account.
Saved queries can be accessed by clicking the "Saved Queries" button on the Discover homepage. Query cards with a user avatar indicate saved queries. The user who created a saved query will have their avatar displayed on the query card. Saved Queries are viewable by anyone in your organization and **are not** scoped to the user's account.

### Build a New Query

Expand All @@ -51,7 +51,7 @@ From the **Discover** page, you can build a <SandboxLink scenario="oneDiscoverQu
2. Enter a display name
3. Click "Save"

Apply new search conditions or table columns to modify the results of the query. Save the query and assign a custom display name. For the full details, see [documentation on the Query Builder](/product/explore/discover-queries/query-builder/).
Apply new search conditions or table columns to modify the query results. Save the query and assign a custom display name. For the full details, see the [documentation on the Query Builder](/product/explore/discover-queries/query-builder/).

### Search for a Query

Expand All @@ -70,21 +70,21 @@ The dropdown in the top right will allow you to sort by attributes.

### Edit Queries

If you need to edit any of these queries, go into the query, make the desired changes and a button will appear in the top right asking you to save/update the query. Keep in mind, edits to the query conditions **will not** be automatically saved.
If you need to edit any of these queries, go into the query, make the desired changes and a button will appear in the top right asking you to save/update the query. Keep in mind that edits to the query conditions **will not** be automatically saved.

To rename a saved query, click on the pencil icon by the header and enter the desired display name. Click "enter" or outside of the area to save the updated name.

### Share Queries

Share your queries as often as you want. You can share URLs with other users who also have access to the same organization. As each part of the query is built, the results update and the URL is updated so that in-progress searches can be shared in an email, chat, and so forth.
Share your queries as often as you want. You can share URLs with other users who also have access to the same organization. As each part of the query is built, the results update, and the URL is updated so that in-progress searches can be shared in an email, chat, and so forth.

### Delete Queries

On the **Discover** page, each saved query card has an ellipsis that will open a context menu. From here, you can delete the query. This action is irreversible. You can also delete the query within the [query results](#query-results) view by clicking the "Delete Saved Query" option in the context menu.

### Add to Dashboard

Queries can also be added to <SandboxLink scenario="dashboards" projectSlug="react">custom dashboards</SandboxLink> as widgets. You can find the "Add to Dashboard" button by opening the context menu in the **Discover** page or within the context menu of the [query results](#query-results) view. When you click "Add to Dashboard", a form opens where you can name your widget, select your target dashboard, and make other changes before saving your new widget.
Queries can also be added to <SandboxLink scenario="dashboards" projectSlug="react">custom dashboards</SandboxLink> as widgets. You can find the "Add to Dashboard" button by opening the context menu on the **Discover** page or within the context menu of the [query results](#query-results) view. When you click "Add to Dashboard", a form opens where you can name your widget. Select your target dashboard, and make any other required changes before saving your new widget.

### Set as Default

Expand All @@ -100,9 +100,9 @@ To navigate to the query management page, where you can find pre-built and saved

![Page displaying a graph of error spikes by URL, the event tag summary, and results of the query.](./img/discover-results.png)

To view query results, click on any query card. You'll find a graph, table, and toggleable tag summary (or facet map). The search bar at the top enables you to see the search conditions entered. The table reflects the events with sortable columns.
To view query results, click on any query card. You'll find a graph, table, and toggleable tag summary (or facet map). The top search bar lets you to see the search conditions entered. The table reflects the events with sortable columns.

Each table cell has a dynamic context menu that allows you to continue exploring your data by automatically updating the search bar or the table columns, according to your selection. Actions like, adding or excluding values from the filter, opening a selected release, or viewing the underlying stack of issues:
Each table cell has a dynamic context menu that allows you to continue exploring your data by automatically updating the search bar or the table columns, according to your selection. Actions like adding or excluding values from the filter, opening a selected release, or viewing the underlying stack of issues:

![Context menu](./img/013.png)

Expand Down
Loading