NewRelic Synthetics (unofficial) CLI (NeReS)

NeReS is a cli tool to manage NewRelic Synthetics monitors with a Synthetics Lite account (Pro should work too). The tool emulates the actions of a user in the browser and doesn't use the Synthetics API since that's only available to the Pro accounts.

With this tool you can:

• List all your monitors, including their success rate, locations, notifications etc.
• Create, update and delete monitors
• List available locations for monitor installation and
• everything else available though the Web console.

Installation

$ pip install neres

Configuration

1. You will need a newrelic account
2. Start by using the login command
3. Read the docs or run --help

Use

Login to NewRelic

Login to NewRelic with the login command:

$ neres login

If you have multiple NewRelic accounts you can have different environments:

$ neres --environment work login

List Accounts

You can list all the accounts connected to the email you used to connect using:

$ neres list-accounts

By default neres will act on the first account listed. This command will help you select a different account by using the ID of the account in combination with the --account option or by setting NERES_ACCOUNT in your environment.

List Locations

Lists available monitor locations:

$ neres list-locations

List Monitors

Lists available monitors:

$ neres list-monitors

You can only list IDs of the monitors:

$ neres list-monitors --ids-only

Or get the raw JSON output from NewRelic:

$ neres list-monitors --raw

Add Monitor

Adds a Synthetics monitor:

$ neres add-monitor monitorName http://example.com

Use --help to get a full list of supported options for the command. All options are optional.

Get Monitor

Get details on a monitor

$ neres get-monitor de310b69-3195-435e-b1ef-3a0af67499de

Update Monitor

Update an existing monitor

$ neres update-monitor de310b69-3195-435e-b1ef-3a0af67499de --name "Foobar"

Use --help to get a full list of supported options for the command. All options are optional.

Open Monitor

Open monitor in the browser

$ neres open de310b69-3195-435e-b1ef-3a0af67499de

Get state of all monitors of account

Export the state of all monitors of account in YAML format with

$ neres get-state

Save the output into a file, edit and use in combination with the update-from-statefile command to update multiple monitors at once.

$ neres get-state > state.yaml

Update monitors from statefile

Update monitors from statefile with

$ neres update-from-statefile state.yaml

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.