Dashboards

  • 10min

Latest Dynatrace

Permissions

The following table describes the required permissions.

Permission
Description
app-engine:functions:run
Allows the user to run functions
app-engine:apps:run
Allows the user to run functions
app-engine:edge-connects:read
Allows the user to read EdgeConnect configuration via functions
document:environment-shares:read
Allows the user to access shared dashboards
document:direct-shares:read
Allows the user to access shared dashboards
state:user-app-states:write
Allows the app to persist view settings like the selected timeframe or variable values
state:user-app-states:read
Allows the app to read view settings like the selected timeframe or variable values
state:user-app-states:delete
Allows the app to delete view settings like the selected timeframe or variable values
davis:analyzers:read
Allows the user to read configuration of Davis analyzers
davis:analyzers:execute
Allows the user to run Davis analyzers

With Dashboards Dashboards, you can create powerful, data-driven documents for custom analytics.

Get real-time insights by transforming complex data into dynamic, interactive dashboards.Start fast using our ready-made dashboards, designed for your everyday needs.Build your dashboard effortlessly with only a few clicks.Customize any visualization with ease.Experience dynamic and interactive dashboards with versatile variable filtering.Share your insights with others in seconds.
1 of 6Get real-time insights by transforming complex data into dynamic, interactive dashboards.

These procedures describe the basics of using dashboards and get you started on the way to customizing and creating your own dashboards.

Use dashboards

List all dashboards

To list dashboards

  1. Go to Dashboards.

  2. In the Dashboards panel, the Recently modified section lists recently modified dashboards.

  3. Hover over a dashboard name and select for a menu of available commands for that dashboard. In this example, we would display the menu for a dashboard called my dashboard 3.

    Dashboard kebab menu

    The commands you see in the menu depend on your permissions for that dashboard. For example, you can't rename someone else's dashboard unless they have given you edit permissions for that dashboard. (But you can make a copy of a shared dashboard and then edit your copy.)

    • Rename enables editing for the dashboard name
    • Duplicate makes a copy of the dashboard
    • Download writes the dashboard to a JSON file that you can import
    • Move to trash moves the dashboard to the trash can

    This icon after a dashboard name means someone shared that dashboard with you.

  4. To display a table of all dashboards to which you have access—your own dashboards and all dashboards that people have shared with you—select All dashboards.

    • To sort the table, select the Name, Created, or Last modified header.
    • To filter the table:
      • You can enter a search string in the filter bar at the top of the table.
      • You can select All dashboards, My dashboards, Shared with me, or Ready-made in the list at the top of the table.
    • To create a new dashboard, select Dashboard in the upper-left corner.
    • To upload a dashboard, select Upload in the upper-left corner.
    • To delete a dashboard, select Move to trash. If there's no icon for a dashboard, it means you have permission to view that shared dashboard but not to delete it.
    • To list deleted dashboards, select Deleted in the upper-right corner of the Dashboards page.
      • To restore a deleted dashboard, select Restore.
      • To permanently delete a dashboard, select Delete permanently.

  5. To close the Dashboards table and return to your initial view, select Dashboards in the upper-left corner of the Dashboards page.

List my dashboards

To list all dashboards you own

  1. Go to Dashboards.
  2. In the Dashboards panel, select All dashboards.
  3. At the top of the Dashboards table, select My dashboards.

List dashboards shared with me

To list all dashboards shared with you

  1. Go to Dashboards.
  2. In the Dashboards panel, select All dashboards.
  3. At the top of the Dashboards table, select Shared with me.

List ready-made dashboards

To list all ready-made dashboards

  1. Go to Dashboards.
  2. In the Dashboards panel, select Ready-made dashboards.

Alternatively, you can select All dashboards and then change the filter at the top of the table from All dashboards to Ready-made.

What's special about ready-made documents
  • Created and automatically distributed by Dynatrace as examples and templates.
  • Read-only: you can edit them for use during your session, and you can save a copy with your changes, but you can't save your changes to the original document.
  • This icon in a table of documents indicates that it's a ready-made document.

To display a dashboard

  1. Go to Dashboards.

  2. In the Dashboards panel, select the name of the dashboard. In this example, we open my dashboard 2.

    Open a dashboard

If you see something on a dashboard that you want to zoom in on, you can maximize it and have a closer look, and then minimize it again when you're done.

When you maximize a tile, it is temporarily zoomed to the maximum size of the display so you can see the details of the selected tile.

To maximize a tile

  1. Hover over the tile to display the tile-specific commands.
  2. Select Maximize.

To return to the normal dashboard view, select Minimize in the upper-right corner.

When you open a dashboard for the first time, the refresh rate is set to Off (no automatic refresh).

Manual refresh

To refresh the current dashboard manually, in the upper-right corner of the dashboard, select (in the pair).

Automatic refresh

To refresh the current dashboard automatically, in the upper-right corner of the dashboard, select (in the pair) and select a refresh rate.

  • Off turns off automatic refresh
  • Other settings will refresh the dashboard at the specified interval

If you change the refresh rate, that rate is remembered the next time you open the dashboard.

A frequent refresh rate can keep you literally up to the minute, but a complex dashboard may take some time to recalculate each time it is refreshed. Choose a refresh rate that suits your needs and the complexity of the dashboard.

When you open a document (dashboard or notebook) for which you don't have write permission, you can still edit the document during your session. After you're finished, you have two options:

  • Save your changes to a new document
  • Discard your changes

Example:

  1. Go to Dashboards Dashboards, list the ready-made dashboards, and select the Getting started dashboard.

    It says Ready-made in the upper-left corner, next to the document name.

  2. Select the Pie chart tile and then select Edit.

  3. Change the visualization from Pie to Donut.

    Now you are offered two buttons: Save as new and Discard changes.

  4. Use the updated dashboard as needed. You have full edit access for this session.

  5. When you're finished, select what to do with your changes:

    • Save as new—saves your changes in a new copy of the edited dashboard.
    • Discard changes—discards your changes and returns you to the unedited read-only dashboard.

To review or change settings that apply to an entire dashboard

  1. Display the dashboard.

  2. In the upper-right corner of the dashboard, select Settings.

    The Settings panel is displayed.

  3. Review or change settings as needed.

    To set a default timeframe for a dashboard

    1. Display the dashboard.

    2. In the upper-right corner of the dashboard, select Settings.

    3. Turn on Custom timeframe.

    4. Select the default timeframe for the selected dashboard.

      Changing this setting does not immediately update the timeframe of the current dashboard. The change is applied only to a new session with the dashboard (either for a different user, or for the same user returning to the dashboard for another session).

    For details about the dashboard timeframes, see Select the timeframe.

    To review or change the dashboard default segment

    1. Display the dashboard.

    2. In the upper-right corner of the dashboard, select Settings.

    3. Turn on Default segment.

    4. Select the default segment for the selected dashboard.

      Changing this setting does not immediately update the segment of the current dashboard. The change is applied only to a new session with the dashboard (either for a different user, or for the same user returning to the dashboard for another session).

    For details about dashboard segments, see Select segments.

    To review or change dashboard variables

    1. Display the dashboard.

    2. In the upper-right corner of the dashboard, select Settings.

      The Settings panel is displayed.

    3. Select Variables.

    For details about dashboard variables, see Add a variable to a dashboard.

The timeframe describes the when of the data on the dashboard.

  • When you open a dashboard for the first time, the standard global timeframe (Last 2 hours) is applied.

  • If you change the global timeframe setting for your dashboard, that timeframe is applied the next time you open the dashboard. However, there are exceptions as described below.

  • You can set a dashboard-specific default timeframe that is applied each subsequent time you open the dashboard.

  • You can set a tile-specific timeframe. This setting overrides the global timeframe.

  • When you open a dashboard via a link, if a timeframe is included in the link, the link timeframe is applied and the default dashboard timeframe is ignored.

Change global timeframe

To change the global timeframe

  1. In the upper-right corner of the dashboard, open the timeframe selector menu (the default is Last 2 hours ).
  2. Select a new timeframe.
    • To select a standard timeframe, choose one of the standard Relative timeframes
    • To define a custom timeframe, define the timeframe in the Custom timeframe panel and select Apply.
      • Use the calendar buttons Calendar to select calendar dates
      • Edit the resulting From and To settings to fine-tune the range

When you change the global timeframe:

  • The new timeframe is displayed in the upper-right corner of the dashboard.
  • The dashboard contents are recalculated and displayed according to the new timeframe. This overrides the default dashboard timeframe.
  • This does not affect any tile-specific timeframe overrides. Tile-specific timeframes take precedence over any global timeframe settings.

Default dashboard timeframe

To set a default timeframe for a dashboard

  1. Display the dashboard.

  2. In the upper-right corner of the dashboard, select Settings.

  3. Turn on Custom timeframe.

  4. Select the default timeframe for the selected dashboard.

    Changing this setting does not immediately update the timeframe of the current dashboard. The change is applied only to a new session with the dashboard (either for a different user, or for the same user returning to the dashboard for another session).

Tile-specific timeframe override

To specify a custom timeframe in a dashboard tile

  1. Edit the tile.

  2. In the edit panel, turn on Custom timeframe.

  3. Select the timeframe to apply to the selected tile.

    This timeframe overrides the dashboard timeframe set in the upper-right corner of the dashboard. Using this method, a dashboard can have multiple tiles, where each tile has its own timeframe.

You can also specify a custom timeframe in a data tile's DQL query. If you use this method (with a timeframe specified in the query), the above UI setting is disabled and the timeframe specified in the query is used.

Example timeframe specification in DQL:

fetch [recordtype], from:now() - 2h
    | ....

For details on specifying a timeframe in DQL, see Specify timeframe in the DQL documentation.

To filter data, you can specify segments at two levels: dashboard and tile. Tile-level segment selections override dashboard-level segment selections.

Segments

Use segments when you want to reuse them across dashboards. For example, use segments for recurring filters such as for your Kubernetes clusters, namespaces, workloads, or pods. Segments automatically apply on top of the queries of your tiles/sections, so you don’t need to reference them within.

Variables

If you need more control over how a filter is applied, however, you might want to use variables.

  • Variables allow you to fully control the underlying query or within your Explore section or tile, determining where and how they are applied. For example, you can specify how they connect with other filters applied (AND, OR) and you can control which operator is used for your filter (such as equals, contains, startsWith, and endsWith).
  • Additionally, use variables when you need fine-grained control over how filters are interdependent.

For a Dashboards-specific segments use case, see Analyze monitoring data with segments.

Dashboard-level segments

To select dashboard-level segments

  1. Display the dashboard.

  2. Open the segment selector at the top of the dashboard and, in Filter by segments, select a segment.
    If the segment requires an additional value selection, select it now.

  3. To add another segment, select Segment. Repeat this step for each segment you want to add.

  4. Select Apply to apply the selection and filter data on the dashboard.

    • The segment selector now displays the name of the selected segment or, if you select more than one segment, the number of selected segments.
    • To change your segment selection, select again, make your changes, and select Apply.
    • To manage segments in general (list, create, view, edit, delete), select and then select the Manage segments link.

Tile-level segments

To select tile-level segments

  1. Display the dashboard.

  2. Select the tile and then select in the tile controls to edit the tile.

  3. In the edit panel, turn on Custom segments.

  4. In the Custom segments list, select a segment.
    If the segment requires an additional value selection, select it now.

  5. To add another segment, select Segment. Repeat this step for each segment you want to add for the selected tile.

  6. Select Apply to apply the selection and filter data on the tile.

    • The segment selector now displays the name of the selected segment or, if you select more than one segment, the number of selected segments.
    • To change your segment selection, select again, make your changes, and select Apply.
    • To manage segments in general (list, create, view, edit, delete), select and then select the Manage segments link.

To review or change settings that apply to an entire dashboard

  1. Display the dashboard.

  2. In the upper-right corner of the dashboard, select Settings.

    The Settings panel is displayed.

  3. Review or change settings as needed.

    To set a default timeframe for a dashboard

    1. Display the dashboard.

    2. In the upper-right corner of the dashboard, select Settings.

    3. Turn on Custom timeframe.

    4. Select the default timeframe for the selected dashboard.

      Changing this setting does not immediately update the timeframe of the current dashboard. The change is applied only to a new session with the dashboard (either for a different user, or for the same user returning to the dashboard for another session).

    For details about the dashboard timeframes, see Select the timeframe.

    To review or change the dashboard default segment

    1. Display the dashboard.

    2. In the upper-right corner of the dashboard, select Settings.

    3. Turn on Default segment.

    4. Select the default segment for the selected dashboard.

      Changing this setting does not immediately update the segment of the current dashboard. The change is applied only to a new session with the dashboard (either for a different user, or for the same user returning to the dashboard for another session).

    For details about dashboard segments, see Select segments.

    To review or change dashboard variables

    1. Display the dashboard.

    2. In the upper-right corner of the dashboard, select Settings.

      The Settings panel is displayed.

    3. Select Variables.

    For details about dashboard variables, see Add a variable to a dashboard.

When you open a document from another user, you may see the following message:

This dashboard contains custom code. It is read-only until you review the code and select “Accept and run”.

When you run a code tile or section written by another person, Dynatrace executes the other person's JavaScript using your user account and your permissions. This is a powerful feature, but it needs to be used correctly and responsibly. The JavaScript code can access external APIs on your behalf (using your account and permissions).

To review code

  1. Select Review all code.

    The Review code page displays each code tile's code in a separate box.

  2. Review the code and decide whether you want to run it.

    If you want to run the code, you can approve it just this time or permanently.

    • To run the code just this time, select Accept and run. The next time you open this document, you will be asked once again to review the code before running it.
    • To permanently accept the code in this document, select Always trust code in this document and then select Accept and run.

To download (export) the result of the current dashboard tile or notebook section

  1. Hover over the tile or section to display available commands.

  2. On the command bar, select More actions > Download result > [format].

    The result is downloaded to a local file in the selected format.

    The selection of download formats available depends on the visualization.

    • CSV: The result is downloaded to a local comma-separated values (*.csv) file
    • JSON: The result is downloaded to a local JSON (*.json) file

    Some visualizations offer no option for downloading the result.

Manage dashboards

To add your dashboard to the Dock for easy access, open the menu next to the dashboard name and select Add to Dock.

To rename a dashboard from the Dashboards panel

  1. Go to Dashboards.

  2. In the Dashboards app, the Recently modified section lists your most recently modified dashboards.

  3. Hover over the name of the dashboard you want to rename and select > Rename. If the rename option isn't available, you don't have edit rights to that dashboard.

To duplicate a dashboard from the Dashboards panel

  1. Go to Dashboards.

  2. In the Dashboards app, the Recently modified section lists your most recently modified dashboards.

  3. Hover over the name of the dashboard you want to duplicate and select > Make a copy.

To make a copy of the current dashboard

  1. At the top of the dashboard, open the dashboard menu next to the dashboard name.

  2. Select Duplicate from the menu.

    A copy is created with the name Copy of + the name of the current dashboard. The copy is now listed in the Dashboards panel.

If you own a document (dashboard or notebook), you can share it.

There are two ways to share a document with other Dynatrace users in your company:

  • Share access: Create and maintain a list of users and user groups that can access the document.
  • Share links: Create links (URLs) pointing to your document and distribute the links through the channel of your choice (email, for example).

These methods are not mutually exclusive. For example, you can maintain a focused list of users for ongoing access to the document (maybe everyone in a certain group edits the document regularly) and you can create and distribute view-only links for a wider audience as needed.

In either case, you control whether people can edit the document or only view it.

For details on sharing documents, see Share documents.

Dashboard versions are saved automatically.

  • You can access the 50 most recent versions of your dashboard.
  • Each dashboard version is available for up to 30 days.

To view and manage dashboard versions

  1. Display your dashboard.

  2. In the upper-right corner of your dashboard, select History.

    This displays a menu of the most recent versions of the current dashboard.

    • Date
    • Time
    • Name of the person who created that version

  3. From any version entry in the Versions menu, you can select version-specific actions.

    • Preview Preview displays a preview of the selected version.
    • Restore switches your dashboard to the selected version.
    • Make a copy creates a new dashboard from the selected version and displays the new dashboard. The original dashboard remains unchanged.
    • Download saves a JSON file of the selected version of the dashboard to your local machine.
    • Preview in new tab displays a preview of the selected version on a new browser tab.
    • Delete this version deletes the selected version.

  4. To list and manage all versions of the dashboard in a separate window, go to the bottom of the Versions menu and select Show all.

For details, see Manage document versions.

When you create a document (dashboard or notebook), you are the owner. To give ownership of the document to another Dynatrace user

  1. Open the document menu and select Change owner.

  2. Find and select a new owner, and then select Change owner.

    When you change the document owner, you immediately lose access to the document.

    • Be sure you are ready to transfer ownership before you select this command.
    • You can regain access to the document only if the new owner gives you permisssion.

  3. After the transfer is complete, the new owner will receive email about the document ownership transfer.

To download (export) the currently displayed dashboard as JSON

  1. At the top of the dashboard, open the menu to the right of the dashboard name.

  2. Select Download from the menu.

    The definition of the current dashboard is downloaded to a local JSON file.

To download (export) a dashboard from the Dashboards Dashboards side panel

  1. Go to Dashboards Dashboards.

  2. In Last opened by you, hover over the name of the dashboard you want to export and select Download from the menu. The dashboard is downloaded to a local JSON file that you can upload.

    If your dashboard isn't listed in Last opened by you, select All dashboards to display a table of all dashboards that you can access (your dashboards or dashboards shared with you). From there, you can find the dashboard and select Download from the menu.

To upload (import) the JSON definition of a dashboard from the Dashboards side panel

  1. In the Dashboards app, in the Dashboards panel on the left, select Upload.
  2. Find and open the dashboard JSON definition file.

To upload (import) the JSON definition of a dashboard from the Dashboards table

  1. Go to Dashboards.

  2. In the Dashboards panel on the left, select All dashboards.

    A Dashboards table displays all dashboards by Name and Last modified date.

  3. In the upper-left corner of the page, select Upload.

  4. Find and open the dashboard JSON definition file.

An uploaded dashboard is:

  • Opened in Dynatrace.

    If you see a message about running custom code when you upload a dashboard, see Run code warnings for more information.

  • Added to your Recently modified list.

  • Added to the Dashboards page with Last modified set to the upload date and time.

To delete any dashboard on the Dashboards page

  1. Go to Dashboards.

  2. In the Dashboards panel on the left, select All dashboards.

    A table displays all dashboards by Name and Last modified date.

  3. On the Dashboards page, select Move to trash for the dashboard you want to delete.

Create and edit dashboards

The fastest and easiest way to explore your data is with our new Explore tiles and sections. In a few seconds, you can find and analyze your logs, metrics, or business events. No DQL required!

To create a new dashboard

  1. Go to Dashboards.
  2. In the Dashboards panel, select New dashboard.

After you create an empty dashboard, you need to add tiles to it.

  • Query Grail
  • Add code
  • Add Markdown
  • Add a variable
  • Add a snippet

To Query Grail

  1. In the upper-right of the dashboard, select Add > DQL.

    Dashboards: Add tile button (Plus)

    A configuration side panel opens on the right to display two tabs:

    • Data
    • Visual

  2. On the Data tab, use the Dynatrace Query Language (DQL) to define your query.

  3. Select Run to execute the query.

  4. On the Visual tab, choose a visualization format for your results.

    • means the visualization type is unavailable for your query.

  5. Under the Visualization selector, expand the options sections to adjust visualization settings as needed.

  6. Close the side panel when you're done.

    If you want to return to these settings, select your tile to display them.

For details, see Add data to a dashboard.

To add code to a dashboard

  1. In the upper-right of the dashboard, select Add > Code.

    Dashboards: Add tile button (Plus)

    An empty tile is added to the dashboard and an Options side panel opens on the right.

  2. optional In Tile title, enter a title to display at the top of your tile.

  3. In the numbered Code box, enter custom JavaScript to fetch external data from any available API. Use the Fetch API to fetch data from external APIs.

    To make sure your requests aren't blocked, ask your administrator to allow your external data sources by adding them to the External requests.

    External requests enable outbound network connections from your Dynatrace environment to external services. They allow you to control access to public endpoints from the AppEngine with app functions and functions in Dashboards, Notebooks, and Automations.

    1. Go to Settings and select General > Environment management, External Requests.

    2. Select New host pattern.

    3. Add the domain names.

    4. Select Add.

    This way you can granularly control the web services your functions can connect to.

    Don't include the address prefix. For example, if the address is https://some.service.org, just add some.service.org.

For details, see Add code to a dashboard.

To add a markdown tile to a dashboard

  1. In the upper-right of the dashboard, open the Add menu and select Add markdown.

    Dashboards: Add tile button (Plus)

    An Options side panel opens on the right.

  2. In the Options side panel, enter your text.

    • Use Markdown to format your text and add links and images.
    • The tile is updated as you edit.
    • While you're editing text, press Ctrl+Space to see options.

  3. Close the Options side panel when you're done.

For details, see Add Markdown to dashboard.

Use variables to filter your dashboards, to act as variable values in code tiles, and as placeholders in tile titles and Markdown tile text.

To add a variable to a dashboard

  1. In the upper-right corner of the dashboard, select > Variables.

    Dashboards: Add tile button (Plus)

    The Variable panel is displayed.

  2. Define the variable.

    • Name: the name of the variable.
      • Only alpha-numerical values are allowed
      • A variable name must not start with dt_
    • Type: can be one of the following:
      • Query: the value is returned from a query you enter when you define the variable.
        • Select Run query to test your query.
      • Code: the value is returned from code you enter when you define the variable.
      • CSV: a comma-separated values (CSV) list of values.
        • To define possible values, enter them (separated by commas) in the box under Type.
        • To define a default value, select one from the Default value list.
        • To allow multiple values to be selected at the same time, turn on Multi-select.
      • Text: free text. You can enter a Default value. Your changes are saved automatically.

  3. Set Display settings.

    • Turn on the Display as filter on dashboard toggle if the variable dropdown should be displayed on the dashboard. Turn it off when you want it hidden, such as when the variable is used as a static value across tiles but should not be displayed to the dashboard user.
    • Turn on the Multi-select toggle if users should be able to select multiple values at the same time within the variable dropdown. Turn it off when you want to use only single values of the variable dropdown.
    • Select a Default value for the variable dropdown. If you do not enter anything in this field, the first available value will be selected.

  4. When you're finished, select < Variable at the top to go to the Variables panel, or close the panel to display the dashboard.

Variables in dashboards can be defined to depend on other variables.

  • The value of a variable is recalculated if its definition refers to another variable and the other variable's value changes.

    For example, if the value of variable A changes, the value of any variable whose definition refers to variable A is recalculated.

  • Loops are not allowed.

    For example, if the value of variable A depends on the value of variable B, the value of variable B can't depend on the value of variable A.

For details, see Add a variable to a dashboard.

To get started based on a snippet

  1. In the upper-right of the dashboard, select Add.

    Dashboards: Add tile button (Plus)

  2. Scroll down to the Start with a snippet section and choose one of the snippets. In this example, we select the Fetch logs snippet, which is displayed in a preview panel.

    Example: select the "Fetch logs" snippet.

  3. After you select a snippet, the edit panel displays the snippet you added.

    Example: "Fetch logs" snippet added.

  4. Edit the query or code (depending on the snippet type you selected) and the visualization settings as needed.

  5. Select Run to see results.

  6. Close the side panel when you're done.

For details, see Add a snippet to a dashboard.

To analyze data using Davis analyzers

  1. Explore a timeseries.

    In your document (dashboard or notebook)

    1. Select to add a new section or tile, and then select Metrics to explore metrics.

      Example: select Add > Metrics

    2. In Select metric, select Infrastructure > CPU > CPU usage %.

      Example: select metric "CPU usage %"

    3. Set Split by to host.name.

      Example: set "Split by" to host.name

    4. Set Limit to the maximum number of series to analyze. Davis analyzer currently supports analysis up to 1000 series.

    You should get something like this:

    Example: complete query

  2. Run the query.

  3. In the options panel on the right, scroll down and expand Davis AI.

    Example: select Davis AI settings

    Example: initial panel for Davis AI

  4. On the Davis AI panel, set Analyzers to the analyzer you want to use, and then configure the analyzer.

    • Number of signal fluctuations—how many times the signal fluctuation is added to the baseline to produce the actual threshold for alerting.
    • Alert condition—your selection depends on whether you want to know when the metric is above, below, or outside (above or below) the normal range.

    For details, see Anomaly detection configuration.

    • Tolerance—the higher the tolerance, the broader the confidence band, leading to fewer triggered events.
    • Alert condition—your selection depends on whether you want to know when the metric is above, below, or outside (above or below) the normal range.

    For details, see Anomaly detection configuration.

    • Threshold—a hard limit that a metric should not violate.
    • Unit—the unit of the value.
    • Alert condition—your selection depends on whether you want to know when the metric is above or below the threshhold value.
    • Suggest threshold—Davis AI can help you to find the right threshold based on historical data.

    For details, see Anomaly detection configuration.

    • Data points to predict—the total steps the time series is forecasted. More steps generally results in less reliable forecasts and longer analyzer runtimes.
    • Forecast offset—an offset for the start of the forecast. For example, if the offset is set to 2, the last two data points are ignored and a forecast for these points is returned as well.

    For details, see Davis® forecast analysis.

    You can use the default values or turn on Show advanced properties to fine-tune these settings.

    • Alert on missing data—alert if no data is detected within the sliding window.
    • Violating samples—number of samples in the sliding window that must violate to trigger an event.
    • Sliding window—number of samples that form the sliding window.
    • Dealerting samples—number of samples in the sliding window that must go back to normal to close the event.

  5. By default, the analyzer is not enabled. To enable it, turn on the switch at the top of the edit panel (switch from Davis analyzer is not active to Davis analyzer is active).

  6. To view the results, select the Davis AI analysis visualization and expand the Davis AI analysis chart section to review or change the visualization-specific settings:

    Example: select "Davis AI analysis" visualization and display visualization-specific settings

    The Davis AI analysis visualization has two sections: chart and visualization. You can use the Visible sections setting to display either or both of them.

    • All—show a chart and a table. The chart reflects your table selections.
    • Table—show only a table. You can sort columns that display a sort icon in the header. Select the column header to toggle the sort order up or down .
    • Chart—show only a chart. Use the table to select entries you want to show on the chart.

Example: anomalous CPU usage percent

To detect when CPU usage percent exceeds 70 percent, in your document (dashboard or notebook)

  1. Select to add a new section or tile, and then select Metrics to explore metrics.

    Example: select Add > Metrics

  2. In Select metric, select Infrastructure > CPU > CPU usage %.

    Example: select metric "CPU usage %"

  3. Set Split by to host.name.

    Example: set "Split by" to host.name

  4. Set Limit to the maximum number of series to analyze. Davis analyzer currently supports analysis up to 1000 series.

    Example: complete query

  5. Select Run.

  6. In the edit panel, expand Davis AI.

    Example: select Davis AI settings

    Example: initial panel for Davis AI

  7. In the Analyzers list, select Static threshold anomaly detection.

    Example: select "Static threshold anomaly detection" analyzer

  8. Set Threshold to 70 (enter a value) and Alert condition to Alert if metric is above (default).

    Example: configure settings for "Static threshold anomaly detection" analyzer

  9. Activate the analyzer: at the top of the edit panel, switch from Davis analyzer is not active to Davis analyzer is active.

  10. To view the results, select the Davis AI analysis visualization. Expand the Davis AI analysis chart section to see visualization-specifc settings.

    Example: select "Davis AI analysis" visualization and display visualization-specific settings

  11. In the Davis AI analysis chart section, set Visible sections to All.

  12. Review the results.

    In this example, we selected the hosts that exceeded the threshold.

    • The chart shows a line for the selected metric (CPU usage %) for each selected host.
    • A red bar across the top of the visualization indicates where the threshold for that metric was exceeded.
    • The table under the chart has those hosts selected.

    Example analyzer results in dashboard with "Davis AI analysis" visualization

If a dashboard has one or more variables, they are listed by name along the upper-left of the dashboard, under the dashboard name. When you change variable values, the dashboard contents are recalculated and displayed according to the new values.

To change the value of a variable

  1. In the upper-left of the dashboard, locate the variable name in the upper-left of the dashboards.

  2. Use the menu or edit box under the variable name to change the value.

    • If the variable allows just one selection (value) at a time, select the value that you want to apply to the dashboard.
    • If the variable allows multiple selections (values) at a time, select the checkbox for each value you want to apply to the dashboard. The menu name for that variable shows how many values are selected.
    • For a text variable, you can edit the text in the box under the variable name.

Use Open with to copy a dashboard tile to another document (such as a different notebook or dashboard).

For example, an easy way to start a new document (dashboard or notebook) is to use Open with to copy reusable sections from existing documents (dashboards or notebooks) to a new document and then edit the copied sections as part of the new document.

To copy a dashboard tile to a notebook (as a notebook section)

  1. In the dashboard, select the tile that you want to copy to a notebook.

  2. Select > Open with.

  3. In the Open with… window, select the Notebooks option.

    A Select destination box is displayed.

  4. In Select destination, you can create a new notebook or select an existing notebook.

  5. Select Add.

    The Dashboards application opens with the selected section copied into a new or existing dashboard (depending on what you chose in Select destination).

For details, see Open with.

To edit a tile

  1. Select the tile to display the tile-specific commands.

  2. Select Edit.

    An Options panel opens on the right to display the tile or section configuration.

  3. Select and drag the expander control left or right as needed to resize the Options panel for a better look at the code.

    Resize options panel

Layout

To resize a tile

  1. Hover over the tile to display the tile-specific commands.
  2. Select and drag Resize in the lower-right corner of the tile to change the size and shape of the tile.

You can move one tile at a time or select and move multiple tiles simultaneously.

To move one tile at a time

  1. Hover over the tile to display the tile-specific commands.
  2. Select and drag Move to drag the selected tile to a new location.

To move multiple tiles simultaneously

  1. Click one tile to select it.
  2. Ctrl-click additional tiles that you want to move.
    • Each selected tile is highlighted.
    • The total number of selected tiles is displayed on the tile command bar.
  3. Select and drag Move to drag all of the selected tiles to a new location.

You can copy and paste tiles to the same dashboard or another dashboard.

To copy and paste one tile

  1. Select the tile to display the tile-specific commands.

  2. On the tile command bar, select Copy to clipboard.

    The selected tile is copied to your clipboard.

  3. Paste the tile (Ctrl-V).

    • You can paste the copied tile to the current dashboard, in which case it's the equivalent of Duplicate.
    • You can switch to another dashboard and paste the copied tile there.

To copy and paste multiple tiles simultaneously

  1. Click one tile to select it.

  2. Ctrl-click additional tiles that you want to copy and paste.

    • Each selected tile is highlighted.
    • The total number of selected tiles is displayed on the tile command bar.

  3. On the tile command bar, select Copy to clipboard.

    The selected tiles are copied to your clipboard.

  4. Paste the tiles (Ctrl-V) to the same dashboard or switch to another dashboard and paste them there.

You can duplicate one tile at a time or duplicate multiple tiles simultaneously.

To duplicate one tile

  1. Select the tile to display the tile-specific commands.

  2. Select Duplicate.

    A copy of the tile is created on the current dashboard.

To duplicate multiple tiles simultaneously

  1. Click one tile to select it.

  2. Ctrl-click additional tiles that you want to duplicate.

    • Each selected tile is highlighted.
    • The total number of selected tiles is displayed on the tile command bar.

  3. On the tile command bar, select Duplicate.

    The selected tiles are duplicated on the current dashboard.

You can delete one tile at a time or select and delete multiple tiles simultaneously.

To delete one tile

  1. Select the tile to display the tile-specific commands.
  2. On the tile command bar, select More actions > Delete.
  3. In the Are you sure you want to delete this tile? message, select Cancel or Delete.

To delete multiple tiles simultaneously

  1. Click one tile to select it.
  2. Ctrl-click additional tiles that you want to delete.
    • Each selected tile is highlighted.
    • The total number of selected tiles is displayed on the tile command bar.
  3. On the tile command bar, select Delete.
  4. In the Are you sure you want to delete this tile? message, select Cancel or Delete.