1.1 Commercial Notice
Important note: Some of the features described in this release note may not be covered by your current licenses. Please contact Edgeware for further information.
For technical support, please contact Edgeware via the Support Portal.
Changes: First version
2 API specification
2.1 Basic description
The Cloud Monitor API provides monitoring of the overall state of a distributed SW Origin setup by giving access to metrics aggregated from the installation’s multiple availability zones.
The API is based on JSON over HTTPS with all requests performed with
2.2 Using the API
The Cloud Monitor API is available as an HTTPS service. All requests are performed using HTTPS GET with /api/1/monitor/ as the base path for all requests. monitor-url will be provided along with the account details.
2.2.1 Query strings
22.214.171.124 Resource schema
To get an informative schema of the resources that are available through the API, request the base path appended with the query parameter
The response will be a JSON schema describing the structure and the datatypes of the available resources:
In this example we can see that requesting the resource path
services/repackaging/egressRate will produce a list of sub-intervals where each interval contains
126.96.36.199 Time window specification
To specify the time interval over which to get monitoring data, a time window can be supplied as a query string by extending the URL with e.g.
?startTime=1551945061&stopTime=1551946660. The time specification is in UNIX Epoch time, i.e. seconds since Jan 1 1970.
If only one of
stopTime is supplied, the response will contain all data points during 1 hour fromor until the specified time. If neither
stopTime is provided, data for the last 1 hour is returned.
For each resource that can be requested, a list of sub-intervals covering the time span from startTime to stopTime is returned as a list. The duration of each sub-interval is 60 seconds:
If there is no data available for some period of time, the response may omit entries for that period.
2.2.2 Available resources
ingressRate resource describes the total ingress traffic amount that is consumed by the Live Ingest nodes in the SW Origin setup. The bitrate unit is bits per second.
The response is a list of data broken down to one-minute intervals with start and stop time according to the time window specification.
egressRate resource describes the total amount of egress traffic that is produced by the Repackager nodes in the SW Origin setup. The bitrate unit is bits per second.
The response is a list of data broken down to one-minute intervals with start and stop time according to the time window specification .
To get the state of a particular channel in the SW Origin setup, query the path
This will return a list with the channel’s state for every minute in the requested time interval. For example, to get the status of Channel2:
2.2.3 HTTPS response codes
The following response codes can potentially be returned by the server:
188.8.131.52 200 OK
The GET request was successfully completed.
184.108.40.206 400 Bad request
The syntax of the request is incorrect. The format of the request is not according to the specifications. Most likely some of the fields are missing. Please see the section of Available resourses to pinpoint the problem.
220.127.116.11 404 Not Found
The resource does not exist.
18.104.22.168 405 Method Not Allowed
The request method is not allowed. The HTTPS methods allowed is GET.
22.214.171.124 500 Internal Server Error
The server encountered an unexpected condition that prevents it from fulfilling the request.
126.96.36.199 502 Bad Gateway
One or more of the required backend services are unavailable.
188.8.131.52 503 Service Unavailable
The server is currently unable to handle the request due to a temporary overload or maintenance of the server.