> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/sonar/get-started/architecture.md).

# Arquitetura e componentes

As partes que compõem o SONAR, no servidor e em cada endpoint, o caminho de um comando até um dispositivo e de volta, e o que para quando uma parte cai.

O SONAR tem duas metades. No **servidor**, operado pela DataDike, um conjunto de serviços guarda os dados, serve o console e conversa com os dispositivos. Em cada **endpoint**, um ou mais serviços instalados pelo instalador do agente mantêm uma conexão com o servidor, enviam informações sobre o computador e executam o que o console pede.

Saber qual parte faz o quê transforma "o SONAR não está funcionando" em "a área de trabalho remota está fora do ar neste computador, todo o resto responde".

{% hint style="info" %}
Esta página trata do software que faz o produto funcionar. Os objetos que você gerencia (clientes, sites, dispositivos, políticas) estão em [Conceitos fundamentais](https://wiki.datadike.com/pt/sonar/get-started/core-concepts.md). A instalação dos agentes fica em Implantação e operação.
{% endhint %}

## Os componentes

### No servidor

| Componente                   | O que faz                                                                                                                                                                                                                                                                                                                                                                          |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Console**                  | A aplicação web em que você faz login. Tudo o que você vê e faz no SONAR passa por ela                                                                                                                                                                                                                                                                                             |
| **API**                      | Serve o console e as suas integrações, autentica cada requisição, registra as alterações na trilha de auditoria e recebe os dados que os agentes enviam por HTTPS: resultados de checks, resultados de tarefas, saída de scripts, software instalado, atualizações do Windows, atividade dos usuários                                                                              |
| **Serviço de mensageria**    | Mantém uma conexão persistente por agente. Os comandos chegam ao dispositivo por ela, e o sinal de vida (heartbeat) e os relatórios de inventário do agente fazem o caminho de volta, para serem gravados no banco de dados à medida que chegam                                                                                                                                    |
| **Serviço de tarefas**       | Executa o trabalho agendado e em segundo plano: alertas e notificações de disponibilidade, ações em massa, entrega de tarefas automatizadas aos computadores Windows, tarefas agendadas no Linux e no macOS, agendamentos de aprovação e instalação de atualizações, atualizações automáticas do agente, distribuição das políticas de acesso e os números por trás dos dashboards |
| **Serviço de acesso remoto** | Leva as sessões de área de trabalho remota, terminal remoto e transferência de arquivos até o agente de acesso remoto de cada dispositivo, e oferece o wake-on-LAN e o histórico de energia exibido na aba **Uptime**                                                                                                                                                              |
| **Banco de dados**           | Guarda a configuração, o inventário, o histórico e a trilha de auditoria                                                                                                                                                                                                                                                                                                           |

Esses serviços rodam no servidor que a DataDike opera para você. O dimensionamento, o backup e a atualização deles são definidos com o suporte de implantação da DataDike.

### No endpoint

| Componente                  | Plataformas           | Nome do serviço no computador                                                     | O que faz                                                                                                                                                                                                                                                |
| --------------------------- | --------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Agente SONAR**            | Windows, Linux, macOS | `sonarrmm` (**Sonar Agent Service**) no Windows; `sonaragent` no Linux e no macOS | Registra o computador, envia o sinal de vida e o inventário, executa checks, comandos, scripts e tarefas, procura e instala atualizações do Windows e se atualiza sozinho                                                                                |
| **Agente de acesso remoto** | Windows, Linux, macOS | **Mesh Agent**                                                                    | Atende as sessões de área de trabalho remota, terminal remoto e transferência de arquivos. Instalado pelo instalador do agente                                                                                                                           |
| **Módulo de produtividade** | Windows               | `SonarProductivityService` (**Sonar Productivity Service**)                       | Registra as sessões de logon, os aplicativos e sites em uso e o tempo ocioso, e aplica as políticas de acesso no computador: bloqueia um logon fora da janela permitida, avisa antes de uma sessão terminar e faz o logoff do usuário quando ela termina |

Toda conexão é aberta **do endpoint para o servidor**, por HTTPS na porta 443: o agente para o endereço da API, e o agente de acesso remoto para o endereço de acesso remoto. Nada na rede precisa alcançar o endpoint de fora para dentro. Veja [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.md).

## Como um comando chega a um dispositivo

Executar um comando em um dispositivo, a partir da ação **Send Command** do painel do dispositivo:

1. **Você envia o comando no console.** A API verifica se o seu papel concede a permissão e lhe dá acesso ao cliente e ao site daquele dispositivo.
2. **A API grava uma linha na aba History do dispositivo** e entrega o comando ao serviço de mensageria, endereçado àquele único agente.
3. **O serviço de mensageria o entrega** pela conexão que o agente mantém aberta. O agente executa o comando no seu próprio processo.
4. **O agente responde** pela mesma conexão e também envia a saída à API, que a armazena junto com a linha do History.
5. **O console mostra a saída**, e a trilha de auditoria registra quem executou o quê e em qual dispositivo.

Um script segue o mesmo caminho. Uma ação em massa do menu **Tools** difere em um ponto: a API não espera pelos dispositivos. Ela coloca o trabalho na fila, o serviço de tarefas o envia a todos os agentes selecionados de uma vez, e a saída de cada dispositivo chega à sua própria aba **History** à medida que ele termina.

O trabalho agendado segue o caminho inverso. O agente pergunta à API, segundo o seu próprio agendamento, quais checks devem ser executados e devolve cada resultado. As tarefas automatizadas no Windows são gravadas no agendador de tarefas do próprio computador, que as inicia no horário planejado; no Linux e no macOS, é o serviço de tarefas que as inicia. Nos dois casos, o resultado volta para a API e aparece nas abas do dispositivo.

## Quando um dispositivo está offline

O status de um dispositivo é o tempo decorrido desde o seu último sinal de vida (heartbeat), que o agente envia cerca de uma vez por minuto enquanto está conectado. Não existe um sinal separado de "desconectado": um dispositivo que para de se reportar mantém o último status até que o limiar de offline seja ultrapassado. Os limiares estão em [Conceitos fundamentais](https://wiki.datadike.com/pt/sonar/get-started/core-concepts.md#status-do-dispositivo).

O que isso significa para o trabalho que você envia:

| Você envia                                                                                               | Enquanto o dispositivo está offline                                                                                                                                                                                              |
| -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Um comando, um script, uma reinicialização, um desligamento, uma lista de processos, uma ação de serviço | Precisa do agente conectado. Uma ação em um único dispositivo falha com uma mensagem como `Unable to contact the agent`. Uma ação em massa é enviada uma vez; um dispositivo que está offline nesse momento não a executa depois |
| Checks                                                                                                   | O agente busca os checks pendentes quando executa o seu próximo ciclo, então eles voltam sozinhos quando o dispositivo retorna                                                                                                   |
| Tarefas automatizadas para Windows                                                                       | Criadas, alteradas ou removidas no computador na próxima vez que ele estiver online. As tarefas que já estão no computador mantêm o seu agendamento                                                                              |
| Políticas de acesso                                                                                      | Retidas para o dispositivo. O módulo de produtividade recebe a versão atual quando se reconecta, aplica-a e confirma a aplicação                                                                                                 |
| Área de trabalho remota, terminal, transferência de arquivos                                             | Precisa do agente de acesso remoto conectado, indicado como **Remote Online** no painel do dispositivo                                                                                                                           |

## O que para quando uma parte fica indisponível

| Indisponível                                  | O que para                                                                                                                                                                                                                                                                   | O que continua funcionando                                                                                                                                         |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Console ou API**                            | O console, as integrações e tudo o que os agentes enviam por HTTPS: resultados, saída de scripts, atualizações de inventário                                                                                                                                                 | Os agentes continuam rodando nos computadores                                                                                                                      |
| **Serviço de mensageria**                     | Comandos, scripts, reinicializações, visualização de processos, serviços e logs de eventos, execução de checks sob demanda. Os sinais de vida deixam de ser registrados, então os dispositivos ficam offline quando o limiar é ultrapassado                                  | Área de trabalho remota, terminal e transferência de arquivos, que usam o serviço de acesso remoto                                                                 |
| **Serviço de tarefas**                        | Alertas de disponibilidade e notificações por e-mail ou SMS, ações em massa, atualizações automáticas do agente, agendamentos de atualizações, tarefas agendadas no Linux e no macOS, entrega das alterações de políticas de acesso e o recálculo dos números dos dashboards | Ações em um único dispositivo a partir do seu painel, que passam diretamente pela API                                                                              |
| **Serviço de acesso remoto**                  | Área de trabalho remota, terminal remoto, transferência de arquivos, wake-on-LAN, a aba **Uptime**                                                                                                                                                                           | Tudo o que passa pelo agente                                                                                                                                       |
| **Banco de dados**                            | Tudo                                                                                                                                                                                                                                                                         | Nada do lado do servidor                                                                                                                                           |
| **Agente SONAR em um dispositivo**            | Aquele dispositivo deixa de se reportar e de aceitar comandos, e fica offline                                                                                                                                                                                                | A área de trabalho remota ainda pode responder, se o agente de acesso remoto estiver rodando                                                                       |
| **Agente de acesso remoto em um dispositivo** | Área de trabalho remota, terminal e transferência de arquivos daquele dispositivo. O painel mostra **Remote Offline**                                                                                                                                                        | Tudo o que passa pelo agente SONAR. Com o agente online, **Restart Remote Service** no painel do dispositivo pede ao agente que reinicie o agente de acesso remoto |
| **Módulo de produtividade em um dispositivo** | A atividade dos usuários daquele computador e a aplicação das políticas de acesso nele                                                                                                                                                                                       | Tudo o que passa pelo agente SONAR                                                                                                                                 |

## Por que alguns números demoram a atualizar

As telas que resumem o parque inteiro não contam os dispositivos a cada vez que você as abre. O serviço de tarefas calcula esses números em segundo plano, e os cartões do dashboard **Home** são recalculados a cada cinco minutos. Um dispositivo que acabou de ficar online aparece na lista de dispositivos do **Sysadmin** assim que você a recarrega, e nas contagens da Home em poucos minutos.

## Erros comuns

| Sintoma                                                                                                | Causa                                                                                                       | Correção                                                                                                                                      |
| ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `Unable to contact the agent` ao enviar um comando                                                     | O agente não está conectado ao serviço de mensageria                                                        | Confira **Agent Status** e **Last Response**. Se o dispositivo estiver desligado ou offline, espere que ele volte; o comando não fica na fila |
| Uma ação em massa informa que será executada, mas alguns dispositivos não têm resultado em **History** | Esses dispositivos estavam offline quando o trabalho foi enviado                                            | Execute a ação de novo nesses dispositivos quando eles estiverem online                                                                       |
| **Take Control** está desabilitado e o painel mostra **Remote Offline**                                | O agente de acesso remoto do dispositivo não está conectado                                                 | Se o dispositivo estiver online, use **Restart Remote Service**; caso contrário, espere o dispositivo voltar                                  |
| A lista de dispositivos mostra um dispositivo como online, mas ele foi desligado há uma hora           | O status é o tempo decorrido desde o último sinal de vida, e o limiar de offline ainda não foi ultrapassado | Leia **Last Response**, que mostra o horário real do último contato                                                                           |
| Um dispositivo novo está na lista de dispositivos, mas ainda não nas contagens da Home                 | Os números da Home são recalculados a cada cinco minutos                                                    | Espere alguns minutos e atualize o dashboard Home                                                                                             |

## Páginas relacionadas

* [Conceitos fundamentais](https://wiki.datadike.com/pt/sonar/get-started/core-concepts.md): os objetos sobre os quais os componentes agem
* [Um tour pelo console](https://wiki.datadike.com/pt/sonar/get-started/console-tour.md): onde fica cada tela
* [Requisitos de rede](https://wiki.datadike.com/pt/sonar/deploy-operate/network-requirements.md): o que os endpoints precisam conseguir alcançar
* [O módulo de produtividade](https://wiki.datadike.com/pt/sonar/deploy-operate/productivity-module.md)
* [Solucionar problemas dos agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/troubleshooting.md)
