Auditoria

Monitoramento e auditoria

Rastreabilidade

O Riversoft® STCP Gemini Server registra no banco de log cada sessão e cada transferência, com o usuário, a direção, o arquivo e o resultado. Ao final de uma transmissão ou recepção, a mensagem traz também o tamanho do arquivo, o tempo da transferência e o hash. As confirmações do protocolo OFTP (EERP e NERP) também são registradas.

Cada registro tem um código de mensagem e, nas etapas da transferência, um código de evento. Veja Códigos de mensagem e eventos.

Relatórios

Os registros podem ser consultados:

no Riversoft Console Portal, nos relatórios de eventos e de transferências;
pela Riversoft STCP Gemini API, nos relatórios de eventos de sistema, de usuários, de atividades de operadores e de transferências. Veja Consultar relatórios.

Supervisão pelo Riversoft Console Portal

O Riversoft STCP Gemini Server mantém um serviço de supervisão, usado pelo Riversoft Console Portal para acompanhar e operar a instância. O serviço é cadastrado na instância como o serviço de rede Supervisão (gemini) (porta padrão 33050), e a Riversoft STCP Gemini API conecta a ele em nome do Portal. Veja Serviços de supervisão.

Operações disponíveis:

Operação	Descrição
Informações da instância	Estado e dados da instância em execução.
Informações de usuários	Situação das caixas postais e das conexões dos usuários.
Informações dos serviços	Situação dos serviços de rede.
Iniciar agenda	Executa uma agenda imediatamente.
Iniciar e cancelar usuário	Inicia ou cancela a conexão de um usuário.
Criar usuário	Cria a estrutura de diretórios de um usuário.
Criar arquivo de teste	Gera um arquivo de teste para um usuário.
Parar e reiniciar a instância	Para ou reinicia a instância.
Nível de debug	Altera o nível de debug sem reiniciar o serviço.

As conexões de supervisão são autenticadas com a credencial de supervisão e registradas no log.

Spool de contingência do log

Quando não consegue gravar no banco de log, o Server grava os eventos em um arquivo local de contingência, para não perder os registros:

Item	Valor
Diretório	`$TMPDIR/stcplog-spool/`, ou `/tmp/stcplog-spool/` quando `TMPDIR` não está definido
Arquivo	`stcplog-events.jsonl`, um evento JSON por linha
Rotação	A cada 10 MB, mantendo até 20 arquivos
Retenção	7 dias

Os eventos do spool não são reenviados automaticamente ao banco de log. Monitore esse diretório: arquivos novos indicam falha de gravação no banco.

Debug

O nível de debug é definido em ApplDebug, na seção STCPCore da configuração do Server (0 desabilita), e pode ser alterado durante a execução pelo Riversoft Console Portal. As mensagens de debug são enviadas ao log do sistema:

journalctl -u stcpgemini-server

Use o debug somente durante o diagnóstico: ele aumenta o volume de mensagens.

Checklist de monitoramento

O serviço stcpgemini-server está em execução (systemctl status stcpgemini-server).
O banco de log está acessível e recebe os registros.
O diretório stcplog-spool não tem arquivos novos.
Os relatórios de transferências estão sendo acompanhados no Riversoft Console Portal ou pela API.
O nível de debug volta a 0 depois de um diagnóstico.

Operação Solução de problemas