ServicePilot SaaS 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 Llave API para asegurar la comunicación. El resto de la configuración se realiza a través de la interfaz web de ServicePilot.

Capacidades de recogida de agentes ServicePilot

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

  1. Utilizando una cuenta con privilegios de administradores, acceda a ServicePilot.
  2. Abre la configuración Configuration icon
  3. Haga clic en Agentes Agents menu item
  4. Haga clic en Agent Details Agent Details button

Agente Server & Gateway de ServicePilot

Los Agentes Server & Gateway recogen datos directamente de los servidores en los que están instalados, o de otros equipos (entonces actúan como relés para ServicePilot). Estos agentes también pueden recibir datos de eventos no solicitados si están configurados para ello.

El agente de Windows de ServicePilot ha sido compilado con las versiones 3.5, 4.0 y 4.5 de .NET. Elija el agente con la versión más reciente de .NET soportada por su sistema operativo ya que esto le dará más opciones de colección.

El agente Linux de ServicePilot ha sido compilado para las distribuciones x86 y x64 en RedHat y Debian, así como para el ARM de Raspbian.

Si se requieren más capacidades de recolección en los sistemas operativos Linux o MacOS, se puede instalar un Agente .NET Core de ServicePilot después de instalar el requisito .NET Core.

Agente Desktop Inventory de ServicePilot

El agente Desktop Inventory 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 o tipo de llamadas a la Web realizadas en las aplicaciones Puppeteer, JavaScript en los navegadores Web y NodeJS. 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.

Descargar los agentes de ServicePilot

  1. Utilizando una cuenta con privilegios de administradores, acceda a ServicePilot.
  2. Abre la configuración Configuration icon
  3. Haga clic en Agentes Agents menu item
  4. Haga clic en Instalar un agente Install an agent button
  5. Seleccione el Agente que se va a instalar y siga las instrucciones en Empezar Get started button

Obtener una clave API de ServicePilot

Los agentes de ServicePilot se comunican con ServicePilot mediante una clave 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 la API se pueden usar, ve a la página de claves:

  1. Utilizando una cuenta con privilegios de administradores, acceda a ServicePilot.
  2. Abre la configuración Configuration icon
  3. Haga clic en Llaves Keys menu item
  4. Recuperar una clave de la API con autorización Read/Write Key list

Instalación de un agente Windows de ServicePilot

Después de descargar el agente de 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 de ServicePilot se comunique con el 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 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 paquetes 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 guión pedirá una clave de la API. Establezca los parámetros para que el agente de ServicePilot se comunique con ServicePilot. Puedes detener e iniciar el servicio spagent 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
logrotate is present on this machine.
logrotate file set up for spagent.

#

Instalar un agente .NET Core de ServicePilot

Antes de instalar un agente .NET Core, asegúrate de que el tiempo de ejecución de .NET Core esté instalado. Siga la documentación de instalación de Microsoft y verifique la instalación ejecutando el siguiente comando como root.

# dotnet --list-runtimes

Después de descargar el agente ServicePilot, asegúrate de que el archivo es ejecutable y conviértete en root para poder ejecutar el archivo autoextraíble. Al final de la instalación, el script pedirá una clave de la API. Establezca los parámetros para que el agente de ServicePilot se comunique con ServicePilot. Puedes detener e iniciar el servicio DotnetCoreAgent usando los comandos estándar de tu distribución Linux.

# chmod +x servicepilotdotnetagent.run
# ./servicepilotdotnetagent.run

Creating directory _agent_files
Verifying archive integrity...  100%   All good.
Uncompressing ServicePilot .NEt Core Agent Package  100%
dotnet version 3.0.0 [/usr/share/dotnet/shared/Microsoft.NETCore.App] installed.  Proceeding with installation of agent..
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/

This is RedHat based distro
DotnetCoreAgent Started.
DotnetCoreAgent started

#

Comprueba si un agente de ServicePilot está funcionando

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

  1. Utilizando una cuenta con privilegios de administradores, acceda a ServicePilot.
  2. Abre la configuración Configuration icon
  3. Haga clic en Agentes Agents menu item

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.

Logs del agente ServicePilot

El agente ServicePilot registra los errores de conectividad entre el agente ServicePilot y el 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 (por ejemplo).

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/spagent.log

Logs del agente .NET Core

/var/log/ServicePilotAgent.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. Abre la configuración Configuration icon
  3. Haga clic en Agentes Agents menu item

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.

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 borrar 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 spagent usando los comandos estándar de su distribución de Linux systemctl stop spagent o service spagent stop
  2. Desinstale el agente Linux de ServicePilot usando los comandos estándar de su distribución Linux. rpm -e spagent o dpkg --remove spagent
  3. Opcional: Puedes borrar los archivos /var/log/spagent* si no quieres mantener los logs del agente.
  4. Opcional: Si no planea reinstalar un agente ServicePilot en la máquina, puede borrar el directorio de configuración /etc/spagent. Tenga en cuenta que este directorio es usado tanto por el agente Linux como por el agente .NET Core.

Desinstalar un agente .NET Core de ServicePilot

Para desinstalar correctamente un agente Core .NET de ServicePilot , asegúrese de que esté detenido antes de retirarlo.

  1. Detenga el daemon DotnetCoreAgent usando los comandos estándar de su distribución de Linux systemctl stop DotnetCoreAgent O service DotnetCoreAgent stop
  2. Desinstale el agente .NET Core de ServicePilot eliminando el directorio de instalación. Borre el directorio /usr/DotnetCoreAgent
  3. Opcional: Puede borrar los archivos /var/log/ServicePilotAgent* si no quiere mantener los logs del agente.
  4. Opcional: Si no planea reinstalar un agente ServicePilot en la máquina, puede borrar el directorio de configuración /etc/spagent. Tenga en cuenta que este directorio es usado tanto por el agente de Linux como por el agente .NET Core.
  5. Opcional: Puedes desinstalar el .NET Core runtime si no se está usando para otro software siguiendo las instrucciones de Microsoft.

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. Abre la configuración Configuration icon
  3. Haga clic en Agentes Agents menu item
  4. 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.

Empiece Ahora