Utilisation de l'agent Linux

Après avoir mis à disposition une instance du service IBM Cloud Monitoring dans le IBM Cloud, vous pouvez déployer l'agent Monitoring sur vos hôtes Linux pour collecter automatiquement des données et des métriques. Vous pouvez configurer quelles métriques surveiller dans chaque environnement.

Vous pouvez associer une ou plusieurs étiquettes à chaque agent de surveillance. Les étiquettes sont des valeurs séparées par une virgule qui se présentent sous la forme TAG_NAME:TAG_VALUE. Lorsque vous surveillez votre environnement, vous pouvez les utiliser pour identifier les métriques mises à disposition par un agent. Par exemple, vous pouvez inclure des informations sur le nom du service et l'emplacement dans toutes les métriques qui sont collectées par cet agent.

Configuration requise

Consultez la rubrique Agent d'élagage

Déploiement de l'agent Linux à l'aide d'un script

Pour configurer un agent de surveillance sous Linux afin qu'il collecte et transmette des métriques à une instance du service IBM Cloud Monitoring, procédez comme suit :

Obtenez la clé d'accès.
Obtenez l'URL d'ingestion publique ou privée. Pour plus d'informations, voir Noeuds finaux du collecteur.
Installez les en-têtes du noyau.

Lorsque vous installez un agent de surveillance, celui-ci utilise des fichiers d'en-tête du noyau. En savoir plus

Choisissez une distribution et exécutez pour celle-ci la commande ci-dessous.

Pour les distributions Debian et Ubuntu Linux, exécutez la commande suivante :
```
apt-get -y install linux-headers-$(uname -r)
```
Pour les distributions RHEL, CentOS et Fedora Linux, exécutez la commande suivante :
```
yum -y install kernel-devel-$(uname -r)
```
Déployez l'agent de surveillance. Exécutez la commande suivante à partir d'un terminal.
```
curl -sL https://ibm.biz/install-sysdig-agent | sudo bash -s -- --access_key MONITORING_ACCESS_KEY --collector COLLECTOR_ENDPOINT --collector_port 6443  --tags TAG_DATA --additional_conf 'sysdig_capture_enabled: false\nfeature:\n    mode: monitor_light'
```
Où
- MONITORING_ACCESS_KEY est la clé d'ingestion de l'instance.
- COLLECTOR_ENDPOINT est l'URL d'ingestion publique ou privée de la région où l'instance de surveillance est disponible. Pour obtenir un noeud final, voir Noeuds finaux de collecteur.
- TAG_DATA sont des étiquettes séparées par une virgule qui se présentent sous la forme TAG_NAME:TAG_VALUE. Vous pouvez associer une ou plusieurs étiquettes à votre agent de surveillance. Par exemple, role:serviceX,location:us-south.
- Définissez sysdig_capture_enabled sur false pour désactiver la fonction de capture. La valeur par défaut est true. Pour plus d'informations, voir Utilisation des captures.
Pour installer cURL, lancez la commande yum -q -y install curl pour les distributions RHEL, CentOS et Fedora Linux.
Assurez-vous que l'agent de surveillance est en cours d'exécution. Exécutez la commande suivante :
```
ps -ef | grep sysdig
```
Pour afficher les derniers journaux de l'agent de surveillance, accédez au répertoire /opt/draios/logs et consultez le fichier journal draios.log.

Pour rechercher des erreurs, vous pouvez exécuter la commande suivante :
```
grep error /opt/draios/logs/draios.log
```

Vérification du statut d'un agent à l'aide de l'interface de ligne de commande

Pour vérifier le statut d'un agent, exécutez la commande suivante :

service dragent status

Vérification de la version d'un agent à l'aide de l'interface de ligne de commande

Pour vérifier la version d'un agent, exécutez la commande suivante :

/opt/draios/bin/dragent --version

Mise à jour d'un agent d' Linux

Pour mettre à jour un agent de surveillance sous Linux, procédez comme suit :

Pour mettre à jour l'agent de distributions Debian et Ubuntu Linux, exécutez les commandes suivantes en tant qu'utilisateur sudo depuis un terminal :
```
sudo apt-get update
```
```
sudo apt-get -y install draios-agent
```
Pour mettre à jour l'agent de distributions RHEL, CentOS et Fedora Linux, exécutez les commandes suivantes en tant qu'utilisateur sudo depuis un terminal :
```
yum clean expire-cache
```
```
sudo yum -y install draios-agent
```

Retrait d'un agent de surveillance qui a été déployé en tant que service dans un système Linux

Pour retirer un agent de surveillance sous Linux, procédez comme suit :

Pour désinstaller l'agent de distributions Debian et Ubuntu Linux, exécutez la commande suivante en tant qu'utilisateur sudo depuis un terminal :
```
sudo apt-get remove draios-agent
```
Pour désinstaller l'agent de distributions RHEL, CentOS et Fedora Linux, exécutez la commande suivante en tant qu'utilisateur sudo depuis un terminal :
```
sudo yum erase draios-agent
```

Affichage des journaux d'un agent

Pour afficher les derniers journaux de l'agent de surveillance, accédez au répertoire /opt/draios/logs et consultez le fichier journal draios.log.

Pour rechercher des erreurs, vous pouvez exécuter la commande suivante :

grep error /opt/draios/logs/draios.log

Vérification de l'état de l'agent

Assurez-vous que l'agent de surveillance est en cours d'exécution. Exécutez la commande suivante :

ps -ef | grep sysdig