> 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/administration/devices/device-list.md).

# A lista de dispositivos

Encontre um dispositivo em Dashboard › Sysadmin: a visão geral dos clientes, a busca, os filtros, as colunas e o status, o menu de ações e o formulário Edit.

## O que é e quando usar

**Dashboard › Sysadmin** é onde aparecem todos os dispositivos com um agente SONAR. A tela abre em uma visão geral da saúde por cliente; ao escolher um cliente, abre-se a lista de dispositivos, com o título **SYSADMIN — Endpoint monitoring and management**. Na lista, você encontra um dispositivo, lê o status dele de relance, abre o painel de detalhes, age sobre ele pelo menu de ações e altera as configurações dele com **Edit**.

Use-a sempre que a pergunta começar por um dispositivo: ele está online, quando respondeu pela última vez, quem está conectado nele, ele precisa ser reiniciado, em qual site ele está.

## Antes de começar

* Um papel com **List Agents** (**Admin Center › Roles**, grupo **Agents**). A lista mostra apenas os dispositivos dos clientes e sites que o seu papel permite.
* **Edit Agent** para usar **Edit**, o modo de manutenção e o arquivamento. As demais ações do menu têm permissões próprias, listadas em [Ações em um dispositivo](#acoes-em-um-dispositivo).
* Pelo menos um dispositivo com o agente instalado. Veja [Integre o seu primeiro dispositivo](https://wiki.datadike.com/pt/sonar/get-started/first-device.md).

## Passos

1. Abra **Dashboard › Sysadmin**. Aparece a **Clients overview** (visão geral dos clientes), com um cartão por cliente e um cartão **All clients** com os totais da organização.
2. Clique no cartão de um cliente, ou em **All clients**. A lista de dispositivos abre com um chip de filtro **Client** acima dela.
3. Para restringir a lista a um site, expanda o cliente no grupo **Clients** da barra lateral e clique no site.
4. Digite em **Search devices...** e pressione Enter, ou clique na lupa.
5. Clique em **Filters** para filtrar por disponibilidade, tipo de dispositivo ou último contato, e depois clique em **Apply**.
6. Clique no cabeçalho de uma coluna para ordenar a lista por ela. Clique de novo para inverter a ordem.
7. Clique em uma linha. O painel de detalhes abaixo da lista carrega esse dispositivo.
8. Clique com o botão direito na linha para abrir o menu de ações desse dispositivo.

## O que você deve ver

A lista mostra 10 linhas por página por padrão; o seletor acima da tabela alterna entre 10, 25, 50 e 100, e **Page 1 of N**, com os botões de seta, navega entre as páginas. A busca, os filtros e a ordenação valem para a lista inteira, e não só para a página que está na tela.

Cada filtro ativo aparece como um chip acima da tabela: **Client**, **Site**, **Availability**, **Type**, **Last seen**, e a ordenação, como **Order By Hostname (ASC)**. Cada chip tem um `x` para removê-lo; **Clear Filters** remove todos eles, inclusive o texto da busca.

Quando uma lista carrega, a primeira linha fica selecionada e o painel de detalhes a mostra. **No devices found.** significa que nada corresponde ao cliente, à busca e aos filtros atuais.

O console lembra o último cliente que você abriu. Na próxima vez que você abrir **Dashboard › Sysadmin** no mesmo navegador, ele vai direto para os dispositivos desse cliente; remova o chip **Client** para voltar à visão geral.

## Como verificar se funcionou

* **Encontrar um dispositivo**: os chips acima da tabela dizem exatamente qual cliente, qual site e quais filtros produziram a lista. Se estiver faltando um dispositivo que você esperava ver, remova os chips um de cada vez até ele aparecer.
* **Editar um dispositivo**: depois de **Save**, o console mostra `Agent was edited!` e a linha passa a refletir o novo site, tipo ou descrição. A alteração fica registrada em **Reports & Audits › Audits** como uma ação **Modify** sobre o objeto **Agent**, com o seu nome de usuário e os valores antes e depois.

## A visão geral dos clientes

A primeira tela de **Dashboard › Sysadmin** tem o título **Clients overview — Device health snapshot per client**. Cada cartão mostra o nome do cliente, o número dele, o total de dispositivos e sete contadores. Passe o mouse sobre um contador para ver o nome dele.

| Contador       | Dispositivos que ele conta                  |
| -------------- | ------------------------------------------- |
| Online < 12h   | Com contato nas últimas 12 horas            |
| Offline > 12h  | Último contato há entre 12 e 24 horas       |
| Offline > 24h  | Último contato há entre 24 horas e 7 dias   |
| Offline > 7d   | Último contato há entre 7 e 30 dias         |
| Overdue > 30d  | Último contato há mais de 30 dias, ou nunca |
| In maintenance | Dispositivos em modo de manutenção          |
| Archived       | Dispositivos arquivados                     |

Os cinco contadores baseados em tempo deixam de fora os dispositivos em modo de manutenção e os dispositivos arquivados, que têm contadores próprios. As janelas são fixas e não dependem das configurações **Offline after** e **Overdue after** de cada dispositivo.

**Search client...** filtra os cartões pelo nome ou pelo número do cliente.

## Colunas

Qualquer coluna pode ser ocultada ou exibida pelo botão **⋮** à direita da barra de ferramentas (**Columns**). A escolha fica guardada no seu navegador.

| Coluna          | O que mostra                                                                                                                  |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| #               | Número da linha, contado ao longo das páginas                                                                                 |
| Hostname        | Nome do dispositivo, com um ícone de servidor ou de estação de trabalho                                                       |
| IP              | Endereços IPv4 locais informados pelo agente; o IP público quando não há nenhum                                               |
| Agent Status    | `online`, `offline` ou `overdue`. Veja [Status](#status)                                                                      |
| Last Response   | Data e hora do último contato do agente                                                                                       |
| OS              | Nome e versão do sistema operacional                                                                                          |
| Type            | `server` ou `workstation`, conforme definido em **Edit**                                                                      |
| Checks Status   | `Passing`, ou o número de checks com falha, com aviso e informativos, por exemplo `1 failing / 0 warning / 0 info`            |
| Client          | Cliente ao qual o dispositivo pertence                                                                                        |
| Site            | Site ao qual o dispositivo pertence                                                                                           |
| Public IP       | Endereço que o dispositivo usa para alcançar o SONAR                                                                          |
| Description     | Texto livre definido em **Edit**                                                                                              |
| User            | Usuário conectado ao dispositivo. Quando ninguém está conectado e o dispositivo está online, o último usuário que se conectou |
| Patches Pending | `Yes` quando o dispositivo tem atualizações do Windows aprovadas e ainda não instaladas                                       |
| Pending Actions | Número de ações na fila, como uma reinicialização agendada                                                                    |
| Needs Reboot    | `Yes` quando o sistema operacional informa uma reinicialização pendente                                                       |
| Boot Time       | Tempo desde a última inicialização, por exemplo `3 days ago`                                                                  |
| First Seen      | Quando o agente se registrou no SONAR                                                                                         |

Estas colunas permitem ordenação: **Hostname**, **IP**, **Agent Status**, **Last Response**, **OS**, **Type**, **Client**, **Site**, **Public IP**, **User**, **Boot Time** e **First Seen**.

## Status

O agente faz contato com o SONAR cerca de uma vez por minuto. Cada contato atualiza **Last Response**, e o status resulta da idade desse último contato, comparada com dois tempos definidos por dispositivo em **Edit**:

| Status    | Regra                                                                                                                              | Padrão                  |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| `online`  | Último contato mais recente que **Offline after**                                                                                  | 720 minutos (12 horas)  |
| `offline` | Mais antigo que **Offline after** e mais recente que **Overdue after**. Um dispositivo que nunca fez contato também fica `offline` | -                       |
| `overdue` | Mais antigo que **Overdue after**                                                                                                  | 43200 minutos (30 dias) |

Um dispositivo desligado continua mostrando `online` até que **Offline after** tenha passado. Reduza **Offline after** nos dispositivos sobre os quais você precisa saber mais cedo. `overdue` é o status que gera um alerta de disponibilidade, quando os alertas de atraso estão habilitados para o dispositivo. Veja [Alertas e modelos de alerta](https://wiki.datadike.com/pt/sonar/administration/automation/alerts.md).

## Busca e filtros

**Search devices...** encontra o texto em qualquer parte destes dados: nome do host, descrição, sistema operacional, plataforma, tipo, cliente, site, endereços IP público e locais, usuário conectado e último usuário conectado, e modelo de CPU. Uma data digitada como `dd/mm` ou `dd/mm/yyyy` encontra os dispositivos cujo último contato, primeiro registro ou data de inicialização cai nesse dia. As palavras `server`, `desktop` e `notebook`, digitadas sozinhas, listam os dispositivos dessa categoria de hardware.

**Filters** abre **Filter Devices**:

| Seção        | Opção                                                             | Dispositivos listados                                                               |
| ------------ | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| Availability | All                                                               | Sem filtro de disponibilidade                                                       |
|              | Online                                                            | Com contato nas últimas 12 horas                                                    |
|              | Offline                                                           | Status `offline`, segundo **Offline after** e **Overdue after** de cada dispositivo |
|              | Overdue                                                           | Último contato há mais de 30 dias                                                   |
|              | Offline 12+ hours                                                 | Último contato há entre 12 e 24 horas, ou nunca                                     |
|              | Offline 24+ hours                                                 | Último contato há entre 24 horas e 7 dias                                           |
|              | Offline 7+ days                                                   | Último contato há entre 7 e 30 dias                                                 |
|              | Maintenance Mode                                                  | Dispositivos em modo de manutenção                                                  |
| Device Type  | All, Servers, Workstations                                        | Pelo **Type** definido em **Edit**                                                  |
| Last Seen    | Any time, Last 1H, Last 3H, Last 12H, Last 24H, Last 7D, Last 30D | Último contato dentro dessa janela, contada para trás a partir de agora             |
|              | Custom...                                                         | Último contato entre duas datas que você escolhe                                    |

Exceto **Offline** e **Maintenance Mode**, as opções de disponibilidade deixam de fora os dispositivos em modo de manutenção e os dispositivos arquivados. **Clear** redefine as três seções e recarrega a lista.

## Ações em um dispositivo

Clique com o botão direito em uma linha, ou use o botão **⋮** no cabeçalho do painel de detalhes, para abrir **Agent Actions** desse dispositivo. Um item para o qual você não tem permissão aparece esmaecido e mostra `You don't have permission for this action`.

| Ação                                               | O que faz                                                                                                                                                                                         | Permissão                        |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| Take Control                                       | Abre a janela de acesso remoto do dispositivo em uma nova aba do navegador                                                                                                                        | Use Mesh                         |
| Edit                                               | Abre o formulário Edit. Veja [Editar um dispositivo](#editar-um-dispositivo)                                                                                                                      | Edit Agent                       |
| Pending Agent Actions                              | Lista as ações na fila do dispositivo, como reinicializações agendadas, com **Cancel Action**                                                                                                     | Edit Agent, List Pending Actions |
| Send Command                                       | Executa um comando avulso no dispositivo                                                                                                                                                          | Send Command                     |
| Run Script                                         | Executa no dispositivo um script da biblioteca                                                                                                                                                    | Run Scripts                      |
| Run Favorited Script                               | Submenu com os seus scripts favoritos                                                                                                                                                             | Run Scripts                      |
| Enable Maintenance Mode / Disable Maintenance Mode | Impede que o dispositivo gere alertas enquanto você trabalha nele. Veja [Detalhes do dispositivo](https://wiki.datadike.com/pt/sonar/administration/devices/device-details.md#modo-de-manutencao) | Edit Agent                       |
| Archive Agent / Unarchive Agent                    | Arquiva o dispositivo depois que você digita `yes`. Veja [Detalhes do dispositivo](https://wiki.datadike.com/pt/sonar/administration/devices/device-details.md#arquivar-um-dispositivo)           | Edit Agent                       |
| Patch Management › Run Patch Status Scan           | Pede ao dispositivo que procure atualizações do Windows                                                                                                                                           | Manage Windows Updates           |
| Patch Management › Install Patches Now             | Instala agora as atualizações do Windows aprovadas                                                                                                                                                | Manage Windows Updates           |
| Run Checks                                         | Executa agora os checks do dispositivo                                                                                                                                                            | Run Checks                       |
| Wake-Up (WoL)                                      | Envia uma solicitação Wake-on-LAN ao dispositivo                                                                                                                                                  | Send Wake-on-LAN                 |
| Assign Automation Policy                           | Atribui uma política diretamente ao dispositivo, ou bloqueia a herança                                                                                                                            | Manage Policies, Edit Agent      |
| Reboot › Now                                       | Reinicia o dispositivo depois de uma confirmação                                                                                                                                                  | Reboot Agents                    |
| Reboot › Later                                     | Agenda uma reinicialização para uma data e uma hora no fuso horário do dispositivo                                                                                                                | Reboot Agents                    |
| Shutdown                                           | Desliga o dispositivo depois que você digita `yes`                                                                                                                                                | Reboot Agents                    |
| Remove Agent                                       | Desinstala o agente e exclui o dispositivo do SONAR. Pede um **Reason** (motivo), guardado no registro de auditoria                                                                               | Uninstall Agents                 |

**Remove Agent** verifica primeiro se o dispositivo responde. Se ele não responder, o console avisa que o agente precisará ser desinstalado manualmente no computador e pergunta se deve continuar. Veja [Remover agentes](https://wiki.datadike.com/pt/sonar/deploy-operate/remove-agents.md).

Um duplo clique em uma linha abre **Edit**.

## Editar um dispositivo

1. Clique com o botão direito na linha e escolha **Edit**, ou dê um duplo clique na linha.
2. Em **General**, altere os campos necessários. Veja a referência de campos abaixo.
3. Em **Custom Fields**, preencha os valores dos campos personalizados do dispositivo. A aba lista todos os campos criados para agentes em **Admin Center › Settings › Custom Fields**, e avisa quando não há nenhum.
4. Em **Patches**, defina a aprovação e o agendamento das atualizações do Windows do dispositivo. Veja [Política de aprovação de atualizações](https://wiki.datadike.com/pt/sonar/administration/patching/patch-policy.md).
5. **Automation Policies** é somente leitura: mostra as políticas que se aplicam ao dispositivo, o modelo de alerta dele e a política de atualizações efetiva.
6. Clique em **Save**.

Alterar **Site** move o dispositivo para esse site, com as políticas e o modelo de alerta que vêm com ele.

## Erros comuns

| Sintoma                                                                                            | Causa                                                                              | Correção                                                                                                                     |
| -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Um dispositivo não aparece na lista                                                                | Um chip ainda o está filtrando, ou o seu papel não inclui o cliente ou o site dele | Clique em **Clear Filters**. Se ele continuar sem aparecer, confira os clientes e sites do papel em **Admin Center › Roles** |
| Uma ação aparece esmaecida com `You don't have permission for this action`                         | O seu papel não tem a permissão indicada na tabela acima                           | Peça que a permissão seja adicionada ao seu papel                                                                            |
| Um dispositivo desligado continua mostrando `online`                                               | **Offline after** ainda não passou desde o último contato                          | Aguarde, ou reduza **Offline after** para esse dispositivo                                                                   |
| `Minimum is 15 seconds`, `Minimum is 2 minutes` ou `Minimum is 3 minutes` sob um campo em **Edit** | O valor está abaixo do intervalo que o formulário aceita                           | Informe um valor dentro do intervalo indicado na referência de campos                                                        |
| **Remove Agent** diz que o agente está offline                                                     | O dispositivo não respondeu                                                        | Continue apenas se você puder desinstalar o agente no computador à mão                                                       |
| A lista abre direto em um cliente                                                                  | O console restaurou o último cliente que você abriu                                | Remova o chip **Client** para voltar à visão geral                                                                           |

## Referência de campos

**Edit › General**

| Campo                        | O que faz                                                                                         | Valores aceitos                                             | Padrão                       |
| ---------------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ---------------------------- |
| Site                         | Site ao qual o dispositivo pertence. Alterá-lo move o dispositivo                                 | Qualquer site que você possa ver                            | Site escolhido na instalação |
| Type                         | Servidor ou estação de trabalho. Decide quais políticas se aplicam e como o dispositivo é contado | `server`, `workstation`                                     | Escolhido na instalação      |
| Description                  | Texto livre exibido na coluna **Description** e incluído na busca                                 | Até 255 caracteres                                          | Vazio                        |
| Timezone                     | Fuso horário usado nos agendamentos do dispositivo, como **Reboot › Later**                       | Qualquer fuso horário, ou vazio para seguir o padrão global | Padrão global                |
| Device ownership             | Se o dispositivo é próprio da organização ou alugado                                              | **Owned**, **Leased**                                       | **Owned**                    |
| Leased Reference             | Referência do contrato ou do patrimônio de um dispositivo alugado                                 | Até 200 caracteres                                          | Vazio                        |
| Run checks every (seconds)   | Com que frequência o agente executa os checks do dispositivo                                      | 15 a 86400                                                  | 120                          |
| Offline after (minutes)      | Tempo sem contato após o qual o dispositivo mostra `offline`                                      | 2 a 9999998                                                 | 720                          |
| Overdue after (minutes)      | Tempo sem contato após o qual o dispositivo mostra `overdue`                                      | 3 a 9999998                                                 | 43200                        |
| Get overdue email alerts     | Envia um e-mail quando o dispositivo passa a `overdue`                                            | Ligado, desligado                                           | Desligado                    |
| Get overdue sms alerts       | Envia um SMS quando o dispositivo passa a `overdue`                                               | Ligado, desligado                                           | Desligado                    |
| Get overdue dashboard alerts | Mostra um alerta no console quando o dispositivo passa a `overdue`                                | Ligado, desligado                                           | Desligado                    |

Um modelo de alerta aplicado ao dispositivo pode enviar alertas de atraso mesmo com essas três caixas desmarcadas.

## Páginas relacionadas

* [Detalhes do dispositivo](https://wiki.datadike.com/pt/sonar/administration/devices/device-details.md): o painel abaixo da lista
* [Clientes e sites](https://wiki.datadike.com/pt/sonar/administration/devices/clients-and-sites.md)
* [Campos personalizados](https://wiki.datadike.com/pt/sonar/administration/settings/custom-fields.md)
* [Alertas e modelos de alerta](https://wiki.datadike.com/pt/sonar/administration/automation/alerts.md)
* [Controle remoto](https://wiki.datadike.com/pt/sonar/administration/remote-access/remote-control.md)
