This document explains what non-web transactions are in APM, and how you can instrument background tasks and other arbitrary activity to be reported as non-web transactions.
The two main New Relic APM transaction categories are web and non-web.
- Web transactions are transactions we detect as being initiated by a web request; they are the most common type of transaction reported by APM.
- Non-web transactions are transactions that are not web transactions; we do not detect they were initiated by a web request. This includes processes and jobs that do not handle web requests, such as message processing and background tasks.
For example, you might schedule something to run periodically on your server to do database work, send emails, etc. The source is not a web request but something on your server.
Some non-web transactions from supported frameworks or services are detected automatically by New Relic; others may be created using custom instrumentation. We intentionally separate your web and non-web transactions in the UI.
Non-web vs. web transactions
Less directly important
Non-web transactions are often background processes and tasks, and they are less directly important to your application's users when compared to web transactions.
Non-web transactions are often long-running processes. Separating them from web transactions prevents those results from skewing your customer-facing response times.
Omitted from Apdex score
Combining your non-web transactions with your web transactions would hurt your Apdex score (a measure of satisfaction with load times). This is why Apdex data for non-web transactions does not appear in the UI.
To create new non-web transactions, follow the procedures for your APM language agent.
To view non-web transaction data in the New Relic UI, go to the main chart on the following pages, and then select the Non-web option in the dropdown:
- New Relic Explorer: Go to one.newrelic.com > Explorer > (select an app) > Summary.
- APM: Go to one.newrelic.com > APM > (select an app) > Summary.
- Transactions: Go to one.newrelic.com > APM > (select an app) > Monitor > Transactions.
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's data security and licenses documentation.