diff --git a/docs/product/dashboards/custom-dashboards/index.mdx b/docs/product/dashboards/custom-dashboards/index.mdx index c9ca2c353cbb1..55199c794ec36 100644 --- a/docs/product/dashboards/custom-dashboards/index.mdx +++ b/docs/product/dashboards/custom-dashboards/index.mdx @@ -7,20 +7,18 @@ description: >- og_image: /og-images/product-dashboards-custom-dashboards.png --- - - -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 @@ -31,7 +29,7 @@ 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 @@ -39,7 +37,7 @@ When the "Show Templates" toggle is enabled, several default dashboard templates ### 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 diff --git a/docs/product/dashboards/img/custom-dash.png b/docs/product/dashboards/img/custom-dash.png new file mode 100644 index 0000000000000..4067dbdca2584 Binary files /dev/null and b/docs/product/dashboards/img/custom-dash.png differ diff --git a/docs/product/dashboards/index.mdx b/docs/product/dashboards/index.mdx index c7e89551804ab..a969b6705d70c 100644 --- a/docs/product/dashboards/index.mdx +++ b/docs/product/dashboards/index.mdx @@ -9,13 +9,26 @@ og_image: /og-images/product-dashboards.png Sentry's Dashboards 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. ## Open Dashboard Widgets in Discover and Issues diff --git a/docs/product/dashboards/widget-builder/index.mdx b/docs/product/dashboards/widget-builder/index.mdx index 5c50c75433ddd..40f9dc00f55aa 100644 --- a/docs/product/dashboards/widget-builder/index.mdx +++ b/docs/product/dashboards/widget-builder/index.mdx @@ -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 --- - - 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. diff --git a/docs/product/dashboards/widget-library/index.mdx b/docs/product/dashboards/widget-library/index.mdx index a381266928505..51a5cf5631e03 100644 --- a/docs/product/dashboards/widget-library/index.mdx +++ b/docs/product/dashboards/widget-library/index.mdx @@ -7,9 +7,7 @@ description: >- og_image: /og-images/product-dashboards-widget-library.png --- - - -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: @@ -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 diff --git a/docs/product/explore/discover-queries/index.mdx b/docs/product/explore/discover-queries/index.mdx index 260635bd2baf8..53e29ee8f3d0a 100644 --- a/docs/product/explore/discover-queries/index.mdx +++ b/docs/product/explore/discover-queries/index.mdx @@ -7,19 +7,6 @@ description: >- og_image: /og-images/product-explore-discover-queries.png --- - - -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. - - - -Discover provides visibility into your data across environments by building -upon and enriching your error data. You can query and unlock insights into the health of your entire system and get -answers to critical business questions — all in one place. Use Discover 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: @@ -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.