Les Agents ServicePilot

Qu'est-ce qu'un Agent ServicePilot ?

Les Agents ServicePilot sont conçus pour collecter des données de supervision de différentes sources et les envoyer à ServicePilot. Les Agents ServicePilot ne nécessitent qu'une configuration succinte. Tout ce dont ils ont besoin, c'est d'un accès web à ServicePilot et d'une Clé API pour sécuriser la communication. Toute autre configuration se fait via l'interface web de ServicePilot.

Agents ServicePilot SaaS

Agents ServicePilot On Premise

Combien d'Agents ServicePilot doivent être installés ?

Pour savoir si un Agent ServicePilot doit être installé sur le même serveur que les données qu'il va collecter, consultez la colonne Collecte locale dans le tableau Licenses - Agent details, disponible dans l'interface web de ServicePilot.

Proxy d'Agent ServicePilot pour accéder à ServicePilot

Veuillez contacter notre support ServicePilot si vous souhaitez configurer un proxy pour l'Agent ServicePilot.

Capacités de collectes de l'Agent ServicePilot

Chaque Agent ServicePilot possède des capacités de collectes différentes. Pour voir ce que ces Agents Enterprise peuvent faire, consultez la page Agent Details :

Agents Enterprise ServicePilot

Les Agents Enterprise collectent des données directement sur les serveurs où ils sont installés, ou sur d'autres équipements. Ces agents peuvent aussi recevoir des données d'événements non sollicités s'ils sont configurés pour le faire.

L'Agent Windows ServicePilot utilise le framework .NET de Microsoft.

L'Agent Linux ServicePilot a été compilé pour les distributions x86 et x64 basées sur RedHat et Debian actuellement supportées, ainsi que pour l'OS Raspberry Pi 32-bit sur ARM.

Agent Endpoint ServicePilot

L'Agent Endpoint ServicePilot est conçu pour collecter l'inventaire matériel et logiciel des postes de travail Windows.

Agent Developer ServicePilot

Des données statistiques sur le nombre et le type d'appels Web effectués dans les applications Puppeteer, JavaScript dans les navigateurs Web et Node.js peuvent être collectées. Ces intégrations nécessitent d'instrumenter le code en question pour envoyer les détails des appels à ServicePilot.

Intégration de l'Agent Open Source

L'Agent Windows ServicePilot peut agir comme une passerelle vers un certain nombre d'Agents Open Source, fournissant ainsi à ServicePilot les données collectées par ces agents.

Status Monitor de ServicePilot

Le Status Monitor de ServicePilot n'est pas un agent utilisé pour collecter des données. Il s'agit d'une extension de l'interface web de ServicePilot permettant aux utilisateurs de ServicePilot de voir le nombre actuel d'éléments avec des alertes sur le bureau de Windows.

Le Status Monitor de ServicePilot peut être téléchargé depuis le menu Utilisateur.

Télécharger les Agents ServicePilot

Obtenir une clé API ServicePilot

Installer un Agent Windows ServicePilot

Après avoir téléchargé l'Agent ServicePilot, double-cliquez sur le fichier pour exécuter le programme d'installation. Définissez les paramètres pour que l'Agent ServicePilot puisse communiquer avec ServicePilot.

Installer un Agent Linux ServicePilot

Après avoir téléchargé l'Agent ServicePilot, vérifiez que le fichier est exécutable puis lancez-le en tant que root. A la fin de l'installation, le script demandera une clé API. Définissez les paramètres pour que l'Agent ServicePilot puisse communiquer avec ServicePilot. Vous pouvez arrêter et démarrer le service spagent en utilisant les commandes standards de votre distribution Linux.

Pour x86, le fichier s'appelle servicepilotlinuxagent.run
Pour ARM, le fichier s'appelle servicepilotlinuxarmagent.run

# 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

#

Pour obtenir la liste complète des paramètres de la ligne de commande, exécutez le programme d'installation avec l'option -- --help.

Installer un Agent Linux ServicePilot dans Docker

L'Agent Linux de ServicePilot peut être exécuté dans un conteneur Docker.

Le hostname du conteneur Docker doit être unique afin qu'il puisse être configuré correctement.

La connexion d'un conteneur Docker pour l'Agent ServicePilot à l'offre ServicePilot SaaS nécessitera la définition d'un SERVICEPILOT_API_KEY. Des variables d'environnement de proxy peuvent également être ajoutées :

docker run --detach --hostname spagent1 -e SERVICEPILOT_API_KEY=10000000-0000-0000-0000-000000000000 servicepilot/agent:latest

Pour les déploiements On Premise, les variables SERVICEPILOT_API_KEY, SERVICEPILOT_IP, SERVICEPILOT_PORT et HTTPS sont requis. Des variables d'environnement de proxy peuvent également être ajoutées :

docker run --detach --hostname spagent1 -e SERVICEPILOT_API_KEY=00000000-0000-0000-0000-000000000000 -e SERVICEPILOT_IP=servicepilot.company.com -e SERVICEPILOT_PORT=443 -e HTTPS=1 servicepilot/agent:latest

Installer un Agent Linux ServicePilot dans Kubernetes

L'Agent Linux ServicePilot peut être exécuté dans un Pod Kubernetes.

Le nom d'hôte du Pod Kubernetes devra être unique afin qu'il puisse être configuré correctement.

Remarque : l'exécution d'un Agent ServicePilot dans un Pod Kubernetes limitera ses capacités à l'interrogation à distance et à l'obtention d'informations Kubernetes.

Déployez un Agent ServicePilot DaemonSet sur le cluster Kubernetes. Notez les variables d'environnement SERVICEPILOT_* qui doivent correspondre à votre déploiement ServicePilot. Pour ServicePilot SaaS, SERVICEPILOT_IP doit être data.servicepilot.com. Pour les déploiements On Premise, les variables d'environnement SERVICEPILOT_API_KEY, SERVICEPILOT_IP, SERVICEPILOT_PORT et HTTPS sont nécessaires.

# 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)

Vérifiez si un Agent ServicePilot fonctionne

Pour vous assurer que les Agents ServicePilot communiquent correctement avec ServicePilot, ouvrez la page Agents :

Logs des Agents ServicePilot

Les logs des Agents ServicePilot journalisent les erreurs de connectivité entre l'Agent ServicePilot et ServicePilot, et les problèmes de récupération des données depuis les équipements. Ces logs d'Agents sont particulièrement intéressantes si la supervision ne semble pas fonctionner entre l'Agent et les équipements distants en raison de mauvaises informations d'accès.

Ouvrez les logs de l'Agents avec un éditeur de texte :

Logs de l'Agent Windows

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

Logs de l'Agent Linux

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

Désinstaller un Agent ServicePilot

Si un Agent ServicePilot n'est plus utilisé, il peut être désinstallé.

Vérifier si un Agent est en cours d'utilisation

Désinstaller un Agent Windows ServicePilot

Pour désinstaller un Agent Windows ServicePilot correctement, vérifiez qu'il est arrêté avant de le supprimer.

Désinstaller un Agent Linux ServicePilot

S'assurer que l'Agent Linux ServicePilot n'est pas utilisé avant de le désinstaller.

Supprimer les Agents désinstallés de la liste des Agents

Tant qu'un Agent n'est pas désinstallé, sa suppression de la liste des Agents n'aura pas l'effet souhaité car l'Agent continuera à communiquer avec ServicePilot et réapparaîtra continuellement dans la liste des Agents.