tutorial instalação agente

Instalando um agente de monitoramento PostgreSQL em 2 minutos

Targino C. Branco ·

Pré-requisitos

Antes de começar, você precisa de:

  • Uma conta no Argus DBA (gratuita)
  • Acesso root/sudo ao servidor onde o PostgreSQL está rodando
  • O servidor precisa ter acesso HTTPS à internet (para se comunicar com o Argus DBA)

Passo 1: Obtenha seu token

Após criar sua conta, acesse Configurações → Agente. Você verá seu token de agente — ele começa com argus_agent_. Copie-o.

Passo 2: Instale o agente

Linux

Execute no terminal do seu servidor:

curl -s https://app.argusdba.com/install/linux.sh | bash -s -- --token SEU_TOKEN_AQUI

O script vai:

  1. Baixar o binário do agente (~10MB)
  2. Criar um usuário de sistema argus-agent
  3. Configurar o agente como serviço systemd
  4. Iniciar o monitoramento automaticamente

Windows

Execute no PowerShell como Administrador:

irm https://app.argusdba.com/install/windows.ps1 | iex

Passo 3: Verifique

Após a instalação, o agente vai automaticamente:

  • Conectar ao servidor Argus DBA
  • Sincronizar seus clusters PostgreSQL
  • Começar a enviar checks de disponibilidade

Volte ao dashboard do Argus DBA — em poucos segundos, você verá seus clusters com status “Online”.

Como funciona por baixo dos panos

O agente é um binário Go compilado estaticamente. Ele:

  1. Lê a configuração do arquivo /etc/argus-agent/config.env
  2. Faz pull da lista de clusters a monitorar via API HTTPS
  3. Verifica conectividade TCP em cada cluster (host:port)
  4. Envia os resultados de volta via API
  5. Repete a cada intervalo configurado (padrão: 10 segundos)

O modelo pull significa que o agente inicia todas as conexões — nenhuma porta precisa ser aberta no firewall do seu servidor.

Desinstalando

Se precisar remover o agente:

curl -s https://app.argusdba.com/install/uninstall-linux.sh | bash

Use --purge para remover também os arquivos de configuração.

Conclusão

Em 2 minutos e 3 passos, você tem monitoramento de disponibilidade PostgreSQL rodando. O agente é leve, seguro e não requer manutenção.

Entenda por que monitoramento ativo de disponibilidade é essencial →

Crie sua conta gratuita →

Voltar ao blog