What is in this article?
This article introduces and explains the Upstream Monitor and its functions as part of the STREAMBOXY Livestream functions.
What is the upstream monitor?
The upstream monitor is located in a livestream session under the session settings. As soon as the livestream has been started, the upstream monitor appears under the other buttons. Detailed information on the session settings for livestreams can be found here.
In the upstream monitor, the livestream operator/speaker is shown information about the ongoing livestream in the respective session.
Here you can find a diagram depicting the trend of the bitrate given in Megabits per Second followed by the Event log in which all events and information about the transmission of the livestream are stated.
Clicking on the arrow unfolds the Upstream Monitor exposing the diagram and the event log.
What does the bit rate show?
The graph depicts the incoming Bitrate (Mbps) on the y-axis whereas the time on the x-axis.
The line shows the average bitrate over the last minute for each data point.
Additionally, the area encloses the minimal and maximal bitrate over the last minute.
By hovering with the mouse you can highlight the average, minimal, and maximal bitrate for any given data point.
The graph shows all data since the beginning of the stream or since the last reload of the page.
What does the event log show?
The event log displays all events and all current information.
These are recorded in chronological order and refreshed with each new event that flows in. The most recent event is always at the top.
The following information is refreshed each time:
- Date
- Time
- Name of the transmitted event
- Bit rate or count or frames per second (FPS) (dependent on the type of event)
- Minimum (only for bitrate and framerate)
- Maximum (only for bitrate and framerate)
In the following, you can find the event types, their respective descriptions, and the ideal values:
| Event type | Description | Ideal Value |
|---|---|---|
| ActiveAlerts | Number of active alerts over the last minute. | 0 |
| ActiveOutputs | Number of active outputs over the last minute. | >0 |
| DroppedFrames | Number of dropped frames over the last minute. | 0 |
| FillMsec | Amount of milliseconds that must be filled in because no stream is available. | 0 |
| InputVideoFrameRate | Average, minimum, and maximum framerate over the last minute. | >0 |
| NetworkIn | Average, minimum, and maximum incoming bitrate over the last minute. | >0 |
| NetworkOut | Average, minimum, and maximum outgoing bitrate over the last minute. | >0 |
| Output4xxErrors | Number of client-side errors over the last minute. | 0 |
| Output5xxErrors | Number of server-side errors over the last minute. | 0 |
If any value falls out of its ideal range, this will be indicated with "ERROR" in the log message.
Additionally, the graph itself can indicate a low bitrate if the line reaches the bottom.
How are the graph and event log updated?
The upstream monitor is initially loaded when the speaker joins the session.
All data is automatically updated from this point onwards and with every event that comes in. The update takes place every minute.
How do I get an export of the livestream status data?
The data can be exported at any time during the broadcast or directly afterwards. To do this, click on the corresponding selection directly below the graphic display of the upstream monitoring.
In the report itself, you can now view the entire log of your stream in detail. Perhaps you need to adjust the column width as well as the format of the "date" column to display the data correctly.