Los Agentes ServicePilot

¿Qué es un Agente ServicePilot?

Los Agentes ServicePilot están diseñados para recoger datos de monitorización de diversas fuentes y enviarlos a ServicePilot. Los Agentes ServicePilot requieren una configuración mínima. Una vez instalados, solo necesitan acceso web a ServicePilot y una clave API para proteger la comunicación. El resto de la configuración se realiza a través de la interfaz web de ServicePilot.

Se han diseñado para garantizar la eficacia en sus tareas de recopilación y transmisión de datos mediante varios mecanismos:

• Procesamiento local: parte del análisis se puede realizar de forma local. El filtrado y la agregación de los datos sin procesar para transmitir únicamente los KPI esenciales a ServicePilot limitan los flujos de entrada.
• Protocolo seguro: utiliza HTTP2 combinado con el protocolo HTTPS para facilitar la compresión, optimizar los intercambios y permitir una comunicación de datos segura.

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.

Recopilación de datos local y remota

Cada agente ServicePilot tiene diferentes capacidades de recolección. 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.

Local data collection	Remote data collection
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.	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.

Tipos de Agentes ServicePilot

En la siguiente tabla se presentan los diferentes tipos de agentes de ServicePilot, sus plataformas, sus usos principales y sus características técnicas.

Instalación de Agentes ServicePilot

Descargar los Agentes ServicePilot

Obtener una clave de API ServicePilot

Los Agentes 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 de API:

Instalar un Agente ServicePilot

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

Creating directory _agent_files
Verifying archive integrity...  100%   All good.
Uncompressing ServicePilot Linux Agent Package  100%
spagent install script running
No configuration found, awaiting input
Enter API KEY

10000000-0000-0000-0000-000000000000

Use web proxy? [default: n]

n

Use ServicePilot proxy? [default: n]

n

Run in debug mode? [default: n]

n

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

/var/log/servicepilot/

This is debian based distro
Removing spagent files
Removing dotnetcoreagent files
Reset spagent
Created symlink /etc/systemd/system/multi-user.target.wants/spagent.service → /etc/systemd/system/spagent.service.
spagent started

#

./servicepilotlinuxagent.run -- --help

# Create a namespace for ServicePilot components
apiVersion: v1
kind: Namespace
metadata:
  name: monitoring
  labels:
    app: servicepilot-agent
---
# To have ServicePilot retrieve metrics from Kubelets with authentication and
# authorization enabled (which is highly recommended and included in security
# benchmarks) the following flags must be set on the kubelet(s):
#
# --authentication-token-webhook
# --authorization-mode=Webhook
#
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: servicepilot-stats-viewer
  labels:
    rbac.authorization.k8s.io/servicepilot-stats-viewer: "true"
rules:
  - apiGroups: [""]
    resources:
      - nodes
      - nodes/proxy
      - nodes/metrics
      - nodes/stats
      - services
      - endpoints
      - pods
      - ingresses
      - configmaps
      - persistentvolumes
    verbs: ["get", "list", "watch"]
  - apiGroups: ["extensions", "networking.k8s.io"]
    resources:
      - ingresses/status
      - ingresses
    verbs: ["get", "list", "watch"]
  - apiGroups: ["metrics.k8s.io"]
    resources: 
      - pods
    verbs: ["get", "list", "watch"]
  - nonResourceURLs:
      - "/metrics"
    verbs: ["get"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: servicepilot
  labels:
    app: servicepilot-agent
aggregationRule:
  clusterRoleSelectors:
    - matchLabels:
        rbac.authorization.k8s.io/servicepilot-stats-viewer: "true"
    - matchLabels:
        rbac.authorization.k8s.io/aggregate-to-view: "true"
rules: [] # Rules are automatically filled in by the controller manager.
---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: servicepilot
  labels:
    app: servicepilot-agent
  namespace: monitoring
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: servicepilot
  labels:
    app: servicepilot-agent
subjects:
  - kind: ServiceAccount
    name: servicepilot
    namespace: monitoring
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: servicepilot
---
# ServicePilot Agent deployment
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: servicepilot-agent
  namespace: monitoring
  labels:
    app: servicepilot-agent
spec:
  selector:
    matchLabels:
      app: servicepilot-agent
  template:
    metadata:
      labels:
        app: servicepilot-agent
    spec:
      tolerations:
      # this toleration is to have the daemonset runnable on master nodes
      # remove it if your masters can't run pods
      - key: node-role.kubernetes.io/control-plane
        operator: Exists
        effect: NoSchedule
      - key: node-role.kubernetes.io/master
        operator: Exists
        effect: NoSchedule
      serviceAccountName: servicepilot
      containers:
        - name: servicepilot
          image: servicepilot/agent
          env:
          - name: SERVICEPILOT_API_KEY
            value: "10000000-0000-0000-0000-000000000000"
          - name: SERVICEPILOT_IP
            value: "data.servicepilot.com"
          - name: SERVICEPILOT_PORT
            value: "443"
          - name: HTTPS
            value: "1"
          - name: NODE_NAME
            valueFrom:
              fieldRef:
                fieldPath: spec.nodeName
          - name: NODE_IP
            valueFrom:
              fieldRef:
                fieldPath: status.hostIP
          - name: HOSTNAME
            value: $(NODE_NAME)-pod
          - name: SP_K8_RESOURCE
            value: "K8 Cluster 1"
          - name: SP_K8_NAMESPACE_FILTER
            value: "*"
          - name: SP_K8_POD_FILTER
            value: "*"

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:

Establecer el Agente por defecto

Al aprovisionar recursos se puede configurar al menos un Agente de ServicePilot para indicar que realice el monitoreo de ese recurso en la misma máquina que el recurso o desde Agentes remotos.

Si los campos Agente se dejan en blanco, se utilizará el Agente por defecto para monitorear el recurso.

Para definir o cambiar el Agente ServicePilot por defecto:

Establecer un Agente de backup

Opcionalmente, se puede configurar un Agente de Backup que asumirá las responsabilidades de supervisión del Agente por Defecto transcurridos unos minutos si el Agente por Defecto pierde la conectividad con el Manager ServicePilot. El Agente de Backup necesita estar en posición de acceder a todos los mismos recursos que el Agente por Defecto y estar instalado en el mismo tipo de sistema operativo que el Agente por Defecto.

Para definir el Agente ServicePilot de backup:

El Agente de backup no puede ser el mismo que el Agente por defecto.

Agente ServicePilot SPProxy

El SPProxy es una función de proxy del agente de ServicePilot que puede actuar como pasarela y concentrador entre varios agentes de ServicePilot y el ServicePilot Manager. En entornos distribuidos y en sitios remotos con poco ancho de banda, simplifica enormemente la implementación, ya que los agentes se conectan localmente al proxy. Contribuye a:

• Agrupación y optimización del tráfico: SPProxy agrega y comprime las comunicaciones de los agentes de un mismo sitio antes de transmitirlas. Al reducir el número de conexiones simultáneas al servidor central, disminuye el consumo de ancho de banda y agiliza los intercambios.
• Seguridad y simplificación del flujo: al consolidar las comunicaciones salientes, los agentes remotos ya no necesitan abrir sesiones externas de forma individual, lo que reduce la exposición al limitar las conexiones directas entre el sitio y la plataforma ServicePilot. Proporciona un cifrado sistemático de extremo a extremo de los intercambios para todos los agentes conectados.

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:

C:\Program Files\ServicePilot\ServicePilot ISM Enterprise\logs\ServicePilotAgent.log

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

Desinstalar un Agente ServicePilot

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

Comprobar si un Agente está en uso

Desinstalación de un Agente ServicePilot

./servicepilotlinuxagent.run -- --uninstall

Eliminar los Agentes desinstalados de la lista de Agentes

Cuando se desinstala un agente de un sistema, los recursos asignados asociados (elementos supervisados, objetos creados automáticamente, configuraciones dependientes, etc.) siguen estando presentes en ServicePilot mientras el agente siga figurando en la lista de agentes. Por lo tanto, eliminar el agente de esta lista permite borrar correctamente todos los recursos vinculados.

Mientras un agente siga instalado y activo, eliminarlo de la lista no tendrá ningún efecto duradero: seguirá comunicándose con ServicePilot y se volverá a registrar automáticamente.

Estos son los pasos para eliminar un agente desinstalado: