> 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/core-concepts.md).

# Conceitos fundamentais

O vocabulário do SONAR (clientes, sites, dispositivos, status, políticas, checks, tarefas, alertas, colaboradores, papéis) e como os objetos se relacionam.

Quase toda tela do console é uma lista de um dos objetos abaixo. Entender como eles se encaixam torna a leitura do restante desta documentação mais rápida, e alguns deles são fáceis de confundir: esses estão destacados no final.

## A cadeia, em uma frase

Um **dispositivo** executa o **agente** e pertence a um **site** de um **cliente**; as **políticas de automação** que chegam a ele por esse cliente e esse site lhe dão os seus **checks** e **tarefas**; um check que falha gera um **alerta**, tratado conforme o seu **modelo de alerta**; e toda alteração feita no console é gravada na **trilha de auditoria** em nome do **usuário do SONAR** que a fez.

## Como os dispositivos são organizados

### Cliente

O nível mais alto da árvore: uma organização cujos computadores você gerencia. Todo site e, portanto, todo dispositivo pertence a exatamente um cliente. Os clientes aparecem no grupo **Clients** da barra lateral do **Sysadmin** e são gerenciados em **Management › Clients**.

### Site

Uma subdivisão de um cliente: um escritório, uma filial, um departamento. Um dispositivo pertence a exatamente um site. O instalador do agente é sempre gerado para um site, então é o site que decide onde um novo dispositivo aparece.

### Dispositivo e agente

Um **dispositivo** é um computador que executa o **agente**. O dispositivo é o registro no console; o agente é o software no computador. Cada dispositivo tem um **tipo**, **workstation** ou **server**, escolhido quando o agente é instalado. O tipo decide qual política de automação um cliente ou um site dá ao dispositivo, já que cada um deles pode ter uma política para estações de trabalho e outra para servidores.

Os dispositivos aparecem em **Dashboard › Sysadmin**, e selecionar um deles abre o painel do dispositivo com as suas abas. Veja [A lista de dispositivos](https://wiki.datadike.com/pt/sonar/administration/devices/device-list.md).

## Status do dispositivo

O status de um dispositivo é o tempo decorrido desde o último sinal de vida (heartbeat) do agente, que ele envia cerca de uma vez por minuto enquanto está conectado. **Last Response**, na lista de dispositivos, mostra quando foi esse último sinal.

| Status      | Significado                                                 | Limiar padrão            |
| ----------- | ----------------------------------------------------------- | ------------------------ |
| **online**  | O agente se reportou dentro do limiar de offline            | Não se aplica            |
| **offline** | Nenhum sinal de vida por mais tempo que o limiar de offline | 12 horas (720 minutos)   |
| **overdue** | Nenhum sinal de vida por mais tempo que o limiar de atraso  | 30 dias (43.200 minutos) |

Os dois limiares são definidos por dispositivo, na caixa de diálogo **Edit** do dispositivo, como **Offline after (minutes)** e **Overdue after (minutes)**. É quando um dispositivo fica em atraso (overdue) que um alerta de disponibilidade é gerado, se o dispositivo ou o seu modelo de alerta pedir um; o alerta é resolvido quando o dispositivo volta a se reportar.

Os contadores do dashboard **Home** e do **Clients overview** agrupam os dispositivos por faixas fixas de tempo desde o último contato (menos de 12 horas, mais de 12 horas, mais de 24 horas, mais de 7 dias, mais de 30 dias) e contam à parte os dispositivos em modo de manutenção. O Clients overview também conta separadamente os dispositivos arquivados.

### Modo de manutenção

Uma chave em um dispositivo, ou em todos os dispositivos de um site ou de um cliente de uma vez (**Enable Maintenance Mode** no menu do dispositivo ou na árvore de clientes). Enquanto um dispositivo está em modo de manutenção, nenhum alerta é gerado para ele. Os seus checks e tarefas continuam sendo executados, e ele é contado em **In Maintenance** em vez de pelo status. Use-o em trabalhos planejados, para que um servidor que você está reiniciando não acione ninguém.

### Dispositivo arquivado

**Archive Agent** manda o agente do computador se desinstalar, o que acontece se o dispositivo estiver online naquele momento, e mantém o registro e o histórico do dispositivo no console, contado em **Archived**. Nenhum alerta é gerado para um dispositivo arquivado. Desarquivá-lo não reinstala o agente; para voltar a gerenciar aquele computador, instale o agente nele.

## Automação

### Política de automação

Um conjunto nomeado de **checks** e **tarefas** (e, opcionalmente, uma política de atualizações e um modelo de alerta) que você define uma vez e atribui a muitos dispositivos. As políticas são gerenciadas em **Management › Automations** e atribuídas com **Assign Automation Policy**, em um dispositivo, um site ou um cliente.

Um dispositivo recebe, do nível mais específico ao mais geral:

1. a política atribuída ao próprio dispositivo;
2. a **Workstation Policy** ou a **Server Policy** do site, conforme o tipo do dispositivo;
3. a política para estações de trabalho ou para servidores do cliente;
4. a política padrão para estações de trabalho ou para servidores, definida em **Admin Center › Settings**, em **Defaults**.

**Block policy inheritance** em um dispositivo, um site ou um cliente impede que os níveis acima dele se apliquem. Quando um check do próprio dispositivo e um check de política medem a mesma coisa (o mesmo disco, o mesmo serviço), vale o check do dispositivo, a menos que a política esteja como **Enforced**, caso em que vale o check da política. As tarefas não são mescladas: o dispositivo executa as suas próprias tarefas e as de todas as políticas que chegam até ele.

Veja [Políticas de automação](https://wiki.datadike.com/pt/sonar/administration/automation/automation-policies.md).

### Check

Uma medição que o agente faz de forma agendada, com resultado de sucesso ou falha: **CPU Load Check**, **Memory Check**, **Disk Space Check**, **Ping Check**, **Windows Service Check**, **Event Log Check**, **Script Check**. Um check que falha um número definido de vezes seguidas gera um alerta. Os resultados ficam na aba **Checks** do dispositivo. Veja [Checks](https://wiki.datadike.com/pt/sonar/administration/automation/checks.md).

### Tarefa

Uma tarefa automatizada: uma sequência de comandos e scripts que o agente executa de forma agendada (**Daily**, **Weekly**, **Monthly**, **Run Once**) ou quando um check falha (**On check failure**), uma vez quando a tarefa chega pela primeira vez a um dispositivo (**Onboarding**), ou só quando você a inicia (**Manual**). Os resultados ficam na aba **Tasks** do dispositivo. Veja [Tarefas automatizadas](https://wiki.datadike.com/pt/sonar/administration/automation/automated-tasks.md).

### Script

Um trecho de código reutilizável guardado em **Management › Scripts** (PowerShell, Batch, Python, Shell, Nushell ou Deno) que você executa em um dispositivo, em vários dispositivos, como um check ou como uma etapa de uma tarefa. Veja [Biblioteca de scripts](https://wiki.datadike.com/pt/sonar/administration/automation/scripts.md).

## Alertas

### Alerta

Um registro de que algo precisa de atenção: um dispositivo ficou em atraso, um check falhou ou uma tarefa falhou. Cada alerta tem uma severidade (**Informational**, **Warning** ou **Error**) e fica aberto até ser resolvido, seja sozinho, quando o check volta a passar ou o dispositivo retorna, seja à mão. O sino no cabeçalho mostra os alertas ativos mais recentes.

### Modelo de alerta

As regras que decidem o que acontece quando um alerta abre e quando ele é resolvido: quem recebe um e-mail ou um SMS, se o alerta aparece no console e qual script ou requisição web é executado como ação. Os modelos são gerenciados pelo botão **Alerts** do cabeçalho e atribuídos a um cliente, a um site ou a uma política de automação, ou definidos como padrão em **Admin Center › Settings**.

O modelo em vigor para um dispositivo é o mais específico: o da política do dispositivo, depois o do site, depois o do cliente, depois o padrão. Nos níveis de site e de cliente, um modelo trazido pela política de automação atribuída vem antes de um atribuído diretamente. Veja [Alertas e modelos de alerta](https://wiki.datadike.com/pt/sonar/administration/automation/alerts.md).

## Pessoas e acesso

### Usuário do SONAR

Uma pessoa que faz login no console. Os usuários do SONAR são gerenciados em **Admin Center › Users**, entram com uma senha e um segundo fator, e têm um **papel** cada um. Tudo o que eles alteram é gravado na trilha de auditoria em nome deles.

### Papel

O que um usuário do SONAR pode fazer no console: um conjunto de permissões, agrupadas como **Agents**, **System**, **Automation & Tasks**, **Policies** e assim por diante, mais **Client & Site Access**, ou seja, os **Allowed Clients** e **Allowed Sites** aos quais o papel está limitado. Uma lista vazia significa que todos os clientes, ou todos os sites, são permitidos. **Super User** concede tudo. Os papéis são gerenciados em **Admin Center › Roles**. Veja [Papéis e permissões](https://wiki.datadike.com/pt/sonar/administration/identities/roles.md).

### Colaborador

Uma pessoa que usa os computadores gerenciados, e não alguém que faz login no console. O SONAR cria um registro de colaborador na primeira vez que o módulo de produtividade vê um novo nome de usuário do Windows em uma sessão, e você o completa com nome, cargo, departamento e os sites em que a pessoa trabalha. Um colaborador pode ter vários nomes de usuário. Os colaboradores ficam em **Management › Employees**, e os **termos** de uso assinados vinculados a eles, em **Management › Terms**. Veja [Colaboradores](https://wiki.datadike.com/pt/sonar/administration/employees/employees.md).

### Política de acesso

Um conjunto de janelas de horário de logon do Windows (por exemplo, de segunda a sexta, das 08:00 às 18:00) atribuído a dispositivos (um dispositivo, um site, um cliente ou todos os dispositivos) e a usuários (um nome de usuário, um padrão de nome de usuário ou os colaboradores de um site). Para esses usuários, nesses dispositivos, o módulo de produtividade bloqueia um logon fora da janela, avisa antes de a janela terminar e faz o logoff do usuário quando ela termina, conforme as configurações da política. Usuários que nenhuma política cobre não são afetados. As políticas de acesso ficam em **Observability › Policies**. Veja [Políticas de acesso](https://wiki.datadike.com/pt/sonar/administration/access/access-policies.md).

### Pedido de extensão

Um pedido que um usuário final envia de um computador Windows para ter mais tempo fora da sua janela. Ele aparece em **Observability › Requests**, onde você o aprova ou nega; um pedido aprovado dá a esse usuário uma liberação temporária. Veja [Pedidos de extensão](https://wiki.datadike.com/pt/sonar/administration/access/requests.md).

## Trilha de auditoria

O registro do que aconteceu pelo console: objetos criados, alterados e excluídos, com os valores de antes e depois; logins; comandos e scripts executados; ações em massa; sessões remotas. Ela fica em **Reports & Audits › Audits**, e os registros de um dispositivo ficam na aba **Audits** dele. A aba **History** do dispositivo guarda a saída dos comandos, scripts e tarefas executados nele. Veja [Trilha de auditoria](https://wiki.datadike.com/pt/sonar/administration/audit/audit-trail.md).

## Distinções que vale acertar

**Usuário do SONAR não é colaborador.** Um usuário do SONAR faz login no console e age sobre os dispositivos. Um colaborador usa um computador gerenciado e nunca faz login no console. A mesma pessoa pode ser as duas coisas, com dois registros sem relação entre si.

**Política de automação não é política de acesso.** Uma política de automação dá checks e tarefas aos dispositivos: trata de cuidar do computador. Uma política de acesso decide quando as pessoas podem fazer logon no Windows: trata do usuário. Elas são gerenciadas em lugares diferentes (**Management › Automations** e **Observability › Policies**) e nunca afetam uma à outra.

**Check não é tarefa.** Um check mede e reporta sucesso ou falha; ele pode gerar um alerta. Uma tarefa age: executa comandos e scripts. Os dois se encontram quando uma tarefa é configurada para rodar em **On check failure**, e é assim que um check que falha pode corrigir a própria causa.

**Papel não é só escopo de clientes.** Um papel ao mesmo tempo concede ações e as limita aos clientes e sites permitidos. Dar a alguém acesso a um cliente não permite que essa pessoa execute scripts nele, a menos que o papel também conceda **Run Scripts**.

**Offline não é o mesmo que em atraso.** Offline significa que o dispositivo não se reporta há algum tempo, como um notebook desligado à noite. Em atraso significa que ele sumiu por tempo suficiente para gerar um alerta de disponibilidade.

## Páginas relacionadas

* [Arquitetura e componentes](https://wiki.datadike.com/pt/sonar/get-started/architecture.md): o software que faz esses objetos funcionarem
* [Um tour pelo console](https://wiki.datadike.com/pt/sonar/get-started/console-tour.md): onde fica cada objeto
* [Integre seu primeiro dispositivo](https://wiki.datadike.com/pt/sonar/get-started/first-device.md): o vocabulário na prática
* [Clientes e sites](https://wiki.datadike.com/pt/sonar/administration/devices/clients-and-sites.md)
* [Glossário](https://wiki.datadike.com/pt/sonar/reference/glossary.md)
