Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

An interactive command line interface for querying NRQL data.

Project description

An interactive command line interface for querying New Relic Insights event data.



The New Relic Insights query API is a REST API for querying Insights event data. After you supply a standard NRQL query via HTTPS request, the query API returns a JSON response for parsing.

To use the API, you need a query key. You can have multiple query keys, and any query key can be used to initiate any Insights API query. If you have multiple systems querying Insights or different data destinations, New Relic recommends you use multiple query keys to enhance data security.

To create a new query key:

  1. Go to > Manage data > API keys.
  2. Select the plus icon next to the Query keys heading.
  3. Enter a short description of the key.
  4. Select Save your notes.

You will also need make note of your New Relic Account ID. To find the account ID for your New Relic account:

  1. Sign in to
  2. In the URL bar, copy the number after the /accounts/ portion of the URL:


nrql-cli is available on the Python Package Index (PyPI) at

You can install nrql-cli using pip.

pip install nrql-cli

Export your Query API key and Account ID as environment variables:


Then, run:


This command will start the program and you can start querying your data!

Alternatively, you can run in Docker. You will need to update the Dockerfile with your API key and account id and then run:

docker build -f Dockerfile -t nrql-cli .
docker run --rm -it nrql-cli


usage: nrql [-h] [--region {EU,US}] [--env ENV] [--verbose]

optional arguments:
  -h, --help            show this help message and exit
  --region {EU,US}, --r {EU,US}
                        Pass this flag to set your region (EU or US) By
                        default the region is set to US.
  --env ENV, --e ENV    Environment handler.
  --verbose, --v        Pass this flag if you want the whole response.

Managing multiple accounts

If you wish to easily switch between your New Relic accounts, you can use the --env switch:

nrql --env PROD

By default, the program looks for the environment variables NR_API_KEY and NR_ACCOUNT_KEY.

If the env argument is not none, then the program appends the environment string to NR_API_KEY. For example:


When naming your environment variables, ensure to follow this naming convention.


Please note that this is offered for use as-is without warranty. You are free to use and modify as needed. It has been created for use with New Relic, but is not a supported product of New Relic

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nrql-cli, version 1.0.3
Filename, size File type Python version Upload date Hashes
Filename, size nrql_cli-1.0.3-py2.py3-none-any.whl (6.8 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size nrql-cli-1.0.3.tar.gz (7.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page