Introduction to chart builder

Access to this feature depends on your subscription level.

With the New Relic One chart builder, you can run queries of your data to create custom charts and other visualizations. You can also build custom dashboards containing multiple charts.

To get to the chart builder, go to and at the top of the page, select Chart anything.

Chart creation workflow

There are four stages in specifying your data and creating your chart:

cb-intro-stages.png > Chart builder: Use chart builder to specify data for a chart, customize the chart, share the chart with others, and add it to a dashboard.

Specify your data

Chart builder offers two methods for specifying the data you want to see in a chart: basic mode and advanced (NRQL) mode.

Basic mode doesn't require a query language, and so it's useful if you aren't familiar with NRQL or SQL. It's also a quick way to answer one-off questions, such as how many cities outside of the United States are accessing the shopping site for your company. Basic mode guides you through the process of:

  • Choosing your data source. In basic mode, you'll start by selecting an event and then choosing the attribute that corresponds to the information to show in your chart.
  • Specifying (filtering) the data for your chart. You can narrow the results and choose an attribute to facet by.
  • Selecting the time range to present in the chart. You can select a time range from the menu or use the custom option to create your own time range.
Example of data defined using basic mode > Chart builder > Basic mode: Guides you through the process to specify data for a chart.

See Use basic mode to specify data for more information about this feature.

With the advanced (NRQL) mode you can create your own queries using the NRQL query language. NRQL queries may be simple or complex, depending on what data you want to use and how to display it in your chart. This example of the advanced mode shows the NRQL query with the same data as used in basic mode.

Example of data defined using advanced (NRQL) mode > Chart builder > Advanced (NRQL): Use advanced (NRQL) to write a query that specifies data for a chart.

With APM's real time streaming, you can query and visualize your data for transactions, errors, and custom events in New Relic One and Insights dashboards in near real time.

See Use advanced (NRQL) mode to specify data for more information about using this feature.

You can switch between basic and advanced modes while defining your data, whether you want to customize some of the values or just to learn about how NRQL queries are structured using the data you specified in basic mode.

If your query was started using basic mode and if you make changes to that query using advanced (NRQL) mode, you cannot return to basic mode to edit that query. Any additional changes may only be done in advanced (NRQL) mode.

Once you have specified the data you want to view, your chart is ready to view. Your query will automatically run in basic mode as you make changes to the inputs. If using advanced (NRQL) mode, run your query.

Customize your chart

Based on the data you specified, chart builder selects the chart type that displays your results most effectively. However, you can choose from other available chart types to present your data in the visual format that you want to use.

In this example, you run a query to get information about the response time of your application.

Chart builder uses the Line chart type for the results. > Chart builder > Advanced (NRQL): Example of the line chart type.

Chart builder uses the line chart type to display the data. Chart builder also lists other options for displaying your data. This example shows the area chart type:

Data shown with area chart type > Chart builder > Advanced (NRQL): Example of the area chart type.

Depending on your data, not all chart types will be appropriate for your data. For example, for the chart we've been viewing, the pie chart type would not present the information in a meaningful way.

Share your chart

To share a chart: select Share. Available share options include:


You can add a high-quality image to documents or other assets.


When a chart is created in chart builder, an embed is created, encased in a <div> tag, and is ready to be added to a website. If the chart is run from the dashboard, a regular link is provided.

Comma-separated value

Used for the table chart type. The .csv file is designed to be added to a spreadsheet.


Used only for the JSON chart type. Useful for developers who want to access information in the JSON for use in their software programs or for troubleshooting issues that were detected in the chart.


Use your charts has detailed information about sharing charts.

Add your chart to a dashboard

Learn how to add charts to a dashboard.

For more help

Recommendations for learning more: