Export Monitoring Events

Astra allows you to export monitoring events with the status of incoming streams or DVB-adapters.

Monitoring URL

The address of the monitoring server can be specified in the web interface: Settings -> General -> Monitoring:

Address has the following parameters:

interval=30 - this parameter defines the interval for transmitting statistics, measured in seconds. The default value for this parameter is 30.
total=1 - this parameter is used to obtain summary statistics from the data packet

For example with address http://example.com/api#interval=60&total=1 astra sends HTTP POST request to the http://example.com/api every minute, request containing JSON with summary statistics for one minute of stream monitoring.

Stream Properties

Stream properties Astra send only once on stream startup.

[
    {
        "channel": {
            "type": "spts",
            "name": "Channel Name",
            "id": "a002",
            ...
        },
        "timestamp": 1677687308,
        "hostname": "astra"
    }
]

channel - whole stream configuration
timestamp - event time
hostname - server hostname

Stream Status

[
    {
        "count": 0,
        "timestamp": 1677687310,
        "channel_id": "a002",
        "input_id": 1,
        "current": true,
        "onair": false,
        "scrambled": false,
        "bitrate": 3013,
        "packets": 2005,
        "cc_error": 0,
        "sc_error": 0,
        "pes_error": 0,
        "pcr_error": 15
    }
]

This list describes the parameters that provide information about the stream workflow:

count - only for summary data, provide an amount of seconds that has elapsed since the last collection of statistics
timestamp - event time in Unix format
channel_id - unique ID of the channel
input_id - the input number. Starts with 1
current - indicates that statistics for current active input
onair - stream status, providing a quick way to check if it's running
scrambled - indicates whether the stream is encrypted or not
bitrate - input bitrate in Kbit/s
packets - total number of TS packets
cc_error - total number of occured CC errors
pes_error - total number of occured PES errors

This data is transmitted in JSON format as an array of several elements, with each element representing one second of observations. The number of elements in the array is determined by the frequency of statistics transmission. If statistics aggregation is enabled, then there is only one element in the array, which contains the total number of errors and the average bitrate for the period equal to the statistics transmission frequency.

Adapter Properties

Adapter properties Astra send only once on adapter startup.

[
    {
        "dvb": {
            "name": "11034V @ 13E",
            "id": "a001",
            ....
        },
        "timestamp": 1677687308,
        "hostname": "astra"
    }
]

dvb — while adapter configuration
timestamp — event time
hostname — server hostname

Adapter Status

[
    {
        "dvb_id": "a0dj",
        "timestamp": 1677687310,
        "status": 31,
        "signal": 76,
        "signal_db": -2488,
        "snr": 60,
        "snr_db": 902,
        "unc": 0,
        "ber": 0,
        "bitrate": 1938
    }
]

This list describes the parameters that provide information about the adapter workflow:

dvb_id - unique ID of the adapter
timestamp - event time
status - signal status
signal - approximate signal level in percent
signal_db - signal level in dBm * 100
snr - approximate signal to noise ratio in percent
snr_db - signal to noise ratio in dB * 100
ber - bit errors counter
unc - block errors counter
bitrate - total bitrate in Kbit/s

Signal status describe the state of the tuner, described in 5-bit number:

SIGNAL — the signal bit will be set when the tuner captures the signal
CARRIER — stable signal reception
FEC — reception FEC (forward error correction) data
SYNC — received information for synchronization
LOCK — the tuner is set to receive a signal.

If the tuner configured successfully and signal is locked, the status parameter will be set to 31