New Relic for Beginners: What Observability Actually Means and How to Start
Most engineering teams know they need monitoring. Fewer understand what observability actually means — and why the distinction matters when something breaks at 2am.
This guide walks you through the foundational concepts and gives you a practical starting point with New Relic.
Monitoring vs. Observability
Monitoring tells you when something is wrong. A CPU alert fires. A service goes down. An error rate crosses a threshold. Monitoring answers: is the system healthy?
Observability tells you why something is wrong. It gives you the ability to ask arbitrary questions about system behavior — from the outside — without having to deploy new instrumentation every time you hit an unknown failure mode.
The three pillars of observability are:
- Metrics — numeric measurements over time (response time, error rate, throughput)
- Traces — end-to-end records of individual requests as they travel through distributed systems
- Logs — timestamped records of events inside your application
New Relic unifies all three in a single platform, with a common query language (NRQL) that works across all data types.
Your First New Relic Setup
Step 1: Create an Account and Note Your Account ID
Sign up at newrelic.com. Your Account ID is visible in the URL when you are logged in — you will need it for agent configuration. Write it down.
Step 2: Install the APM Agent
APM (Application Performance Monitoring) is where most teams start. New Relic provides agents for Node.js, Java, Python, .NET, Ruby, PHP, and Go.
For a Node.js application:
npm install newrelic --save
Then create newrelic.js in your project root:
exports.config = {
app_name: ['Your App Name'],
license_key: 'YOUR_LICENSE_KEY',
logging: {
level: 'info',
},
};
Require it as the first line of your application entry point:
require('newrelic');
Within minutes of deploying, New Relic begins collecting response times, throughput, error rates, and transaction traces — with zero additional code.
Step 3: Explore the APM Summary
In the New Relic UI, navigate to APM & Services and select your application. The summary view shows:
- Web transaction time — how long your endpoints take on average
- Throughput — requests per minute
- Error rate — percentage of requests resulting in errors
- Apdex score — a satisfaction metric combining response time thresholds
The transactions view shows which specific endpoints are slowest. This is usually where you find your first actionable insight.
Understanding NRQL
NRQL (New Relic Query Language) is SQL-like and used to query all New Relic data. You do not need to master it immediately, but understanding the basics makes every other part of the platform more useful.
The basic structure:
SELECT <attribute> FROM <data type> WHERE <condition> SINCE <time range>
Examples:
-- Average response time for the last hour
SELECT average(duration) FROM Transaction SINCE 1 hour ago
-- Error rate by endpoint
SELECT percentage(count(*), WHERE error IS true)
FROM Transaction FACET name SINCE 30 minutes ago
-- Count of a specific log pattern
SELECT count(*) FROM Log WHERE message LIKE '%timeout%' SINCE 1 day ago
NRQL results can be visualized as line charts, bar charts, tables, or billboard values — and saved to dashboards.
Setting Up Your First Alert
An alert in New Relic has three parts:
- Alert policy — the container (one per team or service is a good starting point)
- Alert condition — the NRQL query + threshold that triggers an alert
- Notification channel — where alerts go (email, Slack, PagerDuty, etc.)
A simple error rate alert:
SELECT percentage(count(*), WHERE error IS true)
FROM Transaction
WHERE appName = 'Your App Name'
Set the critical threshold to trigger when this value exceeds 5% for at least 5 minutes. This prevents alert storms from transient spikes.
What to Instrument Next
Once APM is running and your first alerts are in place:
- Browser monitoring — instrument your frontend to track real user experience, not just server-side performance
- Synthetic monitoring — set up scripted checks that simulate user journeys and alert before real users are affected
- Infrastructure monitoring — install the infrastructure agent on your servers or containers to track CPU, memory, disk, and network
- Log management — forward your application and system logs to New Relic for correlation with metrics and traces
Observability is not a one-time setup. It is a habit of instrumenting what you care about before it breaks — not after.