A live stream is the basic unit which is checked in Qosifire. The web console allows adding and changing streams settings for further check, view their stats and send notifications about significant events to users.
At the moment Qosifire support only Icecast live streams. Other protocols are planned, feel free to address and vote for them in Feature requests community section.
This article describes the initial setup of streams in Qosifire web console. For more information about collected stats and received notifications, check related articles.
To view the list of streams and manage them, click on Streams link in left navigation panel.
The opened page shows the list of streams if they were added. Each stream shows its name, URL, current status and logging settings. All other setting can be found in stream edit dialog by clicking on triple dots on the right side. The same settings are used during the setup of a new stream.
To add new stream for checking, click on Add stream button on top, this will bring a dialog shown below.
The fields have the following purposes. More details on some of those fields will be explained in specific separate articles.
- Stream name is used for identifying the stream inside of web console.
- Stream URL is the full address of Icecast stream to be checked.
- Log mode and Sys log me are defined for agent node application debugging and monitoring. We'll describe those settings and their usage in separate articles.
- User-Agent is the optional field where you can define what user agent name will be used when accessing stream via its URL. By default our agent will use "Qosifire" and agent software version as its User-Agent.
- Duration field defines how long the statistics and events data will be stored. The data storage is located on the agent node side so it's a matter of your storage planning to define this number.
- Decoder name allows selecting which decoding library will be used for quality of content. At the moment they are ffmpeg and libfdk_aac.
- Thread count is a setting which you will use in case of heavy load on your agent nodes. By default it's not required.
- Assigned nodes field on the bottom allows selecting which agent nodes will be used for checking the stream status.
Quality of content fields
- Silence detection checkbox defines whether Qosifire will run silence detection check over the stream's content.
- Per channel checkbox allows defining if quality check needs to be performed on each channel separately.
- Noise threshold field defines the audio noise level which will be considered as silence for its detection
- Duration threshold field defines how long the audio noise level must be equal or below Noise threshold to be considered as silence. As soon as this duration is reached, the silence detection event occurs and users get proper notification.
Saving settings will apply them to assigned nodes and the check-over process will be started.
Then the stream is set up and the check-over is started, you'll be able to click on it in the streams list and view its stats and events list as shown below. For more information about this functionality, check respective article in our knowledge base.