Pular para o conteúdo principal
Versão: 0.4 · atual

Adicionar um recurso

Guia de instruçõesRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Administrador de entidade
PlanosFree · Core · Pro · EnterpriseImplantaçãoAuto-hospedado

Um recurso é algo que o Excubius monitora: uma instância do SQL Server, um endpoint web, um servidor de relatórios, um host. Quando você adiciona um, o Excubius configura imediatamente as verificações padrão do tipo dele. Este guia mostra como adicionar um recurso com o assistente Add resource, testar a conexão, descobrir o que é executado nele e editá-lo ou excluí-lo.

Antes de começar​

  • Você precisa da função Entity admin (Administrador de entidade) na entidade que vai conter o recurso.
  • A credencial de que o recurso precisa está armazenada, ou você está pronto para criá-la no assistente. Consulte Armazenar uma credencial para o coletor.
  • O servidor do Excubius alcança o sistema na porta correta. Consulte Caminhos de rede.

Os recursos que uma fonte informa, como os recursos do Azure vindos do Azure Monitor ou os dispositivos do NinjaOne, aparecem sozinhos. Você adiciona apenas o que o coletor nativo alcança. Bancos de dados e servidores vinculados também não são adicionados manualmente: você os descobre a partir da instância deles.

Adicionar o recurso​

  1. Abra Resources e selecione Add resource.
  2. Type: escolha o que ele é. Cada tipo mostra quantas verificações recebe por padrão e os detalhes de que precisa.
  3. Place and name: escolha a Entity, que decide o que ele herda (limites, canais, credenciais), e digite o Name exibido em todos os lugares, por exemplo sql-ventas-01.
  4. Connection: digite os detalhes do tipo, com os obrigatórios primeiro. Eles são verificados antes de você continuar.
  5. Tags: adicione pares key:value, pelo menos env, role e client, e uma Criticality de 1 (baixa) a 5 (crítica).
  6. Credential: escolha uma credencial adequada que esteja ao alcance, None para usar a do recurso pai ou New credential para criar uma aqui.
  7. Em Review, confira o que você digitou e selecione Create resource.

As verificações padrão são configuradas imediatamente, e os primeiros valores chegam em um ou dois minutos. A última tela oferece Test connection, Discover para instâncias do SQL Server, Open the resource e Add another.

Detalhes por tipo​

TipoObrigatórioOutros detalhes
Instância do SQL Serverhostport (1433 por padrão); instance para uma instância nomeada sem porta fixa, alcançada por meio do SQL Server Browser na porta UDP 1434
Grupo de disponibilidade Always Onag_nameNormalmente criado pela descoberta, com o ouvinte, as réplicas e os bancos de dados dele
SQL Server Reporting Servicesportal_urltest_report_path para renderizar um relatório; host, port, instance e report_server_db (ReportServer por padrão) para a verificação do log de execução
Endpoint web / portalurlexpect_status, expect_text; domain (o domínio registrável) para o vencimento do domínio
Host Windows—ip; sem ele, o coletor se conecta ao nome do recurso
Host Linux—ip e ssh_port (22 por padrão); sem ip, o coletor se conecta ao nome do recurso
Servidor PostgreSQL—host, port
Locatário do Entra ID / serviços de domínio—tenant_id, domain; contém as verificações de identidade
A própria plataforma de monitoramento—heartbeat_url; contém as verificações de toda a plataforma, como os feeds de atualizações e a postura na nuvem
Recursos do Azure—resource_id; normalmente adicionados pela fonte Azure Monitor

Testar a conexão​

Na página do recurso, selecione Test connection. O coletor obtém o teste em cerca de 10 segundos e se conecta com a credencial do recurso.

TipoUm teste bem-sucedido mostra
Instância do SQL Server, grupo de disponibilidadeO nome do servidor, a versão, a edição e a latência, as permissões do logon com as que estiverem faltando e um aviso quando o logon é sysadmin
Servidor de relatórios, endpoint webO endereço, o status HTTP e a versão e a latência

Um teste com falha mostra o tipo de erro com uma dica:

Tipo de erroVerifique
authO logon e a senha, e se a instância aceita logons do SQL
unreachableO nome do host, a porta e o firewall entre o servidor do Excubius e o sistema
timeoutO caminho de rede; o sistema não respondeu a tempo
queryUma permissão que falta ao logon
configAlgo a corrigir no Excubius: o host, a credencial ou um segredo armazenado

Quando o teste permanece em waiting for the collector e termina com No collector picked it up, o coletor não está em execução, não tem token ou não oferece esse transporte. Consulte Erros do coletor.

Descobrir o que é executado em uma instância​

Em uma instância do SQL Server, selecione Discover. A descoberta lê o servidor, os grupos de disponibilidade dele com as réplicas, as funções e o ouvinte, os bancos de dados, os servidores vinculados e um resumo do SQL Agent. Ela os adiciona, ou os atualiza, como recursos filhos com as próprias verificações e informa quantos foram criados, atualizados e não foram mais encontrados.

  • Execute a descoberta novamente sempre que a topologia mudar.
  • Um filho que não é mais encontrado é marcado como missing e mantido com o histórico dele. Ele nunca é excluído pela descoberta; exclua-o você mesmo quando ele deixar de existir definitivamente.
  • Em um grupo de disponibilidade, adicione cada réplica como uma instância e execute a descoberta em uma delas. Consulte Início rápido: adicionar um grupo de disponibilidade.

Editar ou excluir um recurso​

  • Edit altera o nome, a criticidade, as marcas e a credencial. Os detalhes de conexão e a entidade são alterados por meio da API: PATCH /api/v1/resources/{id} com attributes ou entity_id.
  • Delete remove o recurso com os filhos descobertos, as verificações, as métricas e os alertas dele. O próprio sistema monitorado nunca é alterado.

Os editores ativam ou desativam verificações e alteram o intervalo e os limites delas para um recurso na guia Checks dele; consulte Recursos e a página do recurso.