You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
## DESCRIBE YOUR PR
Added details about global dashboard filters. Updated some related docs
while in transition to new dashboards paradigm.
Main preview:
https://sentry-docs-git-global-dashboard-filters.sentry.dev/product/dashboards/https://sentry-docs-git-global-dashboard-filters.sentry.dev/product/dashboards/#global-filters
Updated related pages under /product/dashboards to remove old plan
requirements.
## IS YOUR CHANGE URGENT?
Help us prioritize incoming PRs by letting us know when the change needs
to go live.
- [ ] Urgent deadline (GA date, etc.): <!-- ENTER DATE HERE -->
- [x] Other deadline: Feature is in EA, so should get out ASAP
- [ ] None: Not urgent, can wait up to 1 week+
## SLA
- Teamwork makes the dream work, so please add a reviewer to your PRs.
- Please give the docs team up to 1 week to review your PR unless you've
added an urgent due date to it.
Thanks in advance for your help!
## PRE-MERGE CHECKLIST
*Make sure you've checked the following before merging your changes:*
- [ ] Checked Vercel preview for correctness, including links
- [ ] PR was reviewed and approved by any necessary SMEs (subject matter
experts)
- [ ] PR was reviewed and approved by a member of the [Sentry docs
team](https://github.com/orgs/getsentry/teams/docs)
---------
Co-authored-by: Shannon Anahata <[email protected]>
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.
10
+
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.
13
11
14
12
## Manage Dashboards
15
13
16
-
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:
14
+
On the Dashboards home page, you can:
17
15
18
16
-[Create a dashboard](#create-dashboards)
19
17
-[Create a dashboard from a template](#create-dashboards-from-templates)
@@ -31,15 +29,15 @@ Clicking "Create Dashboard" takes you to a new dashboard where you can immediate
31
29
- Rearrange existing widgets
32
30
- Resize existing widgets
33
31
34
-
32
+
35
33
36
34
### Create Dashboards From Templates
37
35
38
36
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).
39
37
40
38
### Dashboard Filters
41
39
42
-
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.
40
+
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.
Sentry's <SandboxLinkscenario="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).
11
11
12
-
12
+
13
13
14
-
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.
14
+
15
+
## Global Filters
16
+
17
+
All widgets in the same view reflect the results of the global filters set at the top of the dashboard.
18
+
19
+
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.
20
+
21
+
### Custom Filters
22
+
23
+
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.
24
+
25
+
### Dashboard Edit Access
26
+
27
+
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.
15
28
16
29
## Custom Dashboards
17
30
18
-
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.
31
+
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.
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.
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.
10
+
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.
13
11
14
12
The library includes the following widgets:
15
13
@@ -67,7 +65,7 @@ Finally, add a third query for for the frustrating transaction duration:
67
65
68
66
The chart now shows cumulative counts at different response time thresholds.
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.
13
-
14
-
</Alert>
15
-
16
-
<SandboxLinkscenario="discover"projectSlug="react">Discover</SandboxLink> provides visibility into your data across environments by building
17
-
upon and enriching your error data. You can <SandboxLinkscenario="oneDiscoverQuery"projectSlug="react">query</SandboxLink> and unlock insights into the health of your entire system and get
18
-
answers to critical business questions — all in one place. Use <b>Discover</b> to
19
-
view comprehensive information sent to Sentry.
20
-
21
-
22
-
23
10
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.
24
11
25
12
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:
@@ -101,20 +88,18 @@ To navigate to the query management page, where you can find pre-built and saved
101
88
102
89
## Query Results
103
90
104
-
91
+
105
92
106
93
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.
107
94
108
95
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:
109
96
110
-
97
+
111
98
112
99
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.
113
100
114
101
For more about how to build a query, go to [the Query Builder](/product/explore/discover-queries/query-builder/).
115
102
116
-
## Trace View
117
-
118
-
103
+
## Trace Explorer
119
104
120
105
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.
0 commit comments