Metrics Explorer

A metric is a measurable attribute or occurrence related to an observed entity, such as the average CPU utilization of a network device. Metric values can be used to evaluate performance or identify potential problems.

Open the Metrics Explorer

In the left pane, click Analyze > Metrics. The Metrics Explorer lists the metrics collected for all of your observed entities.

You can filter metrics listed in the Metrics Explorer based on the selected time period, hiding metrics that are not available or have no data.

To view charts for multiple metrics side-by-side to compare similar data sets or view related metrics simultaneously, check the box next to the desired metrics and then click Compare Metrics at the top of the page.

A pane opens and displays line charts for each of the selected metrics. Click the X, in the top-right corner, to close this pane.

Locate a metric

Use the Search box to search for a specific metric or to filter the list of metrics. When you enter a string in the Search box, the Metrics Explorer displays only the metrics whose name includes that string.

The search is not case sensitive.

Change the time period

To change the time period, click the drop-down menu in the upper-right corner and choose how much historical data to display. You can choose to view all recent data for standard lengths of time, or to view data between two dates.

To show data from a custom time period, choose Custom. In the calendar that appears, click the starting date of your time period and click the ending date. The time period's start and end times default to the current time. To change a start or end time, click the clock next to the time you want to change and click the desired time.

The value selected will carry over to the metrics details pane for a selected metric, but it can be changed within the metrics details pane.

View metric details

Click a metric to open the metric details pane.

A line chart represents the metric values data collected during the specified time period. To change the time period, click the drop-down menu in the upper-right corner and choose how much historical data to display. You can choose to view all recent data for standard lengths of time, or to view data between two dates.

To show data from a custom time period, choose Custom. In the calendar that appears, click the starting date of your time period and click the ending date. The time period's start and end times default to the current time. To change a start or end time, click the clock next to the time you want to change and click the desired time.

The table below the chart includes a column for each tag associated with the selected metric. Tags provide details about where the metric data came from. For example, a metric that measures the average CPU utilization of a network device might have tags that include the device name, the device type, and the device location. If you are observing devices named Router1 and Router2, then data coming from the first device would be tagged Router1, and data coming from the second device would be tagged Router2.

Most tags are applied automatically, and they are based on defaults during ingestion. For some entities, tags can be customized. For example, when you monitor a service with an APM library, you can define custom tags to be applied to the monitored data.

Each line on the chart and each row in the table represents a measurement stream. A measurement stream is a set of data that came in with the same combination of tag values. For example, a metric has tags indicating the name of a service and the host on which it ran. Data tagged with Service1 and Host1 would be in one measurement stream, while data tagged with Service1 and Host2 would be in a different measurement stream.

View metric values

Position your mouse pointer over the chart to see the metric values for each measurement stream at a specific point in time.

Group measurement streams

To group measurement streams that have the same value for one or more tags, select the tags from the Group By drop-down menu.

When you group measurement streams, each line in the chart represents a set of data with the same values for the selected tags. Values for other tags might be different. The table columns include only the tags used for grouping. In the following example, each line represents data that came from services that have the same name and ran on the same host.

To ungroup measurement streams, click the X in the box that represents each tag name.

Select aggregate method

By default, data is aggregated by the average value of the tags. To choose the method used to aggregate (count, sum, etc.), use the drop-down menu to change the selection.

Filter by tag values

Apply filters to see only metric streams with a certain value for one or more tags.

1. Click inside the Filter By box.

   The Tags drop-down menu displays the tags available for this metric.

2. Click a tag name.

   The Tag Values drop-down menu displays all values for the selected tag that are assigned to currently displayed metric streams.

3. Click a value.

4. Press Enter to apply the filter.

   The chart and table show only measurement steams with the specified value for the selected tag.

   

   To further refine the list, you can add other tags. If you include multiple filters, metric streams must match all filters.

To remove all filters, click the X in the Filter By box.

Save filter combinations

If you regularly apply the same combination of filters, you can save the combination as a "saved search" and quickly run it again.

Save a search

1. Apply filters to define the combination you want to save.

2. Click the folder icon on the right side of the Filter By box, and click Save Search.

   The Create Saved Search dialog opens.

3. Enter a name to identify the search.

4. If you want the saved search to be available only to you, select Private.

5. Click Save.

Run a saved search

1. Click the folder icon on the right side of the Filter By box.

   The drop-down menu lists the saved searches for metrics that you have access to.

2. Click the name of the search you want to run.

Save the current view to a dashboard

To save the current view of the metric as a widget, add it to a dashboard.

1. On the metrics pane, click the menu button in the top-right corner.

2. Click Send to Dashboard.

3. Select an existing Dashboard and enter a name for the widget, or click New Dashboard and complete the following fields.

   • Dashboard Title – a title for your custom dashboard where you can view various widgets you select or create

   • Private – visible only in your dashboards

   • Widget Title – a title for the selected filter settings for the selected metric

4. Click Save.