# SmartSense
## Introdução
O **GBS SmartSense** é uma aplicação web para monitorar clusters GBDS, permitindo que o usuário veja relatórios ao vivo do desempenho e integridade do ambiente.
Este manual está atualizado para a versão 1.2.4 do SmartSense.
### Acesso e Autenticação
O GBS SmartSense deve ser acessado com um navegador web e recomendamos o Google Chrome. A URL para acesso é específica para cada ambiente. Se necessário, entre em contato com a equipe de suporte da Griaule para obter a URL correta.
É necessário se autenticar para acessar o aplicativo. As credenciais necessárias para o GBS SmartSense são nome de usuário e senha.
{% hint style="info" %}
Na parte inferior da tela há uma opção para alterar o idioma da interface do usuário. Esta opção também está disponível nas configurações após o login.
{% endhint %}
### Autenticação de dois fatores (2FA)
Quando a autenticação de dois fatores (2FA) estiver ligada, na primeira vez que você fizer login, após entrar seu username e senha, será mostrado um QR Code que deve ser registrado no Google Authenticator.
{% hint style="info" %}
Google Authenticator é um gerador de códigos de autenticação disponível como um aplicativo para smartphones [Android](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2\&hl=en\&gl=US) e [iOS](https://apps.apple.com/us/app/google-authenticator/id388497605).
{% endhint %}
Após registrar com sucesso o QR Code no Google Authenticator, insira o código de seis dígitos gerado e clique em Enviar.
Você só precisará registrar o QR Code uma vez. Mas, a cada login subsequente, você precisará inserir o código de seis dígitos gerado pelo Google Authenticator.
Existe um número limitado de tentativas de login sem sucesso que um usuário pode fazer. Sempre que um código incorreto é inserido, uma mensagem de erro será exibida:
Se você atingir o número máximo de tentativas de login sem sucesso, sua conta será automaticamente bloqueada.
{% hint style="warning" %}
Se sua conta for bloqueada, entre em contato com o administrador do sistema.
{% endhint %}
### Logins Simultâneos e Cadastro de Navegador
Apenas uma sessão por usuário é permitida. Não é possível fazer login simultaneamente com um mesmo perfil mais de uma vez na aplicação. Se um usuário já estiver conectado e outro acesso acontecer usando o mesmo nome de usuário e senha, o usuário com a sessão mais antiga será notificado e desconectado na próxima ação.
Além disso, apenas um navegador pode ser usado de cada vez. Ao tentar fazer login usando um navegador diferente, o usuário será informado que é necessário autenticar o novo navegador. A autenticação de um novo navegador revogará o acesso do navegador anterior.
Para autenticar um novo navegador, clique em Autenticar e, em seguida, insira o código de verificação que será enviado para o e-mail vinculado à conta do usuário.
Se a autenticação for bem-sucedida, uma notificação aparecerá no canto superior direito da tela após o login.
### Redefinir Senha
Você pode redefinir sua senha caso a esqueça.
Para redefinir sua senha, na tela de login, clique em Esqueceu sua senha?:
Em seguida, insira o nome de usuário do perfil e clique em Enviar.
Um e-mail contendo um código de verificação será enviado para o endereço de e-mail vinculado a esse perfil. Insira o código de verificação e clique em Enviar código.
Se o código estiver correto, você poderá criar uma nova senha. Insira a nova senha duas vezes. Certifique-se de atender aos requisitos da senha, eles estão listados abaixo do campo de nova senha e ficarão verdes quando atendidos. Por fim, para confirmar a redefinição, clique em Redefinir senha.
## Interface do Usuário
Há seis telas que podem ser acessadas usando a barra lateral: `Lista de Nós`, `Comparação entre Configurações`, `Port Sweep`, `Histórico de Transações`, `Fila` e `Lista de Transações`.
### Lista de Nós
A tela de `Lista de Nós` mostra informações sobre espaço de armazenamento disponível, RAM, temperatura, número de matchers e status para cada host/IP.
Para atualizar as informações mostradas, use o botão de atualização ou recarregue a página pressionando Ctrl/Command + R no teclado.
No canto superior direito, é possível filtrar as informações mostradas por hostname ou endereço IP:
Para criar um novo nó sem acessar diretamente a base de dados, clique no botão Novo Nó no canto inferior direito. Insira as informações de hostname, IP, e porta. Em seguida, marque se é um nó **Ativo**. Finalmente, clique em Adicionar Nó.
O status **Ativo** significa que o nó será analisado e mostrado no SmartSense.
{% hint style="warning" %}
O **hostname** identifica o nó e deve ser único. Tentar criar um novo nó com o mesmo hostname de um nó já existente sobrescreverá o nó existente.
{% endhint %}
#### Detalhes do Nó
Clique em um item da Lista de Nós para abrir a tela de Detalhes do Nó, que mostra informações detalhadas sobre os serviços rodando naquele nó (aba de `Serviços`) e seus recursos de hardware (aba de `Recursos`). Nas duas abas, é possível atualizar as informações mostradas clicando no botão de atualização localizado no canto superior direito da tela.
**Aba de Serviços:**
A aba de `Serviços` mostra os serviços rodando no nó, com suas respectivas portas e seus status.
**Aba de Recursos:**
A aba de `Recursos` mostra informações sobre o hardware do nó, como uso do disco, uso de memória RAM, taxa de transmissão, etc.
### Comparação entre Configurações
A tela de `Comparação entre Configurações` permite que o usuário selecione um arquivo de configuração e um nó de referência para comparar suas configurações com todos os outros nós. As configurações divergentes são mostradas em vermelho.
Para selecionar um arquivo de configuração, clique no menu *dropdown* e escolha um arquivo da lista.
Em seguida, para selecionar um nó, clique no menu *dropdown* e escolha um nó da lista.
É possível remover linhas da tabela clicando no `X` localizado no lado esquerdo de cada linha. Essa opção simplesmente remove a linha da visualização, nenhum arquivo de configuração é modificado.
Para restaurar a lista original com todas as linhas, marque a opção `Mostrar todas as linhas`.
É possível filtrar os resultados e mostrar somente as colunas com nós que possuem configurações diferentes. Para fazer isso, marque a opção `Mostrar somente nós com diferenças`.
### Port Sweep
A tela de `Port Sweep` permite que o usuário selecione um IP e portas específicas para fazer um port sweep em todos os hosts e mostrar os resultados em uma tabela:
Para selecionar um IP, clique no menu *dropdown* e escolha um endereço IP.
As portas podem ser selecionadas como uma lista de portas separadas por vírgula (ex. `8000, 8080, 8125`); como um intervalo, com os limites superior e inferior separados por um hífen (ex. `8005-8015`); or como uma combinação de ambos (ex. `8005-8015, 8080`).
Depois de selecionar um IP e as portas, clique no botão Filtrar, localizado no canto superior direito da tela para realizar o port sweep.
### Histórico de Transações
A tela de `Histórico de Transações` mostra o uso em gráficos de barras (tipo histograma), criados com Kibana. Há cinco abas: `Identify`, `Identify (Latent)`, `Verify`, `Enroll` e `Update`. Em cada aba, é possível interagir com o gráfico, por exemplo, colocando o cursor sobre uma barra para mostrar o número de operações ou clicando e arrastando o cursor sobre algumas barras para dar zoom naquele intervalo. Na parte superior do gráfico, é possível adicionar filtros para personalizar a forma como as informações são mostradas.
{% hint style="warning" %}
Para essa função, é preciso ter o ELK instalado e configurado corretamente. Além disso, é preciso ter os seguintes parâmetros em `config.properties`:
```properties
linkVerify=
linkIdentify=
linkIdentifyLatent=
linkEnroll=
linkUpdate=
```
{% endhint %}
### Fila
A tela de `Queue` mostra a fila atual de transações listada por prioridade.
A lista é continuamente atualizada e o tempo de atualização pode ser ajustado usando o menu *dropdown* localizado no canto superior direito da tela:
É possível exibir a fila para o cluster inteiro ou para um nó referência. Para escolher um nó, clique no menu *dropdown* localizado no canto superior da tela e selecione um nó:
### Lista de Transações
A tela de `Lista de Transações` mostra uma lista de transações processadas em um determinado período de tempo.
Ao abrir a página, serão exibidas as transações realizadas na última hora da data atual.
Para mostrar as transações realizadas em um intervalo de tempo diferente, selecione uma data, um tempo inicial e um tempo final. Em seguida, clique no botão Filtrar.
Também é possível filtrar as transações por PGUID, TGUID, label, chave e biográfico. Para isso, utilize o menu *dropdown* localizado no canto superior direito da tela para selecionar o tipo de filtro, preencha o campo *Valor* e clique no botão Filtrar.
Para obter informações detalhadas sobre uma transação, clique em um item da lista para mostrar a tela `Detalhes da transação`:
É possível baixar os dados biométricos da transação. Para isso, clique no botão Download, localizado no canto superior direito da tela. O arquivo ZIP para download conterá as imagens das biometrias, bem como os templates.
Para mais informações sobre o status da transação, passe o mouse sobre *Ver detalhes* no lado direito da tela, na seção *Problemas*.
### Menu
No canto superior direito da tela, clique sobre o nome de usuário para acessar o menu:
As opções disponíveis são:
* Configurações;
* Manual;
* Sair.
#### Configurações
Nesta tela, há opções para os usuários definirem suas preferências de uso:
* Tema: **claro** ou **escuro**;
* Idioma: **Português** ou **Inglês**;
* Formato de Data: **dd/mm/yyyy**, **mm/dd/yyyy**, ou **yyyy/mm/dd**;
* Formato de Hora: relógio de **12 horas (AM/PM)** ou de **24 horas**.
