The custom dashboards feature (v2) allows you to create dashboards containing charts and tables with metric timeslice data from New Relic APM agents, plugins, and the REST API. It also provides a way to view your custom metrics by adding them to your custom dashboard.

The Metrics value you select will affect the type and amount of information that appears on your chart or table. For example, to select multiple metrics and plot a multi-series graph on your dashboard, you can use:

Specific metric values, such as WebTransaction/accounts/create (referred to as Controller/accounts/create for Ruby users)

Wildcards, such as WebTransaction/* (referred to as Controller/* for Ruby users)

Add charts, tables, and data

After you give the new dashboard a name and select the layout, you can add one or more charts or tables to it. You can also select the type of information that will appear in each chart or table.

Select your choice from the list of available agents for the selected type; for example, a specific web application, mobile application, host or instance, or plugin component or instance.

Select how the information will appear on your dashboard (Visualizer): chart or table.

From the preview widget, fill in the fields as applicable.

To save the chart or table in your dashboard and view it, select Save and preview.

OR

To exit without saving your edits, click anywhere outside the widget.

To exit and go to your custom dashboard, select Save and finish.

When finished with your custom dashboard, select I'm done editing.

After you select Save and finish, you can continue adding more charts and tables (maximum of 15) to your custom dashboard. You can also make changes to existing charts and tables, or delete them.

Time windows for charts

When you create a custom dashboard (v2), you can change the time period for information that appears on your charts by changing the time picker value (for example, last 60 minutes, last 7 days, etc.). The time period for your custom dashboard is dynamic, because the charts you add will adjust automatically with the time picker. You also have the option to lock specific time periods to New Relic charts that you add to your custom dashboard.

Time windows for custom dashboard charts: Here are examples of charts on a custom dashboard with (A) a dynamic, unlocked time window, (B) a time period locked to a fixed interval that moves with time, and (C) a snapshot time period that does not change.

Example: You create a custom dashboard with three charts with different time windows. You set the custom dashboard's time picker to Last 6 hours, ending now. Depending on the type of time window selected for each chart, different data appears:

Custom dashboard with time picker set to

"Last 6 hours, ending now"

Chart data at 3:00 p.m.

Chart data at 4:00 p.m.

Dynamic (unlocked) chart

Follows custom dashboard's time picker set to Last 6 hours

9:00 a.m. to 3:00 p.m.

10:00 a.m. to 4:00 p.m.

Fixed interval chart set to Last 30 minutes

Follows custom dashboard's time picker but keeps 30-minute time period

2:30 p.m. to 3:00 p.m.

3:30 p.m. to 4:00 p.m.

Snapshot (locked) chart set to June 28-30

Keeps time period from original dashboard

June 28-30

June 28-30

Dynamic (unlocked) time periods

Dynamic charts show data for the time interval you select with the time picker, such as the last 6 hours, a date range, etc. When you change the time picker on the custom dashboard (for example, Last 6 hours ending now), the chart changes to match.

Examples:

Chart you create for a custom dashboard

New Relic chart on a custom dashboard that is not locked (chart A in the screenshot above)

New Relic chart on a New Relic dashboard

Fixed intervals that move with time

When you add an existing New Relic chart to your custom dashboard by selecting Add to dashboard, you have the option to lock the chart's time picker value from its original New Relic dashboard. For example, if the New Relic dashboard's time picker shows last 30 minutes, last 3 days, etc., you can lock that range when you add the New Relic chart to your custom dashboard.

These charts show data for a fixed time interval, but they adjust to your custom dashboard's time picker. For example, if you change the time picker to the Last 6 hours ending now and the chart was originally Locked to 30 minutes, this chart will show the past 30 minutes of information from the current time. Any other dynamic charts on the dashboard will show the past 6 hours from the current time.

Examples:

New Relic chart locked to a time span; for example, last 30 minutes (chart B in the screenshot above)

This option is not available for charts you create for your custom dashboard.

Snapshot (locked) time periods

When you lock a New Relic chart to a specific time period in the past (from a custom date or range) and add it to your custom dashboard, the chart only shows data for that time period. It does not adjust with your custom dashboard.

This is useful to have comparison data for different time periods when viewing other charts on your custom dashboard. For example, if you change the custom dashboard's time picker to the Last 6 hours ending now and the New Relic chart was originally Locked to 3 days for June 28-30, the New Relic "snapshot" chart will continue to show its original time period (June 28-30), regardless of the current date or selected time period for your custom dashboard's time picker.

Example: New Relic charts are the only kind of charts that can be locked to a custom date range in the past before being added to your custom dashboard (chart C in the screenshot above). The snapshot time period option is not available for charts you create for your custom dashboard.

Metric naming conventions

When you build a chart or table for your custom dashboard, the Metrics, Limit, and Value fields work together to determine what appears. Custom dashboards support metric timeslice data.

Metric naming examples

The root (initial) metric folders contain much of the metric timeslice data used to show data about your application throughout New Relic. Use the arrow keys to view a metric and its sub-folders, then press Enter to select your choice, or include a wildcard * with the value. For example, you could select:

Apdex/* (all Apdex information)

Apdex/accounts/* (Apdex for all accounts)

Apdex/accounts/new (a specific type)

Tools > Custom dashboards > (selected dashboard) > Edit: Here is an example of how the Metrics, Limit, and Value fields determine what appears in your chart or table.

To plot the response time for a single web transaction (or controller/action), select the metric value named WebTransaction/accounts/index (or Controller/accounts/index, if your app has an accounts controller). This will plot a transaction that shows an index of accounts.

To plot a multi-series chart of all web transactions (or controller/actions) dealing with accounts, use the * wildcard. For example, from the Metrics field, select WebTransaction/accounts/* or Controller/accounts/*.

Metric folders

The custom dashboards (v2) feature includes many root metric timeslice folders for you to experiment with. Here are some of the most common.

Metric timeslice folder

Explanation

EndUser/

All Browser metric timeslices, including web transactions from the browser perspective. Without the trailing slash, this name also serves as a metric timeslice and will plot overall response time and throughput from the browser perspective for your entire app.

Database/ or ActiveRecord/ (Ruby)

Database performance from the app's perspective.

HttpDispatcher

A single metric timeslice with summary data about your entire app in aggregate. This metric does not include a trailing slash.

Custom/

Custom metrics that you may be tracking (for example, Custom/MyMetric/My_label). The Custom/ prefix is required for all custom metrics.

Value and Limit fields

By default, metric timeslices plotted on your chart or table appear in order from the highest to the lowest number. For example, if you choose Average response time for the Value field, this plots the slowest to fastest response times for the selected metric timeslices. Typical values include Average response time or Requests per minute (rpm).

A custom metric can be any kind of value, so you must select one of the available types from the Value field. You cannot customize the type of Value you select in the UI, but you can use the Y-axis unit label field for additional clarification.

In addition, the Limit field controls the number of series visible on the chart. It defaults to five unless your metrics value includes a wildcard. For example, to plot the top ten slowest web transactions, use these values:

Metrics: WebTransaction/*

Value: Average response time

Limit: 10

Troubleshooting metric auto-completion

Sometimes metric names do not auto-complete when you type them in. New Relic imposes a soft limit of 2250 unique metric names. If your application exceeds the limit, the auto-complete may not return all metrics.

If you have an application that is not returning all metric names in the auto-complete, use the REST API to list metric names for your app. Once you have the full metric name, you will be able to copy and paste the metric name in the Metric(s) field and proceed from there.

Exception: The embed function is not available with custom dashboards.

Blank areas on charts

If an area on a chart appears blank when you preview it, this may be due to the selected time value. For example, if a chart shows data in minutes, areas with activity in milliseconds may be empty.

To view data, use the edit widget to change the Value field for an individual chart or table as needed. Or, use New Relic's time picker to change the time period for the dashboard itself.

Edit v2 dashboards

After you select Save and finish on a new or existing custom dashboard, you can continue making additions, changes, and deletions to your own charts. Your custom dashboard includes tools to edit, delete, and move charts and tables on it.

You cannot edit existing New Relic charts that you add to your dashboard. However, you can move or delete them.

Editing tools and functions

Here are some of the standard tools and functions for editing your custom dashboards.

Change names and labels

If you want to...

Do this...

Rename the dashboard

Type a new name where the original name appears at the top of the dashboard.

Add labels to a chart or table

To give the chart or table a name:

Select the edit [pencil] icon for the chart or table.

From the edit widget, select the Title field.

This is useful, for example, to identify an app or server if you select a specific one.

To identify the type of units on your table or chart (seconds, kbps, etc.): From the edit widget, use the Suffix field.

Define the Y axis for a chart or table

Select the edit [pencil] icon for the chart or table.

From the edit widget, type a value in the Y-axis unit label field.

For example, you may want to clarify that the Y axis shows data in milliseconds, seconds, pages per minute (PPM), etc.

You can also use the edit widget's Suffix field to clarify what appears on your chart or table. This is useful, for example, when the Y axis is not related to a time value.

Change individual charts and tables

If you want to...

Do this...

Change a chart to a table, or vice versa

Select the edit [pencil] icon for the chart or table.

From the edit widget, select Visualizer, then select your choice.

Add more charts or tables to an existing dashboard

From the selected dashboard, select Add chart or table, then follow standard procedures to create another chart or table.

Insert an existing New Relic chart into an existing dashboard

From an application, mobile application, server, or plugin dashboard with charts, follow standard procedures to select Add to dashboard, then select the existing dashboard's name. To move or delete the chart on your custom dashboard, select the here link that immediately appears.

Select how many items to show on a chart or table

The Limit field defaults to the top five unless your Metrics value includes a wildcard (*). Also, the sorting value depends on the Metrics you select.

Typically items sort from slowest to fastest, so your chart or table will show the top five slowest items. However, if you include a wildcard (*) with the metric, then you can specify the number of items that show.

For example, if you type 25 for a table, then your custom dashboard will show the first five rows of the table and include a link indicating how many more rows are available.

To select how many items to show on a chart or table:

Select the edit [pencil] icon for the chart or table.

From the edit widget, type a value in the Limit field.

Change dashboard structure

If you want to...

Do this...

Rearrange charts and tables

Select the Column icon , then drag the chart or table to a new location on the dashboard.

Remove a chart or table from the dashboard

Select the delete icon for the chart or table, then select the confirmation prompt to cancel or continue.

Select I'm done editing to return to the custom dashboard, then use the time picker to change the range.

If an existing New Relic chart on your dashboard has been locked to a specific time period, you cannot change it. Instead, you can delete the New Relic chart, add it to your dashboard again, and this time do not select the Lock to span checkbox.

Delete the entire dashboard

If you delete a custom dashboard, you cannot recover it. If you accidentally delete the wrong custom dashboard, you will need to re-create it.