What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

If your application already reports data to New Relic, the New Relic CLI lets you find the correct application, run NRQL-oriented investigations, select machine-readable output, and add deployment context without leaving a terminal. It does not collect telemetry itself: you still need an instrumented application, a New Relic account, and an appropriate user key.

This guide follows a practical workflow: install the CLI, create a region-aware profile, resolve the application’s identifiers, query the data your account actually contains, and correlate results with logs and deployment markers.

What the New Relic CLI does—and what it does not

The CLI is a command-line interface for New Relic platform features and workflow automation. New Relic’s CLI Reference describes its purpose this way: “The New Relic CLI enables the integration of New Relic into your existing workflows.” It is not an agent, SDK, or telemetry collector. Installing it on a workstation or build runner does not cause an application to send data.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Before starting, verify that the application is already instrumented and reporting to the account you intend to inspect. The CLI can query and manage platform data, but it cannot create missing PageView, transaction, log, or custom attributes retroactively.

#1 Best Overall
Sale
Compressed Air Duster,130000RPM Super Power Cordless Air Duster,Rechargeable Brushless Blower,3 Gear Adjustable Blower with LED Light,Dust Remover for Computer/House/Outdoor/Car
  • Powerful Turbo Fan:CAGIWIRU Electric Air Duster have reached speed up to 130000RPM,Can efficient remove dust and debris.With LED light and Three Adjustable Speed to meet with different cleaning tasks.
  • With Attached USB C Fasting Charging cable.Charing 3 hours,Enjoy up to 240 minutes of use on the lowest setting, For third speed can use for 25mins.with four charging options to meet with your needs.
  • Wide Application: attached 5 different nozzles,making it suitable for a variety of scenes, such as car,pet, pc, keyboards, and other electronic devices. It also serves for office and home clean duster.
  • Handy Design & Portable:Cordless air duster electric nozzle is Light weight and small size, design and comfortable to hold and space saving, convenient to carry around. You can put it in your room or inside the car without taking up space.
  • Economical &Reusable: Built durable materials with a long-lasting battery,our CAGIWIRU air duster it's a sustainable alternative to disposable air cans.

Prerequisites and the identifiers you will use

Have these items ready:

  • A New Relic account and its account ID.
  • A New Relic user key with permissions appropriate for the operations you will perform. Use the least privilege your organization allows.
  • The account region: us, eu, or jp.
  • An instrumented application that has reported data.
  • The application name as it appears in New Relic.
  • A shell where you can install the CLI and keep credentials out of shared history and source control.

Three identifiers are easy to confuse:

Identifier Where it comes from Typical use
Account ID Your New Relic account Scopes searches and account-level commands
Application ID Returned by the APM application search Commands that explicitly request an application ID, including the documented deployment example
GUID Returned by the application search Entity-oriented commands and relationships; it uniquely identifies the application entity

Use the GUID when a command asks for an entity identifier and the application ID when the command explicitly asks for an application ID. They are not interchangeable.

Install the CLI on your operating system

Installation methods can change, so confirm the current package name and release instructions in New Relic’s installation documentation before automating setup. The documented approaches are:

Operating system Documented command or method Notes
macOS brew install newrelic-cli Uses Homebrew
Linux sudo snap install newrelic-cli Uses Snapcraft; distributions may also use a downloaded package
Windows Add the newrelic-cli Scoop bucket, then install the package New Relic also documents a Windows x64 MSI
Other or locked-down environments Download a prebuilt binary or installer package Documented packages include .deb, .rpm, and Windows x64 MSI files

macOS

  1. Ensure Homebrew is available to the user account that will run the CLI.
  2. Run brew install newrelic-cli.
  3. Check that the executable is on your PATH with newrelic --help.

Linux

  1. Install and configure Snapcraft if it is not already present.
  2. Run sudo snap install newrelic-cli.
  3. Run newrelic --help to confirm that the shell can find the executable.

Windows

  1. Install Scoop if your organization permits it.
  2. Add the bucket that contains newrelic-cli, following the current Windows instructions from New Relic.
  3. Install the package and open a new shell if Scoop updated your PATH.
  4. Run newrelic --help.

Downloaded binaries and packages

Use a prebuilt binary, .deb, .rpm, or MSI when package-manager installation is unavailable or when you need a pinned artifact in a build image. Record the CLI version in that image and review release notes before upgrading; command flags and supported workflows are volatile.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Create a profile with the right key and region

A profile stores credentials and settings so you can switch between accounts without rewriting every command. The documented pattern below creates a profile named tutorial and then makes it the default:

newrelic profiles add --profile tutorial --apiKey YOUR_NEW_RELIC_USER_KEY -r YOUR_REGION
newrelic profiles default --profile tutorial

Replace YOUR_NEW_RELIC_USER_KEY with a key created for your organization and YOUR_REGION with us, eu, or jp. Do not publish a real key, place it in a committed script, or paste it into a shell command that will be retained in a shared history file.

Use profiles for account switching

Create separate profiles when you work across production and non-production accounts or across regions. Select the intended profile as the default before a session, or pass the profile option where supported. A profile change affects subsequent commands, so make the active profile visible in your shell prompt or runbook when mistakes would be costly.

Rank #2
EVEO® Screen Cleaner Spray Kit (Streak-Free) TV Screen Cleaner for Smart TV, Lcd, LEd, Oled | Computer Screen Cleaner Spray and Wipe Microfiber Cloth - TV, Monitor, Laptop, iPad, Car - 6.7oz 1 Pack
  • Screen Cleaner is Your Screen’s New Bestfriend! - EVEO is proud to present a screen cleaner that’s perfectly suited for your TV. Meet your new screen cleaner, computer screen cleaner, laptop cleaner, iPad cleaner, Macbook,tv cleaner or any other electronic device. Our screen cleaner spray and wipe along with the included plush microfiber cloth, easily removes dust, fingerprints & other smudges on the screen’s surface. Clean effectively for a streak-free screen
  • Gentle on your Screens - Our screen cleaner spray and wipes is compatible to be used even for the most sensitive LCD, LED, CRT, and OLED screens in proper use. Be at ease knowing that this product is compatible with all the major brands: LG, SONY, Samsung, Sharp, iPad, iPhone, Android screens, Kindle, PC monitors - we’ve got you covered! Can be used as LCD screen cleaner, tv cleaner, smart tv screen cleaner, and more
  • Premium Super Soft Plush Microfiber Cloth - Included in this efficient screen cleaning kit. This screen cleaner spray and wipe has our signature plush microfiber cloth specially designed to comply with screens and monitors and leave them streak-free. Has been shown to effectively absorbs stubborn stains, zero streaks, and no fiber shedding. Always use this together with our screen cleaner for the best results
  • Easy-to-Use Screen Cleaner Kit + microfiber cleaning cloth - The EVEO Screen Cleaning Kit will easily be your new favorite tool when it comes to taking care of the things you love most, quick and easy solution for a streak-free screen. Simply screw on the sprayer gun on the screen cleaner bottle. Spray the cleaning liquid onto the microfiber cloth, then wipe the screen until desired cleanliness & shine is achieved.
  • Quality Screen Care Kit Worth Purchasing - Enjoy a convenient Screen Cleaner anytime, anywhere you need it. Your satisfaction is our top priority. We stand behind the quality of our products and that’s why, you shouldn’t be worrying at all. We manufacture the Best Screen Cleaner. and can be used for laptop cleaning kit, laptop screen cleaner, tv screen cleaner for smart tv. MacBook screen cleaner, monitor cleaner or screen cleaner spray for electronic devices with microfiber cleaning cloth

Supply an account ID explicitly

The CLI reference documents a global --accountId option. It also documents NEW_RELIC_ACCOUNT_ID as an environment variable that can override the account ID option. Decide on one convention for interactive work and automation, then make the selected account explicit in scripts so a different shell environment cannot silently redirect a query.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Find the application before querying it

Search by account ID and application name:

newrelic apm application search --accountId YOUR_ACCOUNT_ID --name NAME_OF_YOUR_APP

The documented JSON response includes fields such as accountId, applicationId, guid, name, reporting, and entity type and domain fields. Save the matching GUID and application ID for later commands, and check reporting before assuming that an empty query means the application has no data.

If several applications match

  • Use the full displayed name rather than a short fragment.
  • Confirm the returned account ID and region.
  • Check the reporting status and entity domain.
  • Compare the result with the application’s known environment or deployment naming convention.

A name match alone is not enough when staging and production use similar labels.

Understand the newrelic nrql command group

The CLI reference identifies newrelic nrql as the command group for interacting with the New Relic Database. Its global --format option accepts JSON, Text, or YAML, with JSON documented as the default.

Format Best fit Trade-off
JSON Scripts, jq, CI jobs, and downstream tools Verbose for a quick human scan
Text Interactive terminal inspection Less convenient for reliable parsing
YAML Readable configuration-style output and some automation Requires YAML-aware tooling

The reference page points to detailed command documentation rather than spelling out every query flag. Run newrelic nrql --help and the help for its query subcommand on the installed version before copying a command into a script. That check is important because invocation syntax can change between releases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use NRQL to ask focused telemetry questions

Paste the following NRQL examples into the query option shown by your installed CLI version. They illustrate query shapes documented by New Relic; they are not a guarantee that every account contains the named event types or attributes.

Rank #3
Sale
BladeHawks RGB Gaming Mouse Pad Extra Large Extended 31.5x12 Inch-Black | LED mouse pad with 14 lighting modes, covers keyboard & mouse, anti-slip rubber base, waterproof surface, USB powered
  • 【Large size】:Measuring 800 x 300 mm/ 31. 5×12 inches, which is wider and taller than others. Large mouse pad can perfectly fit your keyboard and mouse of any size, and there is also ample space for peripherals such as phones, tablets, etc.
  • 【LED backlight mouse pad】:Blade Hawks RGB mouse pad provides 7 static modes and 7 dynamic modes will give you the options you are looking for. Power-off memory function remembers the last lighting mode you selected. The super glow fiber Chroma will give you a colorful gaming setup that you want.
  • 【Anti-slip rubber base】:Made from Natural rubber, this gaming mousepad will firmly grip your desktop, allowing you to enjoy the ultimate precision in the games you are most passionate about. It also comes with a texture that enhances this ability even further.
  • 【Smooth and waterproof surface】: Micro-textured cloth surface, for extremely precise mouse control and a smooth movement. When liquid splashes on the gaming mouse pad, it forms water droplets and slides down. Will not delay your work or gameplay.
  • 【Plug and play】: This mouse and keyboard pad is powered by USB, plug and play, no driver required. One button control light modes. Press one time to change the lighting mode, press twice to change the brightness, press and hold about 3 seconds turn ON/OFF.

Count unique sessions over the last week

SELECT uniqueCount(session) FROM PageView SINCE 1 week ago

This asks how many distinct session values were recorded on PageView events during the preceding week. If your instrumentation does not send PageView events or a session attribute, the result will not answer that question.

Compare with the previous week

SELECT uniqueCount(session) FROM PageView SINCE 1 week ago COMPARE WITH 1 week ago

COMPARE WITH adds a prior-period comparison. Keep the time windows and filters equivalent when comparing environments or accounts; otherwise, a difference may reflect query construction rather than application behavior.

Graph daily PageView volume

SELECT count(*) FROM PageView SINCE 1 week ago TIMESERIES AUTO

TIMESERIES AUTO lets New Relic choose an interval suited to the selected range. Use the resulting sequence to spot gaps, spikes, or a gradual change instead of relying only on a single aggregate.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Break mobile sessions out by operating-system version

SELECT uniqueCount(session) FROM PageView WHERE deviceType = 'Mobile' SINCE 1 week ago FACET osVersion

FACET osVersion creates one series or result group per observed operating-system version. Attribute names and values depend on your instrumentation, so confirm that deviceType and osVersion are actually present before interpreting an empty result.

Calculate Apdex for one customer

SELECT apdex(duration, t: 0.4) FROM Transaction WHERE customerName = 'Example Customer' SINCE 1 week ago

This uses a custom customerName attribute and an Apdex threshold of 0.4. Replace the attribute value and time range with values that match your data model and service-level question. A custom attribute that was never reported cannot be recovered by changing the query.

A repeatable terminal investigation

  1. Confirm scope. Note the active profile, account ID, region, application name, and time zone used by the incident.
  2. Resolve identity. Run the APM application search and retain the matching GUID and application ID.
  3. Start with an aggregate. Use a count or unique count over a bounded interval to establish whether data is present.
  4. Add a time series. Use TIMESERIES AUTO to see when a change occurred.
  5. Compare an equivalent period. Add COMPARE WITH only when the baseline period and filters are comparable.
  6. Facet the suspected dimension. Break out a version, device type, region, or other attribute only after confirming that the attribute exists.
  7. Switch output format for the task. Use Text for reading and JSON or YAML when another command will consume the result.
  8. Record the exact query. Save the time window, filters, profile, and CLI version with the incident notes so another engineer can reproduce the scope.

Add logs when a metric needs an explanation

The Logs UI supports filtering and NRQL queries over log events. Logs are a related workflow, not an automatic consequence of installing the CLI. Your application or logging pipeline must forward logs to New Relic.

Rank #4
Sale
Vaydeer Wrist Rest for Keyboard and Mouse, Computer Ergonomic Wrist Support Pad, Soft Memory Foam Arm Cushion for Desk, Palm Hand Office Laptop Typing
  • 【Softer and More Comfortable】Vaydeer wrist rest has unique diamond pattern, which is the combination of softness and aesthetics. The materials of wrist rest are improved into higher quality memory foam and covered with silky smooth lycra. The computer wrist rest makes you as comfortable and cushiony as like rest your wrists on clouds.
  • 【Ergonomic Wrist Saver】The wrist rests for keyboard and mouse comes with a 17.32×3.15×0.83 inch keyboard wrist pad and a 5.94×3.15×0.83 inch mouse wrist support. Based on ergonomic design, the unique concave shape is the perfect fit for your wrist joints. The wrist rest pad fits most computer keyboards and laptops, improve hand and wrist posture, release your wrist and arm stress.
  • 【Non-Slip Rubber Bottom】Featuring an anti-skid silicone base on the bottom, this wrist keyboard support stays firmly in place on your desk, preventing the padding from sliding around, ensuring stable and consistent wrist support during extended computer sessions.
  • 【Better Experience & Pain Relief】Our keyboard arm rest is beneficial to alleviate the soreness caused by direct contact and friction between your arm and a hard desk surface, reducing the risk of wrist fatigue or carpal tunnel. The soft texture of memory foam can evenly distribute the pressure around your wrists and provide good support with just enough give.
  • 【Helpful in Multiple Scenarios】Whether you're working, studying, writing, typing, gaming, this keyboard and mouse rest combo is an essential accessory to add comfort and support to your hands and wrists. It’s also a great gift for men, women, family, friend, coworker, gamer, teacher, etc.

New Relic’s APM logs-in-context documentation describes agents decorating logs with metadata such as span.id, trace.id, hostname, entity.guid, and entity.name. Current APM agent versions document these capabilities as enabled by default, but agent behavior and deployment configuration are not identical everywhere. Confirm the agent version and forwarding setup before relying on a field.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Correlate a suspicious interval

  1. Use the NRQL time series to identify the first interval in which the symptom appears.
  2. Query logs for that same interval rather than searching an unbounded history.
  3. Filter by the application’s entity name or GUID when those fields are present.
  4. Use trace or span identifiers to move from an aggregate symptom to an individual request.

A missing log field can indicate configuration or agent differences; it does not prove that the application generated no corresponding request.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Mark deployments and other changes

A deployment marker gives the telemetry timeline a point that you can compare with a change. It is useful context, but a marker alone does not prove that the deployment caused a performance or error change.

APM deployment command

The getting-started workflow shows a deployment command using an application ID and revision:

newrelic apm deployment create --applicationId YOUR_APPLICATION_ID --revision YOUR_REVISION

Use the application ID returned by the APM search, not the GUID, when following this documented form. Include a revision value that your release process can identify consistently.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Change tracking workflow

New Relic also documents a change-tracking command:

Best Value
Sale
Under Desk Cable Management Tray No Drill, Metal Mesh Cable Management Under Desk with Clamp Mount, 2 Hole Cable Tray with Wire Management and Cord Organizer for Home Office Standing Desk
  • 【No Drill Mounted】Cable management tray can be assembled in as little as 3 minutes or less-simply. Side clips easily clampe the edge of desk, pass through the holes on the sides, and secure excess cables with baskets. Desk cable management supports inward or outward installation to meet your needs in different scenarios, and provides you with great convenience when collecting and organizing wires.
  • 【Rubber Pad Protects Desk】Wire organizer under desk built-in soft rubber pads on the clamp protect your desk from scratches, so you will not damage your furniture or office.
  • 【Sturdy and Beautiful】Cord management under desk is made of high-quality carbon steel and holds about 15 lbs. The wire basket has 2 holes on each side of the tray to enable your cables to pass freely. Cable baskets are suitable for desk thickness use from 0.4" to 2.4".
  • 【Space Saving & Keep Organized】Desk cable management tray holds all your power cords, outlet strips, USB hubs and computer transformers hidden from your feet, and the data cables will not enter the vacuum cleaner to keep your desk clean and tidy. Desk wire organizer is also suitable for use in the kitchen and outdoors.
  • 【Reduce Safety Risks】Cable tray under desk keeps all plugs away from your kids, no more worry about tripping. Using 2 holes wire tray saves extra space, helps you easily cabling and wire protection. The mesh design is not easy to accumulate dust, but avoids safety accidents caused by messy wires.
newrelic changeTracking create

The documented change-tracking workflow requires CLI version 0.104.5 or higher. Check the installed version and the current command help for the required fields before running it. Change tracking can provide a broader timeline of operational changes than a single deployment marker, but it still supplies correlation context rather than causal proof.

Query entity relationships when a service depends on another entity

New Relic documents querying entity and relationship data alongside telemetry with NRQL. The documented retention period for entity relationship data is 24 hours. Treat that as a short investigation window: if a dependency question matters, capture the relevant result while the relationship data is available rather than assuming it will remain queryable indefinitely.

Troubleshoot common failures

The shell cannot find newrelic

  • Open a new terminal after installation so package-manager path changes are loaded.
  • Check the executable location and your PATH.
  • On Windows, verify that Scoop’s shims directory is available to the current shell.
  • If you installed a downloaded binary, place it in a directory intended for executables and invoke it with an explicit path while diagnosing.

Authentication or authorization fails

  • Confirm that the active profile is the one containing the intended user key.
  • Check the account region; a key and account in different regions can produce confusing failures.
  • Verify that the key has permission for the command, not merely for viewing the web UI.
  • Generate or rotate credentials through your organization’s approved process instead of embedding a replacement key in a script.

The application search returns nothing

  • Check the account ID and region.
  • Use the exact application name shown in New Relic.
  • Confirm that the application has reported recently and that the instrumentation is connected to this account.
  • Search for naming variants used by staging, production, or regional deployments.

The NRQL result is empty

  • Verify that the event type, attribute name, and attribute value exist in your data.
  • Widen or adjust the time window only after checking that the application was reporting during the original interval.
  • Remove facets and custom filters temporarily to identify which condition eliminates the rows.
  • Check whether the selected account and region match the application returned by the search.

The query command in a script breaks after an upgrade

Run newrelic nrql --help and the relevant subcommand help against the installed release. The CLI reference’s detailed command documentation is maintained separately, and flags can change. Pin a known CLI version in automation, then review upgrades deliberately.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Operational practices for safe automation

  • Use a dedicated, least-privilege user key for automation and rotate it according to your organization’s policy.
  • Keep secrets in the CI system’s secret store or an approved credential helper, not in shell history, source files, or command output.
  • Set the profile and account ID explicitly in production jobs.
  • Prefer JSON when a parser will consume results, and validate the schema before assuming a field exists.
  • Bound every query with a deliberate time range to limit accidental large scans and ambiguous incident notes.
  • Log the CLI version, profile name, account ID, application identifier, query text, and time window for reproducibility, while redacting credentials.
  • Treat deployment and change markers as timeline evidence. Combine them with time-series behavior, logs, traces, and a plausible mechanism before claiming causation.

What this workflow cannot establish by itself

The CLI does not establish your account’s pricing, entitlements, general telemetry-retention policy, or which event types your application reports. Those details vary by account, instrumentation, region, and configuration. The examples above also do not promise that every account has PageView events, session values, mobile attributes, customer attributes, logs-in-context metadata, or change-tracking access.

Use the commands to inspect the data that is actually present, verify the current syntax for your installed release, and keep region, profile, identifier, and time-window choices visible whenever you share a result.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.