• Log inStart now

Working with touchpoints

Touchpoints are the most granular entities within the PathPoint model and behave similarly to a specific browser application or APM (Application Performance Monitoring). Each step of a Pathpoint is connected to one or more touchpoints, and the status of every stage is determined by the culmination of its respective touchpoints.

Since touchpoint is the pulse of each Pathpoint, it is crucial to test, tune, and work with Touchpoint Queries to obtain the desired data accurately.

On this page, you learn to:

  • Test a touchpoint
  • Tune touchpoint thresholds
  • Run touchpoint queries
  • Turn off touchpoint

Test a touchpoint

Pathpoint offers the functionality to test the validity and health of a specific touchpoint.

To test a touchpoint:

Step 1 of 3

Select a touchpoint to test. Right click on it and click Queries.

Step 2 of 3

It opens a dialogue box. On this window, click Test.

Step 3 of 3

Now you see the result of the test.

In this example, we see Successfully validated, meaning that your touchpoint is healthy.

If the validation fails, find out why, and fix it. Then, test it again until you get the Successfully validated message.


When testing a touchpoint, if you get an Incorrect validated error, it might be caused by the query being ran on the wrong account ID.

Verify that you're running the query on your account in the accountId dropdown.

Tune touchpoint thresholds

One way to get better data from your touchpoints is to tweak their tuning configuration. Note that the initial values you see during the tuning process are defined by the JSON file uploaded to your Pathpoint. However, you can manually adjust these values later as well.

To tune a touchpoint:

Step 1 of 2

Select a touchpoint to test. Right click on it and select Tune.

It opens a dialogue box window showing the threshold values for the selected touchpoint.

Step 2 of 2

Enter new Min and Max threshold values and click Save/Update.

Your touchpoint is now tuned with new threshold values.

Run touchpoint queries

Touchpoint queries are written in NRQL which is New Relic's SQL-like query language. NRQL enables you to retrieve detailed New Relic data and gain insights into your applications, hosts, and business-critical activities. Although touchpoint queries are programmed using the JSON file uploaded to your Pathpoint, you can also manually modify them, as long as you don't change the main query variable that the touchpoint is looking to get.

To run a touchpoint query:

Step 1 of 2

Right click on the particular touchpoint you want to work with and click Queries.

It opens a dialogue box window.

Step 2 of 2

In the dialog box, you see the NRQL query associated with the touchpoint.

Now, you can modify the query to get different results from the selected touchpoint.

Turn off a touchpoint

If you need to work on or troubleshoot a specific touchpoint in Pathpoint, you can disable it manually. Once you've resolved any issues, you can reactivate the touchpoint to resume monitoring.

To turn off a touchpoint:

Step 1 of 2

Select a touchpoint to turn off. Right click on it to open a pop-up window with options.

Step 2 of 2

Click on the On symbol to turn off the touchpoint.

The touchpoint is now off.

Later on, you can follow the same steps to enable the touchpoint again.

Copyright © 2023 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.