Armazenamento de Arquivos

← Viewer
↑ Documentação
Grabber →

O que é o Armazenamento de Arquivos?

O Armazenamento de Arquivos é um novo componente do conjunto Kickidler, projetado para armazenar dados binários (vídeo e áudio) recolhidos por agentes, fora da base de dados central. Funciona no disco local e melhora significativamente a estabilidade e desempenho do sistema.

O Armazenamento de Arquivos oferece:

  • armazenamento de todos os arquivos de vídeo e áudio gravados pelo agente Kickidler,
  • descarregamento de grandes dados binários do PostgreSQL,
  • maior escalabilidade ao lidar com um grande número de agentes.

Tipos de dados armazenados:

  • screen/ — gravações de tela,
  • audio/ — gravações de microfone.

Estrutura de armazenamento

Os dados são armazenados da seguinte forma:

ano/mês/dia/tipo/

Esta abordagem oferece flexibilidade e simplifica a administração.

Eliminação de dados

O sistema elimina automaticamente dados obsoletos:

  • verificações a cada 10 minutos,
  • eliminação é feita diariamente (por pastas),
  • período de retenção configurável através da interface da node central.

O que acontece durante a instalação e atualização

Na instalação nova:

  • o utilizador especifica o caminho do armazenamento,

Na atualização:

  • os dados existentes na base de dados permanecem,
  • os novos vídeos e áudios são guardados no armazenamento externo,
  • é garantida compatibilidade com versões anteriores: o sistema continua a ler os dados antigos da BD.

Características e limitações

  • suporta mais de 1000 agentes simultaneamente,
  • sem limite de tamanho .blob (até 9 GB),
  • retransmissão de dados em caso de perda de ligação,
  • chaves únicas impedem duplicação,
  • segurança garantida por permissões do SO (arquivos não são encriptados).

Localização por omissão do armazenamento

Windows:

C:\ProgramData\ki-data

Linux:

/var/opt/ki

Importante: Os diretórios são criados automaticamente após a instalação do servidor.

Alterar o caminho de armazenamento

O caminho pode ser alterado através do arquivo de configuração node.ini.

Instruções para alterar o caminho

  1. Pare o serviço KickidlerNode (nns):

    no Windows através de "Serviços" (services.msc) ou linha de comando:

    net stop nns
    no Linux: 
    systemctl stop kickidlernode

  2. Abra o arquivo de configuração

    C:\Program Files\KickidlerNode\config\ (Windows)

    /opt/KickidlerNode/ (Linux)

    Abra node.ini com um editor de texto (Notepad, Vim, Nano etc.).

  3. Defina o novo caminho:

    Encontre a linha

    fileStoragePath=

    Se existir: altere o valor após = para o caminho absoluto da nova pasta.

    Se não existir: adicione no final:

    fileStoragePath=<Novo_Caminho>

    Formato de caminho:

    utilize barras (`/`) (Unix-style), mesmo no Windows.

    Exemplo para Windows: fileStoragePath=D:/KickidlerData/ ou fileStoragePath=E:/Monitoring/Records/

    Exemplo para Linux: fileStoragePath=/mnt/storage/kickidler_data/

    Assegure que termina com /.

  4. Salve node.ini:

  5. e reinicie o serviço:

    Windows 
    net start nns
    Linux 
    systemctl start kickidlernode

  6. Migrating existing data:

    If you need recordings that are already in the old folder (C:\ProgramData\ki-data or /var/opt/ki), manually copy or move all contents from the old folder to the new folder specified in fileStoragePath= after starting the service with the new settings.

    Make sure that the structure inside the new folder matches the old one (Year/Month/Day/screen/, Year/Month/Day/audio/).

    Key warnings when changing the path:

    Access rights: Ensure that the account under which the nns service (KickidlerNode) runs has full permissions (read/write/modify) on the new target directory and all its subdirectories.

    Sufficient disk space: The new disk must have enough free space to store the recordings.

    Service stop required: Changing the config requires stopping the service. On-the-fly changes are not supported and may cause errors.

Data storage structure inside the storage

Data is organized hierarchically by date:

   Год (YYYY)/

       Месяц (MM)/

           День (DD)/

               screen/ (Папка с видеофайлами)

               audio/ (Папка с аудиофайлами)

File formats (Inside screen/ and audio/):

  • <Number>.lock
  • <Number>.blob
  • <Number>.key

Important: These files are not standard video/audio files (.mp4, .wav, etc.). They cannot be opened directly by third‑party players. They are used exclusively by the player inside Kickidler Viewer. Deleting these files will make the corresponding recordings unavailable in the Viewer.

Retention management and data deletion

Automatic deletion: Since May 2025, a feature has been added to automatically remove video (and related audio) data after the retention period expires.

Configuring the retention period:

  1. Open the Kickidler Administrator web interface.
  2. Go to Configuration → Components & Coordination → Server
  3. Find the parameter Video Retention Period.
  4. Set the desired number of days for which recordings should be stored on the Node (e.g., 7, 14, 30).
  5. Save the server configuration changes.

Como funciona:

Quando expira o “Período de Retenção de Vídeo” definido (contado desde a data da gravação):

  1. As gravações são removidas da base de dados central do servidor.
  2. Os arquivos correspondentes (.lock, .blob, .key) no armazenamento local do Node são automaticamente apagados.

A eliminação manual de arquivos nas pastas de armazenamento já não é necessária nem recomendada, pois arquivos apagados manualmente antes do prazo tornam as gravações indisponíveis no Viewer, e arquivos expirados após o prazo são eliminados automaticamente.

Eliminação manual de dados

Não recomendada para gestão quotidiana, pois a eliminação automática já cobre esta necessidade.

Utilize apenas se:

  • Precisa liberar espaço no disco imediatamente.
  • Pretende eliminar dados por um período específico ainda dentro do “Período de Retenção de Vídeo”.

Como eliminar manualmente:

  1. Pare o serviço KickidlerNode (nns) (ver seção 3.1).
  2. Acesse à pasta de armazenamento local (padrão ou alterada).
  3. Apague as subpastas correspondentes (Ano/Mês/Dia) dos dados que quer limpar.
  4. Reinicie o serviço KickidlerNode (nns).

Apagar manualmente pastas/arquivos diretamente tornará as gravações correspondentes indisponíveis no Kickidler Viewer. Os dados na BD do servidor não são apagados automaticamente nestes casos e podem originar referências “quebradas” a arquivos ausentes.

Resumo para Administrador:

  1. Caminho de armazenamento:

    Configurado em node.ini → fileStoragePath (Unix-style), após parar o serviço. Verifique permissões!

  2. Estrutura:

    Ano/Mês/Dia/screen|audio/ com arquivos .lock, .blob, .key. Não altere manualmente sem necessidade.

  3. Limpeza:

    Configure o Período de Retenção de Vídeo na interface web (Configuração → Componentes & Coordenação → Servidor). A remoção automática de arquivos e registos do BD está ativa. A limpeza manual é apenas como último recurso.

↑ Documentação
Grabber →