Welcome to the Internet Alerts – Performance Express Configuration! The Express Configuration is designed to make setup for Internet Alerts – Performance easier for most users. Express Configuration uses a single POST request to configure several IP addresses. These IP addresses will be (1) added to the same (newly created) inventory, (2) be monitored by the same collector, (3) and alert at the same thresholds.

Note for Users who also use Internet Intelligence’s UI: Performance Monitoring status does not display on the Inventory view in the UI. The Monitor toggle switch is accurate for Routing Alerts only.

Syntax

Click to view all Internet Alerts – Performance API Resources
POST /portfolio/performance/express — Creates an inventory, adds the IP addresses from a file you supply into the inventory, sets up Internet Alerts – Performance on the IP addresses. Everything except for the IP addresses is specified using HTTP request parameters in the URL.

cURL example for Internet Alerts – Performance Express Install:

$ curl -u $username:$password -X POST --data-binary @addrs.txt -H "Content-Type: text/plain"
    "https://api.renesys.com/portfolio/performance/express?inventory={INVENTORY_NAME}
    &collector={COLLECTOR_NAME}&latency_fixed=30&packetloss_percent=15"

Where:

{INVENTORY_NAME} is the name of the inventory to create in your portfolio.

{COLLECTOR_NAME} is the name of the collector to use. See Get Available Performance Collectors to determine the collectors that are available to use.

latency_fixed=30 means an alert is raised if the collector measures latency (PING) longer than 30 milliseconds.

packetloss_percent=15 means an alert is raised if the collector measures packet loss rate higher than 15% of packets.

Request Body Content:
addrs.txt file containing your IP addresses in a newline-separated list as in this example:command to create text file
Response:

HTTP/1.1 204 No Content     
Date: Wed, 01 Apr 2015 20:47:02 GMT     
Server: TornadoServer/4.0.2     
Content-Length: 0     
Content-Type: text/html; charset=UTF-8      
Vary: Accept-Encoding     
Connection: close