Build dashboards and charts with sample data, create an alert, and get pointers to more info.

This tutorial uses Wavefront sample data to get you started. To complete these tasks you need:
  • Access to a Wavefront instance. If your company doesn't have one, sign up for a free trial
  • Dashboard permission and Alert permission. Trial users have these permissions. If you're not in a trial, your Wavefront administrator can grant the permissions if you don't have them.
click here for the classic doc

Step 1: Explore Sample Dashboards and Metrics

Your Wavefront instance includes tutorial and tour dashboards that we built using sample metrics. Let’s have a look at a tutorial dashboard.

  1. Log in to Wavefront.
  2. Select Dashboards > All Dashboards.
  3. In the Tags section of the filter bar on the left, click the ~welcome.tutorial tag
  4. Click each dashboard.
  5. Examine some of the charts by selecting the chart title.
select ~welcome.tutorial

click chart title to select a chart

Next, let's have a look at some metrics in the Metrics browser.
  1. Select Browse > Metrics.
  2. In the Metrics field, type ~sample. (include the period). The sample metrics categories (shown on the right) display
  3. Explore folders until you see a chart icon representing a metric, and click the icon to display a chart with the metric.
sample metrics

Step 2: Create a Dashboard

The Wavefront UI supports several ways of creating a dashboard.

Option 1: Use Dashboard Builder

Use our Dashboard Builder drag-and-drop interface to quickly create a dashboard from your metrics. You can start with metrics, charts, or integrations and create one or multiple charts.

It’s easy to create a dashboard from metrics or by selecting a chart.

To create a dashboard:
  1. Select Dashboards > Create Dashboard from the taskbar.
  2. Drag the Metrics or New Chart widget onto the canvas
  3. Select metrics, filters, and functions now or later.
  4. In the top right, click Save and specify a name and URL for the dashboard. The URL field supports letters, numbers, underscores, and dashes. The Name field supports letters, numbers, characters, and spaces.
create dashboard

Option 2: Save a Chart to a New Dashboard

Saving an existing chart to a new dashboard is another easy way to create a dashboard. We create a copy of the chart, and create new dashboard with the name and URL you specify.

This example uses a chart from our Tour Pro, which is a set of dashboards for exploring typical customer use cases. Tour Pro also includes a dashboard that monitors a sample cluster and one dashboard that monitors a single host.

Task 1: Open the Sample Cluster Metrics dashboard. 
  1. Log in to Wavefront.
  2. Select Dashboards > All Dashboards.
  3. In the Search field at the top, type Sample Cluster and press Enter.
  4. Click the Sample Cluster Metrics dashboard link.
Sample Cluster
Task 2: Open a chart in the dashboard. 
  1. Select Jump To > App Servers to go to the App Servers section.
  2. Click the Requests chart title.

The stacked area chart opens in the chart editor. This chart displays the query:
last(ts("~sample.requests.total.num", az=${az}, env=${env}))

The query returns the total number of requests (~sample.requests.total.num) metric, filtered by availability zone and environment. The last() function fills in any gaps in data with the last known value of the metric.

Sample Cluster
Task 3: Add the chart to a new dashboard. 
  1. With the chart still in the chart editor, click Save in the top right corner.
  2. Select Save to a New Dashboard and specify a dashboard url.
The new dashboard is created, with a clone of the chart in the chart editor.
save to new dashboard
Task 4: Edit the chart in the cloned dashboard. 

The chart is currently using variables to determine what to display. Let's simplify the chart to show only metrics for the dev environment.

  1. With the chart still in Edit mode, select the variables and replace them with env=dev. Auto-complete offers options as you type.
  2. Experiment with some of the chart types available from the pull-down menu on the left.

For an introduction, see the Chart Builder page.

select environment select chart type

Dashboard Videos

These two 90-second videos show how to do it:

Creating Charts with Chart Builder

Customizing Dashboards

Step 3: Create an Alert

In this section you create an alert that fires when the request latency metric reaches a certain threshold. One way to create an alert is directly from a chart.

Task 1: Create the alert. 
  1. In the App Server section of the dashboard, click the Request Latencies chart title to open the chart.
  2. Click the ellipsis icon on the right of the query and select Create Alert.
The Create Alert page displays.
Create Alert menu item
Task 2: Customize the alert. 
  1. In the Name field, replace New Alert with Latency Alert.
  2. At the end of the Condition field, type > 210. We're deliberately setting this alert threshold low so you can see the alert fire after a few minutes. In normal practice, you would set the threshold to an anomalous value.
  3. In the Alert fires field, change the value to 2 and press Enter. The alert fires whenever the moving maximum of the latency is greater than 210 for 2 minutes.
  4. In the Targets field, type your email address.
  5. Click Save.
create latency alert
Task 3: Observe and snooze the alert. 
  1. To watch the alert fire, click Alerting in the taskbar.

    Because your alert was the most recently created, you should see it with the state CHECKING.

    Watch the state change to FIRING and check your email.
  2. Select the alert's check box, click Snooze and select Forever.

    You'll receive a second email that the alert was snoozed.
create latency alert snooze alert

Learn More

Wavefront offers an onboarding (Getting Started) workflow, tutorial and tour dashboards, in-product help, videos, docs, and other resources.

Intro Videos

This doc set and the VMware Learning Zone include videos that help you understand basic concepts, learn the mechanics of customizing the Wavefront UI, and use advanced features.

In-product Tutorials and More

We offer in-product or external resources:

  • Learn Wavefront in Wavefront: Getting Started workflow, tutorial and tour integrations, help panel, integration setup examples.
  • Tutorials, Videos, and More: This doc set includes tutorials, reference documentation, FAQs and recipes, videos, and more. See Learn Wavefront

Getting Started Docs

Click a tile for doc about integrating with Wavefront, visualizing your data, refining what you see with queries, and alerting with Wavefront.

Integrate

Explore our integrations

Visualize

Get started with charts and dashboards

Query

Understand Wavefront Query Language

Alert

Get started with alerting.

Release Notes

Release notes summarize the features added to each release and changes to existing features.