Documentation

Descubre el modo de configuración cero

ServicePilot OnPremise (en sus instalaciones)

Despliegue del ServicePilot

Hay dos formas de acceder a ServicePilot:

Software as a Service: interfaz web de ServicePilot basada en la cloud y gestionada por ServicePilot Technologies a la que los clientes se conectarán a través de Internet. Sólo requiere un mínimo de 1 agente para la supervisión.
On Premise: los clientes instalan el software ServicePilot en las instalaciones.

Este documento se aplica a las instalaciones On Premise de ServicePilot en las que un administrador local tendrá que instalar, actualizar, hacer copias de seguridad y gestionar el servidor de ServicePilot.

Instalar ServicePilot

Requisitos del sistema para el servidor de Manager ServicePilot

Antes de instalar ServicePilot, verifique que su sistema cumpla con algunos requisitos básicos.

Consulte a ServicePilot Technologies para obtener más detalles si se conocen sus requisitos de supervisión.

Los siguientes son requisitos mínimos para un sistema de monitoreo básico. Se requerirá hardware o máquinas virtuales más potentes dependiendo de la cantidad de datos que se recopilen y del uso concurrente esperado.

8 core CPU
8GB RAM min
Disco duro de alto rendimiento con espacio suficiente para almacenar datos de ServicePilot - min 250GB
Windows Server 2016 o posterior

Instalar ServicePilot**

Para instalaciones locales de ServicePilot, descargue el software Manager ServicePilot e instálelo en su propio servidor de Windows.

Descargue el archivo ejecutable del sitio web de ServicePilot Technologies. Los ingenieros de ServicePilot proporcionarán la URL del instalador.
Siga el video Install ServicePilot Manager (Solo en la tienda) para completar la instalación del software Manager ServicePilot.

Requisitos del sistema para los agentes de ServicePilot

Los agentes de ServicePilot requieren muy poco CPU, RAM y espacio en el disco duro. Al instalar el Manager ServicePilot, un Agente Windows de ServicePilot se instala automáticamente en el mismo servidor. Esto puede ser suficiente para supervisar los sistemas de la red empresarial local, sin embargo, se pueden instalar más Agentes ServicePilot para obtener datos de sitios y servidores remotos.

Como usuario Administrativo de ServicePilot, para los requisitos previos del Agente, descargar e instalar instrucciones vaya a Ajustes > Agentes > Descargar.

Instalación de los agentes de ServicePilot

Para instalar un ServicePilot Agent, como usuario Administrativo de ServicePilot, para los requisitos previos del Agente, descargar e instalar instrucciones vaya a Ajustes > Agentes > Descargar.

Puede seguir el video Install ServicePilot Agent para instalar los agentes de ServicePilot que recopilarán y enviarán los datos al ServicePilot Manager.

Habilitar la compatibilidad HTTPS con certificados SSL

La interfaz web de ServicePilot se puede servir mediante HTTPS al habilitar esta capacidad en la configuración en ejecución y reiniciar el ServicePilot Manager. Puede generar esto por su cuenta o puede comprar uno de una autoridad comercial de certificados.

NOTA: Los agentes de ServicePilot se comunican con el Manager ServicePilot utilizando HTTP o HTTPS. Si HTTPS está habilitado o se cambia el puerto de interfaz web de Manager ServicePilot, todos los agentes de ServicePilot también tendrán que volver a configurarse y reiniciarse.

Una vez que obtenga el certificado, la clave privada del certificado y la cadena del certificado de la CA, deberá actualizar su servidor para poder utilizarlos. Siga estos pasos para activar el soporte SSL:

Obtenga o convierta su certificado de servidor, clave privada de certificado y cadena de certificado de CA en un archivo PKCS12/PFX protegido por contraseña
Importe el certificado en el Almacén de claves del certificado personal de la máquina local de Windows. Si el certificado se importa correctamente, será visible en la aplicación certlm.msc con un icono de certificado y clave.
Abra la ServicePilot Setup Console y haga clic en el botón Certificates.
Haga doble clic en el certificado que importó que estará visible en la lista si se puede usar. La huella digital del certificado se copiará en el campo Thumbprint. Haga clic en OK para guardar este cambio.
Abra la interfaz web de ServicePilot e inicie sesión como administrador
Haga clic en Ajustes > Configuración
Haga clic en Basicó
Haga clic en Otros Ajustes > Editar la configuración
Haga clic en el botón Expand
Añada la siguiente información a la sección general:
Guardar la configuración mediante el botón Guardar
Reinicie el Manager ServicePilot con el botón Reiniciar
Una vez reiniciado el Manager ServicePilot, intente iniciar sesión en la interfaz web mediante HTTPS

Configurar agentes de ServicePilot para HTTPS

Todos los agentes de ServicePilot tendrán que estar configurados para usar la comunicación recién asegurada. En cada máquina con un Agente de ServicePilot, incluyendo el servidor en el que está instalado el Manager ServicePilot, ejecute el siguiente procedimiento.

Windows

Abrir "ServicePilot Setup Console" de ServicePilot ("C:\Program Files (x86)\ServicePilot\ServicePilot ISM Enterprise\Console.exe")
Ir a la pestaña Agente
Detenga el Agente de ServicePilot
Establecer el número de puerto correcto (por defecto 443)
Marque la casilla HTTPS
Inicie el Agente de ServicePilot

Linux

Detenga el daemon spagent
Edite el archivo de configuración del agente /etc/spagent para incluir el puerto correcto e indique que HTTPS se está utilizando
Iniciar el daemon spagent

Clave de licencia de ServicePilot

ServicePilot ya se está ejecutando

Si ServicePilot ya se está ejecutando y debe actualizarse la clave de licencia de ServicePilot:

Inicie sesión en la interfaz web Manager ServicePilot como administrador
Haga clic en AJUSTES > Configuración > Licencia y License key
Introduzca la clave de licencia proporcionada por ServicePilot y actívela en línea o fuera de línea en función del acceso del servidor Manager ServicePilot a Internet

ServicePilot no se está ejecutando

Si ServicePilot aún no se está ejecutando, la clave de licencia se puede aplicar desde la Consola de Configuración de ServicePilot. Para iniciar la consola de configuración de ServicePilot, vaya a C:\Program Files (x86)\ServicePilot\ServicePilot ISM Enterprise\Console.exe y ejecútela con privilegios de administrador escalados.

Haga clic en el elemento de menú License
Haga clic en Enter a new license key y acepte el contrato de licencia
Introduzca la clave de licencia proporcionada por ServicePilot y haga clic en Continue
Si el Manager ServicePilot no tiene acceso a Internet:

Seleccione Activate offline
Haga clic en Get an activation by email
Envíe el Harware ID presentado a [email protected]
Pegue la Activation key recibida por correo electrónico en el campo correspondiente y haga clic en Activate

Si el servidor de Manager ServicePilot tiene acceso a Internet, haga clic en Activate

Administrar ServicePilot

Iniciar o detener los servicios de ServicePilot

Windows

Los servicios de Manager ServicePilot y Agentes de ServicePilot se pueden iniciar y detener utilizando la ServicePilot Setup Console suministrada. Estos servicios se iniciarán automáticamente durante el arranque. Esta consola también puede realizar la configuración inicial y permite al administrador ver el estado de los componentes de ServicePilot.

Inicie la "ServicePilot Setup Console"

Si la consola de instalación de ServicePilot no se está ejecutando, puede iniciarse ejecutando C:\Program Files (x86)\ServicePilot\ServicePilot ISM Enterprise\Console.exe con privilegios administrativos escalados.

La "ServicePilot Setup Console" se puede ejecutar desde el icono ServicePilot ISM de la bandeja del sistema seleccionando Launch Console.

Detenga e inicie el Manager ServicePilot desde la ficha Administrador.

Detenga e inicie el Agente de ServicePilot desde la ficha Agente.

Linux

El Agente de ServicePilot se registra como un daemon de Linux. Inicie y detenga el daemon spagent utilizando los comandos estándar basados en su distribución de Linux.

Configurar la configuración de correo electrónico saliente

Para enviar alertas por correo electrónico, ServicePilot requiere una retransmisión SMTP saliente configurada.

Para configurar un servidor de correo electrónico:

Inicie sesión en la interfaz web de Manager ServicePilot como administrador
Haga clic en AJUSTES > Configuración, luego Basicó, y luego haga clic en Email servidor.
Establecer el nombre de host del servidor SMTP, De la dirección de correo electrónico, A la dirección de correo lectrónico.
Haga clic en la casilla de verificación Funciones avanzadas" para agregar más configuraciones de servidor SMTP que puedan ser necesarias.
Haga clic en "Guardar" para guardar los cambios.
Haga clic en "Test" para abrir un cuadro de diálogo de prueba que le permite enviar correos electrónicos de prueba para verificar su conexión.

Solución de problemas SMTP

Algunos servidores de correo electrónico ahora requieren más autenticación antes de aceptar el correo electrónico para la entrega. Es posible que deba habilitar un método de acceso menos seguro o proporcionar una contraseña específica de la aplicación para que su servicio SMTP permita que ServicePilot pueda enviar correo electrónico.

Volver a cargar la configuración

Para actualizar los cambios realizados en los packages, existen los siguientes dos métodos:

Uso de la interfaz ServicePilot

Inicie sesión en la interfaz web de Manager ServicePilot como administrador
Haga clic en AJUSTES > Configuración, luego Avanzado, y luego haga clic en Recargar

Uso de la API ServicePilot

La API permite actualizar la configuración automáticamente sin necesidad de reiniciar ServicePilot. El comando cURL que se muestra a continuación es un ejemplo de solicitud utilizando la clave API con permisos de escritura 10000000-0000-0000-0000-000000000000 al servidor ServicePilot https://data.servicepilot.com.

curl -H "X-Api-Key: 10000000-0000-0000-0000-000000000000" -d "{}" -X POST "https://data.servicepilot.com/api/service/reload"

Autenticación

ServicePilot se integra con OpenID Connect / Microsoft Entra ID / Sign in with Google y LDAP o Active Directory, plataformas de autenticación externas. Los usuarios definidos por LDAP o Active Directory también pueden asociarse a grupos de ServicePilot automáticamente, eliminando la necesidad de definir cada usuario en ServicePilot.

Integración de OpenID Connect

Para habilitar la autenticación remota, añada la configuración al archivo servicepilot.conf y reinicie el Manager ServicePilot. Los usuarios aún deben definirse en ServicePilot para asignar la pertenencia a grupos de ServicePilot. Las direcciones de email de los usuarios deben utilizarse para el campo Nombre al añadir los usuarios a ServicePilot.

Al definir usuarios en ServicePilot, debe introducirse una contraseña, incluso para los usuarios autenticados remotamente. Debe ser una contraseña segura, ya que siempre es posible iniciar sesión con una contraseña definida localmente.

Microsoft Entra ID

La URL de Single Sign-On de ServicePilot que redirigirá a la autenticación de Microsoft Entra ID termina en /auth_microsoft (Ej: https://servicepilot.company.com/auth_microsoft).
La URL de redirección de Sign-in a la que se devolverá a los usuarios autenticados es /signin-microsoft (Ej: https://servicepilot.company.com/signin-microsoft).

Ejemplo de configuración de Microsoft Entra ID en servicepilot.conf:

general:
  webServer:
    OAuth:
      MicrosoftClientId: "id"
      MicrosoftClientSecret: "secret"

Sign in with Google

La URL de Single Sign-On de ServicePilot que redirigirá a la autenticación de inicio de sesión con Google termina en /auth_google (Ej: https://servicepilot.company.com/auth_google).
La URL de redirección de Sign-in a la que se devolverá a los usuarios autenticados es /signin-google (Ej: https://servicepilot.company.com/signin-google).

Ejemplo de configuración de Sign in with Google en servicepilot.conf:

general:
  webServer:
    OAuth:
      GoogleClientId: "id"
      GoogleClientSecret: "secret"

OpenID Connect

La URL de Single Sign-On de ServicePilot que redirigirá al servidor de autenticación de OpenID Connect termina en /auth_openid (Ej: https://servicepilot.company.com/auth_openid).
La URL de redirección de Sign-in a la que se devolverá a los usuarios autenticados es /signin-oidc (Ej: https://servicepilot.company.com/signin-oidc).

Ejemplo de configuración de OpenID Connect en servicepilot.conf:

general:
  webServer:
    OAuth:
      OpenIdAuthority: "https://openid.company.com/"
      OpenIdClientId: "id"
      OpenIdClientSecret: "secret"

Integración LDAP/Active Directory

Autenticación de usuarios LDAP/Active Directory

Al autenticar usuarios contra un servidor LDAP o Active Directory es posible utilizar el servidor de autenticación para verificar las contraseñas de los usuarios que ya están definidos en ServicePilot.

Ejemplo de configuración de autenticación de usuarios LDAP/Active Directory en servicepilot.conf:

general:
  webServer:
    authentication: ADPassword

Ejemplo de configuración de autenticación de usuarios LDAP/Active Directory en tenant.conf:

groups:
- group: "admin"
  accessLevel: OnPremiseAdmin
  users:
  - user: "user1"

Autenticación de grupos LDAP/Active Directory

Alternativamente, se puede consultar al servidor de autenticación para determinar de qué grupos es miembro un usuario. Si se realiza la autenticación de grupo, todos los miembros del grupo LDAP o Active Directory se asignarán a un grupo vinculado de ServicePilot. Tenga en cuenta que cada usuario de LDAP o Active Directory sólo debe ser miembro de cero o un grupo de ServicePilot asignado.

Ejemplo de configuración de autenticación de grupos LDAP/Active Directory en servicepilot.conf:

general:
  webServer:
    authentication: ADUserPassword

Ejemplo de configuración de autenticación de grupos LDAP/Active Directory en tenant.conf:

groups:
- group: "admin"
  ldapGroup: "ServicePilot Admins"
  accessLevel: OnPremiseAdmin

Configuración del servidor Active Directory

Si se conecta a un servidor de Microsoft Active Directory, se puede especificar un nombre de dominio estilo NT4. Esto permite el uso de nombres de usuario que no son direcciones de email, por ejemplo user1 se asignaría a DOMAIN\user1. Es posible autenticar usuarios en otros dominios especificando el dominio en el inicio de sesión (DOMAIN2\user2) o utilizar la dirección de email de inicio de sesión ([email protected]). Los servidores Active Directory necesitan que el parámetro isOpenLDAP sea false.

Es posible autenticar usuarios en un bosque de Active Directory utilizando el puerto LDAP del bosque AD y la path GC (Ej: GC://10.1.1.1).

La configuración de la path debe incluir un DN base de búsqueda excepto cuando se utiliza una path GC`.

Se recomienda establecer LDAPEncryption en startTLS aunque también están disponibles las opciones none y ssl. Especifica LDAPS:// path si estableces LDAPEncryption a ssl.

Ejemplo de configuración de Active Directory en servicepilot.conf:

general:
  webServer:
    LDAPInfo:
      isOpenLDAP: false
      LDAPEncryption: startTLS
      path: "LDAP://ad.company.com:389/dc=company,dc=com"
      domain: "DOMAIN"

Configuración del servidor LDAP

Cuando se conecta a un servidor LDAP que no es de Active Directory, domain no está configurado, isOpenLDAP está configurado como true y el campo path debe incluir un DN base. Se puede establecer searchUserDN y searchUserPassword si las búsquedas anónimas no permiten acceder a la información de usuario y grupo requerida. El parámetro userField siempre contiene implícitamente uid y mail. Si es necesario buscar el ID de usuario en otros campos, se puede especificar este parámetro.

Se recomienda establecer LDAPEncryption a startTLS aunque las opciones none y ssl están disponibles. Especifica una ruta LDAPS:// si estableces LDAPEncryption a ssl.

Ejemplo de configuración LDAP en servicepilot.conf:

general:
  webServer:
    LDAPInfo:
      isOpenLDAP: true
      LDAPEncryption: startTLS
      path: "LDAP://ldap.company.com:389/dc=company,dc=com"
      searchUserDN: "uid=user,ou=people,dc=company,dc=com"
      searchUserPassword: "password"
      userField: "CN"

Anulación de usuarios definidos internamente

Si la integración con LDAP o Active Directory está activa, es posible que se sigan definiendo usuarios adicionales en ServicePilot. Esto puede ser útil para superusuarios o cuentas especiales, así como en situaciones de emergencia cuando se pierde la conectividad LDAP / Active Directory. Para permitir que estos usuarios definidos internamente sean autenticados por ServicePilot en lugar de pasar la autenticación a LDAP o Active Directory, es necesario añadir internal: true por usuario a estos usuarios especiales en el archivo de configuración tenant.conf.

Ejemplo de usuario localadmin en tenant.conf:

groups:
- group: "admin"
  ldapGroup: "ServicePilot Admins"
  accessLevel: OnPremiseAdmin
  users:
  - user: localadmin
    email: [email protected]
    password: "lQqnt7I0iBNQUE0X9CXHmI/QGzpf5j1/MVm516K/RI0="
    internal: true

Respaldar y restaurar ServicePilot

Copia de seguridad de la configuración y los datos del ServicePilot

ServicePilot hace automáticamente una copia de seguridad de la configuración y los datos en el mismo lugar que la configuración y la base de datos actuales. Los clientes pueden copiar estas copias de seguridad en otro servidor o tomar una instantánea del disco como deseen.

¿Cómo crear una copia de seguridad completa de ServicePilot? (configuración y datos)

ServicePilot realiza automáticamente copias de seguridad de la configuración y los datos que se pueden copiar del servidor de Manager ServicePilot. Sin embargo, la configuración personalizada del cliente debe incluirse para crear una copia de seguridad completa.

Configuración de respaldo de ServicePilot

Copie los siguientes archivos y directorios para crear una copia de seguridad de la configuración:

La clave de licencia de ServicePilot y otras configuraciones de la "ServicePilot Setup Console".
<Work Folder>\Conf
<Work Folder>\Packages
<Work Folder>\Pictures
<Work Folder>\Web

Datos de respaldo de ServicePilot

Los datos de ServicePilot se guardan en Workfolder de la configuración en ejecución. Realice una copia de seguridad de los siguientes directorios:

<Work Folder>\Backup
<Work Folder>\Pdf

Restaurar la configuración de ServicePilot

Sigue estos pasos:

Instalar ServicePilot, si no está ya en el lugar
Detener el Manager ServicePilot
Restaurar toda la configuración a una nueva WorkFolder vacía
Ponga la configuración de WorkFolder en "ServicePilot Setup Console " en el directorio recientemente restaurado
Inicie el Manager ServicePilot

Restaurar datos de ServicePilot

Los datos de ServicePilot se restauran automáticamente en la base de datos a partir de los archivos de copia de seguirdad que se encuentran en <WorkFolder>\Backup.

Nota: la restauración de los datos se produce en segundo plano y tarda varios días.

Para ver el estado actual de la base de datos:

Utilizando una cuenta con privilegios de administradores, acceda a ServicePilot.
Haga clic en Herramienta > Widget > Database
La columna DB History de la tabla Collection Status indica el número de días de historial que hay actualemente en la base de datos

Cambiar la duración de la retención de datos de respaldo

La fuente original de los datos de la base de datos de ServicePilot se almacena en el directorio WorkFolder>\Backup. Esto puede ser necesario si la base de datos se corrompe o si ServicePilot cambia el formato de la base de datos. Las fuentes de la base de datos de ServicePilot se mantienen en disco durante 1 año y un mes de forma predeterminada. Este parámetro se puede cambiar en el archivo de configuración <WorkFolder>\Conf\servicepilotdb.conf.

# Backup retention duration
RETENTIONBACKUP=90

¿Se pueden eliminar las fuentes de respaldo de la base de datos?

Los datos antiguos del directorio <WorkFolder>\Backup pueden ser eliminados pero esto puede ser necesario si la base de datos se corrompe o si ServicePilot cambia el formato de la base de datos. Eliminar manualmente los archivos ZIP de origen si los archivos no se van a necesitar para la restauración. Por ejemplo, normalmente no se necesitarían los archivos objectdata_*.zip más antiguos de una semana, ya que la base de datos de ServicePilot sólo guarda estos datos durante una semana según el ajuste <WorkFolder>\Conf\servicepilotdb.conf RETENTIONOBJECTDATA.

Cambiar la duración de la retención de datos de la base de datos

ServicePilot sólo mantiene los datos en su base de datos por un tiempo limitado. Esto depende del tipo de datos almacenados. Por ejemplo, los datos de los indicadores de objetos se guardan durante 7 días con una resolución de 1 minuto, mientras que los datos de los indicadores de resumen diario se guardan durante un año. Estos parámetros pueden ser modificados en el archivo de configuración <WorkFolder>\Conf\servicepilotdb.conf.

A continuación se presentan las duraciones de retención por defecto

# Event log retention duration
#RETENTIONEVENTS=90
# IP Flow retention duration
#RETENTIONNETTRACE=30
# AppTrace data retention duration
#RETENTIONAPPTRACE=7
# General object log retention duration
#RETENTIONOBJECTLOG=30
# General object data retention duration
#RETENTIONOBJECTDATA=7
# Quarter object data retention duration
#RETENTIONOBJECTDATAQ=30
# Hour object data retention duration
#RETENTIONOBJECTDATAH=365
# RCA retention duration
#RETENTIONOBJECTRCA=365
# Trap retention duration
#RETENTIONTRAP=60
# Syslog retention duration
#RETENTIONSYSLOG=60
# ObjectSL retention duration
#RETENTIONOBJECTSL=90
# ObjectSLD retention duration
#RETENTIONOBJECTSLD=365
# VoIP event retention duration
#RETENTIONVOIP=90

Actualizar ServicePilot a una nueva versión

Se recomienda encarecidamente crear una copia de seguridad antes de iniciar el proceso de actualización. Una copia de seguridad rápida implica detener ServicePilot y hacer una copia completa del WorkFolder de configuración en ejecución.

Importante: Pregunte a ServicePilot Technologies si el formato de la base de datos ha cambiado antes de iniciar una actualización. En este caso se necesitará una copia de seguridad de la configuración y los datos de ServicePilot.

Para actualizar el software ServicePilot:

Detenga el Manager y el Agente de ServicePilot
Detenga la "ServicePilot Setup Console"
Detener la bandeja del sistema ServicePilot ISM
Ejecute el nuevo instalador de ServicePilot
Instale el servicio Manager ServicePilot en la "ServicePilot Setup Console"
Inicie el Manager ServicePilot

Personalice ServicePilot

Agregar imágenes personalizadas a ServicePilot

ServicePilot presenta páginas web que pueden contener iconos y gráficos de clientes.

Las imágenes se pueden subir cuando se añaden recursos a la configuración.

También es posible colocar imágenes personalizadas, en formato JPEG, GIF, PNG o SVG, en el directorio <WorkFolder>\Pictures de la configuración del tiempo de ejecución. Un archivo logo.png agregado a este directorio se utilizará como logotipo de la empresa para informes en PDF.

Agregar páginas web personalizadas a ServicePilot

El Manager ServicePilot puede servir páginas web personalizadas a los usuarios de la interfaz web de ServicePilot si los archivos HTML se colocan en el directorio <WorkFolder>\Web de la configuración en ejecución.

Agregar packages personalizados a ServicePilot

ServicePilot viene con muchos packages integrados. La configuración de ServicePilot puede personalizar cómo se usan estas plantillas para monitorear los recursos. Es posible ampliar las capacidades de ServicePilot utilizando packages personalizados para equipos nuevos o especializados.

Packages personalizados son creados por ServicePilot Technologies y se aplican colocándolos en el directorio de configuración <WorkFolder>\Packages. Es necesario recargar la configuración en ejecución de ServicePilot para que los nuevos packages personalizados estén disponibles para su uso. Para recargar la configuración en ejecución:

Haga clic en AJUSTES > Configuración
Haga clic en Avanzado
Haga clic en Packages > Recargar

Debug

Depurar errores de ServicePilot

El Manager ServicePilot y el Agente Windows ServicePilot almacenan sus archivos de log en el directorio C:\Program Files (x86)\ServicePilot\ServicePilot ISM Enterprise\Logs. El agente Linux de ServicePilot almacena sus logs en el archivo /var/log/servicepilot/servicepilotagent.log.

Consulte estos archivos para ver si hay errores en la configuración o comunicación entre los componentes de ServicePilot y los dispositivos supervisados. A menudo, las contraseñas, las direcciones IP o los números de puerto se configuran incorrectamente al agregar equipos supervisados. Vea estos logs para ver estos errores de acceso.

ServicePilot 429 errores en la página web

Si ServicePilot devuelve códigos de error HTTP 429 al ver páginas web, esto normalmente indica que la base de datos de ServicePilot está sobrecargada. Demasiadas personas están tratando de obtener información o se están realizando demasiadas consultas complejas simultáneas del sistema. Espere y vuelva a intentarlo más tarde.

Se trata de una función de seguridad añadida para ayudar a proteger contra los ataques de denegación de servicio (D/DOS).