Adicionar um recurso
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
- Console
- API
- Abra Resources e selecione Add resource.
- Type: escolha o que ele é. Cada tipo mostra quantas verificações recebe por padrão e os detalhes de que precisa.
- 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. - Connection: digite os detalhes do tipo, com os obrigatórios primeiro. Eles são verificados antes de você continuar.
- Tags: adicione pares
key:value, pelo menosenv,roleeclient, e uma Criticality de 1 (baixa) a 5 (crítica). - Credential: escolha uma credencial adequada que esteja ao alcance, None para usar a do recurso pai ou New credential para criar uma aqui.
- Em Review, confira o que você digitou e selecione Create resource.
curl -s "${H[@]}" -X POST "$BASE/resources" -d "{
\"entity_id\": \"$PROD\", \"type\": \"web_endpoint\", \"name\": \"portal-ventas\",
\"attributes\": {\"url\": \"https://ventas.ciguapa.example/\", \"domain\": \"ciguapa.example\"},
\"tags\": {\"env\": \"prod\", \"role\": \"web\", \"client\": \"ciguapa\"}, \"criticality\": 4
}" | jq '{id, name, checks_provisioned}'
$BASE é https://<your server>/api/v1 e H contém o seu token de portador; consulte a referência da API.
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
| Tipo | Obrigatório | Outros detalhes |
|---|---|---|
| Instância do SQL Server | host | port (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 On | ag_name | Normalmente criado pela descoberta, com o ouvinte, as réplicas e os bancos de dados dele |
| SQL Server Reporting Services | portal_url | test_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 / portal | url | expect_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.
| Tipo | Um teste bem-sucedido mostra |
|---|---|
| Instância do SQL Server, grupo de disponibilidade | O 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 web | O 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 erro | Verifique |
|---|---|
auth | O logon e a senha, e se a instância aceita logons do SQL |
unreachable | O nome do host, a porta e o firewall entre o servidor do Excubius e o sistema |
timeout | O caminho de rede; o sistema não respondeu a tempo |
query | Uma permissão que falta ao logon |
config | Algo 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}comattributesouentity_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.