Java library that allows New Relic Monitoring and Alerting configuration operations to be executed from a command line. The library includes over 90 operations covering Alerts, Applications, Key Transactions, Deployments, Servers, Plugins, Monitors and Labels. It provides a set of tools to simplify or automate the configuration of New Relic Monitoring and Alerting.
The following scripts can be found in the "bin" directory of the distribution:
- new_relic_exec.sh (for Linux)
- new_relic_exec.bat (for Windows)
To execute a command provide the operation required as the first parameter:
>$ new_relic_exec.sh create_alert_policy -key "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -name my-policy -ip PER_POLICY
A message similar to the following is displayed if the command completes successfully:
2018-02-05 02:41:40:941 INFO Created alert policy: 187641 - my-policy
To see the options for a particular command:
>$ new_relic_exec.sh create_alert_policy -h
This produces a listing similar to:
usage: create_alert_policy
-h,--help Prints a usage statement
-ip,--incident_preference <arg> The incident preference of the alert policy.
Optional, defaults to PER_POLICY.
-x,--x_api_key <arg> The New Relic API key for the account or user
-n,--name <arg> The name of the alert policy
-v,--verbose Enables verbose logging messages
To see the complete list of commands supported:
>$ new_relic_exec.sh
The complete list of commands supported is:
- create_campfire_channel
- create_email_channel
- create_hipchat_channel
- create_opsgenie_channel
- create_pagerduty_channel
- create_slack_channel
- create_user_channel
- create_victorops_channel
- delete_alert_channel
- delete_alert_channels
- list_alert_channels
- create_alert_policy
- delete_alert_policy
- delete_alert_policies
- list_alert_policies
- create_alert_condition
- create_nrql_alert_condition
- create_synthetics_alert_condition
- create_external_service_alert_condition
- create_plugins_alert_condition
- create_infra_metric_alert_condition
- create_infra_host_alert_condition
- create_infra_process_alert_condition
- delete_alert_condition
- delete_alert_conditions
- delete_nrql_alert_condition
- delete_nrql_alert_conditions
- delete_synthetics_alert_condition
- delete_synthetics_alert_conditions
- delete_external_service_alert_condition
- delete_external_service_alert_conditions
- delete_plugins_alert_condition
- delete_plugins_alert_conditions
- delete_infra_alert_condition
- delete_infra_alert_conditions
- list_alert_conditions
- list_nrql_alert_conditions
- list_synthetics_alert_conditions
- list_external_service_alert_conditions
- list_plugins_alert_conditions
- list_infra_alert_conditions
- add_alert_policy_channel
- remove_alert_policy_channel
- list_alert_policy_channels
- add_application_alert_condition
- add_browser_application_alert_condition
- add_mobile_application_alert_condition
- add_server_alert_condition
- add_key_transaction_alert_condition
- add_plugin_alert_condition
- remove_application_alert_condition
- remove_browser_application_alert_condition
- remove_mobile_application_alert_condition
- remove_server_alert_condition
- remove_key_transaction_alert_condition
- remove_plugin_alert_condition
- list_application_alert_conditions
- list_browser_application_alert_conditions
- list_mobile_application_alert_conditions
- list_server_alert_conditions
- list_key_transaction_alert_conditions
- list_plugin_alert_conditions
- delete_application
- list_applications
- list_browser_applications
- list_mobile_applications
- list_key_transactions
- create_deployment
- delete_deployment
- list_deployments
- create_ping_monitor
- create_simple_browser_monitor
- create_scripted_browser_monitor
- create_scripted_api_monitor
- update_monitor_script
- delete_monitor
- list_monitors
- delete_server
- list_servers
- list_plugins
- create_label
- create_monitor_label
- delete_label
- delete_monitor_label
- list_labels
- list_label_monitors
- delete_dashboard
- list_dashboards
- list_users
Other commands can be included on request.
A New Relic account with an Admin user. The user needs to generate an Admin API Key to provide read-write access via the New Relic REST APIs. The Admin API Key is referenced in the documentation as the parameter "YOUR_API_KEY".
First clone the repository using:
>$ git clone https://github.com/opsmatters/newrelic-command.git
>$ cd newrelic-command
To compile the source code, run all tests, and generate all artefacts (including sources, javadoc, etc):
mvn package
To execute the unit tests:
mvn clean test
The following tests are included:
- TBC
The build artefacts are hosted in The Maven Central Repository.
Add the following dependency to include the artefact within your project:
<dependency>
<groupId>com.opsmatters</groupId>
<artifactId>newrelic-command</artifactId>
<version>1.2.2</version>
</dependency>
- newrelic-api - Java client library for the New Relic Monitoring and Alerting REST APIs
- Commons CLI - Provides an API for parsing command line options passed to programs
- Maven - Dependency Management
- JUnit - Unit testing framework
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
This project use SemVer for versioning. For the versions available, see the tags on this repository.
- Gerald Curley - Initial work - opsmatters
See also the list of contributors who participated in this project.
This project is licensed under the terms of the Apache license 2.0.
Copyright (c) 2018 opsmatters