Exportar Eventos de Monitoramento

O Astra permite exportar eventos de monitoramento com o status dos streams de entrada ou dos adaptadores DVB.

URL de monitoramento

O endereço do servidor de monitoramento pode ser definido na interface web: Settings → General → Monitoring:

Opções de Monitoramento

O endereço tem os seguintes parâmetros:

interval=30 - este parâmetro define o intervalo de envio das estatísticas, em segundos. O valor padrão é 30.
total=1 - este parâmetro é usado para obter estatísticas resumidas do pacote de dados

Por exemplo, com o endereço http://example.com/api#interval=60&total=1 o astra envia uma requisição HTTP POST para http://example.com/api a cada minuto, contendo um JSON com as estatísticas resumidas de um minuto de monitoramento do stream.

Propriedades do stream

O Astra envia as propriedades do stream apenas uma vez, na inicialização do stream.

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

channel - toda a configuração do stream
timestamp - horário do evento
hostname - nome do host do servidor

Status do stream

[
    {
        "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
    }
]

Esta lista descreve os parâmetros que trazem informações sobre o funcionamento do stream:

count - apenas para os dados resumidos, indica a quantidade de segundos decorridos desde a última coleta de estatísticas
timestamp - horário do evento no formato Unix
channel_id - ID único do canal
input_id - número da entrada. Começa em 1
current - indica que as estatísticas são da entrada ativa no momento
onair - status do stream, uma forma rápida de verificar se ele está funcionando
scrambled - indica se o stream está criptografado ou não
bitrate - bitrate de entrada em Kbit/s
packets - número total de pacotes TS
cc_error - número total de erros de CC ocorridos
pes_error - número total de erros de PES ocorridos

Estes dados são enviados em formato JSON como um array de vários elementos, cada um representando um segundo de observação. A quantidade de elementos no array depende da frequência de envio das estatísticas. Se a agregação de estatísticas estiver ativada, o array terá apenas um elemento, com o número total de erros e o bitrate médio no período igual à frequência de envio das estatísticas.

Propriedades do adaptador

O Astra envia as propriedades do adaptador apenas uma vez, na inicialização do adaptador.

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

dvb — toda a configuração do adaptador
timestamp — horário do evento
hostname — nome do host do servidor

Status do adaptador

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

Esta lista descreve os parâmetros que trazem informações sobre o funcionamento do adaptador:

dvb_id - ID único do adaptador
timestamp - horário do evento
status - status do sinal
signal - nível aproximado do sinal em porcentagem
signal_db - nível do sinal em dBm * 100
snr - relação sinal/ruído aproximada em porcentagem
snr_db - relação sinal/ruído em dB * 100
ber - contador de erros de bit
unc - contador de erros de bloco
bitrate - bitrate total em Kbit/s

O status do sinal descreve o estado do sintonizador, representado por um número de 5 bits:

SIGNAL — o bit de sinal é definido quando o sintonizador capta o sinal
CARRIER — recepção estável do sinal
FEC — recepção dos dados de FEC (correção de erros)
SYNC — informação de sincronização recebida
LOCK — o sintonizador está travado para receber o sinal.

Se o sintonizador foi configurado com sucesso e o sinal está travado, o parâmetro status será 31