Solução de problemas do Senta: streams, falhas e licenças

O stream não inicia ou falha imediatamente

Abra o log do stream pelo link log na linha do stream na página Streams — ele mostra a saída do próprio ffmpeg. As causas mais comuns:

um caminho de arquivo de entrada incorreto ou inacessível (principalmente se o acesso ao sistema de arquivos não estiver configurado corretamente);
a porta de destino já está em uso por outro processo;
um erro no comando do próprio perfil (um erro de digitação em uma opção do ffmpeg).

Não há os campos `Input`/`Output` ao criar um stream

O comando do perfil não tem as variáveis ${i} e/ou ${o} — o Senta as usa para decidir quais campos exibir ao criar um stream. Abra o perfil e adicione essas variáveis ao comando; veja Adicionar perfil e Variáveis do perfil para mais detalhes.

Um stream falha e reinicia sozinho o tempo todo

Esse é o mecanismo integrado Restart on crash — se estiver ativado nas configurações do stream, o Senta reinicia automaticamente um stream que falhou após um atraso configurado, até um número limitado de tentativas por período (Restart limit). Veja Reiniciar em caso de falha para mais detalhes e configuração.

Um processo do ffmpeg usa cada vez mais memória

O Senta pode detectar automaticamente o crescimento descontrolado de memória em processos do ffmpeg e reiniciar o stream afetado — veja a seção Monitoring nas configurações do stream (verificação de curto prazo: crescimento de mais de 100 MB em 10 minutos ou 200 MB em 20 minutos; verificação de longo prazo: crescimento de mais de 3% por hora durante cinco horas consecutivas). As três verificações vêm ativadas por padrão — desative a verificação correspondente nas configurações do stream se esse comportamento não for desejado.

A licença não ativa ou toda a interface web redireciona para a página License Not Active

Sem uma licença ativa (ou enquanto ela ainda está sendo verificada), o Senta bloqueia o acesso a toda a interface web, e não apenas a recursos específicos como a API de Integração — o aplicativo redireciona para a página License Not Active e os streams não iniciam. A página mostra o motivo e o botão Activate. Veja Adicionar licença para o passo a passo completo. Até o início das vendas de licenças pelo perfil Cesbo, use a chave de teste.

O que significa cada motivo:

License activation required - este servidor ainda não tem licença, ou foi atualizado de uma versão que usava o hash de licença do portal de cobrança anterior. Clique em Activate.
License activated, waiting for the license server - a verificação se repete automaticamente, ou clique em Re-check now.
The license has expired - renove a licença no seu perfil Cesbo em app.cesbo.com e clique em Re-check now.
The license was revoked or this device was removed from it - o dispositivo foi removido da licença no seu perfil Cesbo. Ative a licença novamente.
License servers are unreachable - o servidor não tem acesso à internet. Verifique o firewall e o proxy.
The license server answer was tampered with - um proxy ou firewall entre o servidor e a Cesbo alterou a resposta. Verifique a rede.
The license file cannot be read - o arquivo de ativação ao lado do arquivo de configuração (por exemplo, /etc/senta/senta.license.json) está danificado. Ative a licença novamente.

Mensagens durante a ativação:

The activation server ... is unreachable - o servidor não consegue se conectar aos servidores de licença. Verifique o acesso à internet, o firewall e o proxy.
Cannot save the license file ... - o processo do Senta não consegue gravar na pasta de configuração.
This license has reached its device limit - remova um dispositivo no seu perfil Cesbo ou escolha qual substituir.
Link expired or no longer valid - clique em Start again e abra o novo link.
The license server rejected this server's time - o relógio do servidor está incorreto. Ative o NTP.

O Senta demora para reiniciar ou o banco de dados ocupa muito espaço em disco

O Senta mantém logs de streams, eventos de streams e seus relatórios em um banco de dados SQLite (por padrão /opt/senta/db). Registros antigos são excluídos automaticamente pelas opções de Settings:

Log storage duration (days) - logs do FFmpeg, 7 dias por padrão;
Stream events storage duration (days) - eventos de streams e seus relatórios, 365 dias por padrão;
Database size limit (GB) - quando o banco de dados contém mais dados que esse valor, os logs mais antigos são excluídos e, depois, os eventos de streams. Verificado a cada 5 minutos; 0 (o padrão) significa sem limite.

0 em uma duração de armazenamento significa manter para sempre. O Senta não compacta o banco de dados ao iniciar, então um banco grande não deixa mais a reinicialização lenta. O arquivo do banco não diminui depois que registros antigos são excluídos — o SQLite reutiliza o espaço liberado para novos registros, e assim o arquivo para de crescer.

Como obter uma `API key`

A seção API key fica na página Settings — ela fica acessível quando a licença atinge o status valid ou processing (veja acima). Veja API para mais detalhes.

Um servidor adicional continua offline

Verifique, em ordem:

Se o IP/porta do servidor remoto é acessível a partir da rede do servidor principal (sem firewall no meio).
Se a API Key corresponde, caractere por caractere, à definida no servidor remoto.
Se o processo do Senta está de fato em execução no servidor remoto.

Veja Servidores para a configuração completa.

O navegador de arquivos está vazio ou mostra um erro de acesso

A opção Display file system em Settings ativa o recurso, mas o binário do Senta precisa ser iniciado por um usuário que realmente tenha permissão no diretório em questão — caso contrário, o navegador continua vazio ou mostra um erro de acesso mesmo com a opção ativada. Veja Trabalhando com arquivos.

Tenho várias versões do FFmpeg instaladas - como escolher uma

Veja Versões alternativas do FFmpeg — ela explica como configurar e escolher um binário específico para um perfil.

Não encontrou sua resposta?

Escreva para nós por e-mail ou pelo telegram.