> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecotrust.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Executar o Inventário de Ativos

> Como coletar software, hardware e serviços de hosts Windows e Linux pelo CONNECT com o serviço Inventário de Ativos, e ler o painel do host no canvas.

O serviço **Inventário de Ativos** coleta software, hardware e serviços de hosts Windows e Linux pelo CONNECT e importa o resultado na plataforma. Ele roda no **Agent Work**, como todo serviço: o passo a passo geral está em [Executar um serviço](https://docs.ecotrust.io/ecotrust-os/executar-um-servico.md), e esta página traz o que é próprio do Inventory.

## Pré-requisitos

* **CONNECT instalado e operacional** no ambiente dos hosts.
* **Credencial de acesso aos hosts**, salva no painel ou digitada no formulário.
* **Alvos**: subnet, IP-range, IP, nome de host ou grupo de ativos.

## O Agent Work no Inventory

> [!NOTE]
>
> **Onde fica:** Tira de abas, **segunda posição**, entre *Dashboard* e *Artefatos*.

É onde o inventário é pedido, configurado, aprovado e acompanhado. Numa conversa nova, o campo de mensagem fica no centro da tela, com o atalho *Inventário de Ativos* logo abaixo. Quando o agente monta o plano, a tela se divide: a conversa vai para a coluna da esquerda e o canvas ocupa a direita.

| Controle | Onde está | O que faz |
| - | - | - |
| Agendamentos | Cabeçalho da conversa, primeiro ícone (calendário) | Abre as execuções agendadas do módulo. |
| Histórico | Cabeçalho, segundo ícone (relógio) | Lista as conversas anteriores. |
| Nova | Cabeçalho, à direita dos ícones | Abre uma conversa nova, sem os formulários da anterior. |
| plan mode | Selo abaixo do nome do agente | Indica que há um plano montado aguardando a sua aprovação. |
| Campo de mensagem | Pé da conversa | Recebe pedidos em português. Digitando `/`, abre a paleta de comandos. |

## Passos

O agente pede os parâmetros em formulários curtos, um por vez, monta o plano e só coleta depois do **Aprovar**. São sete passos:

**Step 1**

Clique em **Nova**, no cabeçalho da conversa, e escreva *"Quero fazer um inventário de ativos"*, ou clique no atalho **Inventário de Ativos**, abaixo do campo de mensagem. O botão **Executar** da [ficha do serviço](#a-ficha-do-serviço), no **Catálogo de Serviços**, leva ao mesmo ponto.

**Step 2**

**CONNECT.** Escolha o conector na lista e clique em **Confirmar**. O agente testa a conexão e avisa quando o CONNECT respondeu. Escolha com atenção: o ambiente dos ativos é o ambiente desse CONNECT.

![Mensagem do agente explicando o formulário e o passo Selecione um CONNECT com a lista e o botão Confirmar.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/25-connect.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=7af18db7ab6c3041477265c6ed9b8962)

Antes do primeiro formulário o agente resume o que vai pedir. O Confirmar fica abaixo da lista.

**Step 3**

**Alvos.** Marque os hosts na lista dos ativos do ambiente e clique em **Confirmar**. O campo *Buscar ativos...*, no topo da lista, filtra pelo nome. O alvo pode ser uma faixa (subnet ou IP-range), um IP, um nome de host ou um grupo de ativos. Quando todos os alvos são hosts definidos, o agente pula a fase de descoberta e segue direto para a coleta.

![Passo de alvos com a lista de hosts do ambiente, um deles marcado, e os botões Cancelar e Confirmar.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/26-alvos.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=da1b7b0cefb086e7fd65aaa3b11d6964)

Cada linha é um ativo do ambiente do CONNECT escolhido. O nome do ambiente aparece ao lado do título do campo.

**Step 4**

**Credencial.** Em *Credencial*, escolha uma credencial salva ou *Inserir manualmente*. Com credencial salva, o formulário pede só a porta. Inserindo manualmente, ele pede o *Transporte* (SSH, WinRM-WMI ou SSM), o usuário, o tipo de autenticação (usuário e senha ou chave privada SSH), a senha ou a chave e a porta. A porta padrão do SSH é a 22. Clique em **Confirmar**.

![Passo Quais credenciais usar para acessar os hosts, com Credencial em Inserir manualmente e os campos de transporte, usuário, tipo de autenticação, senha e porta.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/27-credencial.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=aae48bc510cf95bed6fe01f5f678eddd)

Com Inserir manualmente, os campos do transporte aparecem abaixo da lista. A senha não é exibida depois de confirmada.

**Step 5**

**Quando rodar.** Clique em **Executar agora** para uma execução única, ou em **Agendar**, ao lado, para escolher data, hora e recorrência antes do plano.

![Mensagem do agente e o passo Quando rodar com os botões Executar agora e Agendar.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/28-quando.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=92e14d515cb8282dfb260d37fd4464ac)

Executar agora leva direto ao plano. Agendar abre a data, a hora e a recorrência.

**Step 6**

**Revise o plano**, que aparece no canvas, à direita. Ele mostra o escopo selecionado (CONNECT, ambiente dos ativos, alvos, título do inventário, credenciais e agendamento), cada linha com o botão **Editar**, e as duas etapas da execução: *Execução do Inventário* e *Importar do Inventário*.

![Plano do serviço Inventário de Ativos no canvas, com o escopo selecionado, os botões Editar e as etapas do plano.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/29-plano.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=7566ede9c3426615932e4715bbef53fc)

Confira a linha Agendamento antes de aprovar. Editar volta ao formulário daquela linha.

**Step 7**

**Aprove.** Clique em **Aprovar**, na coluna da conversa. **Revisar** reabre os formulários e **Cancelar** descarta o plano sem coletar nada.

![Bloco Revisar e aprovar com os botões Aprovar, Revisar e Cancelar.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/29b-aprovar.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=889fc7f1ff2cb6b7ab3feacf38bd17d2)

O Aprovar fica no pé da conversa, acima de Revisar e Cancelar.

Depois do Aprovar, o agente acompanha a execução na conversa, com um bloco *acompanhamento da execução* a cada etapa. A execução termina quando ele informa que os passos foram concluídos sem falhas e marca o serviço como *concluído*, no pé da conversa. O registro fica na [Observabilidade](https://docs.ecotrust.io/ecotrust-os/observabilidade.md) e o ativo aparece atualizado no [Dashboard](https://docs.ecotrust.io/modulos/inventory/painel.md).

![Coluna da conversa com os blocos de acompanhamento da execução e a mensagem de conclusão sem falhas.](https://mintcdn.com/eco-trust/j6nVO8DyNWKUzEk8/images/inventory/31-acompanhamento.png?fit=max\&auto=format\&n=j6nVO8DyNWKUzEk8\&q=85\&s=8b5480cb5fef9e32535e7bf2e4d541af)

A última mensagem confirma os passos concluídos e o selo concluído fecha a execução.

## Verificar o resultado: o host no canvas

Ao fim da coleta, o agente monta no canvas o painel do host coletado:

![Painel do host no canvas, com endereço, sistema, total de pacotes, contadores, especificação do sistema, superfície de rede e itens de inicialização.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/30-canvas-host.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=f4bb634061834e3d080bdccf3a7e07f1)

O cabeçalho traz o endereço, o nome e o sistema. À direita, o total de pacotes inventariados e o selo de atenção.

| Bloco | O que mostra |
| - | - |
| Pacotes | O total de pacotes instalados, com os pacotes pip à parte. |
| RAM / CPU | A memória total e os núcleos e threads do processador. |
| Portas escuta | As portas em que o host aceita conexões e quantos endereços IP ele tem. |
| Patches falta | As atualizações disponíveis ainda não aplicadas, com as críticas à parte. |
| Contas | As contas locais do host, com as administrativas à parte. |
| Serviços | Os serviços do host, com os que estão em execução à parte. |
| Persistência | Os itens que iniciam junto com o sistema, como serviços e tarefas agendadas. |
| Achados | Os pontos que a coleta marcou para atenção, com a contagem por severidade. |
| Especificação do sistema | Sistema, versão, kernel, arquitetura, processador, disco, fabricante, modelo, BIOS e último boot. |
| Superfície de rede | As portas e interfaces de rede do host e o servidor DNS (*Domain Name System*) que ele usa. |
| Itens de inicialização | Os primeiros itens que iniciam com o sistema e a contagem dos demais. |

Depois da coleta, a conversa continua aberta para perguntas sobre o resultado, como *"que tipo de autenticação foi usado nesse host?"*. O agente responde com o que ficou registrado na execução.

## A ficha do serviço

Coleta software, hardware e serviços de hosts Windows e Linux pelo CONNECT e importa o resultado na plataforma. Inclui a descoberta opcional dos ativos antes da coleta e a validação automática da qualidade do resultado ao final. **Ver detalhes**, no pé do cartão, abre a ficha:

![Ficha do serviço Inventário de Ativos com as tarefas Descoberta de Ativos e Inventário de Ativos, os pré-requisitos e os botões Fechar e Executar.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/19-ficha-servico.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=5ab9d83c19b99b529f70c141f1adf725)

A ficha lista as tarefas e o que precisa ter antes. Executar fica no rodapé, à direita de Fechar.

| Tarefa | O que entrega |
| - | - |
| Descoberta de Ativos | Cada host que respondeu na faixa alvo, com portas TCP abertas, sistema operacional inferido, nome quando resolvível e classificação (servidor, estação ou dispositivo de rede). |
| Inventário de Ativos | Cada host alcançado com software, hardware e serviços coletados e importados, e cada host não alcançado registrado com o motivo. |

A ficha também mostra o nível do serviço, o custo da tarefa e os pré-requisitos: **CONNECT instalado e operacional** e **alvos** (subnet, IP-range, IP ou grupo de ativos). **Ver ficha completa** expande o restante. **Executar** leva ao Agent Work com o serviço já escolhido; o passo a passo está em [Executar o Inventário de Ativos](https://docs.ecotrust.io/modulos/inventory/inventario-de-ativos.md).

## Próximos passos

* [Agendar um serviço](https://docs.ecotrust.io/ecotrust-os/agendar-um-servico.md), para manter o inventário em dia
* [Dashboard do Inventory](https://docs.ecotrust.io/modulos/inventory/painel.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.