statistics query examples

View Streaming Statistics

You can use the Wowza Streaming Engine™ media server software REST API to view current and historical statistics about applications, incoming streams, and the server itself.

Notes:

Wowza Streaming Engine 4.3.0 or later is required.

PHP examples for the tasks in this article are available in the tests folder of the PHP REST Library for Wowza Streaming Engine on GitHub.

Before You Start

You should be familiar with the following concepts:

API authentication methods. The examples assume the AuthenticationMethod property in Server.xml is set to none.See Query the Wowza Streaming Engine REST API for information about including authentication in API requests.

Get Current Statistics for an Application

View current statistics for an application, including total connections, the number and rate of bytes entering and leaving the server, and the number of connections per protocol by sending a GET request:

Example request

curl -X GET
-H 'Accept:application/json; charset=utf-8'
-H 'Content-Type:application/json; charset=utf-8'
"http://localhost:8087/v2/servers/{serverName}/vhosts/{vhostName}/applications/{appName}/monitoring/current"

Note: You will replace {appName} with the name of your application.

The command should return a response that looks something like this (if the application is running, you should see real values, not zeros):

Example response

{
"serverName": "{serverName}",
"uptime": 0,
"bytesIn": 0,
"bytesOut": 0,
"bytesInRate": 0,
"bytesOutRate": 0,
"totalConnections": 0,
"connectionCount": {
"WEBM": 0,
"DVRCHUNKS": 0,
"RTMP": 0,
"MPEGDASH": 0,
"CUPERTINO": 0,
"SANJOSE": 0,
"SMOOTH": 0,
"RTP": 0
}
}

Get Current Statistics for an Incoming Stream

View current statistics for an incoming stream by sending a GET request to the /v2/servers/{serverName}/vhosts/{vhostName}/applications/{appName}/instances/_definst_/incomingstreams/{streamName}/monitoring/current endpoint.

You can use the following sample request, making sure to:

Set serverName, vhostName, and instanceName to match your environment.
Set appName to the name of your application.
Set streamName to the name of your stream.

Example request

The command should return a response that looks something like this (if the application is running, you should see real values, not zeros):

Example response

{
"serverName": "serverName",
"uptime": 0,
"bytesIn": 0,
"bytesOut": 0,
"bytesInRate": 0,
"bytesOutRate": 0,
"totalConnections": 0,
"connectionCount": {
"RTMP": 0,
"MPEGDASH": 0,
"CUPERTINO": 0,
"SANJOSE": 0,
"SMOOTH": 0,
"RTP": 0
},
"applicationInstance": "instanceName",
"name": "streamName"
}

Get Historical Statistics for an Application

View historical details for an application by sending a GET request to the /v2/servers/{serverName}/vhosts/{vhostName}/applications/{appName}/monitoring/historic endpoint.

You can use the following sample request, making sure to:

Set serverName and vhostName to match your environment.
Set appName to the name of your application.

Example request

The command should return an entries object with actual, average, minimum, and maximum arrays of data for every date and time ( dateTime) the application ran.The response should look something like this (but with real values, not zeros):

Example response

{
"serverName": "serverName",
"entries": {
"actual": [],
"average": [
{
"dateTime": "2017-04-05T18:00:00",
"data": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
]
}
],
"min": [
{
"dateTime": "2017-04-05T18:00:00",
"data": [
...
]
}
],
"max": [
{
"dateTime": "2017-04-05T18:00:00",
"data": [
...
]
}
]
}
}

The dateTime is the UTC date and time that the server started.The values in each data array are, in descending order:

"data": [
bandwidth_inbound in kilobytes/second,
bandwidth_outbound in kilobytes/second,
rtmp,
rtsp,
hds,
hls,
smooth,
webrtc,
webm,
dash
]

Optionally, you can also include start and end time parameters in your query to return historical statistics only for that time range.Specify the start and end times in the format yyyy-mm-ddThh:mm:ss — for example, 2015-11-01T15:00:00.The following example query uses the start and end parameters:

Example request

Get Historical Statistics for a Server

View historical statistics for a server, including CPU, memory, and heap memory usage as well as connections to the server by sending a GET request to the /v2/servers/{serverName}/monitoring/historic endpoint, making sure to update serverName to match your environment:

Example request

curl -X GET
-H 'Accept:application/json; charset=utf-8'
-H 'Content-Type:application/json; charset=utf-8'
"http://localhost:8087/v2/servers/{serverName}/monitoring/historic"

The command should return an entries object that shows the actual, average, minimum, and maximum values for every date and time ( dateTime) the server ran.The response should look something like this:

Example response

{
"serverName": "serverName",
"entries": {
"actual": [],
"average": [
{
"dateTime": "2017-04-05T18:00:00",
"data": [
0,
0,
0,
54
]
}
],
"min": [
{
"dateTime": "2017-04-05T18:00:00",
"data": [
...
]
}
],
"max": [
{
"dateTime": "2017-04-05T18:00:00",
"data": [
...
]
}
]
}
}

The dateTime is the UTC date and time that the server started.The values in each data array are, in descending order:

"data": [
Bandwidth usage coming into the media server in kilobytes/second,
Bandwidth usage going out of the media server in kilobytes/second,
Java Heap memory usage in megabytes,
Total connection count (in AND out of the media server)
]

Example request

curl -X GET
-H 'Accept:application/json; charset=utf-8'
-H 'Content-Type:application/json; charset=utf-8'
"http://localhost:8087/v2/servers/{serverName}/monitoring/historic?start=2015-11-01T15:00:00&end=2015-11-01T15:01:00"