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
12 changes: 5 additions & 7 deletions docs/product/dashboards/custom-dashboards/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,20 +7,18 @@ description: >-
og_image: /og-images/product-dashboards-custom-dashboards.png
---

<Include name="feature-available-for-plan-trial-business.mdx" />

Custom dashboards are shared across your organization, and users can view each other’s custom dashboards in the management view. Note that any changes you make are global, and will appear for users across the entire organization.
Custom dashboards are shared across your organization, and users can view each other’s custom dashboards on the Dashboards home page. Note that any changes you make and **save** are global, and will appear for users across the entire organization.

## Manage Dashboards

When you have either a Business or Trial Plan, navigating to **Dashboards** takes you to a view where you can manage dashboards instead of the [default dashboard](/product/dashboards/). From here, you can:
On the Dashboards home page, you can:

- [Create a dashboard](#create-dashboards)
- [Create a dashboard from a template](#create-dashboards-from-templates)
- Duplicate a dashboard
- Delete a dashboard

![Manage mode.](./img/dashboard-management.png)
![Manage mode =900x](./img/dashboard-management.png)

### Create Dashboards

Expand All @@ -31,15 +29,15 @@ Clicking "Create Dashboard" takes you to a new dashboard where you can immediate
- Rearrange existing widgets
- Resize existing widgets

![Edit mode.](./img/dashboard-template.png)
![Edit mode. =700x](./img/dashboard-template.png)

### Create Dashboards From Templates

When the "Show Templates" toggle is enabled, several default dashboard templates are displayed. You can add each template directly to the list of dashboards by clicking "Add Dashboard", or preview it by clicking "Preview". You have to add a template before you can edit the resulting dashboard. You can also duplicate or delete a dashboard created from a template (this does not delete the template).

### Dashboard Filters

Dashboard filters are applied to all the widgets in your dashboard. They consist of [page filters](/concepts/search/#page-filters) that allow you to narrow down the widget results to certain projects, environments, and date ranges, and a release filter that restricts the data to certain releases. Changing a dashboard filter will prompt you to "Save" or "Cancel". To persist filter changes to your dashboard, click "Save", or click "Cancel" to discard the changes.
Dashboard filters are applied to all the widgets in your dashboard. By default, they consist of [page filters](/concepts/search/#page-filters) that allow you to narrow down the widget results to certain projects, environments, date ranges, and releases. You can also add custom filters to your dashboard by pressing the _plus_ button. Each filter begins with selecting a dataset, and then adding a filter condition. You can add multiple filters to your dashboard, and they will be applied to all widgets in the dashboard. Changing a dashboard filter will prompt you to "Save" or "Cancel". To persist filter changes to your dashboard, click "Save", or click "Cancel" to discard the changes.

### Dashboard Edit Access

Expand Down
Binary file added docs/product/dashboards/img/custom-dash.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
19 changes: 16 additions & 3 deletions docs/product/dashboards/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,26 @@ og_image: /og-images/product-dashboards.png

Sentry's <SandboxLink scenario="dashboards" projectSlug="react">Dashboards</SandboxLink> provide you with a broad overview of your application’s health by allowing you to navigate through error and performance data across multiple projects. Dashboards are made up of one or more widgets, and each widget visualizes one or more [dataset](/product/dashboards/widget-builder/#choose-your-dataset).

![Widgets visualizing events, errors by country, affected users, and handled vs unhandled issues.](./img/dashboard-customise.png)
![Widgets visualizing events, errors by country, affected users, and handled vs unhandled issues. =900x](./img/custom-dash.png)

All widgets in the same view reflect the date range indicated in date time range filter and update synchronously if you update that date range. You can also zoom in on any time series visualizations you may want to investigate, and all of the widgets reflect the time period that you’ve zoomed in on.

## Global Filters

All widgets in the same view reflect the results of the global filters set at the top of the dashboard.

By default, projects, environments, date range, and release must be set, and will apply to all widgets in the dashboard. You can also zoom in on any time series visualizations you may want to investigate, and all of the widgets will reflect the time period that you’ve zoomed in on.

### Custom Filters

You can also add custom global filters to your dashboard by pressing the _plus_ button. Each filter begins with selecting a dataset, and then adding a filter condition. You can add multiple filters to your dashboard, and they will be applied to all widgets _relating to that dataset_ in the dashboard.

### Dashboard Edit Access

To restrict who can edit or delete your dashboard, go to the "Edit Access" selector. As the dashboard creator, you can limit access to specific teams by selecting the checkboxes in the Edit Access Selector and clicking Save Changes to apply the updates. Dashboard creators and organization owners always retain edit access.

## Custom Dashboards

If you’d like to edit the default dashboard or build out multiple ones, each with its own set of unique widgets, you may want to consider our [Custom Dashboards](/product/dashboards/custom-dashboards/) feature which enables you to create more robust views such as the one below.
Every organization has a general template dashboard that is shared across all users. If you’d like to edit the default dashboard or build out new ones, each with its own set of unique widgets, you may want to consider the [Custom Dashboards](/product/dashboards/custom-dashboards/) feature which enables you to create more robust or customized views for example, to track performance of a specific feature or to track errors by a specific team's ownership.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a note that when we migrate Insights to dashboards (hopefully early ~2026, the Insights pages we have today will act as these out-of-the-box templates that users can fork, and use as a starting point for their dashboards).


## Open Dashboard Widgets in Discover and Issues

Expand Down
4 changes: 1 addition & 3 deletions docs/product/dashboards/widget-builder/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,9 @@ description: Learn how to create widgets for your dashboards or edit existing on
og_image: /og-images/product-dashboards-widget-builder.png
---

<Include name="feature-available-for-plan-trial-business.mdx" />

When adding a widget or editing an existing one, a side panel opens up where you can see the dashboard widget builder:

![Widget Builder overview.](./img/widget-builder-overview.png)
![Widget Builder overview. =900x](./img/widget-builder-overview.png)

The widget builder has several configuration options that you can use to shape data and add information to your dashboard. These options are presented as steps in the widget builder, but you don't have to do them in the order they're presented in.

Expand Down
6 changes: 2 additions & 4 deletions docs/product/dashboards/widget-library/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,7 @@ description: >-
og_image: /og-images/product-dashboards-widget-library.png
---

<Include name="feature-available-for-plan-trial-business.mdx" />

The widget library contains a collection of prebuilt widgets you can add to your [custom dashboards](/product/dashboards/customize-dashboards/). You can access the widget library by clicking the "Add Widget" button and selecting "From Widget Library" on the dashboard.
The widget library contains a collection of prebuilt widgets you can add to your [custom dashboards](/product/dashboards/custom-dashboards/). You can access the widget library by clicking the "Add Widget" button and selecting "From Widget Library" on the dashboard.

The library includes the following widgets:

Expand Down Expand Up @@ -67,7 +65,7 @@ Finally, add a third query for for the frustrating transaction duration:

The chart now shows cumulative counts at different response time thresholds.

![Response Thresholds Widget.](./img/widget-library-response-thresholds-widget.png)
![Response Thresholds Widget. =900x](./img/widget-library-response-thresholds-widget.png)

### My top issues

Expand Down
21 changes: 3 additions & 18 deletions docs/product/explore/discover-queries/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,19 +7,6 @@ description: >-
og_image: /og-images/product-explore-discover-queries.png
---

<Alert>

This feature is available only if your organization is on either a Business or Trial Plan, with the exception of the ["All Events" pre-built query](/product/explore/discover-queries/#pre-built-queries), which is available on Team plans or higher.

</Alert>

<SandboxLink scenario="discover" projectSlug="react">Discover</SandboxLink> provides visibility into your data across environments by building
upon and enriching your error data. You can <SandboxLink scenario="oneDiscoverQuery" projectSlug="react">query</SandboxLink> and unlock insights into the health of your entire system and get
answers to critical business questions — all in one place. Use <b>Discover</b> to
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 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 Down Expand Up @@ -101,20 +88,18 @@ To navigate to the query management page, where you can find pre-built and saved

## Query Results

![Page displaying a graph of error spikes by URL, the event tag summary, and results of the query.](./img/discover-results.png)
![Page displaying a graph of error spikes by URL, the event tag summary, and results of the query. =900x](./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 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:

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

If the first column shows an icon (as seen above), it means the events have been stacked. Click on the icon to view the full list of events. Each event will have an event ID you can click on for more details. Hovering over fields in the "Issue", "Release", and "Event ID" columns displays additional information like issue statuses, release authors, and stack traces for errors.

For more about how to build a query, go to [the Query Builder](/product/explore/discover-queries/query-builder/).

## Trace View

![Trace View](./img/trace-details-view.png)
## Trace Explorer

You can see additional information about your event by clicking into any "Event ID" on the [**Discover**](https://sentry.io/orgredirect/organizations/:orgslug/discover) page. Clicking on any event type other than an error event, will take you to the [**Trace View**](/concepts/key-terms/tracing/trace-view/) page. Clicking on an error event will take you to the [**Issues**](https://sentry.io/orgredirect/organizations/:orgslug/issues/) page.
Loading