Version 9.3.0 (10 aug 2021)

ServicePilot Documentación

Agentes

¿Qué es un Agente ServicePilot?

Los Agentes de ServicePilot están diseñados para recopilar datos de supervisión de varias fuentes y enviarlos a ServicePilot. Los Agentes ServicePilot sólo requieren una breve configuración. Todo lo que necesitan es acceso a la web de ServicePilot y una Clave de API para asegurar la comunicación. El resto de la configuración se realiza a través de la interfaz web de ServicePilot.

Agentes ServicePilot SaaS

Cuando se despliega un Agente de ServicePilot para utilizarlo con ServicePilot en modo SaaS, se establece una conexión HTTPS entre el Agente de ServicePilot y ServicePilot en el Cloud. Se puede definir un proxy web en el Agente Windows de ServicePilot si es necesario para acceder a Internet.

ServicePilot Agent On Premise

Agentes ServicePilot On Premise

Cuando se despliega un Agente ServicePilot para utilizarlo con una instalación de ServicePilot On Premise, el FQDN del Manager ServicePilot tendrá que ser configurado en el Agente. El Agente se comunicará con el Manager ServicePilot a través de HTTP o HTTPS.

ServicePilot Agent for SaaS ServicePilot

¿Cuántos Agentes ServicePilot deben instalarse?

Siempre es necesario tener al menos un Agente ServicePilot, ya que casi toda la recopilación de datos la realizan los agentes. El número de Agentes necesarios depende del tipo de supervisión que se pida a los Agentes y de que éstos puedan acceder a los datos necesarios. Los Agentes pueden recoger datos del servidor en el que están instalados. Algunas recopilaciones de datos sólo pueden realizarse en el mismo host que un Agente ServicePilot.

ServicePilot Agents collecting local data

Los Agentes también pueden obtener datos de otros dispositivos y escuchar los eventos que se les transmiten, siempre que el acceso a la red de otros dispositivos no esté bloqueado.

ServicePilot Agent collection remote data

Para saber si un Agente ServicePilot debe instalarse en el mismo servidor que los datos que va a recoger, consulte la columna Local Collect de la tabla Licenses - Agent details, disponible en la interfaz web de ServicePilot.

1. Utilizando una cuenta con privilegios de administradores, acceda a ServicePilot.
2. Abrir AJUSTES > Configuración Settings menu configuración
3. Haga clic en Agentes > Instalar Agents Install icon
4. Haga clic en Agent Details Agent Details button

Proxy de Agente ServicePilot para acceder a ServicePilot

Si los Agentes ServicePilot no pueden comunicarse con ServicePilot debido a las restricciones del cortafuegos, se puede desplegar un Proxy de Agente ServicePilot. Este proxy de Agente ServicePilot actuará como puerta de enlace y concentrador entre los Agentes de ServicePilot y el Manager ServicePilot. Sólo el proxy del Agente ServicePilot necesita tener acceso al Manager ServicePilot, mientras que los Agentes ServicePilot se configurarán para enviar el tráfico al proxy. Desde el punto de vista de la seguridad, esta configuración podría ser preferible, pero tenga en cuenta que esto introduce un nuevo punto de fallo posible.

Agents communicating with ServicePilot via ServicePilot Agent proxy

Por favor, póngase en contacto con nuestro soporte de ServicePilot si desea configurar un proxy de Agente ServicePilot.

Capacidades de recogida de agentes ServicePilot

Cada agente ServicePilot tiene diferentes capacidades de recolección. Para ver lo que estos Agentes Enterprise pueden hacer, vea la página de Agent Details:

1. Utilizando una cuenta con privilegios de administradores, acceda a ServicePilot.
2. Abrir AJUSTES > Configuración Settings menu configuración
3. Haga clic en Agentes > Instalar Agents Install icon
4. Haga clic en Agent Details Agent Details button

Agentes Enterprise de ServicePilot

Los Agentes Enterprise recogen datos directamente de los servidores en los que están instalados, o de otros equipos. Estos agentes también pueden recibir datos de eventos no solicitados si están configurados para ello.

El Agente Windows de ServicePilot utiliza el framework .NET de Microsoft.

El Agente Linux ServicePilot ha sido compilado para las distribuciones x86 y x64 basadas en RedHat y Debian actualmente soportadas, así como para el OS Raspberry Pi 32-bit en ARM.

Agente Endpoint de ServicePilot

El Agente Endpoint de ServicePilot está diseñado para recopilar el inventario de hardware y software de las estaciones de trabajo de Windows.

Agentes Developer de ServicePilot

Se pueden recopilar datos estadísticos sobre el número y tipo de llamadas a la Web realizadas en las aplicaciones Puppeteer, JavaScript en los navegadores Web y Node.js. Estas integraciones requieren que el código en cuestión esté instrumentado para enviar los detalles de la llamada a ServicePilot.

Integración del Agente Open Source

El Agente Windows de ServicePilot puede servir de puerta de entrada a varios agentes de código abierto, proporcionando a ServicePilot los datos recogidos por estos agentes.

Status Monitor de ServicePilot

El Status Monitor de ServicePilot no es un agente utilizado para recoger datos. Es una extensión de la interfaz web de ServicePilot que permite a los usuarios de ServicePilot ver el número actual de elementos con alertas en el escritorio de Windows.

El Status Monitor de ServicePilot puede ser descargado desde el menú de Usuario.

Descargar los agentes de ServicePilot

Download SP agent

1. Utilizando una cuenta con privilegios de administradores, acceda a ServicePilot.
2. Abrir AJUSTES > Configuración
3. Haga clic en Agentes > Instalar
4. Seleccione el Agente que se va a instalar y siga las instrucciones en Empezar

Obtener una clave de API de ServicePilot

Los Agentes de ServicePilot se comunican con ServicePilot mediante una Clave de API. Se pueden crear y utilizar múltiples claves de API, pero cada agente debe estar configurado con una clave de API válida y con capacidad de escritura. Para ver qué claves de API se pueden usar, ve a la página de Claves:

Obtain API key

1. Utilizando una cuenta con privilegios de administradores, acceda a ServicePilot.
2. Abrir AJUSTES > Configuración
3. Haga clic en Agentes > Claves de API
4. Recuperar una clave de API con autorización Write

Instalación de un Agente Windows de ServicePilot

Después de descargar el Agente ServicePilot, haga doble clic en el archivo para ejecutar el instalador. Al final de la instalación, se abre la consola de configuración de ServicePilot. Establezca los parámetros para que el Agente ServicePilot se comunique con ServicePilot y luego inicie el Agente. La consola puede cerrarse una vez que el Agente se comunica con éxito con ServicePilot.

Parámetro Descripción
Clave de API Una clave de API habilitada para escritura como la que se encuentra en la lista de claves de API mencionada anteriormente.
Remote Command No habilite este parámetro a menos que un recurso monitoreado lo requiera. Las descripciones de los packages indicarán cuándo es necesario.

Windows Agent parameters 1

Parámetro Descripción
Use proxy Si el acceso a ServicePilot requiere un proxy web, habilite esta opción y rellene los campos Dirección y Puerto.
Address Especificar la dirección IP del proxy
Port Especifique el puerto proxy
Username Especifique un nombre de usuario para permitir el acceso del proxy, si es necesario.
Password Especifique una contraseña para permitir el acceso del proxy, si es necesario.

Windows Agent parameters 2

Instalación de un agente Linux de ServicePilot

Después de descargar el agente ServicePilot, comprueba que el archivo es ejecutable y luego ejecútalo como root. Al final de la instalación, el script pedirá una clave de API. Establezca los parámetros para que el Agente ServicePilot se comunique con ServicePilot. Puedes detener e iniciar el servicio splinuxagent usando los comandos estándar de tu distribución de Linux.

# chmod +x servicepilotlinuxagent.run
# ./servicepilotlinuxagent.run

Creating directory _agent_files
Verifying archive integrity...  100%   All good.
Uncompressing ServicePilot Linux Agent Package  100%
This is RedHat based distro
64 Bit
Enter API KEY

10000000-0000-0000-0000-000000000000

Run in debug mode? [default: n]

n

Enter ServicePilot Agent Log Path [default: '/var/log/']

/var/log/

SP Agent Started.
LinuxAgent started

#

Comprueba si un Agente ServicePilot está funcionando

Para asegurarse de que los Agentes ServicePilot se comunican correctamente con ServicePilot, abra la página de Agentes:

1. Utilizando una cuenta con privilegios de administradores, acceda a ServicePilot.
2. Abrir AJUSTES > Agentes Agents menu
3. El agente debe aparecer en la lista con un estado amarillo o verde y un valor Visto hay de hace unos segundos. El estado amarillo indica que el agente aún no ha recibido nada que hacer. Agent list

Logs del Agente ServicePilot

El Agente ServicePilot registra los errores de conectividad entre el Agente ServicePilot y ServicePilot, y los problemas de recuperación de datos de los dispositivos. Estos logs son particularmente útiles si la vigilancia no parece funcionar entre el agente y los dispositivos remotos debido a una información de acceso incorrecta.

Abrir los logs del Agente con un editor de texto:

Logs del Agente Windows

C:\Program Files (x86)\ServicePilot\ServicePilot ISM Enterprise\Logs\ServicePilotAgent.log

Logs del Agente Linux

/var/log/servicepilotagent.log
/var/log/spgoagent.log

Desinstalación de un Agente ServicePilot

Si un Agente ServicePilot ya no se utiliza, se puede desinstalar.

Comprobar si un Agente está en uso

1. Utilizando una cuenta con privilegios de administradores, acceda a ServicePilot.
2. Abrir AJUSTES > Agentes Agents menu
3. Si no se utiliza un Agente, el estado será amarillo, lo que significa que está no configurado. Si el Agente sigue en uso, al hacer clic en la lupa azul se mostrarán los detalles del agente incluyendo el Agent Data. Esto enumerará los recursos que están utilizando actualmente este Agente. Agent list

Desinstalación de un Agente Windows de ServicePilot

Para desinstalar correctamente un Agente Windows de ServicePilot, asegúrese de que esté detenido antes de eliminarlo.

1. Detener el servicio ServicePilotAgent
2. Cierre la ServicePilot Setup Console si está abierta.
3. Desinstale el Agente de ServicePilot del panel de control de Windows.
4. Opcional: puede eliminar el directorio C:\Program Files (x86)\ServicePilot si no quiere mantener los logs del Agente
5. Opcional: si no tiene previsto reinstalar un Agente ServicePilot en la máquina, puede eliminar la clave de registro HKEY_LOCAL_MACHINE\SOFTWARE\ServicePilot Technologies

Desinstalar un Agente Linux de ServicePilot

Para desinstalar correctamente un Agente Linux de ServicePilot, asegúrese de que esté detenido antes de eliminarlo.

1. Detener el daemon splinuxagent usando los comandos estándar de su distribución de Linux systemctl stop splinuxagent
o
service splinuxagent stop
2. Desinstale el Agente Linux de ServicePilot borrando el directorio de instalación. /usr/splinuxagent
3. Opcional: puede eliminar los archivos /var/log/servicepilotagent* y and /var/log/spgoagent* si no quiere mantener los logs del Agente.
4. Opcional: si no planea reinstalar un Agente ServicePilot en la máquina, puede eliminar el directorio de configuración /etc/spagent.

Eliminar los Agentes desinstalados de la lista de Agentes

Hasta que se desinstale un Agente, la eliminación de la lista de Agentes no tendrá el efecto deseado, ya que el Agente seguirá contactando con ServicePilot y reaparecerá continuamente en la lista de agentes.

1. Utilizando una cuenta con privilegios de administradores, acceda a ServicePilot.
2. Abrir AJUSTES > Agentes Agents menu
3. Haga clic en el icono basurero naranjo y luego haga clic en el botón Eliminar para eliminar un Agente de la lista de Agentes. Agent list

Instalación gratuita en unos pocos clics