Requisitos previos

Antes de instalar el agente, verifica que el cliente cuente con lo siguiente:

• Acceso a la base de datos que integrará el agente.
• API Key del cliente.
• Permisos de instalación en el sistema operativo.
• Conectividad de red desde la máquina donde se instalará el agente hacia:
  • los servidores de Uful;
  • la base de datos del cliente.

Descargar Agente Uful

1. Ingresa al panel de socios/gasolineros de tu cuenta Uful.
2. En la parte superior derecha del panel, ubica el botón «Descargar Agente Uful».
3. Selecciona la versión correspondiente a tu sistema operativo: Linux Ubuntu / Debian / RHEL / Rocky / Alma / Fedora.
4. Ejecuta el archivo descargado correspondiente a tu distribución Linux para iniciar la instalación del agente.

Instalación

1. Instalar Alloy

Sigue los pasos de instalación de Alloy según tu sistema operativo.

En Linux, Alloy debe instalarse utilizando el método oficial de Grafana antes de realizar la configuración operativa.

Comandos por distribución

sudo apt install gpg wget

sudo mkdir -p /etc/apt/keyrings
sudo wget -O /etc/apt/keyrings/grafana.asc https://apt.grafana.com/gpg-full.key
sudo chmod 644 /etc/apt/keyrings/grafana.asc
echo "deb [signed-by=/etc/apt/keyrings/grafana.asc] https://apt.grafana.com stable main" | sudo tee /etc/apt/sources.list.d/grafana.list

sudo apt-get update
sudo apt-get install alloy

wget -q -O gpg.key https://rpm.grafana.com/gpg.key
sudo rpm --import gpg.key
echo -e '[grafana]\nname=grafana\nbaseurl=https://rpm.grafana.com\nrepo_gpgcheck=1\nenabled=1\ngpgcheck=1\ngpgkey=https://rpm.grafana.com/gpg.key\nsslverify=1\nsslcacert=/etc/pki/tls/certs/ca-bundle.crt' | sudo tee /etc/yum.repos.d/grafana.repo

sudo dnf install alloy
# En sistemas sin dnf: sudo yum install alloy

Para más información sobre la instalación de Grafana Alloy, consulta la documentación oficial de Grafana Alloy.

2. Instalar el paquete del agente

sudo dpkg -i uful-agent_0.1.0_amd64.deb

sudo rpm -ivh uful-agent-0.1.0-1.x86_64.rpm

3. Ejecutar setup.sh

Para iniciar la configuración del agente, ejecuta el siguiente comando:

sudo /opt/uful/agent/setup.sh

Para completar el asistente de configuración, puedes seguir la guía de configuración del agente Uful.

4. Asignar Alloy al grupo de uful-agent

Agrega el usuario alloy al grupo uful-agent para que pueda ejecutar correctamente el servicio.

sudo usermod -aG uful-agent alloy

5. Reiniciar Alloy

Reinicia Alloy para aplicar la configuración del agente y los cambios de grupo.

sudo systemctl restart alloy

6. Iniciar el servicio del agente

Inicia el servicio del agente y verifica su estado con los siguientes comandos:

sudo systemctl start uful-agent
sudo systemctl status uful-agent

7. Habilitar el arranque automático

Habilita Alloy y el agente para que se inicien automáticamente al encender el sistema.

sudo systemctl enable alloy
sudo systemctl enable uful-agent