Glossary

A glossary of common terminology you may encounter as a New Relic user.

account dropdown

New Relic account dropdownAfter you sign in to New Relic, your account name appears on the right of the New Relic menu bar. To use available account functions, such as changing your password or other user preferences, selecting a different New Relic account, or logging out, select the dropdown.

Depending on your role, from the account dropdown you may also view or change other account settings, such as account users, subscription and pricing levels, credit card and other billing information, account usage, etc.

administrator

A user role that can access all features of New Relic except billing information. Admins manage New Relic account settings, including API access, integrations, and other users. Admins can also enable and configure features, and delete data.

For more information, see Users and roles.

agent

The monitoring software New Relic users run on their app servers or inside their mobile apps. The agent monitors local transactions and server information. The agent then caches this data and reports it to the New Relic collector once each harvest cycle.

The form of the agent software varies:

agent API

The New Relic agent API allows you to extend New Relic's functionality. You can use the API to control, customize and extend the functionality of the New Relic agent.

For more information, see the agent-specific API documentation:

agent SDK (software development kit)

New Relic supports many of the most popular languages in use today, including Java, .NET, Node.js, PHP, Python, and Ruby. However, users who wish to extend New Relic to gain insights into web apps written in other languages and environments can do so using the Agent SDK. The Agent SDK allows you to add most of New Relic's key features to any language. The Agent SDK is currently in beta. For more information, see Getting started with the Agent SDK.

alert

An alert communicates an event or incident that designated personnel can track through New Relic Alerts.

alert condition

An alert condition contains the criteria for New Relic Alerts to create an incident record, including the threshold that is set for a New Relic or custom metric over time on a chosen target.

alert policy

A collection of one or more conditions that, if violated, can send alerts through user-defined notification channels.

apdex

Apdex is an industry-standard way to measure users' satisfaction with the response time of an application or service. New Relic rates each response as Satisfied, Tolerated, or Frustrated, and uses these ratings to calculate an overall user satisfaction score.

For more information, see Apdex: measuring user satisfaction.

apdex_f

The response time above which a transaction is considered "frustrating." Defaults to four times apdex_t.

  • Requests which complete in less than apdex_t are rated satisfied.
  • Requests which take more than apdex_t, but less than four times apdex_t (apdex_f), are tolerated.
  • Any requests which take longer than apdex_f are rated frustrated.

For more information, see Apdex: measuring user satisfaction.

apdex_t

The response time above which a transaction is considered "tolerable." The default value is 0.5 seconds, but this can be changed in your Apdex settings.

  • Requests which complete in less than apdex_t are rated satisfied.
  • Requests which take more than apdex_t, but less than apdex_f, are tolerated.
  • Any requests which take longer than apdex_f are rated frustrated.

For more information, see Apdex: measuring user satisfaction.

API (application programming interface)

API may refer to the agent API or to New Relic's REST API, which is used to programmatically extract data (primarily metric timeslice data) from your New Relic account.

application

For New Relic purposes, any program instrumented by New Relic.

application id

Each app instrumented by New Relic is assigned an application ID, often abbreviated to app ID. This ID is used to uniquely identify it, and to retrieve data about that app via the REST API.

You can find this ID by viewing the app in the New Relic UI and checking the URL:

https://rpm.newrelic.com/accounts/ACCOUNT_ID/applications/APP_ID

For more information, see Listing your app ID.

You can also find your app ID via the API Explorer.

attribute

Attributes are key-value pairs containing information that determines the properties of an event or transaction. These attributes increase the detail in your event data for several destination products. You can also collect custom attributes, to further enhance the amount of detail available. For more information, see Agent attributes.

availability monitoring

New Relic's existing alerting system uses an external "pinger" to verify that customers can reach your site. The pinger service verifies application availability by making requests to them regularly, recording errors, and sending downtime alerts when an application is down. For more information, see Availability monitoring.

browser

New Relic's user interface supports most browsers. For more information, see Supported browsers.

For New Relic's end-user browser monitoring product, see New Relic Browser.

browser trace

A browser trace provides detailed information about a single page load, similar to the way a transaction trace provides details about a single web transaction. New Relic collects browser traces for slow end-user transactions. For more information, see Browser traces.

collector

The component of New Relic that collects data from New Relic agents running on an app server, mobile device, or end-user browser. While the agent is installed on a user's app server, the collectors are centrally located in New Relic's data center. In order to contact the collector, the agent must be able to reach New Relic's domains and IP addresses. The collector receives and interprets this data, and stores it in a database. The data is then retrieved and presented by the New Relic UI.

CPM (calls per minute)

The number of calls your application receives each minute. This usually corresponds to the number of page views or external connections, and is usually the same as RPM.

CPU Burn

The time consumed by code minus the wait time for a transaction. This is the time actually spent processing the transaction. It appears in the New Relic UI at the top of the transaction view for the agents that provide it (Ruby and PHP only).

custom attribute

A key-value pair added to a transaction or event in order to gain additional information about the event. For more information, see custom attributes.

custom dashboard

A customizable dashboard with charts and tables that includes data from multiple New Relic data sources. Custom dashboards are also the only way to view custom metrics. For more information, see Custom Dashboards.

custom event

A named set of key value pairs that represents an event you would like to track with New Relic. Custom events make it possible to add new data from extenal sources.

You can insert custom events by adding your event data with the appropriate method.

custom instrumentation

Custom instrumentation allows you to extend New Relic's monitoring to instrument code elements New Relic doesn't automatically instrument. Custom instrumentation is useful when your framework is not supported by New Relic, or when New Relic fails to pick up some element of your program. You can also use custom instrumentation to block a transaction from being reported entirely. For more information, see Custom instrumentation.

custom metric

Metric timeslice data that is manually recorded via an API call. Custom metrics allow you to record arbitrary metrics (for example: timing or computer resource data). All custom metric names must be prefixed with Custom/. For more information, see Custom metrics.

Not to be confused with custom instrumentation data.

docker

An open platform for distributed applications, which allows you to assemble multi-container portable apps. Servers for Linux includes integrated Docker monitoring. For more information about Docker, see the Docker web site.

downtime

The period of time when customers cannot access your site and your app is not reporting to New Relic. For more information, see Availability monitoring and New Relic Synthetics.

entity

A component or resource that is monitored by a New Relic product; for example, applications or key transactions monitored by New Relic APM, New Relic Browser, or New Relic Mobile; servers monitored by New Relic Servers; New Relic Synthetics data (websites, transactions, API endpoints); plugins created through New Relic Platform, etc. You can identify one or more entities to be targets for alert policy conditions.

established release

New Relic defines an established release as one that has been successfully deployed and extensively used in production by New Relic APM customers. The release is not known to have any critical issues, and all the known issues have been documented.

New Relic currently has established releases for Java and .NET. In general, an established release may not be the most current agent version and therefore may not include the latest set of features and capabilities.

event

Event data is a record of a single event at a particular moment in time. An event consists of core attributes such as a timestamp and an event type, and can be annotated with many additional attributes to provide more context. For more information, see Metric timeslice and event data.

In New Relic Alerts, opening a violation and closing a violation are two unique events with time stamps. You can view a summary of alerting events across all products from the Events page in New Relic Alerts.

framework

A framework is a structured collection of pre-defined functions, into which an application builder inserts their own code to build their application. A framework is not the same as a library. While a library is a collection of functions you can call as needed, a framework is a skeleton for your application. The functions in that framework then call your functions. For more about the distinction between a framework and a library, see What is the difference between a framework and a library? .

New Relic automatically instruments many common frameworks. For more about the frameworks New Relic supports, see the following agent-specific documentation:

harvest cycle

The period of time between each connection from the New Relic agent to the collector. Between harvest cycles, the agent collects and caches data. At the end of the cycle the agent reports those data to the collector, then begins a new harvest cycle.

health status indicator

A colored bar (green, yellow, red, or gray) indicating the status of your app, server, or other entity monitored by New Relic. It also indicates whether the entity has any alert policies assigned to it with New Relic Alerts and whether there are any policy violations. The color-coded health status indicator appears next to the app, server, or other entity's name in every New Relic product index except New Relic Insights.

The New Relic REST API (v2) uses orange instead of yellow for the application's health and reporting status.

Service maps use different criteria for reporting the health of a connection between an app and an external service not monitored by New Relic (for example, a third party API).

host ID

Each host identified by New Relic is assigned a unique host ID. This ID is used to uniquely identify it, and to retrieve data about that host via the REST API.

To find the host ID: From the New Relic menu bar, select APM > (selected app), and then select your host from the Servers drop-down menu. Then, check the URL:

https://rpm.newrelic.com/accounts/ACCOUNT_ID/applications/APP_ID_hHOST_ID

You can also find your host ID via the API Explorer.

incident

An incident is a collection of one or more violations to a condition defined in an alert policy. An incident record includes all of the open and close time stamps for each violation, as well as chart snapshots of the data being evaluated around the time of each violation.

You can view detailed information from the Incidents indexes in the New Relic Alerts user interface. You can also select your preference for how New Relic Alerts rolls up policy violations into the incident.

instance ID

Each instance identified by New Relic is assigned a unique instance ID. Instance IDs are most commonly found for JVMs (Java Virtual Machines), but can exist for each agent. This ID is used to uniquely identify it, and to retrieve data about that instance via the REST API.

You can find this ID by selecting APM > (selected app) from the New Relic menu bar, then selecting your instance from the Servers drop-down menu. Then, check the URL:

https://rpm.newrelic.com/accounts/ACCOUNT_ID/applications/APP_ID_iINSTANCE_ID

You can also find your instance ID via the API Explorer.

instrumentation

The collection of data from an application or server. When New Relic instruments a framework, it detects the methods and calls used by that framework, and intelligently groups them together.

interaction

In New Relic Mobile, an interaction is a specific code path initiated by a user interaction (usually a button press). An interaction is the mobile equivalent of a transaction, and like a transaction an interaction can be traced and monitored.

interaction trace

An interaction trace is a complete picture of a single interaction. With interaction traces, New Relic gives you much deeper visibility into a single slow interaction, which can help you understand a broader problem. Interaction traces are the mobile equivalent of a transaction trace. For more information, see Creating interactions (iOS) and Creating interactions (Android).

key transaction

A web transaction that the user has marked as particularly important. Common key transactions are key business events (such as signups or purchase confirmations), or transactions with a high performance impact, such as searches. Key transactions have their own pages and other customized values. For more information, see Key Transactions.

master account

A master account is a New Relic account with related subordinate accounts, called sub-accounts. This is useful, for example, to limit users so they can view specific applications and not others.

The option to create master and sub-accounts depends on your New Relic subscription level. For more information, see Creating sub-accounts.

metric timeslice

A metric timeslice is a statistical measure that consists of three parts: A metric name, associated numeric values, and a segment of time (a "timeslice") associated with those data points. For more information, see Metric timeslice and event data.

metric grouping issue

A metric grouping issue occurs when an account sends too many differently named metric timeslices to New Relic, and those individual web transactions are not properly aggregated. For example, rather than a single /user/controlpanel/ metric name, you might see /user/controlpanel/alice, /user/controlpanel/bob, and /user/controlpanel/carol. For more information, see Metric grouping issues.

minion

The software that accepts monitor jobs from a private location. A minion is a packaged virtual appliance that runs in your hypervisor. For more information, see Private locations overview and install and configure private minions.

monitor

In New Relic Synthetics, a monitor ensures your website or API endpoint is available. For more information, see Adding and editing monitors.

New Relic APM

New Relic APM (Application Performance Monitoring) provides monitoring of your web application's performance. New Relic APM supports six languages: Java, .NET, Node.js, PHP, Python, and Ruby. For more information about New Relic APM, see Getting Started with New Relic [PDF | 1.07 MB].

New Relic Browser

New Relic Browser allows you to monitor browser-side code performance. New Relic Browser includes standard page load timing, which measures the overall time to load an entire web page. New Relic also goes beyond timing, by monitoring AJAX request performance and JavaScript errors. For more information, see New Relic Browser.

New Relic Insights

New Relic Insights is a software analytics tool to gather and visualize data from your software, and query that data in real-time. While you use APM to optimize your apps, you use Insights to monitor your business and optimize your bottom line. For more information, see New Relic Insights.

New Relic Mobile

New Relic Mobile allows you to monitor and manage the performance of your iOS, Android, and Titanium Studio applications. New Relic Mobile provides end-to-end details, including errors, throughput, HTTP requests, and even server error traces. For more information, see New Relic Mobile.

Not to be confused with New Relic's Android, iPhone, and iPad apps.

New Relic Servers

New Relic Servers allows you to view and analyze critical system data, including CPU usage, physical memory, network activity, processes, and disk I/O utilization and capacity. New Relic Servers is available for Linux/Joyent and Windows. For more information, see New Relic Servers and New Relic Servers (Windows).

New Relic Synthetics

New Relic Synthetics allows you to monitor your website or API endpoint via automated, scriptable tools. Use free ping monitor to ensure your website is accessible; or expand your monitoring with browser monitors, which test your website with real browsers. Go further with scripting, to script browsers or API monitors for sophisticated testing. For more information, see New Relic Synthetics.

NRQL (New Relic Query Language)

NRQL is a SQL-like query language for making calls against the New Relic Insights events database. Use NRQL to make real-time queries to your New Relic data, and to refine those queries to get the data you want. For more information, see Using NRQL.

notification

The message sent for a specified alerting event. The type of notification is defined by the alert policy's channel.

notification channel

A channel allows New Relic Alerts to notify you when a condition in an alert policy passes the defined Critical (red) threshold. Available channels include email, mobile push notifications, webhooks, and more.

owner

The user role that initially creates the New Relic account. The owner has complete access to all account information, including billing information. Owners receive all billing queries. Owners can manage all New Relic account settings, including API access, integrations, and other users. Owners can also enable and configure features, and delete data.

For more information, see Users and roles.

page load timing

With page load timing, New Relic monitors the full load time for end-user browsers. New Relic's application agents dynamically inject JavaScript into the page, then capture the following key load points:

  • Navigation start: The user initiates the transaction.
  • First byte: The browser receives the requested page.
  • DOM ready: The browser has finished parsing DOM.
  • Page ready: Page loading is complete.

Page load timing is sometimes referred to as RUM, or real user monitoring. Unlike standard RUM, page load timing also captures JavaScript errors and AJAX requests. For more information, see Page load timing process.

parameter

Deprecated term; see attribute.

A unique URL that links to a view of your application or server at a specific point in time. Permalinks are useful for troubleshooting, and for sharing interesting time windows with colleagues. For more information, see Permalink.

pinger

The component of New Relic that connects to your website to verify your website is accessible. New Relic has pingers in Europe, Asia, and the United States. Each pinger attempts to contact your website at least once every two minutes. If enough pingers are unable to reach your website, your application will be considered down. If you have enabled availability monitoring with New Relic's alerting system, you will be notified of the downtime.

For in-depth scriptable testing, including real browser tests and testing of API endpoints, see New Relic Synthetics. Synthetics includes free ping monitoring, which allows you to monitor your website from locations around the world.

plugin

A plugin is an extension to New Relic that you deploy to your application server. Plugins allow you to extend New Relic's monitoring and alerting functionality by connecting New Relic to additional data sources. For more information, see Welcome to Plugin Central.

plugin agent

The component of a plugin that runs on the user's premises (typically on servers) or is run on the user's behalf by a SaaS provider. The plugin agent reports data to New Relic via the Plugin API.

Plugin Central

Plugin Central is a searchable directory of New Relic plugins. For more information, see Welcome to Plugin Central.

PPM (pages per minute)

The number of pages per minute your application serves.

private location

A New Relic Synthetics feature that allows you to run Synthetics monitors from within your own systems by creating private minions. Private locations allow you to extend your New Relic Synthetics coverage to new geographical locations, and to monitor websites behind your firewall such as an intranet site. For more information, see Private locations overview.

publisher

Plugin authors who make their plugin publicly available in Plugin Central, so that other users can install and run the plugin agent and view the data in the plugin UI. For more information, see Publishing your plugin.

response time

The duration of time between a request for service and a response.

restricted user

A user role that can view (but not set up or change) New Relic features. The restricted user role is useful for demos or kiosks.

For more information, see Users and roles.

rollup

Using the same application name for multiple applications. This allows you to combine data in APM, either from multiple applications, or from multiple instances of an application. For more information, see Rolling up app data.

RPM (requests per minute)

The number of requests per minute your application receives from its users. This is usually the same as CPM.

RUM (real user monitoring)

See page load timing.

runbook

A runbook contains standard procedures and operations typically used by system administrators, network operations staff, and other personnel to handle outages, alert incidents, and other situations. If your organization stores runbook instructions as URLs, you can link this information to New Relic Alerts so your personnel has easy access to this information when an alert incident violates the defined policy thresholds.

SAML (Security Assertion Markup Language)

SAML is an XML-based data format for sharing authentication data between two parties. SAML creates end points that give an organization's users a single sign on (SSO) URL. Once logged in, users can select any applications they are authorized to use. This provides an additional level of security and simplifies user authentication. In New Relic, owners must obtain a SAML certificate in order to enable Single Sign On. For more information, see SAML service providers.

SDK (software development kit)

See agent SDK.

Selenium

Selenium is an open-source browser testing suite. Synthetics uses Selenium to test monitored websites with real browsers. For more information, see monitor types.

server ID

Each server instrumented by New Relic Servers is assigned a unique server ID. This ID is used to identify it, and to retrieve data about that server via the REST API.

You can find this ID by selecting Servers > (selected server) from the New Relic menu bar. Then, check the URL:

https://rpm.newrelic.com/accounts/ACCOUNT_ID/servers/SERVER_ID

You can also find your server ID via the API Explorer.

SSO (single sign on)

SSO (single sign on) allows you to manage user authentication in New Relic using an external SSO provider. This allows your users to login at one place for multiple applications (for instance, HipChat, Gmail, and New Relic). SSO provides an additional level of security and simplifies user authentication. Enabling SSO requires SAML. For more information, see Setting up SSO.

sub-accounts

See master account.

target

A target is a resource or component monitored by a New Relic product that has been identified in an alert policy's condition. When the condition for that target crosses the defined Critical threshold, New Relic Alerts will create an incident record and send a notification through the defined channel.

threshold

The threshold is the value you define for an alert condition, including an optional Warning (yellow) and required Critical (red) level. The threshold includes what value to alert on, the item it monitors, and what point must pass within the specified frequency or time frame.

The entity's health status indicator in the New Relic UI will change to yellow or red when the threshold is passed for the defined time period. In addition, a Critical (red) threshold's violation will create an alert incident and trigger an alert notification from New Relic Alerts.

tier

A tier represents how New Relic categorizes or visualizes the various agent language ecosystems that we support. For example:

  • In New Relic APM, the color-coded categories that appear on your app's main Overview chart show response time spent in various functions, processes, or agents as tiers; for example, request queuing, garbage collection, Middleware, JVMs, etc.
  • In New Relic labels, TIER could be used to define or classify the client-server architecture; for example, front-end and back-end tiers.
time picker

By default the New Relic UI shows data for the past 30 minutes, ending now. To change the time window, use the time picker below the New Relic menu bar. For more information, see Time picker.

time range or timeslice

A time-unit division of metric timeslice data, as displayed in the UI or extracted via the REST API. The time range has "resolution," which corresponds to the steps shown in a chart. For example, when viewing a half-hour time window, New Relic will display the data in minute increments. New Relic displays the time range appropriate for the period you select in the time picker.

For more information, see Extracting metric data.

timeslice data

The New Relic collector records timeslice data once a minute. Over time, this data is aggregated into longer timeslice data records for more efficient storage. Data is initially aggregated into hourly values, then into daily values. For more information about how New Relic aggregates data, see Data aggregation.

traffic light

See health status.

transaction

A particular path through your code. The exact meaning of a transaction varies for different New Relic products. In a web app monitored by New Relic APM, a transaction begins when a request enters your app and ends when your app sends a response. For New Relic Browser, a transaction begins at first load and ends when the page has finished rendering.

Usually New Relic will group multiple transactions into a single bucket, in order to make sense of your data. For an example of how New Relic groups transactions, see Viewing transactions; and for more about why New Relic groups transactions, see Metric grouping issues.

transaction trace

A transaction trace is a complete picture of a single transaction, down to the database queries and exact invocation patterns. With transaction traces, New Relic gives you much deeper visibility into a single slow transaction, which can help you understand a broader problem. For more information, see Transaction traces.

UI

The New Relic user interface. For more information, see The New Relic user interface and Standard page functions.

user

A user role that can add, edit, and use New Relic features. Users manage the app's performance, but cannot access account or billing information. Typically, this role is appropriate for a developer or operations person.

For more information, see Users and roles.

With New Relic Plugins, "user" refers to any consumer of a New Relic plugin.

UTC

Universal Time Coordinated (UTC), or Coordinated Universal Time, is a standard timestamp for synchronizing time around the world. With New Relic Alerts, you can view data as UTC, or you can switch to your time zone (defined from accounts > User preferences). You can also offset UTC when using the New Relic REST API (v2).

value function (metrics)

The numeric value obtained from metric timeslice data; for example, an average, minimum, maximum, total, sample size, etc.

violation

A violation is an event that occurs when an alert condition's value crosses the defined threshold. You can view a summary of the violations for a selected incident in New Relic Alerts. You can also view the violations for a specific entity from the New Relic product's UI.

WebDriverJS

WebDriver is a Selenium component, used to control Synthetics scripted browsers. Specifically, Synthetics uses WebDriverJS, a Node.js-based flavor of Selenium. For more information, see Writing scripted browsers and Scripted browser examples.

For more help

Additional documentation resources include: